This table provides detailed interpretations of the return codes that may appear in the ret_code parameter of Pockyt API responses.

Return CodeDetailed Meaning
000000Indicates an error within Pockyt's system. Contact solutions@pockyt.io for more information.
000010The API version specified in the request is incorrect or not supported.
000020A required parameter in the API request is missing.
000021The provided parameter does not correspond to any relevant information in the system.
000022There's a mismatch between provided parameters, suggesting an inconsistency in the request.
000023The value assigned to one or more parameters is incorrect or in an invalid format.
000030The request was denied due to lack of proper access rights or permissions.
000040There's an issue with the status of the transaction being processed.
000080An error occurred within the system of an external supplier or partner involved in the transaction.
000100The API call was successful and the transaction or request was processed correctly.

During the integration process with Pockyt's APIs, developers may encounter various errors. Common errors are below:

  1. Incorrect Base URL or Path: the base URL is not correctly set to the sandbox environment during testing phases, or the path specified in the URL is incorrect.

  2. Missing Required Fields: not all the mandatory fields are included in the API request or requests are sent with empty values.

  3. Duplicate Reference Numbers in Pay-Ins: For Pay-Ins, submitting duplicate reference numbers can lead to errors. Each transaction should have a unique reference number.

  4. Improper Formatting in Payouts: For Payouts, errors can occur due to improperly formatted fields, particularly date and time fields. It's important to adhere to the expected format standards for these fields to ensure correct data interpretation.

  5. Verification Signature (verifySign) Errors: Errors in calculating the verifySign value are a common source of issues. The verifySign parameter must be accurately calculated as it plays a crucial role in authenticating and securing API calls..

Common Errors

Data Error: verifySign

CauseFix
Incorrect MD5 signature encryption.Refer to the documentation for proper signature configuration.
Passing null parametersVerify the correct parameter values as per documentation.

Data Error: Timestamp

CauseFix
Incorrect timestamp format.Follow the standard timestamp format in the documentation. correct format should be "yyyy-mm-ddTHH:MM:SSZ"

Supplier Failed: Invalid Routing Number

CauseFix
Incorrect bank account parameters.Provide a valid value or remove the field from the request.

Supplier Failed: Unknown Error Code

CauseFix
Fatal error encountered.Review request details for missing or invalid data.

Cannot Find Related Data

CauseFix
Missing credentials like customerNo, transactionNo, or reference for specific workflows.Ensure credentials are saved correctly and passed as needed.

Data Error: Payment Method Not Supported

CauseFix
Check "vendor": "" ConfigurationRead the documentation for finding the valid options. The possible payment channels are "alipay", "wechatpay", "paypal", "venmo", "unionpay", "creditcard" "truemoney", "alipay_hk", "tng", "gcash", "dana", "kakaopay", "bkash", "easypaisa","cashapppay"

Transaction and Reference error

CauseFix
Using both TransactionNo and reference in the request bodyJust choose one of the two.

System error

CauseFix
Invalid parameter values, e.g., using a different profileType than the default INDIVIDUAL.Verify the correct parameter values as per documentation.