# API Code

## 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.&#x20;
{% 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 |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.pagsmile.com/payin/api-code.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.