API Reference

Error Codes

Error Codes Related to Creation

Error CodeError Message
0000Successfull Process (Link creation successfull)
0001Error in payinMerchantID not valid (the field is empty)
0002Error in payinAmount not valid (the field is empty)
0003Error in payinCurrency not valid (the field is empty)
0004Error in payinMerchantOperationNumber not valid (the field is empty)
0005Error in payinVerification not valid (the field is empty)
0006Error in payinTransactionErrorURL not valid (the field is empty)
0007Error in payinTransactionOKURL not valid (the field is empty)
0008Error in payinProcessorCode not valid
0009Error payinMerchantID not valid (it's wrong)
0010Error in payinVerification (it's wrong)
0011Error in merchant not enabled
0012Error in payinTransactionErrorURL not valid
0013Error in payinTransactionOKURL not valid
0015Error in payinAmount format not valid
0017Error in payinCurrency not valid
0018Error in processor not valid
0019Error in currency, not exist for merchant
0022Error in transaction payinCustomerTypeDocument no exits
0023Error in transaction, payinCustomerDocument no exits
0024Error in transaction, payinCustomerDocument no exits
0025Customer Type Document invalid
0026Customer Document invalid
0030Error due to non-compliance with pre-authorization rules (only for Argentina)
0031Error in processor, code value no registered
0032Error in processor, key no registered
0040Error in transaction, cbu is required
0041Error in transaction, cuit is requiredYUNO LOGIC:
0042Error on sendGateWay YUNO
0043CBU and CUIT don't match
0044The subscription is inactive
0046CBU Exceeds maximum length
0047CUIT Exceeds maximum length
0048Error in collectorCode: invalid or unsupported value.
0049Error in CollectorCode: this value is not enabled for your account
0050Error in collectorCode: the processor is temporarily unavailable. Please try again later.
0051Error in collectorCode: collector not available or currency - min/max amount not allowed
0099Internal Error Payin

Error Codes Related to Payment confirmation

Error CodeError Message
9001Refer to card issuer
9002Refer to card issuer's special conditions
9003Invalid merchant
9007Pick-up card, special condition
9012Invalid transaction
9013Invalid amount
9014Card number does not exist
9015Issuer or bin number does not exist
9017Customer cancellation
9019Retry Transaction
9025Unable to locate record on file
9030Format error
9039No credit account
9051Not sufficient funds
9052Non-existing current account
9054Expired card
9055Incorrect personal identification number
9057Transaction not permitted to cardholder
9061Effective advance is exceeded
9062Restricted card
9065Merchant has exceeded the number of daily transactions
9075Allowable number of PIN tries exceeded
9078Card not activated
9080Card expiration date invalid
9089Customer info invalid
9092Financial institution or intermediate network facility cannot be found for routing
9093Transaction cannot be completed
9094Duplicate transmission
9096System malfunction
9097Operation Timeout
9099Error
9005Do not honor
9020Invalid response
9031Bank not supported by switch
9034Suspected fraud
9040Requested function not supported
9041Lost card
9043Stolen card, pick-up
9056No card record
9058Transaction not permitted to terminal
9062Restricted card
9066Card acceptor call acquirer's security department
9068Response received too late
9094Duplicate transmission
9090Issuer or switch is inoperative
9000Succeeded

Error Codes for Virtual Accounts

🛑Header Errors

Error CodeTypeHTTP StatusMessage
ERR_MISSING_HEADERauth_error400 Bad RequestMissing required header: X-Api-Key
ERR_UNAUTHORIZEDauth_error401 UnauthorizedInvalid API key
ERR_MISSING_HEADERauth_error400 Bad RequestMissing required header: X-Timestamp
ERR_TIMESTAMP_OUT_OF_RANGEauth_error401 UnauthorizedTimestamp too old or too far in the future
ERR_MISSING_HEADERauth_error400 Bad RequestMissing required header: X-Signature
ERR_INVALID_SIGNATUREauth_error401 UnauthorizedInvalid signature

⚠️Body Errors

Error CodeTypeHTTP StatusMessage
ERR_MISSING_FIELDauth_error400 Bad RequestMissing required field: payer.referenceId
ERR_INVALID_LENGTHauth_error401 UnauthorizedInvalid length: must be between 1 and 36 characters
ERR_INVALID_FIELDauth_error400 Bad RequestMissing required header: X-Timestamp
ERR_MISSING_FIELDauth_error401 UnauthorizedTimestamp too old or too far in the future
ERR_UNSUPPORTED_DOCUMENT_TYPEauth_error400 Bad RequestMissing required header: X-Signature
ERR_INVALID_DOCUMENT_TYPEauth_error401 UnauthorizedInvalid signature
ERR_MISSING_FIELDvalidation_error400 Bad RequestMissing required field: payer.referenceId
ERR_INVALID_LENGTHvalidation_error400 Bad RequestInvalid length: must be between 1 and 36 characters
ERR_INVALID_FIELDvalidation_error400 Bad RequestInvalid payer.type: must be PERSON or COMPANY
ERR_MISSING_FIELDvalidation_error400 Bad RequestMissing required field: payer.document.type
ERR_UNSUPPORTED_DOCUMENT_TYPEvalidation_error400 Bad RequestUnsupported document type: must be one of [CUIT, DNI, RUC]
ERR_INVALID_DOCUMENT_TYPEbusiness_error422 Unprocessable EntityInvalid document type: CUIT not allowed for merchant country
ERR_MISSING_FIELDvalidation_error400 Bad RequestMissing required field: payer.document.number
ERR_INVALID_FORMATvalidation_error400 Bad RequestDocument number must contain only digits
ERR_INVALID_DOCUMENT_NUMBERbusiness_error422 Unprocessable EntityInvalid document number for type CUIT
ERR_MISSING_FIELDvalidation_error400 Bad RequestMissing required field: payer.firstName (required when type=PERSON)
ERR_INVALID_LENGTHvalidation_error400 Bad RequestLength must be between 1 and 50
ERR_MISSING_FIELDvalidation_error400 Bad RequestMissing required field: payer.lastName (required when type=PERSON)
ERR_INVALID_LENGTHvalidation_error400 Bad RequestLength must be between 1 and 50
ERR_MISSING_FIELDvalidation_error400 Bad RequestMissing required field: payer.companyName (required when type=COMPANY)
ERR_INVALID_LENGTHvalidation_error400 Bad RequestLength must be between 1 and 80
ERR_MISSING_FIELDvalidation_error400 Bad RequestMissing required field: payer.email
ERR_INVALID_EMAILvalidation_error400 Bad RequestInvalid email format
ERR_INVALID_LENGTHvalidation_error400 Bad RequestLength must be between 1 and 50
ERR_MISSING_FIELDvalidation_error400 Bad RequestMissing required field: payer.phone.countryCode
ERR_INVALID_PHONE_COUNTRYvalidation_error400 Bad RequestInvalid country code: must be 1-4 digits
ERR_MISSING_FIELDvalidation_error400 Bad RequestMissing required field: payer.phone.number
ERR_INVALID_PHONE_NUMBERvalidation_error400 Bad RequestInvalid phone number: must be 4–14 digits
ERR_MISSING_FIELDvalidation_error400 Bad RequestMissing required field: account.category
ERR_INVALID_FIELDvalidation_error400 Bad RequestInvalid account.category: must be VIRTUAL
ERR_MISSING_FIELDvalidation_error400 Bad RequestMissing required field: account.type
ERR_INVALID_FIELDvalidation_error400 Bad RequestInvalid account.type: must be CVU, CCI or CLABE
ERR_MISSING_FIELDvalidation_error400 Bad RequestMissing required field: account.country
ERR_INVALID_COUNTRYvalidation_error400 Bad RequestCountry must be a 3-letter ISO 3166-1 code
ERR_MISSING_FIELDvalidation_error400 Bad RequestMissing required field: account.currency
ERR_INVALID_CURRENCYvalidation_error400 Bad RequestCurrency must be 3-letter ISO 4217 code
ERR_INVALID_DOCUMENT_TYPEbusiness_error422 Unprocessable EntityInvalid currency code for country
ERR_INVALID_ACCOUNT_NAMEvalidation_error400 Bad RequestInvalid account.name: must match ^[a-zA-Z0-9._-]{6,20}$
ERR_INVALID_ACCOUNT_NAMEvalidation_error400 Bad RequestInvalid account.name: must match ^[a-zA-Z0-9._-]{3,15}
ERR_INVALID_METADATA_KEYvalidation_error400 Bad RequestMetadata key 'segment@#' is invalid: must match ^[a-zA-Z0-9_-]{1,20}$
ERR_INVALID_METADATA_VALUEvalidation_error400 Bad RequestMetadata value too long or contains invalid characters
ERR_TOO_MANY_METADATA_ENTRIESvalidation_error400 Bad RequestMetadata supports up to 5 key-value pairs
ERR_INTERNAL_ERRORsystem_error500 Internal Server ErrorUnexpected server error