Payment
HTTP 201
| Status | Reason | Message | Action |
|---|---|---|---|
| AUTHORIZED | – | Transaction approved | – |
| PARTIAL_AUTHORIZED | – | Partial amount approved | – |
| AUTHORIZED_PENDING_REVIEW | AVS_FAILED | Approved; failed AVS | Review |
| AUTHORIZED_PENDING_REVIEW | CONTACT_PROCESSOR | Approved; contact bank | Obtain auth code |
| DECLINED | EXPIRED_CARD | Card expired | Update payment method |
| DECLINED | INSUFFICIENT_FUND | Insufficient funds | Use different payment |
| AUTHORIZED_RISK_DECLINED | SCORE_EXCEEDS_THRESHOLD | Declined by fraud rules | Retry |
| PENDING_AUTHENTICATION | AUTHENTICATION_REQUIRED | Authentication required | Authenticate & retry |
HTTP 400
| Status | Reason | Message | Action |
|---|---|---|---|
| INVALID_REQUEST | MISSING_FIELD | Missing required fields | Correct and resend |
| INVALID_REQUEST | INVALID_DATA | Invalid data provided | Correct and resend |
| INVALID_REQUEST | DUPLICATE_REQUEST | Duplicate request | Use unique reference |
| INVALID_REQUEST | CARD_TYPE_NOT_ACCEPTED | Card type not accepted | Contact bank |
| INVALID_REQUEST | PROCESSOR_UNAVAILABLE | Processor failure | Retry later |
| INVALID_REQUEST | INVALID_AMOUNT | Amount mismatch | Correct and resend |
| INVALID_REQUEST | INVALID_CARD_TYPE | Invalid card type/mismatch | Correct and resend |
HTTP 502
| Status | Reason | Message | Action |
|---|---|---|---|
| SERVER_ERROR | SYSTEM_ERROR | System failure | Check SDK docs |
| SERVER_ERROR | SERVER_TIMEOUT | Server timeout | Review in EBC |
| SERVER_ERROR | SERVICE_TIMEOUT | Service timeout | Review in EBC |
| SERVER_ERROR | INVALID_OR_MISSING_CONFIG | Config error | Contact support |
Capture
HTTP 201
| Status | Reason | Message | Action |
|---|---|---|---|
| PENDING | – | Successful transaction | – |
| INVALID_REQUEST | INVALID_MERCHANT_CONFIGURATION | Configuration error | Contact support |
| SERVER_ERROR | PROCESSOR_TIMEOUT | Processor timeout | Review in EBC |
HTTP 400
| Status | Reason | Message | Action |
|---|---|---|---|
| INVALID_REQUEST | MISSING_FIELD | Missing fields | Resend with correct fields |
| INVALID_REQUEST | INVALID_DATA | Invalid data | Resend with correct data |
| INVALID_REQUEST | DUPLICATE_REQUEST | Duplicate request | Use unique reference |
| INVALID_REQUEST | EXCEEDS_AUTH_AMOUNT | Exceeds authorized amount | New auth & capture |
| INVALID_REQUEST | AUTH_ALREADY_REVERSED | Authorization already reversed | No action |
| INVALID_REQUEST | TRANSACTION_ALREADY_SETTLED | Transaction already settled | No action |
| INVALID_REQUEST | INVALID_AMOUNT | Amount mismatch | Correct & resend |
| INVALID_REQUEST | INVALID_PAYMENT_ID | Invalid request ID | No action |
| INVALID_REQUEST | MISSING_AUTH | No matching authorization | Request new auth |
| INVALID_REQUEST | TRANSACTION_ALREADY_REVERSED_OR_SETTLED | Already reversed/settled | No action |
HTTP 502
| Status | Reason | Message | Action |
|---|---|---|---|
| SERVER_ERROR | SYSTEM_ERROR | System failure | Handle retries |
| SERVER_ERROR | SERVER_TIMEOUT | Server timeout | Review in EBC |
| SERVER_ERROR | SERVICE_TIMEOUT | Service timeout | Review in EBC |
| SERVER_ERROR | INVALID_OR_MISSING_CONFIG | Config error | Contact support |
Reversal
HTTP 201
| Status | Reason | Message | Action |
|---|---|---|---|
| REVERSED | – | Successful transaction | – |
| SERVER_ERROR | PROCESSOR_TIMEOUT | Processor timeout | Review in EBC |
HTTP 400
| Status | Reason | Message | Action |
|---|---|---|---|
| INVALID_REQUEST | MISSING_FIELD | Missing fields | Resend with correct fields |
| INVALID_REQUEST | INVALID_DATA | Invalid data | Resend with correct data |
| INVALID_REQUEST | DUPLICATE_REQUEST | Duplicate request | Use unique reference |
| INVALID_REQUEST | PROCESSOR_UNAVAILABLE | Processor failure | Retry later |
| INVALID_REQUEST | AUTH_ALREADY_REVERSED | Authorization already reversed | No action |
| INVALID_REQUEST | TRANSACTION_ALREADY_SETTLED | Already settled | No action |
| INVALID_REQUEST | INVALID_AMOUNT | Amount mismatch | Correct & resend |
| INVALID_REQUEST | INVALID_PAYMENT_ID | Invalid request ID | No action |
| INVALID_REQUEST | MISSING_AUTH | No matching authorization | Request new auth |
| INVALID_REQUEST | TRANSACTION_ALREADY_REVERSED_OR_SETTLED | Already reversed/settled | No action |
HTTP 502
| Status | Reason | Message | Action |
|---|---|---|---|
| SERVER_ERROR | SYSTEM_ERROR | System failure | Handle retries |
| SERVER_ERROR | SERVER_TIMEOUT | Server timeout | Review in EBC |
| SERVER_ERROR | SERVICE_TIMEOUT | Service timeout | Review in EBC |
| SERVER_ERROR | INVALID_OR_MISSING_CONFIG | Config error | Contact support |
Refund
HTTP 201
| Status | Reason | Message | Action |
|---|---|---|---|
| PENDING | – | Successful transaction | – |
| INVALID_REQUEST | INVALID_MERCHANT_CONFIGURATION | Configuration error | Contact support |
| SERVER_ERROR | PROCESSOR_TIMEOUT | Processor timeout | Review in EBC |
HTTP 400
| Status | Reason | Message | Action |
|---|---|---|---|
| INVALID_REQUEST | MISSING_FIELD | Missing fields | Resend with correct fields |
| INVALID_REQUEST | INVALID_DATA | Invalid data | Resend with correct data |
| INVALID_REQUEST | DUPLICATE_REQUEST | Duplicate request | Use unique reference |
| INVALID_REQUEST | INVALID_CARD | Invalid account number | Use different payment |
| INVALID_REQUEST | INVALID_AMOUNT | Amount mismatch | Correct & resend |
| INVALID_REQUEST | CAPTURE_ALREADY_VOIDED | Credit for voided capture | No action |
| INVALID_REQUEST | ACCOUNT_NOT_ALLOWED_CREDIT | Stand-alone credits not allowed | Use follow-on credit |
HTTP 502
| Status | Reason | Message | Action |
|---|---|---|---|
| SERVER_ERROR | SYSTEM_ERROR | System failure | Handle retries |
| SERVER_ERROR | SERVER_TIMEOUT | Server timeout | Review in EBC |
| SERVER_ERROR | SERVICE_TIMEOUT | Service timeout | Review in EBC |
| SERVER_ERROR | INVALID_OR_MISSING_CONFIG | Config error | Contact support |
Void
HTTP 201
| Status | Reason | Message | Action |
|---|---|---|---|
| VOIDED | – | Successful transaction | – |
| INVALID_REQUEST | INVALID_MERCHANT_CONFIGURATION | Configuration error | Contact support |
| SERVER_ERROR | PROCESSOR_TIMEOUT | Processor timeout | Review in EBC |
HTTP 400
| Status | Reason | Message | Action |
|---|---|---|---|
| INVALID_REQUEST | MISSING_FIELD | Missing fields | Resend with correct fields |
| INVALID_REQUEST | INVALID_DATA | Invalid data | Resend with correct data |
| INVALID_REQUEST | DUPLICATE_REQUEST | Duplicate request | Use unique reference |
| INVALID_REQUEST | INVALID_AMOUNT | Amount mismatch | Correct & resend |
| INVALID_REQUEST | NOT_VOIDABLE | Not voidable | No action |
HTTP 502
| Status | Reason | Message | Action |
|---|---|---|---|
| SERVER_ERROR | SYSTEM_ERROR | System failure | Handle retries |
| SERVER_ERROR | SERVER_TIMEOUT | Server timeout | Review in EBC |
| SERVER_ERROR | SERVICE_TIMEOUT | Service timeout | Review in EBC |
| SERVER_ERROR | INVALID_OR_MISSING_CONFIG | Config error | Contact support |
Validation Response
| Name | Reason | Scope | Default Message |
|---|---|---|---|
| INVALID_MERCHANT | AUTHENTICATION_FAILURE | Request/Auth | Merchant authentication failed. |
| INVALID_TRANSACTION | INVALID_REQUEST | Request | Invalid transaction/request. |
| INVALID_AMOUNT | INVALID_FIELD | Field | Invalid amount. |
| INVALID_CARD | INVALID_FIELD | Field | Invalid card or reference ID. |
| FORMAT_ERROR | INVALID_FIELD | Field | Request format error. |
| FIELD_TOO_SHORT | FIELD_TOO_SHORT | Field | Field value is too short. |
| FIELD_TOO_LONG | FIELD_TOO_LONG | Field | Field value is too long. |
| MISSING_REQUIRED_FIELD | MISSING_FIELD | Field | Required field is missing. |
| EXPIRED_CARD | VALUE_EXPIRED | Field | Value has expired. |
| ISSUER_INOPERATIVE | DECLINED | System | Issuer unavailable / declined. |
| ROUTING_ERROR | SYSTEM_ERROR | System | Routing / network error. |
| DUPLICATE_TRANSMISSION | INVALID_REQUEST | Request | Duplicate request detected. |
| RECONCILE_ERROR | SYSTEM_ERROR | System | Reconciliation error. |
| SYSTEM_MALFUNCTION | SYSTEM_ERROR | System | System malfunction. |