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

# PayPay for API only

Add PayPay to your API-only integration.

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

You can add PayPay to your existing integration. The following instructions show only what you must add to your integration specifically for PayPay.

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 PayPay in your Customer Area](/payment-methods/add-payment-methods).                                                                                                                                |   |

## How it works

1. The shopper selects PayPay 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. You fulfill the order by sending items to the shopper.

## Build your payment form

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

You can [download the logo for PayPay](/online-payments/build-your-integration/advanced-flow/?platform=Web\&integration=API%2Bonly\&version=71#downloading-logos) to use in your form.

## Get PayPay 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 PayPay 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****                                                                        |
| [amount.value](https://docs.adyen.com/api-explorer/Checkout/latest/post/paymentMethods#request-amount)             | The value of the payment, in [minor units](/development-resources/currency-codes). |

**Example request for available payment methods**

```bash
curl https://checkout-test.adyen.com/v72/paymentMethods \
-H 'x-api-key: ADYEN_API_KEY' \
-H 'idempotency-key: YOUR_IDEMPOTENCY_KEY' \
-H 'content-type: application/json' \
-X POST
-d '{
   "merchantAccount": "ADYEN_MERCHANT_ACCOUNT",
   "countryCode": "JP",
   "amount": {
      "currency": "JPY",
      "value": 1000
   },
   "shopperLocale": "jp-JP"
}'
```

**Example response with PayPay available**

```json
{
    "paymentMethods": [
        {
            "name": "PayPay",
            "type": "paypay"
        }
    ]
}
```

## Add additional parameters to your /payments request

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

## Test and go live

To test PayPay payments:

1. Download the PayPay app for iOS or Android.
2. [Sign up for a PayPay developer account](https://developer.paypay.ne.jp/account/signup) and create a test user.
3. [Switch the PayPay app to the sandbox app](https://integration.paypay.ne.jp/hc/en-us/articles/4414061901199-Can-I-use-the-PayPay-app-in-a-test-environment), and log in with the credentials of the test user.

You can check the status of PayPay 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)
