PayNow via Adyen

​

Supported workflows

​

Before you begin

1. Set up an Adyen integration in your workspace. Follow the Adyen integration setup guide if you don’t have one yet.
2. Ask Adyen to enable PayNow on your Adyen merchant account.
3. Configure Adyen webhook notifications for your integration. The payment completes only when Adyen sends the authorization result.
4. In the Payrails Portal, go to Settings → Integrations, open your Adyen integration, select PayNow under Payment methods, and save.
5. Add PayNow as a payment option in your workflow.

​

Request fields for Adyen

​

Authorize a PayNow payment

{
  "amount": {
    "value": "45.00",
    "currency": "SGD"
  },
  "paymentComposition": [
    {
      "integrationType": "api",
      "paymentMethodCode": "payNow",
      "amount": {
        "value": "45.00",
        "currency": "SGD"
      }
    }
  ],
  "meta": {
    "customer": {
      "email": "wei.tan@example.com",
      "country": {
        "code": "SG"
      }
    }
  },
  "returnInfo": {
    "success": "https://example.com/success",
    "error": "https://example.com/error"
  }
}

​

How Adyen handles PayNow

• Payrails shows the PayNow QR code on a Payrails-hosted page with a three-minute countdown, which matches the QR code’s expiry.
• Adyen captures PayNow payments automatically. When Adyen confirms the authorization, Payrails also records the capture, so the payment completes in one step.
• When the QR code expires before the customer pays, Adyen closes the payment and Payrails marks it as abandoned by the customer.
• PayNow through Adyen supports customer-initiated payments only. Payrails rejects an MIT before it calls Adyen.