Dynamic PayNow QR

Dynamic PayNow QR allows you to create unique PayNow QR codes for each and every transaction. Upon getting the response, you will need to convert the base64 string to an image and display it to your customer.

There will be 2 callbacks fired:

  1. Payment completion by customer
  2. Crediting of funds to your account

For more information on PayNow, head over to PayNow QR.

Dynamic Virtual Account

Dynamic Virtual Account (VA) allows you to create unique VAs for each and every transaction. You can tie your transactionID with a VA, e.g. txnID123 <> VA123.

If a transaction (e.g. txnID123) is Paid or Expired, subsequent transfers to the Virtual Account (e.g. VA123) will not be associated. These subsequent transfers will be refunded to the user to the originating bank account.

Parameter

Required?

Type

Description

Amount

Mandatory

Float (up to 2decimal places)

Transaction Amount that user is required to pay/transfer.

referenceId

Mandatory

String

This is used for idempotency and should typically be a "transaction id" or "order id" on your platform.

Description

Optional

String

An arbitrary string attached to the object.

paymentMethodType

Mandatory

String

Must always be "virtual_bank_account"

bankShortCode

Mandatory

String

Supported values: "cimb"

expiredAt

Mandatory

String

Timestamp to be in Time.iso8601.
Expiry limit within 1hour to 30days

Example of Dynamic VA request

# POST api/v4/payments/
# FYI, passing in metadata is possible,
# "description": "{\"key\":\"abc\",\"key2\":\"another key\"}"  
  
Basic Auth
{
    "data": {
        "relationships": {
            "customerProfile": {
                "data": {
                    "id": "customer_profile_ff9a2945-5f58-4cd3-ac6e-90ee4361bf1e"
                }
            }
        },
        "attributes": {
            "amount": 101.0,
            "referenceId": "ORDER_0322",
            "description": "This is the first order",
            "paymentMethodType": "virtual_bank_account",
            "paymentMethodOptions": {
                "bankShortCode": "cimb"
            },
            "expiredAt": "2023-06-20T17:48:42+07:00"
        }
    }
}

Example of Dynamic VA response

{
    "data": {
        "id": "contract_ab8ad04b27d0414a96ae0b30a82576c8",
        "type": "payment",
        "attributes": {
            "status": "pending",
            "amount": "101.0",
            "createdAt": "2022-09-06T16:52:11+08:00",
            "description": "This is the first order",
            "expiredAt": "2023-06-20T17:48:42+07:00",
            "referenceId": "ORDER_0322",
            "fees": "0.0",
            "paymentMethod": {
                "id": "va_756d9f1e6c3f7c1417c3eed133e0ab4d",
                "type": "virtual_bank_account",
                "referenceId": "ORDER_0322",
                "instructions": {
                    "bankShortCode": "CIMB",
                    "accountNo": "8435212389019"
                }
            }
        }
    }
}
Language
Authentication
Query
Click Try It! to start a request and see the response here!