Monederos electrónicos
La billetera electrónica es un método de pago seguro y fácil que se espera supere el uso de tarjetas de crédito en los próximos cinco años.
Permita que sus clientes usen su billetera electrónica preferida para pagar las compras en su sitio web o aplicación. Una billetera electrónica es una categoría de pago que utiliza métodos de pago locales únicos que forman parte de la red global de pagos de Rapyd
Común Billetera electrónica Los pagos incluyen:
GrabPay (Sudeste asiático)
PayTM (India)
Billetera electrónica Samsung Pay (Corea)
FamiPay (Japón)
Método de pago de eWallets
Si utilizas Rapyd Hosted Checkout, simplemente selecciona eWallet como uno de los métodos de pago aceptados. Encontrará una lista completa de los métodos de pago con monederos electrónicos en el Portal del cliente, tal como se describe en Visualización de los métodos de pago
Selecciona tu monedero electrónico.
Haga clic Haga su pedido .
Complete el pago.
Redirigir a la pago exitoso página.
Puedes encontrar los métodos de pago específicos con monederos electrónicos que aceptarás y los campos obligatorios correspondientes que los clientes deben rellenar en la sección Cómo funciona.
Un cliente que utiliza tu sitio web o aplicación selecciona un artículo que cuesta 19,99 SGD (dólares de Singapur) y lo añade al carrito de la compra. El cliente pulsa el botón de pago, llega a la página de pago y selecciona la opción de pagar con una
Solicitas a Rapyd los detalles del monedero electrónico y los presentas al cliente.
El cliente rellena los detalles del monedero electrónico y confirma el pago pulsando Pague.
El back-end del sitio web solicita a Rapyd que procese el pago del cliente, especificando el importe, la moneda, el método de pago y la URL de éxito del pago y la URL de error.
Rapyd procesa la transacción y responde con una URL única para que el cliente complete el pago. La URL solo es válida para este pago
Su sitio web dirige al cliente a URL de redireccionamiento del sitio web de ewallet.
En el sitio web del monedero electrónico, el cliente sigue las instrucciones para completar el pago introduciendo los detalles del monedero electrónico.
El sitio web de ewallet redirige al cliente a la URL que especificó para un pago exitoso o para un pago fallido. El sitio web del monedero electrónico notifica
Rapyd envía un webhook a tu servidor, indicando que el pago se ha completado.
Ejemplo de país y moneda
SG (Singapur) y SGD (dólar de Singapur) se utilizan para el país y la moneda en los códigos de muestra que aparecen a continuación.
Para identificar los monederos electrónicos que están disponibles en SGD y SGD, usa Enumere los métodos de pago por país con los siguientes parámetros:
Descripción de los parámetros de consulta
Parámetro de consulta | Descripción |
|---|---|
país | Entrar SG como código de país. |
moneda | Entrar SGD como código de divisa. |
Solicitud de lista de métodos de pago por país
Solicita una lista de todos los métodos de pago disponibles en SG que admiten SGD.
Solicitud
// Request URL: GET https://sandboxapi.rapyd.net/v1/payment_methods/country?country=SG¤cy=SGD // Message body absent
Lista de métodos de pago por país Respuesta
Listar métodos de pago por país describe los campos de la respuesta.
Respuesta
{ "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "53776342-3d2d-4f20-b54b-8b402f6ef88c" }, "data": [ { "type": "sg_grabpay_ewallet", "name": "Grabpay eWallet Payments Singapore", "category": "ewallet", "image": "", "country": "sg", "payment_flow_type": "redirect_url", "currencies": [ "SGD" ], "status": 1, "is_cancelable": false, "payment_options": [], "is_expirable": false, "is_online": false, "minimum_expiration_seconds": null, "maximum_expiration_seconds": null } ] }
El datos la sección de esta respuesta muestra que sg_grabpay_ewallet es un método de pago con monedero electrónico aceptable.
Lista de respuestas al método de pago
En una respuesta completa se enumeran muchos métodos de pago.
Identifica los campos que tu cliente debe completar para el método de pago. Para hacerlo, usa Campos obligatorios para obtener el método de pago con el siguiente parámetro:
Descripción de los parámetros de ruta
Parámetro de ruta | Descripción |
|---|---|
tipo | Entrar sg_grabpay_ewallet como tipo de método de pago. |
Obtener el método de pago Campos obligatorios Solicitud
Solicite un conjunto de campos obligatorios para sg_grabpay_ewallet.
Solicitud
// Request URL: GET https://sandboxapi.rapyd.net/v1/payment_methods/sg_grabpay_ewallet/required_fields // Message body absent
Obtener el método de pago Campos obligatorios Respuesta
Campos obligatorios del método de pago describe los campos de la respuesta.
Respuesta
{ "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "4d0d21b9-8cc0-4e93-81c3-27a184fdd8c2" }, "data": { "type": "sg_grabpay_ewallet", "fields": [], "payment_method_options": [], "payment_options": [], "minimum_expiration_seconds": null, "maximum_expiration_seconds": null } }
La respuesta muestra que para sg_grabpay_ewallet, el cliente no es
Cuando tu cliente haga el pago en tu sitio web, usa Crea un pago con los siguientes parámetros para que Rapyd procese el pago bancario de su cliente:
Descripción de los parámetros corporales
Parámetro corporal | Descripción |
|---|---|
cantidad | Entrar 19.99 como importe del pago. |
moneda | Entrar SGD como código de divisa. |
método_pago | Introduzca un objeto con los siguientes campos:
|
URL de pago completa | Sustituya el https://success_example.net ejemplo con la URL real de tu sitio web al que quieres redirigir al cliente cuando el pago se realice correctamente. |
error_payment_url | Sustituya el https://error_example.net ejemplo con la URL de tu sitio web real a la que quieres redirigir al cliente cuando se produzca un error en el pago. |
Crear solicitud de pago
Solicita a Rapyd que procese el pago con monedero electrónico del cliente (19,99 SGD en este caso) y que cobre el pago por ti.
Solicitud
/ Request URL: POST https://sandboxapi.rapyd.net/v1/payments // Message body: { "amount": 19.99, "currency": "SGD", "payment_method": { "type": "sg_grabpay_ewallet", "fields": {} }, "complete_payment_url":"http://www.example.com/complete", "error_payment_url":"http://www.example.com/error" }
Crear respuesta de pago
Ver Crear pago para obtener una descripción de los campos de la respuesta.
Respuesta
{ "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "f3b3a4f5-1713-460b-a770-ec8f4c2ccbb2" }, "data": { "id": "payment_56410597a0196e1eec00954b3440461b", "amount": 0, "original_amount": 19.99, "is_partial": false, "currency_code": "SGD", "country_code": "sg", "status": "ACT", "description": "", "merchant_reference_id": "", "customer_token": "cus_1daa2cf4216845afdd277bb6d8f9dadf", "payment_method": "other_6afd4e09b6a2d22b7460a5dc3810112a", // ... "redirect_url": "https://sandboxdashboard.rapyd.net/complete-bank-payment?token=payment_56410597a0196e1eec00954b3440461b&complete_payment_url=https://success_example.net&error_payment_url=https://error_example.net", "complete_payment_url": "https://success_example.net", "error_payment_url": "https://error_example.net", // ... "created_at": 1591620906, // ... "ewallet_id": "ewallet_1a867a32b47158b30a8c17d42f12f3f1", "ewallets": [ { "ewallet_id": "ewallet_1a867a32b47158b30a8c17d42f12f3f1", "amount": 19.99, "percent": 100, "refunded_amount": 0 } ], "payment_method_options": {}, "payment_method_type": "sg_grabpay_ewallet", "payment_method_type_category": "ewallet", // ... } }
La respuesta muestra:
El pago
ides payment_56410597a0196e1eec00954b3440461b. Cuando ejecutes este ejemplo en tu propia zona de pruebas, obtendrás un ID diferente, que necesitarás para los pasos posterioresEl
cantidades 19.99.El
currency_codees SGD (dólares de Singapur).El
estado(bajodatos) es ACTUAR (activo). Esto significa que el proceso de pago está activo pero no está completo.Se incluyen estas URL:
redireccionar_url- Rediriges a tu cliente a esta URL única del sitio web de eWallet para completar el pago.URL de pago completayerror_payment_url- Rapyd proporciona estas URL al sitio web de eWallet para redirigir al cliente a tu sitio web en función de si la compra se ha realizado correctamente.
Tu sitio web redirige al cliente al sitio web de eWallet. Una vez que el cliente haya pagado correctamente
El sitio web de eWallet redirige al cliente a la URL que proporcionaste para realizar el pago correctamente.
El sitio web de eWallet informa a Rapyd de que el pago se completó correctamente.
Rapyd le envía un webhook con los detalles de la transacción completada.
Simulación de un pago con monedero electrónico local
El sandbox no simula directamente la acción del cliente al completar la transacción con la billetera electrónica local. Puede simular esta acción con Completar el pago. Para ello, necesitarás el ID de pago que generaste en tu sandbox.
Configure su sistema para recibir webhooks con el procedimiento descrito en Definición de un endpoint de webhook.
Vamos a echar un vistazo a Webhook: pago completado .
Webhook
{ "id": "wh_718940ccd8fd308b43da58fdd05thj78", "type": "PAYMENT_COMPLETED”, ", "data": { "id": "payment_56410597a0196e1eec00954b3440461b", "fee": 0, "paid": true, "order": null, "amount": 19.99, "status": "CLO", // ... "captured": true, // ... "created_at": "1591620916", // ... "redirect_url": "https://sandboxdashboard.rapyd.net/complete-bank-payment?token=payment_56410597a0196e1eec00954b3440461b&complete_payment_url=https://success_example.net&error_payment_url=https://error_example.net", // ... "currency_code": "SGD", // ... "customer_token": "cus_1daa2cf4216845afdd277bb6d8f9dadf", "payment_method": "other_6afd4e09b6a2d22b7460a5dc3810112a", // ... "original_amount": 19.99, // ... "error_payment_url": "https://https://error_example.net", "payment_method_type": "", "complete_payment_url": "https://success_example.net", // ... "payment_method_type_category": "ewallet" }, // ... "created_at": 1591620906 }
El datos la sección del webhook contiene el mismo tipo de información que la respuesta a la solicitud de creación de pago, excepto que estado ahora es CLO (cerrado). Esto indica que la transacción se ha completado.