---
title: "Rakuten Pay for API only"
description: "Add Rakuten Pay to your API-only integration."
url: "https://docs.adyen.com/payment-methods/rakutenpay/api-only"
source_url: "https://docs.adyen.com/payment-methods/rakutenpay/api-only.md"
canonical: "https://docs.adyen.com/payment-methods/rakutenpay/api-only"
last_modified: "2026-06-01T15:33:15+02:00"
language: "en"
---

# Rakuten Pay for API only

Add Rakuten Pay to your API-only integration.

[View source](/payment-methods/rakutenpay/api-only.md)

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](/online-payments/build-your-integration/advanced-flow/?platform=Web\&integration=API%20only).                                                                   |   |
| **Redirect handling** | Make sure that your existing integration is set up to [handle the redirect](/online-payments/build-your-integration/advanced-flow/?platform=Web\&integration=API%20only#handle-the-redirect). `action.type`: **redirect**. |   |
| **Setup steps**       | Before you begin, [add Rakuten Pay in your Customer Area](/payment-methods/add-payment-methods).                                                                                                                           |   |

## How it works

1. The shopper selects Rakuten Pay as the payment method.
2. The shopper enters their details in the [payment form that you build](#build-your-payment-form).
3. When you make the payment request, you [include additional information about the items that the shopper intends to purchase](#additional-parameters-payments).
4. Your existing integration setup will [handle the redirect](/online-payments/build-your-integration/advanced-flow/?platform=Web\&integration=API%20only#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](/online-payments/build-your-integration/advanced-flow/?platform=Web\&integration=API%2Bonly\&version=72#downloading-logos) to use in your form.

## Get Rakuten Pay as an available payment method

When you make the [/paymentMethods](https://docs.adyen.com/api-explorer/Checkout/latest/post/paymentMethods) to [get available payment methods](/online-payments/build-your-integration/advanced-flow/?platform=Web\&integration=API%20only#get-available-payment-methods), specify the following so that Rakuten Pay is included in the response.

| Parameter                                                                                                          | Values  |
| ------------------------------------------------------------------------------------------------------------------ | ------- |
| [countryCode](https://docs.adyen.com/api-explorer/Checkout/latest/post/paymentMethods#request-countryCode)         | **JP**  |
| [amount.currency](https://docs.adyen.com/api-explorer/Checkout/latest/post/paymentMethods#request-amount-currency) | **JPY** |

**Example request for available payment methods**

```bash
curl https://checkout-test.adyen.com/v72/payments \
-H 'x-api-key: ADYEN_API_KEY' \
-H 'idempotency-key: YOUR_IDEMPOTENCY_KEY' \
-H 'content-type: application/json' \
-X POST
-d '{
  "amount": {
    "currency": "JPY",
    "value": 5678
  },
  "reference": "Your_Reference",
  "merchantAccount": "YOUR_MERCHANT_ACCOUNT",
  "returnUrl": "https://redirect.adyen.com",
  "paymentMethod": {
    "type": "rakutenpay"
  }
}'
```

**Example response with Rakuten Pay available**

```json
{
    "paymentMethods": [
        {
            "name": "Rakuten Pay",
            "type": "rakutenpay"
        }
    ]
}
```

## Add additional parameters to your /payments request

You do not need to add any additional parameters when you [make a payment](/online-payments/build-your-integration/advanced-flow/?platform=Web\&integration=API%20only#make-a-payment).

## Recurring

If you have a business model based on [subscription](/get-started-with-adyen/adyen-glossary#subscriptions) and [unscheduled card-on-file](/get-started-with-adyen/adyen-glossary#unscheduled-card-on-file-ucof) payments, Rakuten Pay permits one-off [card-on-file](/get-started-with-adyen/adyen-glossary#card-on-file-cof) 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](/online-payments/tokenization/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**.

## See also

* [API-only integration guide](/online-payments/build-your-integration/advanced-flow/?platform=Web\&integration=API%20only)
