Skip to main content

Documentación

Retirar efectivo

Reciba dinero en efectivo en un lugar físico.

Rapyd le facilita la posibilidad de que los clientes retiren efectivo en un Punto de venta. El punto de venta API proporciona métodos para gestionar efectivo en las ubicaciones de punto de venta de Rapyd como cajeros automáticos y tiendas minoristas.

En este caso de uso, el punto de venta retira 10 GBP (libra esterlina) de la eWallet del cliente y luego le da 10 GBP (libra esterlina) en efectivo.

Por ejemplo, el cliente desea retirar 10 GBP de su eWallet y recibirlos en efectivo de un punto de venta. El punto de venta retira 10 GBP de la eWallet del cliente y le entrega 10 GBP.

Veamos los aspectos más destacados de su flujo de trabajo.

Paso 1: El cliente obtiene el código
customer-gets-code.png
  1. El cliente ejecuta la aplicación móvil que usted le proporciona a sus clientes para administrar sus eWallets y solicita un OTP para retirar 10 GBP (libras esterlinas) en efectivo en un punto de venta específico.

  2. La aplicación móvil le proporciona un código de autorización al cliente.

Paso 2: Iniciar sesión
open-a-session.png
  1. Usted solicita iniciar sesión.

  2. Rapyd inicia sesión y muestra los valores de campo necesarios para el retiro.

Paso 3: Retirar efectivo
withdrawing.jpg
  1. Usted crea una solicitud de retiro con los valores de campo que recibió en la etapa de ‘iniciar sesión’.

  2. Rapyd ejecuta el retiro.

  3. El punto de venta le entrega 10 GBP (libras esterlinas) en efectivo al cliente.

Paso 4: Cerrar sesión
close-a-session.jpg
  1. Usted solicita cerrar la sesión con los valores de campo que recibió en la etapa de ‘iniciar sesión’.

  2. Rapyd cierra la sesión.

Veamos rápidamente cómo utilizará la API de Rapyd para implementar el flujo de trabajo.

Para retirar dinero de la eWallet del cliente:

  1. Pídale a Rapyd que inicie sesión.

  2. Pídale a Rapyd que retire 10 GBP (libras esterlinas) de la eWallet del cliente.

Para finalizar una sesión:

  • Pídale a Rapyd que cierre sesión.

Para generar un código de contraseña de un solo uso (OTP), el cliente usa la aplicación móvil Rapyd SDK que usted le proporciona a sus clientes para administrar sus eWallets.

  1. El cliente ejecuta la aplicación móvil que le proporciona a sus clientes para administrar sus eWallets (la aplicación del comercio).

  2. El cliente solicita un código OTP y aparece en la aplicación 876680 como código OTP.

  3. El cliente proporciona el código OTP en el punto de venta.

    Asegúrese de guardar el código OTP para usarlo en el futuro.

    643e80887a49c.png

Una vez que se muestre la OTP esta es válida durante 30 segundos, lo que significa que si la OTP se genera a las 11:42:25, este código será válido durante 5 segundos adicionales hasta las 11:42:30. Si no abre una sesión en un plazo máximo de 30 segundos, el cliente debe obtener un nuevo código OTP.

Utilizará el método Iniciar sesión para iniciar sesión para realizar una retiro con los siguientes parámetros:

Descripción de los parámetros del encabezado

Parámetro de encabezado

Descripción

access_key

Introduzca 8C6223151345345D como clave de acceso.

phone_number

Introduzca +14155559992 como número de teléfono del cliente.

Content-Type

Introduzca application/json como el tipo de contenido.

Descripción de los parámetros de ruta

Parámetro de ruta

Descripción

pos_id

Introduzca z128ffb-11a5-11l9-93p5-1231a8maf28 como el ID de la ubicación del punto de venta. El valor pos_id es único para cada ubicación de punto de venta y Rapyd se lo proporciona directamente.

otp_code

Introduzca 876680 como el otp_code.

Solicitud de inicio de sesión

Usted le pide a Rapyd que inicie sesión.

    • Solicitud

      • // Request URL: POST https://sandboxpos.rapyd.net/v1/pos/login/z128ffb-11a5-11l9-93p5-1231a8maf28/876680
        
        access_key: 8C6223151345345D
        phone_number: +14155559992
        Content-Type: application/json
        
        
        // No message body
                          
Respuesta al inicio de sesión

Veamos la respuesta Iniciar sesión.

    • Respuesta

      • {
           "status": {
               "error_code": "",
               "status": "SUCCESS",
               "message": "",
               "response_code": "",
               "operation_id": "d1063f84-977b-48f5-a3a3-a3e4d94be47f"
           },
           "data": {
               "token_id": "d9b7398f-5c2f-438c-8ac6-68e79f28c02e",
               "operation_id": "95e2c071-9513-48d6-a717-a480814f7df8",
               "accounts": [
                   {
                       "account_id": "64e4a964-53b5-11e9-8495-02f0df928b",
                       "account_currency": "GBP",
                       "account_alias": "GBP",
                       "account_balance": 189,
                       "account_currency_symbol": "£"
                   }
               ]
           }
        }
                          

La sección data de la respuesta muestra:

  • La eWallet del cliente incluye una cuenta para la moneda GBP. Su account_id es 64e4a964-53b5-11e9-8495-02f0df928b.

  • El token_id es d9b7398f-5c2f-438c-8ac6-68e79f28c02e.

  • La operation_id es 95e2c071-9513-48d6-a717-a480814f7df8.

Asegúrese de guardar estos valores de campo para usarlos en el futuro.

Usará el método Retirar para retirar 10 GBP de la eWallet del cliente. Realice un retiro con los siguientes parámetros:

Descripción de los parámetros del encabezado

Parámetro de encabezado

Descripción

Content-Type

Introduzca application/json como el tipo de contenido.

access_key

Introduzca 8C6223151345345D como clave de acceso.

token_id

Introduzca d9b7398f-5c2f-438c-8ac6-68e79f28c02e como el token_id que se mostró en la respuesta de inicio sesión.

operation_id

Introduzca 95e2c071-9513-48d6-a717-a480814f7df8 como el operation_id que se mostró en la respuesta de inicio sesión.

phone_number

Introduzca +14155559992 como número de teléfono del cliente

Descripción de los parámetros de ruta

Parámetro de ruta

Descripción

account

Introduzca 64e4a964-53b5-11e9-8495-02f0df928b como el ID del account. Este es el ‘account_id’ de la cuenta del cliente en GBP que se mostró en la respuesta de inicio de sesión.

sum

Introduzca 10 como el sum en GBP.

Solicitud de retiro

Usted le pide a Rapyd que retire fondos de una cuenta de eWallet.

    • Solicitud

      • // Request URL: POST https://sandboxpos.rapyd.net/v1/pos/withdraw/64e4a964-53b5-11e9-8495-02f0df928b/10
        
        Content-Type: application/json
        access_key: 8C6223151345345D 
        token_id: d9b7398f-5c2f-438c-8ac6-68e79f28c02e 
        operation_id: 95e2c071-9513-48d6-a717-a480814f7df8 
        phone_number: +14155559992
        
        
        // No message body
                          
Respuesta de retiro

Veamos la respuesta de Retirar.

    • Respuesta

      • {
           "status": {
               "error_code": "",
               "status": "SUCCESS",
               "message": "",
               "response_code": "",
               "operation_id": "0c211a3c-a4c4-4708-bbe9-7628ddd07437"
           },
           "data": {
               "transaction_id": "4e61e815-b68f-11e9-9ffc-12c4c8fed768"
           }
        }

La sección data de esta respuesta muestra que el transaction_id es 4e61e815-b68f-11e9-9ffc-12c4c8fed768.

En esta etapa, el punto de venta proporciona 10 GBP en efectivo para el cliente.

Usará el método Cerrar sesión para cerrar una sesión para un retiro. Cierre sesión con los siguientes parámetros:

Descripción de los parámetros del encabezado

Parámetro de encabezado

Descripción

Content-Type

Introduzca application/json como el tipo de contenido.

access_key

Introduzca 8C6223151345345D como clave de acceso.

token_id

Introduzca d9b7398f-5c2f-438c-8ac6-68e79f28c02e como el token_id que se mostró en la respuesta de inicio de sesión.

operation_id

Introduzca 95e2c071-9513-48d6-a717-a480814f7df8 como el operation_id que se mostró en la respuesta de inicio de sesión.

phone_number

Introduzca +14155559992 como número de teléfono del cliente.

Solicitud para cerrar sesión

Usted le pide a Rapyd que cierre la sesión.

    • Solicitud

      • // Request URL: POST https://sandboxpos.rapyd.net/v1/pos/logout
        
        Content-Type: application/json
        access_key: 8C6223151345345D 
        token_id: d9b7398f-5c2f-438c-8ac6-68e79f28c02e 
        operation_id: 95e2c071-9513-48d6-a717-a480814f7df8 
        phone_number: +14155559992
        
        
        // No message body
        
                          
Respuesta de cerrar sesión

Veamos la respuesta Cerrar sesión.

    • Respuesta

      • {
           "status": {
               "error_code": "",
               "status": "SUCCESS",
               "message": "",
               "response_code": "",
               "operation_id": "09666c40-77fa-49c7-be73-82ade0217c8e"
           }
        }
                          

La sección de datos de esta respuesta muestra que la sesión se cerró correctamente.