Payments
Payment statuses
VenPays exposes simplified statuses on the merchant status API, plus richer engine statuses used during checkout.
Merchant API statuses
Returned by POST /merchant/payment-status and POST /merchant/payment-status-by-track-id:
| Status | Meaning |
|---|---|
success | Captured / completed |
failed | Failed or error |
pending | Not terminal yet |
not_found | No transaction (authenticated status path may 404 instead) |
Mapping: engine success → success; failed/error → failed; everything else → pending.
Engine statuses
| Status | Typical meaning |
|---|---|
success | Completed |
pending_merchant | Awaiting next merchant/engine step |
pending_user | Customer on checkout |
redirecting | Mid-redirect / callback |
failed | Declined / failed |
error | System / initiation error |
cancelled | Cancelled |
refunded | Fully refunded |
partial_refund | Partially refunded |
Native Apple Pay SDK statuses
pending · processing · succeeded · failed · cancelled (+ SDK-level unknown when recovery is exhausted)
Refund statuses
success · pending · failed · error