Reference
Error codes reference
HTTP (Payment Engine)
See API errors for status code meanings.
Native Apple Pay / iOS SDK
Switch on VenPaysError.code (not message text):
| Code | Typical meaning |
|---|---|
sessionExpired | Native token expired — re-initiate |
applePayUnsupported | Hide Apple Pay |
noSupportedCard | Prompt to add card |
invalidApplePayConfiguration | Merchant ID / networks |
presentationFailed | Sheet failed |
userCancelledBeforeAuthorization | User closed the sheet before any authorization — no charge |
networkRequestCancelled | In-flight request cancelled; may have reached VenPay — reconcile by track ID |
paymentCancelled | Deprecated — replaced by the two codes above |
invalidApplePayToken | Bad paymentData |
unauthorized | Invalid session |
processorDeclined | Declined |
processorUnavailable | Retry later |
requestTimeout | Reconcile by track ID |
networkUnavailable | Retry / recover |
paymentStatusUnknown | Reconcile by track ID |
Benefit issuer codes (selected)
| Code | Reason |
|---|---|
00 | Success |
51 | Insufficient funds |
54 / 33 | Expired card |
55 | Incorrect PIN |
91 | Issuer inoperative |
Surface customer-friendly messages; log the raw code server-side.