[Sandbox] Create a mock PayNow payment

Changed on

[Available in Sandbox environment only] Send test funds to your business account via PayNow

post/sandbox/paynow_simulations

Request

  • Base URL
    https://api-sandbox.straitsx.com/v1
  • URL
    https://api-sandbox.straitsx.com/v1/sandbox/paynow_simulations
  • Auth
    API key in header X-XFERS-APP-API-KEY

Headers

X-XFERS-APP-API-KEYstring required

You can retrieve this from your Dashboard Developer Tools.<br><br><strong>Note:</strong> The X-XFERS-APP-API-KEY is a mandatory header for all authentication methods, including standard API key usage and HTTP Request Signing mode.

X-PUBLIC-KEY-IDstring

The Key ID, can be retrieved from your StraitsX Dashboard.<br><br><strong>Note:</strong> This header attribute is required when HTTP Request Signing is enabled for your account.

X-TIMESTAMPstring

Current Unix epoch time in seconds. Must be within ±300 seconds of server time.<br><br><strong>Note:</strong> This header attribute is required when HTTP Request Signing is enabled for your account.

X-NONCEstring

A unique UUID string per request, used for replay protection. Must not be reused within the timestamp window.<br>Regex: /\A[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\z/i<br><br><strong>Note:</strong> This header attribute is required when HTTP Request Signing is enabled for your account.

X-SIGNATUREstring

Base64-encoded digital signature of the canonical request string.<br><br><strong>Note:</strong> This header attribute is required when HTTP Request Signing is enabled for your account.

Request body

Response

200

Example response

{
  "data": {
    "id": "contract_733b1d7b52e14ccfa74c6664655e0cc1",
    "type": "paynowTransaction",
    "attributes": {
      "idempotencyId": "8cfee2b8-5173-4757-9a75-a769edaaa94c",
      "customerProfileId": "customer_profile_ea25ab3c-b7b7-49ba-ac66-aec1b9a0374b",
      "currency": "sgd",
      "amount": "0.1",
      "fees": "0.0",
      "status": "pending",
      "createdAt": "2024-07-08T09:40:03.809+08:00",
      "senderInformation": {
        "accountHolderName": "John Doe",
        "accountNumber": "123456789",
        "bankName": "DBS Bank Ltd",
        "endToEndRef": "Testing Remarks",
        "swiftBic": "DBSSSGSGXXX"
      },
      "paymentMethod": {
        "id": "paynow_75c8335d-0e91-4110-ba85-7af9298c7094",
        "referenceId": "new_persistent_QR_2",
        "virtualPaymentAddress": "UEN#FAZZ",
        "base64EncodedImage": "iVBORw0KGgoAAAANSUhEUgAAASwAAAxse"
      },
      "blockedReasons": [
        {
          "code": "NM-001"
        }
      ]
    }
  }
}

Changes

    • info

      api operation id sandbox-create-mock-paynow-payment removed and replaced with create-a-mock-paynow-payment

    • info

      added the new optional request property /

    • info

      added the optional property // to the response with the status