Configurar un servidor de autorización remota
Cómo autorizar sus propias tarjetas. | Enterprise
Este procedimiento describe las especificaciones para las comunicaciones entre Rapyd y el servidor de autorización remota de un cliente.
Cree un servidor seguro y cree un software que gestione la comunicación de datos de acuerdo con las especificaciones de Rapyd.
Contacte a Soporte y realice todas las pruebas necesarias.
Proporcione la URL de su servidor de autorización remoto y los números BIN de las tarjetas que se procesarán en el servidor remoto.
Cuando su servidor pase las pruebas de Rapyd, Rapyd configurará su cuenta para que todas las transacciones de las tarjetas emitidas mediante la plataforma de emisión de Rapyd se dirijan a su servidor de autorización remoto.
Para obtener más información sobre cómo se autorizan las transacciones, consulte lo siguiente:
Autorización remota de una transacción con tarjeta: Realiza un seguimiento de una transacción con tarjeta exitosa por medio del proceso de autorización remota.
La mensajería entre Rapyd y su servidor de autorización remoto se realiza por medio del protocolo HTTPS. Los mensajes están en formato JSON, tal y como se especifica a continuación.
Encabezados de solicitud
La solicitud de Rapyd al servidor de autorización remoto contiene los encabezados de solicitud estándar. Los encabezados son obligatorios tanto para la plataforma de producción y el sandbox. Sin embargo, no son necesarios en la respuesta de su servidor de autorización remoto.
La solicitud de autorización se envía desde Rapyd al servidor de autorización remoto operado por el cliente. Tiene los siguientes campos:
Nombre | Tipo | Descripción |
|---|---|---|
amount | número | Monto de la transacción en unidades monetarias definido en |
authorization_id | cadena | ID de la solicitud de autorización de transacción. Cadena que comienza por cardauth_. |
card_id | cadena | ID de la tarjeta en la plataforma Rapyd. Cadena que comienza con card_. |
contact_id | cadena | ID del contacto de la billetera en la plataforma Rapyd. Cadena que comienza con cont_. |
created_at | número | Hora de la transacción en Unix time. |
currency | cadena | Moneda de la transacción. Código ISO 4217 de tres letras |
pos_info | objeto | Describe la ubicación en la que se usó la tarjeta. Contiene los siguientes campos:
|
status | cadena | Estado de la solicitud. |
type | cadena | Para una solicitud de autorización: authorization |
Ejemplo de solicitud de autorización
Solicitud de autorización
{ "amount": 12.96, "authorization_id": "cardauth_874618744ffs3r452", "card_id": "card_874618744ffs3r452", "contact_id": "cont_874618744ffs3r452", "created_at": 1352316334, "currency": "USD", "pos_info": { "card_holder_presence": true, "identification_code": "GYUI", "mcc": "5812", "name_and_location": "RITE AID, 2244 CORNER ST., MEXICO CITY", "terminal_id": "7865" }, "status": "PENDING", "type": "authorization" }
Cuando el servidor de autorización remoto recibe la solicitud de autorización, debe devolver una respuesta con los siguientes campos:
Nombre | Tipo | Descripción |
|---|---|---|
authorization_id Required | cadena | ID de la solicitud de autorización de transacción. Igual que la |
response_code Required | cadena | Código de respuesta, definido en la norma ISO 8583-1987, dos dígitos. |
auth_code | cadena | Código alfanumérico definido por el cliente, opcional. |
Ejemplo de respuesta de autorización
Respuesta de autorización
{ "authorization_id": "cardauth_874618744ffs3r452", "response_code": "00", "auth_code": "1A2B3C" }
Cuando la red de tarjetas informa que la transacción se ha realizado correctamente, Rapyd le envía un webhook al cliente con los siguientes campos:
Nombre | Tipo | Descripción |
|---|---|---|
authorization_id | cadena | ID de la solicitud de autorización de transacción. Igual que el |
created_at | número | Hora de la autorización, en Unix time. |
status | cadena | COMPLETED |
type | cadena | authorization |
Ejemplo de webhook de transacción completada
Webhook de transacción completada
{ "type": "authorization", "authorization_id": "cardauth_43809d47fd8s7f89df", "created_at": 1352316334, "status": "COMPLETED" }
Cuando la transacción no se puede completar debido a una falla de comunicación u otro motivo, la transacción se anula. Cuando esto ocurre, Rapyd le devuelve un webhook al cliente con los siguientes campos:
Nombre | Tipo | Descripción |
|---|---|---|
authorization_id | cadena | ID de la solicitud de autorización de transacción. Igual que el |
currency | cadena | Moneda de la revocación. Código ISO 4217 de tres letras. |
created_at | número | Hora de la reversión, en Unix time. |
reversed_amount | número | Monto de la revocación. Puede ser inferior al monto de la transacción original. |
reversed_authorization_id | cadena | ID de la revocación de la transacción. Cadena que comienza por cardauth_. |
status | cadena | REVERSED |
type | cadena | authorization |
Ejemplo de webhook de una transacción revertida
Webhook de transacción revertida
{ "authorization_id": "cardauth_43809ruifd8s7f89sdf", "currency": "USD", "created_at": 1352316334, "reversed_amount": 3.45, "reversed_authorization_id": "cardauth_874618744ffs3r452", "status": "REVERSED", "type": "authorization" }