Skip to main content

Documentación

Depositar efectivo en Wallet

Deposita efectivo en un lugar físico.

Rapyd te facilita la posibilidad de que los clientes depositen efectivo en una billetera Rapyd mediante un POS. La API POS proporciona métodos para gestionar los depósitos en las ubicaciones POS 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 cartera.

  • Una empresa deposita su efectivo en la billetera de su empresa.

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

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 su aplicación móvil, un cliente solicita un OTP.

  2. Solicitas una OTP a Rapyd.

  3. Rapyd te envía la OTP.

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

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

  1. Le pides a Rapyd que abra una sesión.

  2. Rapyd abre una sesión.

Paso 3: Depositar efectivo
deposit-cash.jpg

  1. Creas una solicitud para depositar efectivo en un Billetera electrónica.

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

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

  4. El POS notifica a Rapyd.

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

Paso 4: Cierre de la sesión
close-the-session.jpg

  1. Le pides 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 les proporcionas a tus clientes para administrar las carteras.

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

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

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

    643e80887a49c.png
Apertura de una sesión

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

Usa el Sesión abierta método para abrir una sesión con los siguientes parámetros:

Descripción de los parámetros del encabezado

Parámetro de encabezado

Descripción

clave_acceso

Entrar 8C6223151 como clave de acceso.

número_teléfono

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

Tipo de contenido

Entrar application/json como el tipo de contenido.

Descripción de los parámetros de ruta

Parámetro de ruta

Descripción

pos_id

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

código otp

Entrar 876680 .

Solicitud de sesión abierta

Le pides a Rapyd que abra una 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 sesión abierta

    • 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": "£"
           }
       ]
   }
}

El datos la sección de la respuesta muestra la siguiente información:

  • La cartera del cliente incluye una cuenta para GBP moneda.

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

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

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

Depositar efectivo en una billetera

Usarás el Depósito método 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

Tipo de contenido

Entrar application/json como el tipo de contenido.

clave_acceso

Entrar 8C6223151 como clave de acceso.

identificador del token

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

identificador de operación

Entrar 95e2c071-9513-48d6-a717-a480814f7df8 como el operation_id.

número_teléfono

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

Descripción de los parámetros de ruta

Parámetro de ruta

Descripción

cantidad

Entrar 100 como la cantidad a depositar.

código_moneda

Entrar GBP como la `divisa del importe.

Solicitud de depósito de efectivo en un monedero

Le pides 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
Depositar dinero en efectivo en una respuesta de monedero

Echemos un vistazo a 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 el monedero del cliente.

Cierre de la sesión

Utilice los siguientes parámetros:

Descripción de los parámetros del encabezado

Parámetro de encabezado

Descripción

Tipo de contenido

Entrar application/json como el tipo de contenido.

clave_acceso

Entrar 8C6223151 como clave de acceso.

identificador del token

Entrar d9b7398f-5c2f-438c-8ac6-68e79f28c02e como el token_id, que se devolvió en la respuesta a «Sesión abierta».

identificador de operación

Entrar 95e2c071-9513-48d6-a717-a480814f7df8 como el operation_id, que se devolvió en la respuesta a «Sesión abierta».

número_teléfono

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

Solicitud de cierre de sesión

Le pides 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 de cierre de sesión

Echemos un vistazo a la respuesta de cierre de 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.