> ## Documentation Index
> Fetch the complete documentation index at: https://gr4vy.radial-commerce.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Adyen - PayPay

> Configure PayPay via Adyen as a payment method in Gr4vy.

**Adyen**

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](https://gr4vy.radial-commerce.com/connections/payments/adyen.md) 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

This list is for guidance only. It doesn't guarantee availability or
create any rights, and the provider may need to enable some features for
your account.

## 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.

```csharp C# theme={"system"}
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",
        }
      ),
  }
);
```

```go Go theme={"system"}
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)
```

```java Java theme={"system"}
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);
```

```php PHP theme={"system"}
$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;
```

```python Python theme={"system"}
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",
  }
)
```

```ts TypeScript theme={"system"}
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.

```json theme={"system"}
{
  "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](https://docs.adyen.com/online-payments/build-your-integration/sessions-flow?platform=Web\&integration=Components\&version=6.23.0), [Android](https://docs.adyen.com/online-payments/build-your-integration/sessions-flow?platform=Android\&integration=Components\&version=5.15.0) and [iOS](https://docs.adyen.com/online-payments/build-your-integration/sessions-flow?platform=iOS\&integration=Components\&version=5.21.1) 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`](https://gr4vy.radial-commerce.com/reference/transactions/get-transaction-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](https://gr4vy.radial-commerce.com/reference/transactions/get-transaction-session.md) for that transaction.

```sh theme={"system"}
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](https://gr4vy.radial-commerce.com/connections/payments/adyen-cashapp.md#direct-integration) for a worked example of initializing the Adyen SDK with this session data.

## Testing

Adyen has [instructions](https://docs.adyen.com/payment-methods/paypay/web-component/#test-and-go-live) on how to test PayPay.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.