Payments

Process payments, refunds, cancellations, and manual transaction saves.

POST/api/v1/{system}/payNow

Process a payment. Tenant ownership is validated server-side.

Auth: Bearer JWT

Request Body

FieldTypeRequiredDescription
grandTotalstringYesDecimal amount (e.g. '10.00')
referenceIdstringYesUnique transaction reference
branchIdlongYesBranch user ID
configIdlongYesTerminal config ID
channelstringNoWECHAT, ALIPAY, UNION_PAY, etc.
authCodestringNoQR scan code (required when qrMode=false)
qrModebooleanNotrue = generate QR for customer to scan

Response Example

{
  "status": true,
  "paymentStatus": "SUCCESS",
  "referenceId": "REF-001",
  "tradeNo": "TRADE-123",
  "grandTotal": "10.00",
  "channel": "WECHAT"
}
SandboxCalls go to https://payus.co.nz

Authentication