Adyen - PayPay

Adyen is a global payment technology company founded in 2006 in Amsterdam, Netherlands. The company provides a single platform for accepting payments across online, mobile, and in-store channels for major enterprises worldwide including Uber, Spotify, and Microsoft. PayPay is the largest QR code and mobile wallet payment method in Japan. Buyers approve the payment in the PayPay app, funded by their wallet balance, a linked bank account, or a registered card. PayPay is available for transactions in Japan in Japanese yen.

Setup

Please follow the common Adyen instructions to get set up with PayPay. Next, make sure to enable PayPay as a payment method on your configured account.

Supported countries

Supported currencies

Capabilities

Integration

For PayPay, the default integration for Adyen is through a redirect to a hosted payments page.

Redirect integration

Start by creating a new transaction with the following required fields.

var transaction = await client.Transactions.CreateAsync(
  transactionCreate: new TransactionCreate()
  {
    Amount = 1299,
    Currency = "JPY",
    Country = "JP",
    Intent = "capture",
    PaymentMethod =
      TransactionCreatePaymentMethod.CreateRedirectPaymentMethodCreate(
        new RedirectPaymentMethodCreate()
        {
          Method = "paypay",
          Country = "JP",
          Currency = "JPY",
          RedirectUrl = "https://example.com/callback",
        }
      ),
  }
);

amount := int64(1299)
currency := "JPY"
country := "JP"
method := components.RedirectPaymentMethodCreateMethodPaypay
redirectUrl := "https://example.com/callback"

redirectPaymentMethodCreate := components.RedirectPaymentMethodCreate{
  Method: method,
  Country: country,
  Currency: currency,
  RedirectURL: redirectUrl,
}
paymentMethod := components.CreateTransactionCreatePaymentMethodRedirectPaymentMethodCreate(redirectPaymentMethodCreate)

transactionCreate := components.TransactionCreate{
  Amount:        amount,
  Currency:      currency,
  Country:       &country,
  Intent:       gr4vy.Pointer(components.TransactionIntentCapture),
  PaymentMethod: &paymentMethod,
}

transaction, err := client.Transactions.Create(ctx, transactionCreate, nil, nil, nil)

CreateTransactionResponse transactionResponse = gr4vyClient.transactions().create()
  .transactionCreate(TransactionCreate.builder()
    .amount(1299L)
    .currency("JPY")
    .country("JP")
    .intent(TransactionIntent.CAPTURE)
    .paymentMethod(TransactionCreatePaymentMethod.of(RedirectPaymentMethodCreate.builder()
      .method(RedirectPaymentMethodCreateMethod.PAYPAY)
      .country("JP")
      .currency("JPY")
      .redirectUrl("https://example.com/callback")
      .build()))
    .build())
  .call();

Transaction transaction = transactionResponse.transaction().orElse(null);

$transactionCreate = new TransactionCreate(
  amount: 1299,
  currency: 'JPY',
  country: 'JP',
  intent: 'capture',
  paymentMethod: new RedirectPaymentMethodCreate(
    method: 'paypay',
    country: 'JP',
    currency: 'JPY',
    redirectUrl: 'https://example.com/callback'
  )
);
$response = self::$sdk->transactions->create($transactionCreate);
$transaction = $response->transaction;

transaction: models.Transaction = client.transactions.create(
  amount=1299,
  currency="JPY",
  country="JP",
  intent="capture",
  payment_method={
    "method": "paypay",
    "country": "JP",
    "currency": "JPY",
    "redirect_url": "https://example.com/callback",
  }
)

const transaction = await gr4vy.transactions.create({
  amount: 1299,
  currency: "JPY",
  country: "JP",
  intent: "capture",
  paymentMethod: {
    method: "paypay",
    country: "JP",
    currency: "JPY",
    redirectUrl: "https://example.com/callback"
  }
})

After the transaction is created, the API response includes payment_method.approval_url and the buyer_approval_pending status.

{
  "type": "transaction",
  "id": "ea1efdd0-20f9-44d9-9b0b-0a3d71e9b625",
  "payment_method": {
    "type": "payment-method",
    "approval_url": "https://cdn.sandbox.spider.gr4vy.app/connectors/adyen/apm.html?token=..."
  },
  "method": "paypay"
}

Redirect the buyer to the approval_url so they can approve the payment in the PayPay app. On desktop the buyer scans a QR code; on mobile they are handed off to the PayPay app. After approval the buyer is redirected to the redirect_url you provided when creating the transaction. Do not rely solely on the redirect - either poll the transaction or (recommended) rely on webhooks to detect the final status (for example capture_succeeded or failure states).

Direct integration

Adyen provides web, Android and iOS SDKs for a direct integration. For these flows you should indicate the platform by setting an appropriate integration_client when creating the transaction, and then build a client-side integration that uses the POST /transactions/:transaction_id/session API to initialize the Adyen SDK. For mobile, set integration_client to ios or android and use your app deep link for redirect_url (for example, yourapp://). After the transaction is created, the API response includes a session_token which can be used to get the session data for that transaction.

POST /transactions/:transaction_id/session?token=:session_token

This session data provides the sessionId and sessionData required to load the Adyen SDK. Refer to the Cash App Pay direct integration for a worked example of initializing the Adyen SDK with this session data.

Testing

Adyen has instructions on how to test PayPay.

Introduction

Aggregators

Methods

Digital wallets

Anti-fraud

Browse

Adyen - PayPay

Setup

Supported countries

Supported currencies

Capabilities

Integration

Redirect integration

Direct integration

Testing

​Setup

​Supported countries

​Supported currencies

​Capabilities

​Integration

​Redirect integration

​Direct integration

​Testing

Setup

Supported countries

Supported currencies

Capabilities

Integration

Redirect integration

Direct integration

Testing