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:
| Status | Meaning |
|---|---|
pending_merchant | Awaiting next merchant/engine step |
pending_user | Customer on checkout |
redirecting | Mid-redirect / callback |
success | Captured / completed |
failed | Failed or declined |
error | System / initiation error |
cancelled | Shopper left checkout, or the payment was not completed within 30 minutes |
refunded | Fully refunded |
partial_refund | Partially refunded |
not_found | No transaction (authenticated status path may 404 instead) |
These values match the VenPay console. See Payment Status API — Detailed Transaction States.
Legacy: a bare pending value may still appear on older records; treat it as in-flight.
An in-progress card, Apple Pay, or Benefit payment that is still unpaid after 30 minutes becomes cancelled. See Payment lifecycle.
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 | Shopper left checkout, or unpaid for 30 minutes |
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