Configuración de un servidor de autorización remota
Cómo autorizar tus propias tarjetas. | Empresa
Este procedimiento describe las especificaciones para las comunicaciones entre el servidor de autorización remota de un cliente y Rapyd.
Cree un servidor seguro y cree un software que gestione la comunicación de datos de acuerdo con las especificaciones de Rapyd.
Ponte en contacto con el servicio de atención al cliente y realiza 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 a través de 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 a través del proceso de autorización remota.
mensajería entre Rapyd y su servidor de autorización remoto se realiza mediante el 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 producción plataforma y el caja de arena, 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 |
|---|---|---|
cantidad | número | Importe de la transacción en unidades monetarias definido en |
id_de autorización | cuerda | ID de la solicitud de autorización de transacción. Cadena que comienza por cardauth_. |
id_tarjeta | cuerda | ID de la tarjeta en la plataforma Rapyd. Cadena que comienza con tarjeta_. |
id_de contacto | cuerda | ID del contacto del monedero en la plataforma Rapyd. Cadena que comienza con cont_. |
creado_en | número | Hora de la transacción, en Hora de Unix. |
moneda | cuerda | 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 campos siguientes:
|
estado | cuerda | Estado de la solicitud. |
tipo | cuerda | Para una solicitud de autorización: autorización |
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 Obligatorio | cuerda | ID de la solicitud de autorización de transacción. Igual que el |
response_code Obligatorio | cuerda | Código de respuesta, definido en la norma ISO 8583-1987. Dos dígitos |
código de autenticación | cuerda | 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 envía un webhook al cliente con los siguientes campos:
Nombre | Tipo | Descripción |
|---|---|---|
id_de autorización | cuerda | ID de la solicitud de autorización de transacción. Igual que el |
creado_en | número | Hora de la autorización, en Hora de Unix. |
estado | cuerda | COMPLETADO |
tipo | cuerda | autorización |
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 devuelve un webhook al cliente con los siguientes campos:
Nombre | Tipo | Descripción |
|---|---|---|
id_de autorización | cuerda | ID de la solicitud de autorización de transacción. Igual que el |
moneda | cuerda | Moneda de la reversión. Código ISO 4217 de tres letras |
creado_en | número | Hora de la reversión, en Hora de Unix. |
cantidad_invertida | número | Importe de la anulación. Puede ser inferior al importe de la transacción original |
id_de autorización_inversa | cuerda | ID de la anulación de la transacción. Cadena que comienza por cardauth_. |
estado | cuerda | INVERTIDO |
tipo | cuerda | autorización |
Ejemplo de webhook invertido en una transacción
Webhook de transacción invertida
{ "authorization_id": "cardauth_43809ruifd8s7f89sdf", "currency": "USD", "created_at": 1352316334, "reversed_amount": 3.45, "reversed_authorization_id": "cardauth_874618744ffs3r452", "status": "REVERSED", "type": "authorization" }