> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Indirect Pix error list > Indirect Pix returns consistent and structured error responses. This helps you quickly understand what went wrong and how to fix it. **Error format** ```jsonon JSON theme={null} { "code": "", "title": "", "message": "" } ``` **Field definitions** * **`code`** – A stable, unique identifier for the error. Useful for programmatic handling and support requests. * **`title`** – A short, human-readable summary of the issue. * **`message`** – Detailed guidance to help you resolve the error. This structure ensures you always get actionable feedback when something doesn’t go as expected. ## Indirect Pix errors *** The following errors can occur when interacting with the Indirect Pix endpoints. Each error follows our standard structure, making it easier to debug and respond to issues programmatically. ### Internal Server error | `code` | `title` | `message` | | -------- | --------------------- | ------------------------------------------------------------------- | | PIX-0000 | Internal Server Error | The server encountered an unexpected error. Please try again later. | ### Middleware errors | `code` | `title` | `message` | | -------- | ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | PIX-0001 | Missing Headers in Request | Your request is missing one or more required header params. Please refer to the documentation to ensure all necessary header params are included in your request. | | PIX-0002 | Invalid Header Value | One or more header values are invalid. Please refer to the documentation to verify the expected format and allowed values for each header. | | PIX-0003 | Missing Fields in Request | Your request is missing one or more required fields. Please refer to the documentation to ensure all necessary fields are included in your request. | | PIX-0004 | Invalid Field Values in Request | Your request contains one or more fields with invalid values. Please refer to the documentation to verify that all fields have the correct values. | | PIX-0005 | Invalid Field Type in Request | Your request contains one or more fields with an invalid data type. Please refer to the documentation to verify that all fields have the correct type. | | PIX-0006 | Unexpected Fields in Request | The request body contains more fields than expected. Please send only the allowed fields as per the documentation. | | PIX-0007 | Missing Path Parameters in Request | Your request is missing one or more required path parameters. Please refer to the documentation to ensure all necessary path parameters are included in your request. | | PIX-0008 | Invalid Path Parameter in Request | One or more path parameters are invalid. Please refer to the documentation to verify the expected format and allowed values for each path parameter. | | PIX-0009 | Missing Query Params in Request | Your request is missing one or more required query params. Please refer to the documentation to ensure all necessary query params are included in your request. | | PIX-0010 | Invalid Query Param in Request | One or more query params are invalid. Please refer to the documentation to verify the expected format and allowed values for each query param. | | PIX-0011 | Invalid Timestamp Format | The timestamp format is invalid. Please refer to the documentation to verify the expected format. | | PIX-0012 | Invalid Metadata | The metadata is invalid. Please refer to the documentation to verify the expected format. | | PIX-0013 | Limit Exceeded | The request exceeded the allowed limit. | ### DICT errors | `code` | `title` | `message` | | -------- | ----------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | | PIX-0101 | EVP Key Cannot Be Provided | EVP keys cannot be provided manually, they are automatically generated. | | PIX-0102 | Invalid Key Format | Invalid format for the specified keyType. | | PIX-0103 | Pix Key Already Exists | The Pix key is already registered. | | PIX-0105 | CPF Mismatch | CPF does not match holder document in CRM. | | PIX-0106 | CNPJ Mismatch | CNPJ does not match holder document in CRM. | | PIX-0107 | Pix Key Limit Exceeded for Holder | The key limit has been exceeded for the holder. | | PIX-0108 | Pix Key Limit Exceeded for Type | The key type limit has been exceeded. | | PIX-0109 | Invalid Opening Date | The opening date in CRM is invalid. Please provide a valid date in the 'yyyy-mm-dd' format. | | PIX-0110 | Pix Key Belongs to Another Holder | The Pix key is already registered to another holder. Please initiate an ownership claim to acquire this key. | | PIX-0111 | Pix Key Already Linked to Another Account | The Pix key is already linked to another account of the same holder. Please initiate a portability request to transfer this key. | | PIX-0112 | Entry Not Found | The entry was not found. | | PIX-0113 | Claim Not Found | The claim was not found. | | PIX-0114 | Key In Custody Account | The entry queried is in custody of the participant making the query. | | PIX-0115 | EVP Key Cannot Be Updated | EVP keys cannot be updated. | | PIX-0116 | Empty Keys Array | The keys array must not be empty. | | PIX-0117 | Keys Array Exceeded Limit | The keys array must not exceed 200 items. | | PIX-0118 | Key Claim Type Not Allowed | Only PHONE keys are allowed for ownership claims. | | PIX-0119 | Pix Key Already Claimed | You already have a claim in progress for this key. | | PIX-0120 | Key Does Not Exist | The Pix key does not exist in DICT. | | PIX-0121 | Pix Key Locked By Claim | The Pix key is currently locked by another claim process. | | PIX-0122 | EVP Key Cannot Be Claimed | EVP keys cannot be claimed. | | PIX-0123 | Key Already Belongs to Holder | The Pix key is already linked to the requesting holder. | | PIX-0124 | Cannot Claim Key | It is not possible to claim this key. | | PIX-0165 | Entry Inactive | The entry is not in active status. | ### Claim errors (confirm) | `code` | `title` | `message` | | -------- | ------------------------------- | ----------------------------------------------------------------------------------------------------------- | | PIX-0125 | Waiting Resolution Status | The claim must be in WAITING\_RESOLUTION status to execute the action. | | PIX-0126 | Must Be Donor Participant | The claim must be from the donor participant to confirm. | | PIX-0127 | Portability Cannot Be Confirmed | Portability claims cannot be confirmed with DEFAULT\_OPERATION reason. | | PIX-0128 | Ownership Cannot Be Confirmed | Ownership claims cannot be confirmed with DEFAULT\_OPERATION reason before the resolution period has ended. | ### Claim errors (cancel) | `code` | `title` | `message` | | -------- | ----------------------------------------- | --------------------------------------------------------------------------------------------------- | | PIX-0134 | Claim Cannot Be Cancelled | The claim cannot be cancelled in current status. | | PIX-0135 | Donor Cannot Cancel Open Claim | The donor participant cannot cancel a claim in OPEN status. | | PIX-0136 | Invalid Reason for Claimer | The claimer cannot cancel with the provided reason in this status. | | PIX-0137 | Invalid Reason for Donor | The donor cannot cancel with the provided reason in this status. | | PIX-0141 | Donor Cannot Cancel Confirmed Portability | The donor cannot cancel a confirmed portability claim. | | PIX-0142 | Resolution Period Not Ended | The resolution period has not ended yet for DEFAULT\_OPERATION cancellation. | | PIX-0143 | Ownership Cancel Period Not Ended | Ownership claims with DEFAULT\_OPERATION can only be cancelled after CompletionPeriodEnd + 16 days. | | PIX-0144 | Donor Cancel Period Expired | The donor can only cancel with FRAUD while CompletionPeriodEnd has not passed. | | PIX-0145 | Unknown Actor | The participant is neither the claimer nor the donor. | ### Claim errors (complete) | `code` | `title` | `message` | | -------- | ------------------------------------- | --------------------------------------------------------------------------------------------------------------------- | | PIX-0146 | Claim Not Confirmed | The claim must be in CONFIRMED status. | | PIX-0147 | Must Be Claimer Participant | Only the claimer participant can complete a claim. | | PIX-0148 | Ownership Completion Period Not Ended | Ownership claims can only be completed after the completion period has ended. | | PIX-0149 | Claim Not Acknowledgeable | The claim does not meet acknowledgement preconditions (must be OPEN status and caller must be the donor participant). | | PIX-0160 | Claim Already Completed | The claim has already been completed. | | PIX-0161 | Claim Is Cancelled | The claim has been cancelled and cannot be completed. | | PIX-0162 | Claim Cannot Be Completed | The claim cannot be completed in its current status. | | PIX-0163 | Completion Period Not Set | The completion period is not set for this claim. | | PIX-0164 | Completion Period Expired | The completion period has expired for this claim. | ### VSync / CID errors | `code` | `title` | `message` | | -------- | ------------------ | ------------------------------------------------------------------ | | PIX-0150 | CID File Not Found | The specified CID file was not found or is not ready for download. | | PIX-0151 | Invalid CID Format | The CID must be a 64-character lowercase hexadecimal string. | | PIX-0152 | CID Not Found | The specified CID was not found in DICT. | ### MED erros (infraction reports) | `code` | `title` | `message` | | -------- | ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | | PIX-0200 | Infraction Report Not Found | The infraction report was not found. | | PIX-0201 | Report Details Too Long | The report details exceed the maximum allowed length of 2000 characters. | | PIX-0202 | Invalid Email Format | The email format is invalid. | | PIX-0203 | Invalid Phone Format | The phone format is invalid. | | PIX-0204 | Duplicate Infraction Report | An infraction report already exists for this transaction. | | PIX-0205 | Invalid Transaction ID Format | The transaction ID format must match a E2E ID format. | | PIX-0206 | Infraction Report Cannot Be Cancelled | The infraction report cannot be cancelled in current status. | | PIX-0207 | Infraction Report Cannot Be Closed | The infraction report cannot be closed in current status. | | PIX-0208 | Infraction Fraud Type Required | The fraud type is required when analysis result is AGREED. | | PIX-0209 | Infraction Analysis Details Required | The analysis details are required when fraud type is OTHER. | | PIX-0210 | Infraction Analysis Details Too Long | The analysis details exceed the maximum allowed length of 2000 characters. | | PIX-0211 | Transaction Not Found | The specified transaction was not found. | | PIX-0212 | Transaction Too Old | The transaction occurred more than 80 days ago and cannot be reported. | | PIX-0213 | Unauthorized to Open Refund Request | A refund request infraction report can only be opened by the payer's PSP. | | PIX-0214 | Unauthorized to Open Cancellation Report | A cancellation of refund infraction report can only be opened by the payee's PSP. | | PIX-0215 | Invalid Transaction Type | The transaction is not a refund transaction. Cancellation of refund infractions can only be used for refund transactions (pacs.004). | | PIX-0216 | Unauthorized to Close Refund Request | A refund request infraction report must be closed by the payee's PSP. | | PIX-0217 | Unauthorized to Close Cancellation Report | A cancellation of refund infraction report must be closed by the payer's PSP. | | PIX-0218 | Cancellation Reason Too Long | The cancellation reason exceeds the maximum allowed length of 500 characters. | | PIX-0219 | Invalid ID Format | The ID must be a valid UUID format. | | PIX-0220 | Invalid Date Range Order | The modified\_before timestamp must be after modified\_after timestamp. | | PIX-0221 | Refund Transaction Too Old | The refund transaction occurred more than 30 days ago and cannot be reported for cancellation. | | PIX-0222 | Invalid Situation Type | Refund cancellation infraction reports must use situationType OTHER. | | PIX-0223 | Infraction Report Cannot Be Acknowledged | The infraction report cannot be acknowledged in current status. | ### MED errors (refund requests) | `code` | `title` | `message` | | -------- | --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | | PIX-0230 | Invalid Refund Amount Format | The refund amount must be in decimal format with exactly 2 decimal places (e.g., 100.50). | | PIX-0231 | Refund Details Too Long | The refund details exceed the maximum allowed length of 2000 characters. | | PIX-0232 | Refund Amount Exceeds Transaction | The refund amount cannot exceed the original transaction amount. | | PIX-0233 | Missing Refund Details | The refundDetails field is required when refundReason is OPERATIONAL\_FLAW. | | PIX-0234 | Refund Request Not Found | The specified refund request was not found. | | PIX-0235 | Missing Refund Transaction ID | The refund transaction ID is required when the refund is accepted (TOTALLY\_ACCEPTED or PARTIALLY\_ACCEPTED). | | PIX-0236 | Invalid Request Status | The request cannot be closed because it is already in CLOSED or CANCELLED status. | | PIX-0237 | Missing Rejection Reason | The refundRejectionReason is required when analysisResult is REJECTED. | | PIX-0238 | Missing Analysis Details | The analysisDetails field is required when analysisResult is REJECTED and refundRejectionReason is INVALID\_REQUEST. | | PIX-0239 | Cannot Cancel Request | The request cannot be cancelled because it is already in CLOSED or CANCELLED status. | | PIX-0240 | Missing Infraction Report | A refund request with reason FRAUD requires a prior infraction report that has been closed with AGREED result. | | PIX-0241 | Infraction Report Expired | The infraction report was closed more than 72 hours ago. Refund requests must be created within 72 hours of infraction report closure. | | PIX-0242 | Duplicate Refund Request | A refund request already exists for this transaction. | | PIX-0243 | Refund Request Already Closed | The refund request is already closed. | | PIX-0244 | Refund Request Already Cancelled | The refund request is already cancelled. | | PIX-0245 | Date Range Exceeds 90 Days | The date range between modifiedAfter and modifiedBefore cannot exceed 90 days. | ### MED errors (fraud markers) | `code` | `title` | `message` | | -------- | ---------------------- | ------------------------------------------------------------------------------- | | PIX-0260 | Invalid Tax ID Format | The taxIdNumber must be a valid CPF (11 digits) or CNPJ (14 digits) format. | | PIX-0261 | Invalid Key Format | The key must be between 8 and 32 characters. | | PIX-0262 | Fraud Marker Not Found | The specified fraud marker was not found. | | PIX-0263 | Cannot Cancel Marker | The fraud marker cannot be cancelled because it is already in CANCELLED status. | ### MED errors (statistics) | `code` | `title` | `message` | | -------- | ----------------- | ------------------------------------------------------------------------ | | PIX-0280 | Invalid Key Value | The key value is invalid or exceeds the maximum length of 77 characters. | ### QR Code errors | `code` | `title` | `message` | | -------- | ------------------------------ | ---------------------------------------------------------------------------------- | | PIX-0300 | Invalid EMV Format | The EMV payload does not follow the valid EMV QCO format specification. | | PIX-0301 | Corrupted QR Code | The QR Code data is corrupted and cannot be decoded. | | PIX-0302 | Unsupported QR Code Version | The QR Code version or format is not supported. | | PIX-0303 | Invalid Payment Date | The payment date exceeds the valid payment period. | | PIX-0304 | Invalid Amount | The amount must be greater than zero and follow the 0.00 format with two decimals. | | PIX-0305 | Invalid City | The city must contain only letters and spaces. | | PIX-0306 | Invalid TxID Format | The txId format is invalid. | | PIX-0307 | Receiver Key Required | The receiverKey is required. | | PIX-0309 | Invalid Category Code Format | The categoryCode must be numeric. | | PIX-0310 | Invalid Merchant Name | The merchant name is required. | | PIX-0311 | Receiver Key Not Found | The receiverKey was not found. | | PIX-0312 | Invalid Receiver Key | The receiverKey is invalid. | | PIX-0314 | EMV Required | The EMV is required. | | PIX-0315 | Empty EMV Payload | The EMV payload cannot be empty. | | PIX-0316 | EMV Not Found | The EMV QR Code was not found. | | PIX-0317 | Invalid City Code | The city code is invalid. | | PIX-0318 | BR Code Not Found | The requested BR Code was not found. | | PIX-0319 | Receiver Key Not Associated | The receiver key is not associated with the account. | | PIX-0320 | Invalid Merchant Name | The merchant name is required. | | PIX-0321 | Invalid Merchant City | The merchant city must contain only letters and spaces. | | PIX-0322 | Invalid Merchant Category Code | The merchant category code must be numeric. | | PIX-0324 | Invalid Amount Value | The amount is not a valid decimal. | | PIX-0327 | Invalid Client Request ID | The client request ID must be a valid UUID. | | PIX-0328 | Invalid Image Type | The image type must be one of: Gif, Jpeg, Png. | | PIX-0329 | Invalid Pixels Per Module | The pixels per module value is out of bounds. | | PIX-0330 | Service Unavailable | The decode service is temporarily unavailable. | ### Transfers errors | `code` | `title` | `message` | | -------- | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------- | | PIX-0400 | Description Too Long | The description field exceeds the maximum allowed length of 140 characters. | | PIX-0401 | Description Contains HTML | The description contains invalid HTML characters. | | PIX-0402 | Invalid Amount Format | The amount must be in format 0.00 with exactly 2 decimal places (1-10 digits before decimal). | | PIX-0403 | Amount Must Be Positive | The amount must be greater than zero. | | PIX-0404 | Invalid UUID Format | The UUID format is invalid. | | PIX-0405 | Invalid End-to-End ID Format | The end-to-end ID format is invalid. | | PIX-0406 | Intra PSP Not Supported | INTRA PSP transfers (same participant) are not supported. The destination bank ISPB cannot be the same as the source PSP. | | PIX-0407 | Transfer Account Mismatch | The transfer does not belong to the specified account. | ### Initiation errors | `code` | `title` | `message` | | -------- | ------------------------ | ------------------------------------------------------ | | PIX-0410 | Initiation Not Found | The payment initiation was not found. | | PIX-0411 | Initiation Expired | The payment initiation has expired. | | PIX-0412 | Initiation Already Used | The payment initiation has already been processed. | | PIX-0413 | Initiation Invalid State | The payment initiation is in an invalid state. | | PIX-0414 | Destination Required | Destination is required for MANUAL initiation type. | | PIX-0415 | Invalid Initiation Type | The initiation type is invalid. | | PIX-0416 | Key Required | Key is required for KEY initiation type. | | PIX-0417 | EMV Required | EMV is required for QR\_CODE initiation type. | | PIX-0418 | Invalid Destination | The destination is invalid for MANUAL initiation type. | ### Cashout errors | `code` | `title` | `message` | | -------- | ----------------------- | -------------------------------------------------------- | | PIX-0420 | Cashout Not Found | The cashout transaction was not found. | | PIX-0421 | Insufficient Balance | Insufficient balance to complete the transaction. | | PIX-0422 | Amount Mismatch | The amount does not match the fixed amount from QR code. | | PIX-0423 | Duplicate End-to-End ID | A transaction with this end-to-end ID already exists. | | PIX-0424 | Invalid Amount Value | The amount must be greater than zero. | | PIX-0425 | Cashin Not Found | The cashin transaction was not found. | | PIX-0426 | Transfer Not Found | The transfer was not found. | | PIX-0427 | Refund Not Found | The refund was not found. | | PIX-0428 | Duplicate Refund | A refund already exists for this transaction. | ### Account errors | `code` | `title` | `message` | | -------- | ----------------- | ------------------------------------------------------- | | PIX-0430 | Account Not Found | The account was not found in ledger. | | PIX-0431 | Account Blocked | The account is blocked and cannot perform transactions. | ### Refund errors | `code` | `title` | `message` | | -------- | ------------------------------ | ------------------------------------------------------------------ | | PIX-0440 | Original Transfer Not Cashin | Only cashin transfers can be refunded with cashout refunds. | | PIX-0441 | Original Transfer Not Complete | Only completed transactions can be refunded. | | PIX-0442 | Refund Exceeds Original | The refund amount exceeds the original transaction amount. | | PIX-0443 | Invalid Refund Reason | The refund reason code is invalid. | | PIX-0444 | Refund Exceeds Net Amount | The partial refund amount exceeds net amount available after fees. | | PIX-0445 | Invalid Transaction Status | Only completed transactions can be refunded. | ### Destination validation errors | `code` | `title` | `message` | | -------- | -------------------------------- | ----------------------------------------------------------------------------------------------- | | PIX-0450 | Destination Bank Required | The destination bank is required. | | PIX-0451 | Destination Bank Invalid | The destination bank must be 8 digits. | | PIX-0452 | Destination Branch Required | The destination branch is required. | | PIX-0453 | Destination Account Required | The destination account is required. | | PIX-0454 | Destination Account Type Invalid | The destination account type is invalid. | | PIX-0455 | Destination Document Required | The destination document is required. | | PIX-0456 | Destination Document Invalid | The destination document is invalid: must be CPF (11 digits) or CNPJ (14 digits). | | PIX-0457 | Destination Name Required | The destination name is required. | | PIX-0458 | Destination Person Type Invalid | The destination person type is invalid. | | PIX-0459 | Destination Person Type Mismatch | Person type does not match document: CPF requires NATURAL\_PERSON, CNPJ requires LEGAL\_PERSON. | ### Status transition errors | `code` | `title` | `message` | | -------- | ------------------------- | ----------------------------------------------- | | PIX-0470 | Invalid Status Transition | The status transition is invalid. | | PIX-0471 | Transfer Already Terminal | The transaction is already in a terminal state. | | PIX-0472 | Cannot Cancel | Cannot cancel transaction in current status. | | PIX-0473 | Already Terminal | The operation is already in a terminal state. | ### Integration errors (CRM) | `code` | `title` | `message` | | -------- | ----------------------------- | --------------------------------------------------------------------------------------- | | PIX-0500 | CRM Connection Error | Failed to connect to CRM service. | | PIX-0501 | CRM Authentication Error | Failed to authenticate with CRM service. | | PIX-0502 | Account Not Found in CRM | The account was not found in CRM for the given criteria. | | PIX-0503 | Holder Not Found in CRM | The holder was not found in CRM. | | PIX-0504 | Invalid Branch in CRM | The branch returned by CRM is invalid. Expected exactly 4 digits. | | PIX-0505 | Invalid Account Number in CRM | The account number returned by CRM is invalid. Expected 1-20 digits. | | PIX-0506 | Invalid Document in CRM | The document (CPF/CNPJ) returned by CRM is invalid. | | PIX-0507 | Invalid Name in CRM | The name returned by CRM is invalid or exceeds 120 characters. | | PIX-0508 | Invalid Trade Name in CRM | The trade name returned by CRM is invalid or exceeds 100 characters. | | PIX-0509 | Invalid Opening Date in CRM | The opening date returned by CRM is invalid. Expected format: yyyy-mm-dd. | | PIX-0510 | Invalid Account Type in CRM | The account type returned by CRM is invalid. Expected: CACC, SLRY, SVGS, TRAN, or OTHR. | | PIX-0599 | CRM Bad Request | CRM returned a bad request error. | ### Integration errors (Midaz) | `code` | `title` | `message` | | -------- | ------------------------ | ------------------------------------------------------- | | PIX-0600 | Midaz Insufficient Funds | Insufficient funds in the source account. | | PIX-0601 | Midaz Account Blocked | The account is blocked and cannot perform transactions. | | PIX-0602 | Midaz Connection Error | Failed to connect to Midaz. | ### Integration errors (Fee Service) | `code` | `title` | `message` | | -------- | ---------------------------- | --------------------------------- | | PIX-0650 | Fee Service Connection Error | Failed to connect to Fee service. | ### Collection errors | `code` | `title` | `message` | | -------- | ------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------- | | PIX-0700 | Collection Not Found | The collection was not found. | | PIX-0701 | Duplicate Collection TxID | A collection with this txId already exists for the receiver. | | PIX-0702 | Collection Already Deleted | The collection has already been deleted. | | PIX-0703 | Invalid Collection Type | The collection type is invalid. | | PIX-0704 | Invalid Collection Status | The collection status is invalid or does not allow this operation. | | PIX-0705 | Invalid Collection Amount | The collection amount is invalid. | | PIX-0706 | Invalid Collection Expiration / Receiver Key Not Owned | The collection expiration is invalid / The receiver key is not associated with the account. | | PIX-0707 | Invalid Due Date / Invalid Debtor | The due date is invalid / The debtor information is invalid. | | PIX-0708 | Expiration Too Long / Collection Has No Provider ID | The expiration exceeds the maximum allowed: 30 days (2,592,000 seconds) / The collection has no pactual ID. | | PIX-0709 | Invalid TxID / Invalid Delete Reason | The txID is invalid or cannot be empty / The delete reason must be DELETED\_BY\_USER or DELETED\_BY\_PSP. | | PIX-0710 | Invalid Receiver Document | The receiver document is invalid or cannot be empty. | | PIX-0711 | Invalid Receiver Name | The receiver name is invalid or cannot be empty. | | PIX-0712 | Invalid Receiver Address | The receiver address is required. | | PIX-0713 | Invalid Debtor Name | The debtor name is invalid or cannot be empty. | | PIX-0714 | Invalid CPF Format | The CPF format is invalid: must be exactly 11 digits. | | PIX-0715 | Invalid CNPJ Format | The CNPJ format is invalid: must be exactly 14 digits. | | PIX-0716 | Invalid Account ID | The account ID is invalid or cannot be empty. | | PIX-0717 | Invalid Pactual ID | The pactual ID is invalid or cannot be empty. | | PIX-0718 | Invalid Location ID | The location ID is invalid or cannot be empty. | | PIX-0719 | Invalid Fine | The fine configuration is incomplete: both type and value must be provided. | | PIX-0720 | Invalid Interest | The interest configuration is incomplete: both type and value must be provided. | | PIX-0721 | Invalid Discount | The discount configuration is incomplete: type, value and days before due must be provided. | | PIX-0722 | Invalid Abatement | The abatement configuration is incomplete: both type and value must be provided. | | PIX-0723 | Too Many Additional Info | The number of additional info items exceeds the maximum allowed: 50. | | PIX-0724 | Pix Troco Amount Mismatch | Pix Troco transaction amount must equal original amount. | | PIX-0725 | Invalid Pix Saque Configuration | Pix Saque cannot have transaction amount, only withdrawal amount. | | PIX-0726 | Collection Update Not Allowed | Updates are not allowed for this collection. | | PIX-0727 | Debtor Document Mismatch | The payment debtor document does not match the collection debtor. | | PIX-0728 | Type Mismatch | The payment type does not match the collection type. | | PIX-0729 | Collection Amount Mismatch | The payment amount does not match the collection amount. | ### Provider errors (BTG) | `code` | `title` | `message` | | -------- | ----------------------------- | -------------------------------------------------- | | PIX-1000 | Provider Connection Error | Failed to connect to provider. | | PIX-1001 | Provider Authentication Error | Failed to authenticate with provider. | | PIX-1002 | Provider Request Timeout | Provider request timed out. | | PIX-1003 | Rate Limit Exceeded | Rate limit exceeded. Please try again later. | | PIX-1004 | Provider Service Unavailable | Provider service is temporarily unavailable. | | PIX-1005 | Key Not Found | The Pix key was not found. | | PIX-1006 | Key Already Exists | The Pix key already exists. | | PIX-1007 | Provider Internal Error | Provider returned an internal error. | | PIX-1008 | Provider Invalid Response | Provider returned an invalid response. | | PIX-1009 | Provider Bad Request | Provider rejected the request due to invalid data. | | PIX-1010 | Provider Unprocessable | Provider cannot process the request. | | PIX-1099 | Provider Unmapped Error | Provider returned an unmapped error. | ### Provider errors (MED) | `code` | `title` | `message` | | -------- | --------------------------- | ---------------------------------------------------------------------------------------------- | | PIX-1065 | Duplicate Refund Request | The provider reports that a refund request already exists for this transaction. | | PIX-1068 | Invalid Request Status | The provider reports that the request is in an invalid state for this operation. | | PIX-1069 | Cannot Cancel Request | The provider reports that the request cannot be cancelled due to its current state. | | PIX-1080 | Duplicate Fraud Marker | The provider reports that a fraud marker already exists for this document and key combination. | | PIX-1081 | Invalid Fraud Type | The provider reports that the fraud type is not valid for this operation. | | PIX-1083 | Cannot Cancel Marker | The provider reports that the marker cannot be cancelled due to its current state. | | PIX-1090 | Person Statistics Not Found | The provider reports that no statistics were found for the specified tax ID. | | PIX-1091 | Key Statistics Not Found | The provider reports that no statistics were found for the specified Pix key. |