• Francia
Back Office Vendedor
asistencia
FAQcontacte el soporte tecnico
Buscar
Categoria
Tags
Perú
Perú
Página principal
Casos de uso
Crear un pago
Crear un pago en cuotas
Crear un pago por token
Crear un enlace de pago
Crear una suscripción
Gestione sus suscripciones
Gestione sus transacciones
Analizar los diarios
Docs API
Formulario incrustado
API REST
API REST PCI-DSS
Formulario en redirección
Pago móvil
Intercambio de ficheros
Ejemplo de código
Módulos de pago
Guías
Back Office Vendedor
Guías funcionales

Guía de integración

Casos de uso

Utilice el Web Service V4.1/PCI/Charge/CreatePayment en función del protocolo de autentificación y del resultado de la autentificación.

  • Para la red VISA/Mastercard/AMEX
  • Autentificación Procesos Diners
  • Autentificación desactivada

autentificación 3-D Secure v2

Testear

Testee el Web Service V4.1/PCI/Charge/CreatePayment desde nuestro playground.

Datos de autenticación

Récupérez les données suivantes :

Protocolo de autentificación

APELLIDO Descripción
name Nombre del protocolo de autentificación con el valor THREEDS
VERSIÓN Versión del protocolo de autenticación. Valores posibles:
  • 2
  • 2.1.0
  • 2.2.0
directoryServer Nombre del Directory Server (DS) utilizado durante la autentificación. Valores posibles:
  • Amex
  • CB
  • Diners
  • Discover
  • Visa
  • mastercard
ChallengePreference Preferencia 3DS transmitida al DS si la autentificación de titular es satisfactoria y su estado es 'SUCCESS' o 'ATTEMPT'.

El resultado del pago depende del estado de la autentificación.

  1. Si el estado de la autentificación tiene el valorSUCCESSoATTEMPT, récupérez ces informations :
</tbody>
APELLIDO Descripción
authenticationType Nombre del protocolo de autenticación. Valor requerido:
  • CHALLENGE
  • FRICTIONLESS
authenticationValue Referencia generada por el emisor para validar todos los datos de la transacción. Según el Directory Service utilizado,
  • CAVV pour VISA
  • AAV pour Mastercard
  • AEVV pour AMEX Safekey.

Ejemplo: +kAr/o8S0DxgGYkz7QQHZCw8V5k=

commerceIndicator Indicador de comercio electrónico (ECI). Valor que devuelve el ACS tras la autentificación en función del estado de la autentificación y del tipo de tarjeta.

Ejemplo: 05

dsTransID Identificador único de la transacción generado por el DS 3DS2.

Ejemplo: d6706a0d-c48d-4cf4-a1d2-d4a401a3143e

una exención Se aplica la exención. Requerido para FRICTIONLESS, valor del campo 'authenticationType' . Ver:Motivos de la desactivación y exenciones.

Ejemplo: LOW_VALUE

  1. Si le statut de l'authentification est en échec avec les valeurs suivantes :
  • DISABLED
  • ENROLLED_UNAVAILABLE
  • FAILED
  • NOT_ENROLLED
  • UNAVAILABLE

Dans ce cas, récupérez ces informations :

APELLIDO Descripción
challengeCancelationIndicator Nombre del protocolo de autenticación. Valor requerido: Indicador de la cancelación del challenge recibido en el mensaje RReq. Valor que devuelve el DS en caso de anulación de la autentificación.

Ex: 01

transactionStatusReason Motivo del fallo de la autentificación devuelta por el DS en caso de fallo de autentificación.

Ex: 82

Para la red VISA/Mastercard/AMEX

Solicitud

Campos obligatorios
  • Monto
  • Moneda

Datos de la tarjeta

  • Tipo del medio de pago:CARDS
  • Número principal de la tarjeta: pan.
  • Mes de vencimiento.
  • Año de vencimiento.

Datos de autenticación

  1. En el protocolo
  • nombre:THREEDS
  • Número de versión:
  • directoryServer: nombre del DS. Ejemplo:VISAoMASTERCARDoAMEX
  • challengePreference: Ejemplo:NO_CHALLENGE_REQUESTEDen caso de autentificación satisfactoria (estadoSUCCESSoATTEMPT).
  1. Datos de test
authenticationType : FRICTIONLESS dsTransID : d6706a0d-c48d-4cf4-a1d2-d4a401a3143e
authenticationValue : +kAr/o8S0DxgGYkz7QQHZCw8V5k= commerceIndicator : 05
challengePreference : NO_CHALLENGE_REQUESTED exemption : LOW_VALUE

Ejemplo de solicitud para VISA

/doc/es-PE/rest/V4.0/api/kb/authentication.html
https://api.micuentaweb.pe/api-payment/V4.1/Charge/CreatePayment
  {
    "amount": "180",
    "currency": "PEN",
    "paymentForms": [
      {
     "paymentMethodType": "CARD",
     "pan": "4970110000001029",    
     "expiryMonth": "09",
     "expiryYear": "27",
     "securityCode": "123",
     "identityDocumentType":"CC",
     "identityDocumentNumber":"01-93-N9l6477D",
     "installmentNumber":"3",
     "mid":"9999999"
      }
    ],    
    "customer": {
     "email": "sample@example.com"
    },    
    "authenticationDetails":{ 
     "protocol":{
      "name":"THREEDS",
      "version":"2.1.0",
      "directoryServer":"VISA",
      "challengePreference":"NO_CHALLENGE_REQUESTED"
     },   
     "status":"SUCCESS",
     "authenticationType":"FRICTIONLESS",
     "commerceIndicator":"05",
     "authenticationValue":"+kAr/o8S0DxgGYkz7QQHZCw8V5k=",
     "dsTransID":"d6706a0d-c48d-4cf4-a1d2-d4a401a3143e",  
     "exemption":"OTHER_EXEMPTION",
    }    
   }

Pour connaître l'intégralité et la description des champs, consultez le playground : V4.1/PCI/Charge/CreatePayment (menu à gauche)

Autentificación Procesos Diners

Recupere los siguientes datos de autentificación:

Protocolo de autentificación

APELLIDO Descripción
name Nombre del protocolo de autentificación con el valor THREEDS
VERSIÓN Versión del protocolo de autenticación. Valores posibles:
  • 2
  • 2.1.0
  • 2.2.0
directoryServer Nombre del Directory Server (DS) utilizado durante la autentificación. Valor: PROCESOS_DINERS

Si le statut de l'authentification a pour valeur SUCCESS ou ATTEMPT, récupérez ces informations :

APELLIDO Descripción
authenticationValue Referencia generada por el emisor para validar todos los datos de la transacción.
dsTransID Identificador único de la transacción generado por el DS 3DS2.

Ejemplo: d6706a0d-c48d-4cf4-a1d2-d4a401a3143e

Si le statut de l'authentification est en échec avec les valeurs suivantes :

  • DISABLED
  • ENROLLED_UNAVAILABLE
  • FAILED
  • NOT_ENROLLED
  • UNAVAILABLE

Dans ce cas, récupérez ces informations :

APELLIDO Descripción
challengeCancelationIndicator Nombre del protocolo de autenticación. Valor requerido: Indicador de la cancelación del challenge recibido en el mensaje RReq. Valor que devuelve el DS en caso de anulación de la autentificación.

Ex: 01

transactionStatusReason Motivo del fallo de la autentificación devuelta por el DS en caso de fallo de autentificación.

Ex: 82

Solicitud

Campos obligatorios
  • Monto
  • Moneda

Datos de la tarjeta

  • Tipo del medio de pago:CARDS
  • Número principal de la tarjeta: pan.
  • Mes de vencimiento.
  • Año de vencimiento.

Datos de autenticación

  1. En el protocolo
  • nombre:THREEDS
  • Número de versión:
  • directoryServer: PROCESOS_DINERS
  1. Datos de test
authenticationValue : T2RpQWxwazcySlZGakx1eXlxYmE=
dsTransID : 4b69e6ba-7edb-4871-aded-162cb5353731

Ejemplo de solicitud

/doc/es-PE/rest/V4.0/api/kb/authentication.html
https://api.micuentaweb.pe/api-payment/V4.1/Charge/CreatePayment
  {
    "amount": "1230",
    "currency": "PEN",
    "paymentForms": [
      {
     "paymentMethodType": "CARD",
     "pan": "36230000000001",    
     "expiryMonth": "09",
     "expiryYear": "27",
     "securityCode": "123",
     "identityDocumentType":"CC",
     "identityDocumentNumber":"01-93-N9l6477D",
     "installmentNumber":"3",
     "mid":"9999999"
      }
    ],    
    "customer": {
     "email": "sample@example.com"
    },    
    "authenticationDetails":{ 
     "protocol":{
      "name":"PROCESOS_DINERS",
      "version":"2",
      "directoryServer":"PROCESOS_DINERS"
     },   
     "status":"SUCCESS",
     "authenticationValue":"T2RpQWxwazcySlZGakx1eXlxYmE=",
     "dsTransID":"4b69e6ba-7edb-4871-aded-162cb5353731"    
    }    
   }

Pour connaître l'intégralité et la description des champs, consultez le playground : V4.1/PCI/Charge/CreatePayment (menu à gauche)

Autentificación desactivada

Le service permet de créer un paiement lorsque l'authentification du porteur a été volontairement désactivée.

Dans ce cas, la raison de cette décision doit être précisée en utilisant le champ exemption (Voir chapitre Motif de débrayage et exemptions).

Campos obligatorios
  • Monto
  • Moneda

Datos de la tarjeta

  • Tipo del medio de pago:CARDS
  • Número principal de la tarjeta: pan.
  • Mes de vencimiento.
  • Año de vencimiento.

Datos de autenticación

  • Estado:DISABLED
  • Exención: Ver: Motivos de la desactivación y exenciones.

Ejemplo de solicitud

/doc/es-PE/rest/V4.0/api/kb/authentication.html
https://api.micuentaweb.pe/api-payment/V4.1/Charge/CreatePayment
  {
    "amount": "1230",
    "currency": "PEN",
    "paymentForms": [
      {
     "paymentMethodType": "CARD",
     "pan": "4970100000000022",    
     "expiryMonth": "09",
     "expiryYear": "27",
     "securityCode": "123",
     "identityDocumentType":"CC",
     "identityDocumentNumber":"01-93-N9l6477D",
     "installmentNumber":"3",
     "mid":"9999999"
      }
    ],    
    "customer": {
     "email": "sample@example.com"
    },    
    "authenticationDetails":{    
     "status":"DISABLED",
     "exemption":"OTHER_EXEMPTION"  
    }    
   }

Pour connaître l'intégralité et la description des champs, consultez le playground : V4.1/PCI/Charge/CreatePayment (menu à gauche)

© 2025 Todos los derechos reservados de Izipay
25.17-1.11