Ejemplo de pago sucesivo COF vía REST.

• Petición de autorización con referencia
• Petición de autorización con datos de tarjeta
• Respuesta Autorización

					
{
    "DS_MERCHANT_IDENTIFIER": "120c14ed9f7264383434fc1154559f1e2bcc2b1c",
    "DS_MERCHANT_MERCHANTCODE": "999008881",
    "DS_MERCHANT_TRANSACTIONTYPE": "0",
    "DS_MERCHANT_DIRECTPAYMENT": "true",
    "DS_MERCHANT_ORDER": "4986Qpqx",
    "DS_MERCHANT_TERMINAL": "49",
    "DS_MERCHANT_CURRENCY": "978",
    "DS_MERCHANT_AMOUNT": "145",
}
					
				

					
{
    "DS_MERCHANT_PAN": "4548**********03",
    "DS_MERCHANT_EXPIRYDATE": "4912",
    "DS_MERCHANT_COF_INI": "N",
    "DS_MERCHANT_COF_TXNID": "2006031152000",
    "DS_MERCHANT_MERCHANTCODE": "999008881",
    "DS_MERCHANT_TRANSACTIONTYPE": "0",
    "DS_MERCHANT_DIRECTPAYMENT": "true",
    "DS_MERCHANT_ORDER": "4986Qpqx",
    "DS_MERCHANT_TERMINAL": "49",
    "DS_MERCHANT_CURRENCY": "978",
    "DS_MERCHANT_AMOUNT": "145",
}
					
				

					
{
    "Ds_Amount": "145",
    "Ds_Currency": "978",
    "Ds_Order": "4986Qpqx",
    "Ds_MerchantCode": "999008881",
    "Ds_Terminal": "49",
    "Ds_Response": "0000",
    "Ds_AuthorisationCode": "382041",
    "Ds_TransactionType": "0",
    "Ds_SecurePayment": "0",
    "Ds_Language": "1",
    "Ds_CardNumber": "454881******0003",
    "Ds_MerchantData": "",
    "Ds_Card_Country": "724",
    "Ds_Card_Brand": "1",
    "Ds_Merchant_Cof_Txnid": "2006031152000"
}
						    
						

Ejemplo de pago con autorización vía Redirección.

• Petición Autorización
• Respuesta Autorización

										
{
  "DS_MERCHANT_IDENTIFIER": "120c14ed9f7264383434fc1154559f1e2bcc2b1c",	
  "DS_MERCHANT_MERCHANTCODE": "999008881",
  "DS_MERCHANT_TRANSACTIONTYPE": "0",
  "DS_MERCHANT_DIRECTPAYMENT": "true",
  "DS_MERCHANT_ORDER": "4986Qpqx",
  "DS_MERCHANT_TERMINAL": "49"
  "DS_MERCHANT_CURRENCY": "978",
  "DS_MERCHANT_AMOUNT": "145",
  "DS_MERCHANT_MERCHANTURL":"http://www.prueba.com/urlNotificacion.php",
  "DS_MERCHANT_URLOK":"http://www.prueba.com/urlOK.php",
  "DS_MERCHANT_URLKO":"http://www.prueba.com/urlKO.php"
}					
					
				

					
{
    "Ds_Amount": "145",
    "Ds_Currency": "978",
    "Ds_Order": "4986Qpqx",
    "Ds_MerchantCode": "999008881",
    "Ds_Terminal": "49",
    "Ds_Response": "0000",
    "Ds_AuthorisationCode": "382041",
    "Ds_TransactionType": "0",
    "Ds_SecurePayment": "0",
    "Ds_Language": "1",
    "Ds_CardNumber": "454881******0003",
    "Ds_MerchantData": "",
    "Ds_Card_Country": "724",
    "Ds_Card_Brand": "1",
    "Ds_Merchant_Cof_Txnid": "2006031152000"
}
						    
						

Gestión de referencias

Borrar referencia

A continuación se muestra la petición que hay que realizar para borrar una referencia.

• IMPORTANTE: Si se desea borrar una referencia creada, se debe enviar el parámetro Ds_Merchant_Identifier con el valor de la referencia a borrar y el valor Ds_Merchant_TransactionType con el valor "44".

• Petición borrar referencia
• Respuesta borrar referencia

							
{
  "DS_MERCHANT_MERCHANTCODE": "999008881",
  "DS_MERCHANT_IDENTIFIER": "a091f0f9f0aaf0506930dda4a6974f1df4a0d9c1",
  "DS_MERCHANT_ORDER": "0281WjRq",
  "DS_MERCHANT_TERMINAL": "49",
  "DS_MERCHANT_TRANSACTIONTYPE": "44"
}
						
				   

															
{
  "Ds_MerchantCode": "999008881",
  "Ds_Order": "0281WjRq",
  "Ds_Response": "0000",
  "Ds_Terminal": "49",
  "Ds_TransactionType": "44"
}
					   
				  

1. Operaciones autenticadas: Todas las operaciones CIT - Cardholder Initiated Transaction (aquellas donde el titular participa activamente) deben ser autenticadas.Esto implica que todas las transacciones en las que se piden los datos de tarjeta al titular para su almacenaje (COF iniciales) deberán ser autenticadas, a excepción de las realizadas en entornos remotos no electrónicos (MO/TO – Mail Order/Telephone Order). que no requieren autenticación


2. Obligatoriedad de enviar el identificador de la transacción original - TID en COF sucesivas: Será obligatorio enviar el TID (parámetro DS_MECHANT_COF_TXNID) de la COF inicial en todas las operaciones COF sucesivas. Esto es necesario para probar ante el emisor de la tarjeta que se está aplicando PSD2 correctamente y no se deniegue las operaciones sucesivas por no estar autenticadas.
   
   La vinculación de una transacción sucesiva generada por el comercio (MIT) con su operación original (CIT) que sí fue autenticada en su momento, permite al emisor de la tarjeta verificar que se está haciendo un uso correcto de las credenciales de pago y autorizar las operaciones sin incumplir la normativa PSD2.
   Para ello Redsys devolverá al comercio siempre el valor del TID en la respuesta de la COF inicial, de forma que el comercio pueda incorporarlo en las transacciones COF sucesivas.
   
   Es posible que algunas operaciones COF iniciales realizadas antes de la entrada en vigor de PSD2 no dispongan de TID (porque no se generó o porque el comercio no lo guardó), en estos casos debe enviarse el parámetro DS_MERCHANT_COF_TXNID con el valor "999999999999999" para identificar de dicha situación al emisor.
   
   No obstante, este valor no deberá usarse en transacciones para hacer referencia a operativas ya realizadas dentro del marco temporal de aplicación de la PSD2 y en el futuro será invalidado su uso para algunas marcas.
   Si en la respuesta a una transacción MIT el comercio recibe un nuevo valor de DS_MECHANT_COF_TXNID, deberá almacenarlo para ser utilizado en las futuras transacciones sucesivas ligadas a esa transacción en lugar del valor "999999999999999"
   


3. Marcaje MIT en COF sucesivas. Las COF subsiguientes podrán ser:
   
   • CIT (Cardholder Initiated Transaction): se marcan como COF sucesivas, y requerirán autenticación del titular (o exención) al estar el titular participando activamente en la transacción.
     
   • MIT (Merchant Initiated Transaction): para asegurar que no se deniegan por el emisor se deben marcar como COF sucesivas y como MIT mediante el parámetro DS_MERCHANT_EXCEP_SCA = “MIT”. De forma adicional, en las transacciones marcadas como MIT se deberá indicar el parámetro Ds_Merchant_DirectPayment=true para indicar que son pagos sin intervención del titular de la tarjeta y por lo tanto no es posible realizar la autenticación del mismo.
   
   
4. Operación COF inicial MO/TO (Mail Order/Telephone Order): La operación COF inicial podría ser realizada en un entorno remoto no electrónico MO/TO. En este caso no será necesario autenticar al estar fuera de alcance de SCA-PSD2. Las operaciones COF subsiguientes (cuando la inicial ha sido MOTO) al igual que las descritas anteriormente, pueden ser:
   • CIT por comercio electrónico/website/app: marcar la operación COF sucesiva, requerirá autenticación o exención.
   • CIT por canal telefónico: la operación por tanto se considera MOTO.
   • MIT: COF sucesivas con el TID obtenido en la operación MOTO inicial (COF inicial).