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.
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:
|
| directoryServer | Nombre del Directory Server (DS) utilizado durante la autentificación. Valores posibles:
|
| ChallengePreference | Preferencia 3DS transmitida al DS si la autentificación de titular es satisfactoria y su estado es 'SUCCESS' o 'ATTEMPT'. |
- Si el estado de la autentificación tiene el valor
SUCCESSoATTEMPT, récupérez ces informations :
</tbody>| APELLIDO | Descripción |
|---|---|
| authenticationType | Nombre del protocolo de autenticación. Valor requerido:
|
| authenticationValue | Referencia generada por el emisor para validar todos los datos de la transacción. Según el Directory Service utilizado,
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. Ex: 05 |
| dsTransID | Identificador único de la transacción generado por el DS 3DS2. Ejemplo: d6706a0d-c48d-4cf4-a1d2-d4a401a3143e |
| exemption | Se aplica la exención. Requerido para FRICTIONLESS, valor del campo 'authenticationType' . Ver:Motivos de la desactivación y exenciones.
Ejemplo: LOW_VALUE |
- 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
- 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).
- 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-AR/rest/V4.0/api/kb/authentication.html
https://api.cobroinmediato.tech/api-payment/V4.1/Charge/CreatePayment
{
"amount": "9900",
"currency": "ARS",
"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 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-AR/rest/V4.0/api/kb/authentication.html
https://api.cobroinmediato.tech/api-payment/V4.1/Charge/CreatePayment
{
"amount": "1230",
"currency": "ARS",
"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)