Guía de integración (obsoleta)

Les paramètres d'appel au service PCI/Charge/CreatePayment (déprécié) dépendent du protocole d'authentification utilisé ainsi que du résultat de l'authentification.

Esta sección describe los parámetros que deben transmitirse con cada protocolo.

autentificación 3-D Secure v2

Contenido de la solicitud :

NIVEL	APELLIDO	Descripción	OBLIGATORIO
1	amount	Monto del pago en la fracción monetaria más pequeña de la divisa. Debe coincidir al monto de autentificación.	Sí
1	currency	Código (ISO 4217 alpha3) de la moneda del pago. Ejemplo: Ej: "PEN" para el sol peruano.	Sí
1	orderId	Referencia del pedido.	NO
1	formAction	Permite indicar si se desea registrar la tarjeta. Valores posibles: PAYMENT: Pago sin creación de token. Valor predeterminado. REGISTER_PAY: Creación del token durante un pago.	NO
1	customer	Objeto que contiene los datos del comprador.	NO
2	email	E-mail del comprador. Obligatorio cuandoformActiontiene el valorREGISTER_PAY.	Ver descripción
1	subMerchantDetails	Objeto que contiene los datos del subvendedor.	NO
1	paymentForms	Objeto que contiene los datos de la tarjeta.	Sí
2	paymentMethodType	Tipo de medio de pago. Su valor debe serCARD.	Sí
2	pan	Número de tarjeta.	Sí
2	expiryMonth	Mes de caducidad de la tarjeta. Ejemplo: 3 o 03	Sí
2	expiryYear	Año de caducidad de la tarjeta. Ejemplo: 27 o 2027	Sí
2	securityCode	Código de seguridad de la tarjeta (CVV o 4DBC).	NO
1	authenticationDetails	Objeto que contiene los datos de autentificación del titular.	Sí
2	protocol	Objeto que describe el protocolo de autentificación utilizado.	Sí
3	name	Nombre del protocolo de autentificación. Su valor debe serTHREEDS.	Sí
3	version	Versión del protocolo de autentificación. Su valor debe ser2, 2.1.0o a2.2.0.	Sí
3	directoryServer	Nombre del Directory Server (DS) utilizado durante la autentificación. Valores posibles: AMEX CB DINERS DISCOVER VISA MASTERCARD	Sí
3	challengePreference	Preferencia 3DS transmitida al DS durante la autentificación del titular. Obligatorio sistatustiene el valorSUCCESSoATTEMPT.	Ver descripción
2	status	Estado de autentificación. Valores posibles: DISABLED ATTEMPT ENROLLED_UNAVAILABLE FAILED NOT_ENROLLED SUCCESS UNAVAILABLE	Sí
2	authenticationType	Tipo de autentificación. Obligatorio sistatustiene el valorSUCCESS o ATTEMPT. Valores posibles: CHALLENGE FRICTIONLESS	Ver descripción
2	authenticationValue	Referencia generada por el emisor que permite validar la totalidad de datos de la transacción. Según el DS, corresponde a CAVV para VISA, a AVV para Mastercard o bien a AEVV para AMEX Safekey. Obligatorio cuandostatustiene el valorSUCCESSoATTEMPT. Ejemplo: Ejemplo: +kAr/o8S0DxgGYkz7QQHZCw8V5k=	Ver descripción
2	commerceIndicator	Indicador de comercio electrónico (ECI). Valor devuelto por el ACS tras la autentificación. El valor ECI depende del estado de la autentificación y del tipo de tarjeta. Obligatorio cuandostatustiene el valorSUCCESSoATTEMPT. Ex: 05	Ver descripción
2	dsTransID	Identificador único de la transacción generado por el DS 3DS2. Obligatorio cuandostatustiene el valorSUCCESSoATTEMPT. Ejemplo: d6706a0d-c48d-4cf4-a1d2-d4a401a3143e	Ver descripción
2	exemption	Se aplica la exención. Obligatorio cuandoauthenticationTypetiene el valorFRICTIONLESS. Consulte capítuloMotivos de la desactivación y exenciones.	Ver descripción
2	requestorName	Nombre del vendedor utilizado durante la autentificación del titular. Obligatorio sidirectoryServertiene el valorCB.	Ver descripción
2	acsTransID	Identificador único de la transacción generado por el ACS. Obligatorio cuandostatustiene el valorSUCCESSoATTEMPTy quedirectoryServertiene el valorCB. Ej: d727ebfe-de4c-4682-85fa-e60ca00a9cff	Ver descripción
2	authValueAlgorithm	Algoritmo de verificación de la autentificación del titular. Obligatorio cuandostatustiene el valorSUCCESSoATTEMPTy quedirectoryServertiene el valorCB. Valores posibles: 0: HMAC 1: CVV 2: CVV_ATN 3: MASTERCARD_SPA a: AV-CB	Ver descripción
2	challengeCancelationIndicator	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. Ejemplo: 01	NO
2	transactionStatusReason	Motivo del fallo de la autentificación devuelta por el DS en caso de fallo de autentificación. Ejemplo: 82	NO

Encuentre la descripción de los campos en nuestro Playground.

Datos de test

pan :	4970110000001029	directoryServer :	VISA
expiryMonth / expiryYear :	A elección	dsTransID :	d6706a0d-c48d-4cf4-a1d2-d4a401a3143e
securityCode :	A elección	authenticationValue :	+kAr/o8S0DxgGYkz7QQHZCw8V5k=
authenticationType :	FRICTIONLESS	challengePreference :	NO_CHALLENGE_REQUESTED
commerceIndicator :	05	exemption :	LOW_VALUE

El resultado del pago depende del valor de status utilizado.

Ejemplo de solicitud

{
	"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":"ACQUIRER_TRA",
	}		  
}

Autentificación Procesos Diners

Contenido de la solicitud :

NIVEL	APELLIDO	Descripción	OBLIGATORIO
1	amount	Monto del pago en la fracción monetaria más pequeña de la divisa. Debe coincidir al monto de autentificación.	Sí
1	currency	Código (ISO 4217 alpha3) de la moneda del pago. Ejemplo: Ej: "PEN" para el sol peruano.	Sí
1	orderId	Referencia del pedido.	NO
1	formAction	Permite indicar si se desea registrar la tarjeta. Valores posibles: PAYMENT: Pago sin creación de token. Valor predeterminado. REGISTER_PAY: Creación del token durante un pago.	NO
1	customer	Objeto que contiene los datos del comprador.	NO
2	email	E-mail del comprador. Obligatorio cuandoformActiontiene el valorREGISTER_PAY.	Ver descripción
1	subMerchantDetails	Objeto que contiene los datos del subvendedor.	NO
1	paymentForms	Objeto que contiene los datos de la tarjeta.	Sí
2	paymentMethodType	Tipo de medio de pago. Su valor debe serCARD.	Sí
2	pan	Número de tarjeta.	Sí
2	expiryMonth	Mes de caducidad de la tarjeta. Ejemplo: 3 o 03	Sí
2	expiryYear	Año de caducidad de la tarjeta. Ejemplo: 27 o 2027	Sí
2	securityCode	Código de seguridad de la tarjeta (CVV).	NO
1	authenticationDetails	Objeto que contiene los datos de autentificación del titular.	Sí
2	protocol	Objeto que describe el protocolo de autentificación utilizado.	Sí
3	name	Nombre del protocolo de autentificación. Su valor debe serPROCESOS_DINERS.	Sí
3	version	Versión del protocolo de autentificación. Su valor debe ser1o a1.0.	Sí
3	directoryServer	Nombre del Directory Server (DS) utilizado durante la autentificación. Su valor debe serPROCESOS_DINERS.	Sí
2	status	Estado de autentificación. Valores posibles: DISABLED ENROLLED_UNAVAILABLE FAILED NOT_ENROLLED SUCCESS	Sí
2	authenticationValue	Referencia generada por el DS que permite validar la totalidad de datos de la transacción (CAVV). Obligatorio cuandostatustiene el valorSUCCESS. Ejemplo: T2RpQWxwazcySlZGakx1eXlxYmE	Ver descripción
2	dsTransID	Identificador único de la transacción generado por el DS2. Obligatorio cuandostatustiene el valorSUCCESS. Ejemplo: 4b69e6ba-7edb-4871-bf1f-162cb5353731	Ver descripción

Encuentre la descripción de los campos en nuestro Playground.

Datos de test

pan :	36230000000001	directoryServer :	PROCESOS_DINERS
expiryMonth / expiryYear :	A elección	authenticationValue :	T2RpQWxwazcySlZGakx1eXlxYmE=
securityCode :	A elección	dsTransID :	4b69e6ba-7edb-4871-aded-162cb5353731

Ejemplo de solicitud

{
	"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":"1",
			"directoryServer":"PROCESOS_DINERS"
		},			
		"status":"SUCCESS",
		"authenticationValue":"T2RpQWxwazcySlZGakx1eXlxYmE=",
		"dsTransID":"4b69e6ba-7edb-4871-aded-162cb5353731"				
	}		  
}

Autentificación desactivada

El servicio permite crear un pago cuando la autentificación del titular ha sido desactivada voluntariamente, cualquiera sea el protocolo de autentificación.

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).

Contenido de la solicitud :

NIVEL	APELLIDO	Descripción	OBLIGATORIO
1	amount	Monto del pago en la fracción monetaria más pequeña de la divisa. Debe coincidir al monto de autentificación.	Sí
1	currency	Código (ISO 4217 alpha3) de la moneda del pago. Ejemplo: Ej: "PEN" para el sol peruano.	Sí
1	orderId	Referencia del pedido.	NO
1	formAction	Permite indicar si se desea registrar la tarjeta. Valores posibles: PAYMENT: Pago sin creación de token. Valor predeterminado. REGISTER_PAY: Creación del token durante un pago.	NO
1	customer	Objeto que contiene los datos del comprador.	NO
2	email	E-mail del comprador. Obligatorio cuandoformActiontiene el valorREGISTER_PAY.	Ver descripción
1	subMerchantDetails	Objeto que contiene los datos del subvendedor.	NO
1	paymentForms	Objeto que contiene los datos de la tarjeta.	Sí
2	paymentMethodType	Tipo de medio de pago. Su valor debe serCARD.	Sí
2	pan	Número de tarjeta.	Sí
2	expiryMonth	Mes de caducidad de la tarjeta. Ejemplo: 3 o 03	Sí
2	expiryYear	Año de caducidad de la tarjeta. Ejemplo: 27 o 2027	Sí
2	securityCode	Código de seguridad de la tarjeta (CVV o 4DBC).	NO
1	authenticationDetails	Objeto que contiene los datos de autentificación del titular.	Sí
2	status	Estado de autentificación. Su valor debe serDISABLED.	Sí
2	exemption	Motivo de desactivación. Consulte capítuloMotivos de la desactivación y exenciones.	Sí

Ejemplo de solicitud

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

Categoria

Tags

Guía de integración (obsoleta)

autentificación 3-D Secure v2

Autentificación Procesos Diners

Autentificación desactivada