ST Pay Merchant APIST Pay Merchant API
Guide
API
Error codes
Back office
AI-assisted integration
  • 繁體中文
  • 简体中文
  • English
Guide
API
Error codes
Back office
AI-assisted integration
  • 繁體中文
  • 简体中文
  • English
  • Getting started

    • Overview
    • Request and response format
    • Authentication and IP whitelist
    • Signature
    • Merchant back office
    • AI-assisted integration
  • API

    • Create a collection order
    • Create a payout order
    • Order query
    • Callback notifications
  • Reference

    • Order status and amounts
    • Duplicate requests and confirming results
    • Error codes
    • Bank codes
    • Go-live checklist

Order status and amounts

"Back office label" is the status text shown in the merchant back office.

Collection orders

pending ──┬── Payment credited ───────────────────────→ success        (Callback sent)
          ├── Rejected manually by ST Pay ─────────────→ rejected       (Callback sent; final)
          └── Rejected by system on expiry (30 min) ──→ rejected       (Callback sent)
                                                          │
                                                          └── Payment receipt confirmed later ──→ late_credited (no Callback)
statusBack office labelMeaningFinal result?
pendingPendingWaiting for the payer's transfer and ST Pay's confirmationNo
successSuccessPayment credited; the settlement amount has been added to your balanceYes
rejectedRejectedNothing is credited and no fee is chargedFinal if rejected manually; an order rejected on expiry by the system can still change to late_credited afterwards
late_creditedLate creditedLate credit: the order was rejected on expiry by the system, but it was later confirmed that the payer did pay, and the settlement amount has been added to your balanceYes

No Callback is sent for late credits

You first receive one Callback with rejected. If the same order later changes to late_credited, you will not receive another notification, but your balance has already increased.

Recommendation: When a payer reports having paid but the order shows as rejected, confirm with an order query. Also reconcile regularly using order queries or the balance ledger in the merchant back office (entry type "Late credit"), checking whether orders whose reject_reason is 「訂單已逾時」 ("order expired") have changed to late_credited.

Payout orders

pending ──┬── Paid out by ST Pay ──→ paid       (balance deducted; Callback sent)
          └── Rejected by ST Pay ──→ rejected   (nothing deducted; Callback sent)
statusBack office labelMeaningFinal result?
pendingPendingWaiting for ST Pay to pay outNo
paidPaidPaid out; the payout amount plus the fee has been deducted from your balanceYes
rejectedRejectedNothing is deducted and no fee is chargedYes

Payout orders do not expire automatically. They remain pending until ST Pay processes them.

Amounts and fees

ItemCalculation
Collection payable amount payable_amountOriginal amount + identification tail (0.01–0.99)
Collection fee feeReceived amount × collection fee rate, truncated (rounded down) to 2 decimal places
Collection settlement amount settlement_amountReceived amount − fee
Payout fee feePayout amount × payout fee rate, truncated (rounded down) to 2 decimal places
Payout total deducted total_deductedPayout amount + fee
  • The fee rate is locked in at the moment the order is created. Later rate changes affect only newly created orders.
  • The received amount received_amount is the amount that ST Pay actually confirmed as credited, and the fee and settlement amount are calculated from it. If the amount the payer transferred differs from the payable amount, the received amount may differ from payable_amount.
  • The fee for a rejected order is 0.00.
  • Each order's original amount or payout amount must be within the per-transaction minimum and maximum set by ST Pay (inclusive of the limits themselves). The limits are set separately by "collection or payout" and by "channel type". Check the current values with ST Pay.

Example: With a collection fee rate of 2.5% and a received amount of 1000.37, the fee is 1000.37 × 2.5% = 25.00925, which is truncated to 25.00, and the settlement amount is 975.37.

Next
Duplicate requests and confirming results