Rapipago
Last updated: April 29, 2022
Start accepting payment using Rapipago, a favorite payment method in Argentina.
Information
If you want to use a gateway model for accepting Rapipago payments, you will need to arrange an agreement with our provider, dLocal, and create merchant details (specifically, x_login
and x_trans_key
) and a secret key with them. Share these details with our Customer Support team and we'll get you up and running. If you have already been onboarded for one of our other dLocal payment methods, you can use the same credentials.
Model | Collecting |
---|---|
Payment flow | Cash |
Payment method type | Voucher |
One-step payment | |
Authorization | |
Capture | |
Refund | |
Partial refund | |
Chargeback | |
Recurring payment |
Rapipago payments follow a two-step process:
You can find the full list, as well as complete request and response examples, in our API reference.
post
https://api.checkout.com/payments
1{2"source": {3"type": "rapipago",4"integration_type": "redirect",5"country": "AR",6"payer": {7"name": "Bruce Wayne",8"email": "[email protected]"9},10"description": "simulate Rapipago Demo Payment"11},12"amount": 100,13"currency": "ARS"14}
You should get a 202
response with the status
field set to Pending
. This means your request has been accepted.
1{2"id": "pay_274nqq3v2vqura6oirwlupvpuu",3"status": "Pending",4"customer": {5"id": "cus_2l5rigg64jqu5d76rmsa4jbuu4"6},7"_links": {8"self": {9"href": "https://api.sandbox.checkout.com/payments/pay_274nqq3v2vqura6oirwlupvpuu"10},11"redirect": {12"href": "https://sandbox.dlocal.com/collect/pay/pay/M-edadd4c6-18d4-4e59-873d-84c361a2d98c?xtid=CATH-ST-1588001175-803994443"13},14"simulator:payment-succeed": {15"href": "http://sb-gateway-internal.cko.lon/dlocal-internal/rapipago/payments/pay_274nqq3v2vqura6oirwlupvpuu/succeed"16},17"simulator:payment-expire": {18"href": "http://sb-gateway-internal.cko.lon/dlocal-internal/rapipago/payments/pay_274nqq3v2vqura6oirwlupvpuu/expire"19}20}21}
To capture and complete the payment, you need to provide the customer with the Rapipago ticket.
Using the redirection URL returned in the response above via _links.redirect
, redirect your customer to the static, hosted Rapipago ticket page. Once redirected, your customer should save or print the ticket.
Information
Make sure your customer is aware that they will be redirected to the ticket page when they select your Pay now button, and that they should print or save the ticket.
A button on the page will allow them to return to your shop:
- If the ticket is still valid, they will be redirected to your success URL.
- If the ticket has expired, they will be redirected to your failure URL.
Note
Your payment confirmation page should make it clear to the customer that their purchase has not yet been completed. Explain that it has been reserved and is pending payment before the order can be completed and the goods/services can be delivered.
Using the following endpoint, pass the payment id
(for example, pay_hcklpcd45ymepcr7thciirbdaa
) from the payment response to get details about the payment.
Use the details below to set up your request.
You can find the full list, as well as complete request and response examples, in our API reference.
get
https://api.checkout.com/payments/{payment_id}
1{2"id": "pay_274nqq3v2vqura6oirwlupvpuu",3"requested_on": "2020-04-27T15:26:15Z",4"source": {5"type": "rapipago",6"dlocal_order_id": "da95e7f4d26e4a14987b49a6a4710a13",7"dlocal_payment_id": "D-30150-cbbdc947-5291-4fe9-a114-5c17b3829f9b",8"integration_type": "redirect",9"description": "simulate Rapipago Demo Payment"10},11"amount": 100,12"currency": "ARS",13"payment_type": "Regular",14"status": "Pending",15"risk": {16"flagged": false17},18"customer": {19"id": "cus_2l5rigg64jqu5d76rmsa4jbuu4"20},21"_links": {22"redirect": {23"href": "https://sandbox.dlocal.com/collect/pay/pay/M-edadd4c6-18d4-4e59-873d-84c361a2d98c?xtid=CATH-ST-1588001175-803994443"24},25"simulator:payment-succeed": {26"href": "http://sb-gateway-internal.cko.lon/dlocal-internal/rapipago/payments/pay_274nqq3v2vqura6oirwlupvpuu/succeed"27},28"simulator:payment-expire": {29"href": "http://sb-gateway-internal.cko.lon/dlocal-internal/rapipago/payments/pay_274nqq3v2vqura6oirwlupvpuu/expire"30},31"self": {32"href": "https://api.sandbox.checkout.com/payments/pay_274nqq3v2vqura6oirwlupvpuu"33}34}35}
You can refund a Rapipago payment using our refund API. Partial and multiple – as well as full – refunds are allowed.
The customer will get an email (the email address is taken from the source.payer.email
property in the initial payment request) from dLocal asking for their banking details. Once the customer has provided their details, dLocal will transfer the money to the customer's bank account.
The payment status will update to refunded
and you will receive a payment_refunded
(or payment_refund_declined
, if unsuccessful) webhook notification.
A refund processing fee may apply.
There is no chargeback mechanism for Rapipago.
Webhooks | Description |
---|---|
| Sent when a payment request is successfully initiated. |
| Sent when the acquirer is in the process of accepting the payment. |
| Sent when the customer has completed the payment with the ticket. |
| Sent when the ticket has expired. |
| Sent when there was a failure in creating the payment. |
| Sent when a refund is successfully initiated. |
| Sent when a refund is successfully processed. |
| Sent when a refund is declined. |
Information
Learn more about webhooks and how to subscribe to them.
Information
To start testing, you'll need to:
- create a test account, and
- contact your Account Manager or Integrations engineer to activate Rapipago payments in the sandbox environment.
In your sandbox environment, you can test payment capture and expiration, as well as refund success and failure.
In order to test these actions, pass the string "simulate"
as part of the source.description
field in the initial payment request.
When you do, you will receive additional hypermedia links in the _links
object in the payment response and in the 'get payment details' response.
Use the URLs contained in the simulator:payment-succeed
, simulator:payment-expire
, simulator:refund-succeed
and simulator:refund-fail
hypermedia objects to simulate the respective action/state change on the test payment.