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 mediante un POS. La API POS proporciona métodos para gestionar efectivo en las ubicaciones POS de Rapyd, como cajeros automáticos y tiendas minoristas

En este caso de uso, el POS retira 10 GBP (libra esterlina) de la cartera del cliente Billetera electrónica, y luego le da 10 GBP (libra esterlina) en efectivo.

Por ejemplo, el cliente desea retirar 10 GBP de su monedero electrónico y recibirlos en efectivo de un punto de venta. El POS retira 10 GBP del monedero electrónico del cliente y le entrega 10 GBP

Proceso de retirada

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 proporciona a sus clientes para administrar sus monederos electrónicos 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 proporciona un código de autorización al cliente.

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

  1. Solicitas abrir una sesión.

  2. Rapyd abre la sesión y muestra los valores de campo necesarios para la retirada.

Paso 3: Retirarse
withdrawing.jpg

  1. Creas una solicitud de retiro con los valores de campo que recibiste en la etapa de «abrir una sesión».

  2. Rapyd ejecuta la retirada.

  3. Los POS entregan 10 GBP (libras esterlinas) en efectivo al cliente.

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

  1. Solicita cerrar la sesión con los valores de campo que recibió en la etapa de «abrir una sesión».

  2. Rapyd cierra la sesión.

Implementación del flujo de trabajo

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

Para retirar dinero del monedero electrónico del cliente:

  1. Pídele a Rapyd que abra una sesión.

  2. Pídele a Rapyd que retire 10 GBP (libras esterlinas) del monedero electrónico del cliente.

Para finalizar una sesión:

  • Pídele a Rapyd que cierre una sesión.

Cómo funciona el retiro de efectivo
Búsqueda del código OTP

Para generar un código de contraseña de un solo uso (OTP), el cliente usa la aplicación móvil Rapyd SDK que les proporcionas a tus clientes para administrar sus monederos electrónicos.

  1. El cliente ejecuta la aplicación móvil que les proporcionas a tus clientes para administrar sus monederos electrónicos (la aplicación del comerciante).

  2. El cliente solicita un código OTP y aparece 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
Sesión de apertura

Una vez que se muestre la OTP, es válida durante 30 segundos absolutos, 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 abres una sesión en un plazo máximo de 30 segundos, el cliente debe recuperar un nuevo código OTP

Usarás el Sesión abierta método para abrir una sesión para realizar una retirada con los siguientes parámetros:

Descripción de los parámetros del encabezado

Parámetro de encabezado

Descripción

clave_acceso

Entrar 8C6223151345345D 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 como el otp_code.

Solicitud de apertura de sesión

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

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


// No message body
Respuesta a la sesión de apertura

Vamos a echar un vistazo a la Sesión abierta respuesta.

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

El datos la sección de la respuesta muestra que:

  • La billetera electrónica del cliente incluye una cuenta para GBP moneda. account_id es 64e4a964-53b5-11e9-8495-02f0df928b.

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

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

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

Retirarse

Usarás el ¿Retirar método para retirar 10 GBP de la billetera electrónica del cliente. Realice un retiro 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 8C6223151345345D como clave de acceso.

identificador del token

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

identificador de operación

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

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

cuenta

Entrar 64e4a964-53b5-11e9-8495-02f0df928b como el ID del cuenta. Este es el 'account_id' del cliente GBP cuenta que se mostró en la respuesta de la sesión abierta.

suma

Entrar 10 como el suma en GBP .

Solicitud de retirada

Le pides a Rapyd que retire fondos de una cuenta de monedero electrónico.

    • 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
Retirar respuesta

Vamos a echar un vistazo a la Retirar respuesta.

    • Respuesta

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

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

En esta etapa, el POS proporciona 10 GBP en efectivo para el cliente.

Sesión de clausura

Usarás el Cerrar sesión método para cerrar una sesión por una retirada. Cierre una sesión 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 8C6223151345345D como clave de acceso.

identificador del token

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

identificador de operación

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

número_teléfono

Ingresa +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

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

Vamos a echar un vistazo a la Cerrar sesión respuesta.

    • 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.

En esta sección:

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

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.

A string of numbers or letters to authenticate a user.