eWallets
La eWallet 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 eWallet preferida para pagar las compras en su sitio web o aplicación. Una eWallet 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.
Los pagos comunes con la eWalllet incluyen:
GrabPay (Sudeste asiático)
PayTM (India)
Samsung Pay ewallet (Corea)
FamiPay (Japón)
Método de pago de las eWallets
Si utiliza el Rapyd Hosted Checkout, simplemente seleccione la eWallet como uno de los métodos de pago aceptados. Encontrará una lista completa de los métodos de pago con eWallets en el Client Portal, tal como se describe en Ver los métodos de pago
Seleccione su eWallet.
Haga clic en Hacer pedido.
Complete el pago.
Redirigir a la página pago exitoso.
Puede encontrar los métodos de pago específicos con la eWallet que aceptará y los campos obligatorios correspondientes que los clientes deben llenar en la sección Cómo funciona.
Un cliente que utiliza su 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 compras. El cliente pulsa el botón de pago, llega a la página de pago y selecciona la opción de pagar con una eWallet.
Solicita a Rapyd los detalles de la eWallet y los presenta al cliente.
El cliente rellena los detalles de la eWallet y confirma el pago pulsando Pagar.
El servidor del sitio web solicita a Rapyd que procese el pago del cliente, especificando el monto, la moneda, el método de pago y la URL del pago completado 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 la URL de redireccionamiento del sitio web de la eWallet.
En el sitio web de la eWallet, el cliente sigue las instrucciones para completar el pago introduciendo los detalles de la eWallet.
El sitio web de la eWallet redirige al cliente a la URL que usted especificó para un pago exitoso o para un pago fallido. El sitio web de la eWallet se lo notifica a Rapyd.
Rapyd envía un webhook a su 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 las eWallets que están disponibles en SG y SGD, use Listar 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 | Introducir SG como código del país. |
moneda | Introducir SGD como código de la moneda. |
Solicitud de la lista de métodos de pago por país
Solicite 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
Respuesta para la lista de métodos de pago por país
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 } ] }
La sección de data de esta respuesta muestra que sg_grabpay_ewallet es un método de pago aceptable con la eWallet.
Respuesta de la lista del método de pago
En una respuesta completa se enumeran muchos métodos de pago.
Identifique los campos que su cliente debe completar para el método de pago. Para hacerlo, use 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 | Introduzca sg_grabpay_ewallet como tipo de método de pago. |
Obtener la solicitud para los campos obligatorios del método de pago.
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 la respuesta para los campos obligatorios del método de pago.
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
Cuando su cliente haga el pago en su sitio web, use Crear un pago con los siguientes parámetros para que Rapyd procese el pago bancario de su cliente:
Descripción de los parámetros de cuerpo
Parámetro del cuerpo | Descripción |
|---|---|
amount | Introducir 19.99 como monto del pago. |
currency | Introducir SGD como código de la moneda. |
payment_method | Introduzca un objeto con los siguientes campos:
|
complete_payment_url | Sustituya el ejemplo https://success_example.net con la URL real de tu sitio web al que desea redirigir al cliente cuando el pago se realice correctamente. |
error_payment_url | Sustituya el ejemplo https://error_example.net con la URL de su sitio web real al que desea redirigir al cliente cuando se produzca un error en el pago. |
Crear solicitud de pago
Solicite a Rapyd que procese el pago con la eWallet del cliente (19,99 SGD en este caso) y que cobre el pago por usted.
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
Consulte 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 ejecute este ejemplo en su propia zona de pruebas, obtendrá un ID diferente, que necesitará para los pasos posteriores.El
amountes 19.99.El
currency_codees SGD (dólares de Singapur).El
status(endata) es ACT (activo). Esto significa que el proceso de pago está activo pero no está completo.Se incluyen estas URL:
redirect_url: Redirija a su cliente a esta URL única del sitio web de eWallet para completar el pago.complete_payment_url and error_payment_url: Rapyd proporciona estas URL al sitio web de la eWallet para redirigir al cliente a su sitio web en función de si la compra se ha realizado correctamente.
Su sitio web redirige al cliente al sitio web de la eWallet. Una vez que el cliente haya pagado correctamente:
El sitio web de la eWallet redirige al cliente a la URL que usted proporcionó para realizar el pago correctamente.
El sitio web de la eWallet informa a Rapyd 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 una eWallet local
El sandbox no simula directamente la acción del cliente al completar la transacción con la eWallet local. Puede simular esta acción con el procedimiento descrito en Completar el pago. Para ello, necesitará el ID de pago que generó en su sandbox.
Configure su sistema para recibir webhooks con el procedimiento descrito en Definición de un endpoint de webhook.
Veamos 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 }
La sección de datos del webhook contiene el mismo tipo de información que la respuesta a la solicitud de creación de pago, excepto que el estado ahora es CLO (cerrado). Esto indica que la transacción se ha completado.