• 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

Recupere los siguientes datos:

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, recupera esta información:
</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 el estado de autenticación es fallido con los siguientes valores:
  • DISABLED
  • ENROLLED_UNAVAILABLE
  • FAILED
  • NOT_ENROLLED
  • UNAVAILABLE

En este caso, recupera esta información:

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",
    }    
   }

Para ver la información completa y las descripciones de los campos, consulte el área de juegos: V4.1/PCI/Charge/CreatePayment (menú de la izquierda)

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 el estado de autenticación es SUCCESS o ATTEMPT , recupere esta información:

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 el estado de autenticación es fallido con los siguientes valores:

  • DISABLED
  • ENROLLED_UNAVAILABLE
  • FAILED
  • NOT_ENROLLED
  • UNAVAILABLE

En este caso, recupera esta información:

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"    
    }    
   }

Para ver la información completa y las descripciones de los campos, consulte el área de juegos: V4.1/PCI/Charge/CreatePayment (menú de la izquierda)

Autentificación desactivada

El servicio le permite crear un pago cuando la autenticación del titular de la tarjeta se ha desactivado voluntariamente.

En este caso, se deberá especificar el motivo de esta decisión mediante el campoexención (Véase el capítulo Motivo de la huelga y exenciones ).

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"  
    }    
   }

Para ver la información completa y las descripciones de los campos, consulte el área de juegos: V4.1/PCI/Charge/CreatePayment (menú de la izquierda)

© 2025 Todos los derechos reservados de Izipay
25.17-1.11