Skip to main content

Documentación

Depositar efectivo en la billetera

Deposite efectivo en una ubicación física.

Rapyd le facilita la posibilidad de que los clientes depositen efectivo en una billetera Rapyd mediante un punto de venta. El punto de venta de API proporciona métodos para gestionar los depósitos en las ubicaciones de punto de venta de Rapyd como cajeros automáticos y tiendas minoristas.

Algunos casos de uso comunes pueden incluir:

  • Un cliente deposita dinero en efectivo en su propia billetera.

  • Una empresa deposita su efectivo en su billetera empresarial.

Por ejemplo, al cliente le gustaría depositar 100 GBP (libras esterlinas) en su billetera al depositar el efectivo en un punto de venta. El punto de venta acepta las 100 GBP (libras esterlinas) en efectivo del cliente y se lo notifica a Rapyd. Posteriormente, Rapyd deposita el dinero en la billetera del cliente.

Flujo de trabajo para depositar efectivo

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

Paso 1: Obtener una contraseña de un solo uso (OTP)
one-time-password.jpg

  1. Al usar la aplicación móvil, un cliente solicita un OTP.

  2. Usted le solicita una OTP a Rapyd.

  3. Rapyd le envía la OTP.

  4. La aplicación le muestra la OTP al cliente.

Paso 2: Iniciar sesión
open-a-session.jpg

  1. Usted le pide a Rapyd que inicie sesión.

  2. Rapyd inicia sesión.

Paso 3: Depositar efectivo
deposit-cash.jpg

  1. Usted crea una solicitud para depositar efectivo en una eWallet.

  2. Rapyd crea una transacción de depósito.

  3. El cliente deposita 100 GBP (libras esterlinas) en el punto de venta.

  4. El punto de venta le notifica a Rapyd.

  5. Rapyd completa el depósito y se lo notifica.

Paso 4: Cerrar sesión
close-the-session.jpg

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

  2. Rapyd cierra la sesión.

Cómo funciona el depósito de efectivo
Obtener un código OTP

Para generar una contraseña de un solo uso (OTP), el cliente usa la aplicación móvil que le proporciona a sus clientes para administrar las billetera.

  1. El cliente ejecuta la aplicación móvil que usted le proporciona a sus clientes para administrar sus billeteras.

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

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

    643e80887a49c.png
Iniciar sesión

La OTP es válida durante 30 segundos. Si no abre una sesión dentro de ese tiempo, el cliente debe obtener un nuevo código OTP.

Use el método Iniciar sesión para iniciar sesión con los siguientes parámetros:

Descripción de los parámetros del encabezado

Parámetro de encabezado

Descripción

access_key

Introduzca 8C6223151 como clave de acceso.

phone_number

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

Tipo de contenido

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.

Solicitud para iniciar 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

// Headers:
access_key: 8C6223151
phone_number: +14155559992
Content-Type: application/json

// No message body
Respuesta de inicar 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": 955,
               "account_currency_symbol": "£"
           }
       ]
   }
}

La sección data de la respuesta muestra la siguiente información:

  • La billetera del cliente incluye una cuenta para la moneda GBP.

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

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

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

Depositar efectivo en una billetera

Utilizará el método Depositar para depositar 100 GBP en la billetera del cliente. Realice un depósito 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 tipo de contenido.

access_key

Introduzca 8C6223151 como clave de acceso.

token_id

Introduzca d9b7398f-5c2f-438c-8ac6-68e79f28c02e como token_id.

operation_id

Introduzca 95e2c071-9513-48d6-a717-a480814f7df8 como operation_id.

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

amount

Introduzca 100 como la cantidad a depositar.

currency_code

Introduzca GBP como moneda del monto.

Solicitud para depositar efectivo en una billetera

Usted le pide a Rapyd que deposite fondos en la billetera del cliente.

    • Solicitud

      • // Request URL: POST https://sandboxpos.rapyd.net/v1/pos/deposit/100.00/GBP

// Headers:
access_key: 8C6223151
phone_number: +14155559992
Content-Type: application/json
token_id: d9b7398f-5c2f-438c-8ac6-68e79f28c02e
operation_id: 95e2c071-9513-48d6-a717-a480814f7df8
                                            
// Message body absent
Respuesta de depositar dinero en efectivo en una billetera

Veamos la respuesta del depósito.

    • Respuesta

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

Esto confirma que Rapyd depositó 100 GBP (libras esterlinas) en la billetera del cliente.

Cerrar sesión

Utilice 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 8C6223151 como clave de acceso.

token_id

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

operation_id

Introduzca 95e2c071-9513-48d6-a717-a480814f7df8 como el operation_id que se devolvió en la respuesta a ‘Iniciar 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

// Headers:
access_key: 8C6223151
phone_number: +14155559992
Content-Type: application/json
token_id: d9b7398f-5c2f-438c-8ac6-68e79f28c02e
operation_id: 95e2c071-9513-48d6-a717-a480814f7df8
                                            
// No message body

El parámetro ‘status’ de esta respuesta muestra que la sesión se cerró correctamente.

Respuesta para cerrar sesión

Veamos la respuesta de cerrar sesión.

    • Respuesta

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

El parámetro ‘status’ de esta respuesta muestra que la sesión se cerró correctamente.

En esta sección:

A retail location where a business or consumer can initiate a transaction in exchange for goods or services.

A string of numbers or letters to authenticate a user.

An electronic means of storing payment methods for use in commerce. The eWallet can be funded by a variety of different payment methods. Some ewallets receive or store funds. Also known as a digital wallet.