> For the complete documentation index, see [llms.txt](https://docs.pagsmile.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pagsmile.com/reference/payin/api-code.md).

# API Code

{% hint style="info" %}

## All API codes listed on this page are returned with HTTP status code \`200\`. The \`Code\`, \`Message\`, \`SubCode\`, and \`SubMessage\` fields indicate the business result returned in the response body.

{% endhint %}

## Success

<table><thead><tr><th width="156.33333333333331">Code(String)</th><th width="157">Message(String)</th><th>SubCode(String)</th><th>SubMessage(String)</th><th>Description/ How to solve</th></tr></thead><tbody><tr><td>10000</td><td>Success</td><td></td><td></td><td></td></tr></tbody></table>

## Failed

### **General Error Code (Part 1)**

{% hint style="danger" %}
If you received the below errors, you can assume the transaction has **failed**. The transaction is created, but the status is **REFUSED**.
{% endhint %}

<table><thead><tr><th width="139">Code(String)</th><th width="167.666748046875">Message(String)</th><th width="204">SubCode(String)</th><th>SubMessage(String)</th></tr></thead><tbody><tr><td>30000</td><td>Account Error</td><td>invalid-account</td><td>Invalid account</td></tr><tr><td>30000</td><td>Account Error</td><td>disabled-account</td><td>Account disabled</td></tr><tr><td>30000</td><td>Account Error</td><td>invalid-account-type</td><td>Invalid account type</td></tr><tr><td>30000</td><td>Account Error</td><td>incorrect-credentials</td><td>The credentials are incorrect</td></tr><tr><td>30000</td><td>Account Error</td><td>incorrect-apikey</td><td>Incorrect API Key</td></tr><tr><td>30001</td><td>Input data errors</td><td>dublicate-data</td><td>Dublicate data</td></tr><tr><td>30001</td><td>Input data errors</td><td>dublicate-order</td><td>Dublicate order</td></tr><tr><td>30001</td><td>Input data errors</td><td>invalid-user</td><td>Invalid User</td></tr><tr><td>30001</td><td>Input data errors</td><td>invalid-amount</td><td>Invalid Amount</td></tr><tr><td>30001</td><td>Input data errors</td><td>amount-range-error</td><td>Amount range error</td></tr><tr><td>30001</td><td>Input data errors</td><td>exceed-amount-limit</td><td>Exceeding bank allowed amount limit</td></tr><tr><td>30001</td><td>Input data errors</td><td>parameters-error</td><td>Input parameters incorrect</td></tr><tr><td>30003</td><td>System error</td><td>Other-reason</td><td>Unknown Reason</td></tr><tr><td>30004</td><td>Processing error</td><td>invalid-payment-type</td><td>Invalid payment type</td></tr><tr><td>30004</td><td>Processing error</td><td>invalid-bank-error</td><td>Invalid bank error</td></tr><tr><td>30004</td><td>Processing error</td><td>mandatory-data</td><td>The data is mandatory</td></tr><tr><td>30004</td><td>Processing error</td><td>processing-error</td><td>Unknown processing error</td></tr><tr><td>30004</td><td>Processing error</td><td>insufficient-balance</td><td>Insufficient balance</td></tr><tr><td>30004</td><td>Processing error</td><td>invalid-transaction</td><td>Invalid transaction</td></tr><tr><td>30004</td><td>Processing error</td><td>browser-error</td><td>browser not support</td></tr></tbody></table>

### **General Error Code (Part 2)**

{% hint style="danger" %}
If you received the below errors, you can assume the transaction has **failed**. This transaction has not been created on our side.
{% endhint %}

<table><thead><tr><th width="139">Code(String)</th><th width="167">Message(String)</th><th width="248">SubCode(String)</th><th width="292">SubMessage(String)</th><th width="332">Description</th></tr></thead><tbody><tr><td>20000</td><td>Service Currently Unavailable</td><td></td><td></td><td>Temporary issue. Check with Pagsmile if keep receiving this error</td></tr><tr><td>40001</td><td>Missing Required Arguments</td><td></td><td></td><td>Check if all required parameters are included</td></tr><tr><td>40002</td><td>Business Failed</td><td>gen-card-token-fail</td><td>Gen card token fail</td><td></td></tr><tr><td>40002</td><td>Business Failed</td><td>card-token-expired</td><td>Card token expired</td><td></td></tr><tr><td>40002</td><td>Business Failed</td><td>missing-signature-config</td><td>Signature configuration missing</td><td>Check Authorization in header, or check if the request API URL is correct.</td></tr><tr><td>40002</td><td>Business Failed</td><td>merchant-status-abnormal</td><td>Merchant is now invalid</td><td>Contact Pagsmile to enable the account</td></tr><tr><td>40002</td><td>Business Failed</td><td>app-status-abnormal</td><td>App is invalid</td><td>Contact Pagsmile to enable the app</td></tr><tr><td>40002</td><td>Business Failed</td><td>app-not-match</td><td>App not match</td><td>The app_id in Authorization doesn't match with the app_id in the request</td></tr><tr><td>40002</td><td>Business Failed</td><td>invalid-signature</td><td>Signature is invalid</td><td>check the signature in Authorization</td></tr><tr><td>40002</td><td>Business Failed</td><td>no-method-supported</td><td>Method not supported</td><td>Check parameter "method"</td></tr><tr><td>40002</td><td>Business Failed</td><td>currency-not-supported</td><td>Currency not supported</td><td>Check parameter "method"</td></tr><tr><td>40002</td><td>Business Failed</td><td>duplicate-out_trade_no</td><td>out_trade_no is duplicate</td><td>out_trade_no should be unique for each transaction</td></tr><tr><td>40002</td><td>Business Failed</td><td>bank-side-busy</td><td>Bank side busy</td><td></td></tr><tr><td>40002</td><td>Business Failed</td><td>SYS-0001</td><td>other reason</td><td></td></tr><tr><td>40002</td><td>Business Failed</td><td>minimum-amount-exceeded</td><td>Minimum amount (include fees) exceeded</td><td></td></tr><tr><td>40002</td><td>Business Failed</td><td>maximum-amount-exceeded</td><td>Maximum amount (include fees) exceeded</td><td></td></tr><tr><td>40004</td><td>Method not supported</td><td></td><td></td><td>Check parameter "method"</td></tr><tr><td>40005</td><td>MediaType not supported</td><td></td><td></td><td>Check "Content-Type" in the header</td></tr></tbody></table>

### **General Error Code (Part 3)**

{% hint style="danger" %}
If you received the below errors, you can assume the transaction has **failed**. The transaction is created, but the status is **REFUSED**, due to AML restrictions.
{% endhint %}

<table><thead><tr><th width="134.33333333333331">Code(String)</th><th width="182">Message(String)</th><th width="198">SubCode(String)</th><th width="268">SubMessage(String)</th><th width="266">Description</th></tr></thead><tbody><tr><td>70001</td><td>Reject by high risk</td><td>10001</td><td>Verify Failed</td><td>User document id not exist</td></tr><tr><td>70001</td><td>Reject by high risk</td><td>10002</td><td>Document Fail</td><td>User's KYC failed</td></tr><tr><td>70001</td><td>Reject by high risk</td><td>10003</td><td>Legal Purpose</td><td>Legal risks</td></tr><tr><td>70001</td><td>Reject by high risk</td><td>10004</td><td>Fraud Suspect</td><td></td></tr><tr><td>70001</td><td>Reject by high risk</td><td>20001</td><td>Exceed Total Transaction Limit</td><td>User exceeds regulated total transaction amount</td></tr><tr><td>70001</td><td>Reject by high risk</td><td>20002</td><td>Exceed Total Frequency Limit</td><td>User exceeds regulated transaction frequency</td></tr><tr><td>70001</td><td>Reject by high risk</td><td>20003</td><td>Exceed Single Limit</td><td>User exceeds regulated single transaction amount</td></tr></tbody></table>

### **General Error Code (Part 4)**

{% hint style="danger" %}
If you received the below errors, you can assume the transaction has **failed**. The transaction is created, but the status is **REFUSED**, due to issues or block on the provider side.
{% endhint %}

| Code(String) | Message(String)   | SubCode(String) | SubMessage(String)                                            | Description         |
| ------------ | ----------------- | --------------- | ------------------------------------------------------------- | ------------------- |
| 90001        | Bank Request Fail | 71012           | Invalid ID Number                                             | Only for PIX        |
| 90001        | Bank Request Fail | 71013           | Payer's bank is not authorized                                | Only for PIX        |
| 90001        | Bank Request Fail | 101             | Invalid authorization                                         | Only for CreditCard |
| 90001        | Bank Request Fail | 102             | Invalid card number                                           | Only for CreditCard |
| 90001        | Bank Request Fail | 103             | Invalid cvv                                                   | Only for CreditCard |
| 90001        | Bank Request Fail | 104             | Invalid amount                                                |                     |
| 90001        | Bank Request Fail | 105             | SCA required                                                  | Only for CreditCard |
| 90001        | Bank Request Fail | 106             | Expired card                                                  | Only for CreditCard |
| 90001        | Bank Request Fail | 107             | Credit exceeded                                               | Only for CreditCard |
| 90001        | Bank Request Fail | 108             | Invalid issuer                                                | Only for CreditCard |
| 90001        | Bank Request Fail | 109             | Suspicion of fraud                                            |                     |
| 90001        | Bank Request Fail | 110             | Restricted card                                               | Only for CreditCard |
| 90001        | Bank Request Fail | 111             | Transaction not permitted to issuer                           | Only for CreditCard |
| 90001        | Bank Request Fail | 112             | Transaction not permitted to acquirer                         | Only for CreditCard |
| 90001        | Bank Request Fail | 113             | Invalid transaction                                           |                     |
| 90001        | Bank Request Fail | 114             | Lost card                                                     | Only for CreditCard |
| 90001        | Bank Request Fail | 115             | Stolen card                                                   | Only for CreditCard |
| 90001        | Bank Request Fail | 116             | Insufficient funds                                            |                     |
| 90001        | Bank Request Fail | 117             | Do not honor                                                  |                     |
| 90001        | Bank Request Fail | 118             | Contact issuer                                                | Only for CreditCard |
| 90001        | Bank Request Fail | 119             | Duplicate transaction                                         |                     |
| 90001        | Bank Request Fail | 120             | Transaction not permitted to cardholder                       | Only for CreditCard |
| 90001        | Bank Request Fail | 121             | Exceeded refund limit                                         |                     |
| 90001        | Bank Request Fail | 122             | Invalid cardholder name                                       | Only for CreditCard |
| 90001        | Bank Request Fail | 123             | Invalid expiration date                                       | Only for CreditCard |
| 90001        | Bank Request Fail | 124             | Transaction not permitted to terminal                         |                     |
| 90001        | Bank Request Fail | 125             | Card not activated                                            | Only for CreditCard |
| 90001        | Bank Request Fail | 126             | Installment not supported                                     |                     |
| 90001        | Bank Request Fail | 127             | Invalid number of installments                                | Only for CreditCard |
| 90001        | Bank Request Fail | 128             | Daily frequency limit exceeded                                | Only for CreditCard |
| 90001        | Bank Request Fail | 129             | Daily amount limit exceeded                                   | Only for CreditCard |
| 90001        | Bank Request Fail | 130             | Monthly frequency limit exceeded                              | Only for CreditCard |
| 90001        | Bank Request Fail | 131             | Monthly amount limit exceeded                                 | Only for CreditCard |
| 90001        | Bank Request Fail | 132             | Exceeds frequency limit                                       | Only for CreditCard |
| 90001        | Bank Request Fail | 133             | Exceeds amount limit                                          | Only for CreditCard |
| 90001        | Bank Request Fail | 134             | Invalid Country code                                          |                     |
| 90001        | Bank Request Fail | 135             | Invalid Currency                                              |                     |
| 90001        | Bank Request Fail | 136             | Invalid Payment Method                                        |                     |
| 90001        | Bank Request Fail | 137             | Transaction not permitted to merchant                         |                     |
| 90001        | Bank Request Fail | 138             | Invalid Billing Information                                   |                     |
| 90001        | Bank Request Fail | 139             | Invalid Shipping Information                                  |                     |
| 90001        | Bank Request Fail | 140             | Cancelled Card                                                |                     |
| 90001        | Bank Request Fail | 141             | Too many attempts                                             |                     |
| 90001        | Bank Request Fail | 142             | Transaction not permitted to card                             |                     |
| 90001        | Bank Request Fail | 143             | Invalid document ID                                           |                     |
| 90001        | Bank Request Fail | 144             | Amount below minimum limit                                    |                     |
| 90001        | Bank Request Fail | 190             | Not allowed for unknown reason                                |                     |
| 90001        | Bank Request Fail | 201             | Validation error                                              |                     |
| 90001        | Bank Request Fail | 202             | Invalid request data                                          |                     |
| 90001        | Bank Request Fail | 203             | Invalid card data                                             | Only for CreditCard |
| 90001        | Bank Request Fail | 204             | Duplicate request                                             |                     |
| 90001        | Bank Request Fail | 205             | Card brand not supported                                      | Only for CreditCard |
| 90001        | Bank Request Fail | 206             | ID cannot be empty or invalid                                 |                     |
| 90001        | Bank Request Fail | 207             | Name cannot be empty or invalid                               |                     |
| 90001        | Bank Request Fail | 208             | Address verification failed                                   |                     |
| 90001        | Bank Request Fail | 209             | Payer declined the order                                      |                     |
| 90001        | Bank Request Fail | 210             | Payer account locked or closed                                |                     |
| 90001        | Bank Request Fail | 211             | Payer account restricted                                      |                     |
| 90001        | Bank Request Fail | 212             | PIN error                                                     |                     |
| 90001        | Bank Request Fail | 213             | Declined due to 3DS failed                                    | Only for CreditCard |
| 90001        | Bank Request Fail | 214             | Invalid merchant                                              |                     |
| 90001        | Bank Request Fail | 215             | Invalid response                                              |                     |
| 90001        | Bank Request Fail | 216             | 3DS authentication incomplete                                 |                     |
| 90001        | Bank Request Fail | 217             | Missing address information                                   |                     |
| 90001        | Bank Request Fail | 218             | Account disabled                                              |                     |
| 90001        | Bank Request Fail | 219             | Invalid account                                               |                     |
| 90001        | Bank Request Fail | 220             | Browser not support                                           |                     |
| 90001        | Bank Request Fail | 221             | Card BIN not support                                          |                     |
| 90001        | Bank Request Fail | 222             | Parameter missing                                             |                     |
| 90001        | Bank Request Fail | 223             | Security violation                                            |                     |
| 90001        | Bank Request Fail | 224             | Missing necessary information                                 |                     |
| 90001        | Bank Request Fail | 225             | Transaction declined by the bank, please use a different card |                     |
| 90001        | Bank Request Fail | 226             | Invalid Card                                                  |                     |
| 90001        | Bank Request Fail | 300             | Order expired                                                 |                     |
| 90001        | Bank Request Fail | 401             | Provider internal error                                       |                     |
| 90001        | Bank Request Fail | 402             | Connection error                                              |                     |
| 90001        | Bank Request Fail | 403             | Authentication error                                          |                     |
| 90001        | Bank Request Fail | 404             | Provider Request Timeout                                      |                     |
| 90001        | Bank Request Fail | 405             | Insufficient balance                                          |                     |
| 90001        | Bank Request Fail | 406             | Amount range error                                            |                     |
| 90001        | Bank Request Fail | 407             | Invalid card number                                           | Only for CreditCard |