You can add Rakuten Pay to your existing integration. The following instructions show only what you must add to your integration specifically for Rakuten Pay.
If an instruction on this page corresponds with a step in the main integration guide, it includes a link to corresponding step of the main integration guide.
Requirements
| Requirement | Description | |
|---|---|---|
| Integration type | Make sure that you have an existing API-only integration. | |
| Redirect handling | Make sure that your existing integration is set up to handle the redirect.action.type: redirect. |
|
| Setup steps | Before you begin, add Rakuten Pay in your Customer Area. |
How it works
- The shopper selects Rakuten Pay as the payment method.
- The shopper enters their details in the payment form that you build.
- When you make the payment request, you include additional information about the items that the shopper intends to purchase.
- Your existing integration setup will handle the redirect.
Build your payment form
Include Rakuten Pay in the list of available payment methods. There are no additional fields that you have to include in your form.
You can download the logo for Rakuten Pay to use in your form.
Get Rakuten Pay as an available payment method
When you make the /paymentMethods to get available payment methods, specify the following so that Rakuten Pay is included in the response.
| Parameter | Values |
|---|---|
| countryCode | JP |
| amount.currency | JPY |
Add additional parameters to your /payments request
You do not need to add any additional parameters when you make a payment.
Recurring
If you have a business model based on subscription and unscheduled card-on-file payments, Rakuten Pay permits one-off card-on-file transactions after a review process. If you do not have a periodic charging cadence, Rakuten Pay prohibits you from initiating the Recurring Processing Model for card-on-file, which is primarily allowed for the Food & Beverage business category. You must apply for every Recurring Processing Model when you request Rakuten Pay.
Refer to Create tokens to integrate with our tokenization feature.
We strongly recommend that you ask explicit permission from the shopper if you intend to make future recurring payments. Being transparent about the payment schedule and the charged amount reduces the risk of chargebacks.
Test and go live
To test Rakuten Pay payments, use the acquirer account DGFT_AcquirerAccount_RakutenPay_closedLoop in the TEST environment.
You will be redirected you to a DGFT simulator tool to complete the transaction. You do not need the Rakuten Pay app.
You can check the status of Rakuten Pay test account transactions in your Customer Area at Transactions > Payments.