Purchase

POST

api/payment-gateway/v1/payments/purchase

The Purchase API is used to initiate a payment transaction between a customer and a merchant through PayWay. It allows merchants to request a payment by providing transaction details such as the amount, currency, item list, and other relevant data.

Once the API is called, the customer is redirected to PayWay’s hosted checkout page, bottom sheet, or modal popup—depending on your integration option—where they can complete the payment using the available methods (e.g., card, ABA PAY, KHQR, digital wallets). After the transaction is completed, PayWay will return the transaction result to the merchant via the configured return URL or callback.

Request

Header Params

Body Params multipart/form-data

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://checkout-sandbox.payway.com.kh/api/payment-gateway/v1/payments/purchase' \
--header 'Content-Type: multipart/form-data' \
--form 'req_time=""' \
--form 'merchant_id=""' \
--form 'tran_id=""' \
--form 'firstname=""' \
--form 'lastname=""' \
--form 'email=""' \
--form 'phone=""' \
--form 'type=""' \
--form 'payment_option=""' \
--form 'items=""' \
--form 'shipping=""' \
--form 'amount=""' \
--form 'currency=""' \
--form 'return_url=""' \
--form 'cancel_url=""' \
--form 'skip_success_page=""' \
--form 'continue_success_url=""' \
--form 'return_deeplink=""' \
--form 'custom_fields=""' \
--form 'return_params=""' \
--form 'view_type=""' \
--form 'payment_gate=""' \
--form 'payout=""' \
--form 'additional_params=""' \
--form 'lifetime=""' \
--form 'google_pay_token=""' \
--form 'hash=""'

Responses

🟢200Success

text/html

Body

Example

<!DOCTYPE html>
<html data-capo="">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalab
<title>PayWay - Checkout</title>
...
</head>
<body>
...
</body>
</html>

🟢200OK

🟢200Exception

Ecommerce Checkout

Get a transaction details