Developer Suite
Register Sandbox
Register Sandbox
  1. Credentials on File
  • Overview
  • API Endpoints
  • Ecommerce Checkout
    • Purchase
      POST
    • Get a transaction details
      POST
    • Close transaction
      POST
    • Check transaction
      POST
    • Refund API
      POST
    • Get transaction list
      POST
    • Exchange rate
      POST
  • Checkout Plugins
    • Prestashop
    • Woocommerce
  • Credentials on File
    • Link Account
      POST
    • Link Card
      POST
    • Purchase using token
      POST
    • Remove account token
      POST
    • Remove card token
      POST
    • Get linked account details
      POST
  • ABA QR API
    • QR API
      POST
  • Payment Link
    • Create payment link
      POST
    • Get payment link details
      POST
  • Pre-auth
    • Complete pre-auth transactions
      POST
    • Complete pre-auh transaction with payout
      POST
    • Cancel pre-purchase transaction
      POST
  • Payout
    • Payout
    • Update a beneficiary status
    • Add a beneficiary to whitelist
  • KHQR Guideline
  • Resources
  1. Credentials on File

Purchase using token

POST
api/payment-gateway/v1/payments/purchase
This API supports both card tokens and account tokens.

Request

Header Params

Body Params application/json

Example
{
    "req_time": "20250312075529",
    "merchant_id": "xxxxx",
    "type": "pre-auth",
    "items": "Nlx1MTc5NFx1MTdiY...MDAwLjAwIn1d",
    "amount": 60000,
    "tran_id": "17417661239",
    "continue_success_url": "demo-payway-uat.ababank.com",
    "return_url": "aHR0cHM6Ly9kZW1vLXBheXdhe..NzY2MTIzOQ==",
    "return_param": "OTg0OQ==",
    "hash": "QRzyIlknvaVA..jXvkA==",
    "custom_fields": "eyJteV9jdXN0bMSI6I..lfY3VzdG9tX2ZpZWDE3NjYxMjl9",
    "firstname": "QA",
    "lastname": "Sakada",
    "phone": "017582717",
    "email": "sakadaqa@gmail.com"
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://checkout-sandbox.payway.com.kh/api/payment-gateway/v1/payments/purchase' \
--header 'Content-Type: application/json' \
--data-raw '{
    "req_time": "20250312075529",
    "merchant_id": "xxxxx",
    "type": "pre-auth",
    "items": "Nlx1MTc5NFx1MTdiY...MDAwLjAwIn1d",
    "amount": 60000,
    "tran_id": "17417661239",
    "continue_success_url": "demo-payway-uat.ababank.com",
    "return_url": "aHR0cHM6Ly9kZW1vLXBheXdhe..NzY2MTIzOQ==",
    "return_param": "OTg0OQ==",
    "hash": "QRzyIlknvaVA..jXvkA==",
    "custom_fields": "eyJteV9jdXN0bMSI6I..lfY3VzdG9tX2ZpZWDE3NjYxMjl9",
    "firstname": "QA",
    "lastname": "Sakada",
    "phone": "017582717",
    "email": "sakadaqa@gmail.com"
}'

Responses

🟢200Success
application/json
Body

Examples
{
    "tran_id": "trx-20201019130949",
    "payment_status": {
        "status": "0",
        "code": "CDA00",
        "description": "OK",
        "pw_tran_id": "trx-20201019130949"
    }
}
🟠403Forbidden
Previous
Link Card
Next
Remove account token