PAYCommercial ยท Adyen N.V.

Adyen

Enterprise payments platform with a single Checkout API for cards and local payment methods. In Singapore it supports PayNow (SGD, SG only) with real-time payments, QR code integration, refunds, partial refunds and separate captures via the standard /payments endpoint with paymentMethod.type set to paynow.

How to authenticate

5 stops to a working call

  1. 1Sign up for an Adyen test account and create a merchant account in the Customer Area.
  2. 2Create an API credential under Developers > API credentials and generate an API key.
  3. 3Add PayNow as a payment method in your Customer Area for your Singapore merchant account.
  4. 4Send the key in the 'x-API-key' header on requests to the Checkout API (test host checkout-test.adyen.com; live uses your account-specific live URL prefix).
  5. 5POST /payments with amount.currency SGD and paymentMethod.type 'paynow'.

Example request

Request
curl -X POST 'https://checkout-test.adyen.com/v71/payments' -H 'x-API-key: YOUR_API_KEY' -H 'Content-Type: application/json' -d '{"merchantAccount":"YourMerchantAccount","amount":{"currency":"SGD","value":1000},"paymentMethod":{"type":"paynow"},"reference":"Your order number","returnUrl":"https://your-company.com/checkout"}'

Example response

Response (truncated)
{"resultCode":"Pending","action":{"paymentMethodType":"paynow","type":"qrCode","qrCodeData":"..."}}

Adyen: common questions

Is the Adyen free?

The Adyen is listed as paid. Check the official Adyen N.V. docs for current pricing.

Does the Adyen need an API key?

Yes. It uses API key. Sign up for an Adyen test account and create a merchant account in the Customer Area. Create an API credential under Developers > API credentials and generate an API key. Add PayNow as a payment method in your Customer Area for your Singapore merchant account. Send the key in the 'x-API-key' header on requests to the Checkout API (test host checkout-test.adyen.com; live uses your account-specific live URL prefix). POST /payments with amount.currency SGD and paymentMethod.type 'paynow'.

What is the Adyen endpoint?

The base URL is https://checkout-test.adyen.com/v71. A working example: curl -X POST 'https://checkout-test.adyen.com/v71/payments' -H 'x-API-key: YOUR_API_KEY' -H 'Content-Type: application/json' -d '{"merchantAccount":"YourMerchantAccount","amount":{"currency":"SGD","value":1000},"paymentMethod":{"type":"paynow"},"reference":"Your order number","returnUrl":"https://your-company.com/checkout"}'

Notes for AI agents

Enterprise-oriented: test account is self-serve but going live requires Adyen onboarding/KYC and enabling PayNow on your merchant account. Live API hosts are account-specific (unique live URL prefix), so the test base URL above is only for sandbox. Full OpenAPI specs are published in the Adyen/adyen-openapi GitHub repo.

Machine-readable version: /api/apis/adyen

On the same line