Error Codes

Error Codes Related to Creation

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

Error Codes Related to Payment confirmation

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

Error Codes — Virtual Account

Authentication Errors

Errors related to API key validation, request signatures, and access authorization.

type	summary	code	message
authentication_error	Unauthorized request	B401	Unauthorized request
authentication_error	Unauthorized request	B401	Timestamp outside allowed time window
authentication_error	Unauthorized request	B401	Invalid api key
authentication_error	Unauthorized request	B401	Invalid signature
authentication_error	Forbidden request	B403	Forbidden request
authentication_error	Forbidden request	B403	API key not authorized for this API

Validation Errors — Headers & Request

Errors triggered by missing or malformed HTTP headers and request body structure.

type	summary	code	message
validation_error	Invalid request	B400	Invalid request
validation_error	Missing required header: X-Timestamp	B400	Missing required header: X-Timestamp
validation_error	Missing required header: {headerName}	B400	Missing required header: {headerName}
validation_error	Invalid timestamp value	B400	Invalid timestamp value
validation_error	No key configured for merchant {merchantId}	B400	No key configured for merchant {merchantId}
validation_error	At least one filter must be provided	B400	At least one filter must be provided
validation_error	Invalid request body	ERR_INVALID_REQUEST_BODY	Invalid request body
validation_error	Invalid request body	ERR_INVALID_REQUEST_BODY	status must be one of: ACTIVE, INACTIVE, DELETED
validation_error	Invalid request body	ERR_INVALID_REQUEST_BODY	Invalid value '{value}' for field '{field}'
validation_error	One or more fields failed validation	ERR_INVALID_TYPE	Invalid value '{value}' for '{field}'. Expected type: {type}

Validation Errors — Owner Fields

Errors triggered by invalid or missing fields in the owner object.

type	summary	code	message
validation_error	One or more fields failed validation	ERR_INVALID_FIELD	owner is required
validation_error	One or more fields failed validation	ERR_INVALID_FIELD	owner.type is required
validation_error	One or more fields failed validation	ERR_INVALID_FIELD	type must be either 'PERSON' or 'COMPANY'
validation_error	One or more fields failed validation	ERR_INVALID_FIELD	Invalid owner fields for selected owner.type
validation_error	One or more fields failed validation	ERR_INVALID_FIELD	owner.referenceId is required
validation_error	One or more fields failed validation	ERR_INVALID_FIELD	owner.referenceId must be between 1 and 36 characters
validation_error	One or more fields failed validation	ERR_INVALID_FIELD	owner.firstName must be between 1 and 50 characters
validation_error	One or more fields failed validation	ERR_INVALID_FIELD	owner.lastName must be between 1 and 50 characters
validation_error	One or more fields failed validation	ERR_INVALID_FIELD	owner.companyName must be between 1 and 80 characters
validation_error	One or more fields failed validation	ERR_INVALID_FIELD	owner.email is required
validation_error	One or more fields failed validation	ERR_INVALID_FIELD	Invalid owner.email
validation_error	One or more fields failed validation	ERR_INVALID_FIELD	owner.email must be between 1 and 50 characters
validation_error	One or more fields failed validation	ERR_INVALID_FIELD	owner.phone is required
validation_error	One or more fields failed validation	ERR_INVALID_FIELD	phone.countryCode is required
validation_error	One or more fields failed validation	ERR_INVALID_FIELD	phone.countryCode must contain only digits and be between 1 and 4 characters
validation_error	One or more fields failed validation	ERR_INVALID_FIELD	phone.number is required
validation_error	One or more fields failed validation	ERR_INVALID_FIELD	phone.number must contain only digits and be between 4 and 14 characters
validation_error	One or more fields failed validation	ERR_INVALID_FIELD	owner.document is required
validation_error	One or more fields failed validation	ERR_INVALID_FIELD	owner.document.type is required
validation_error	One or more fields failed validation	ERR_INVALID_FIELD	owner.document.number is required
conflict_error	Conflict request	owner	owner is required
conflict_error	Conflict request	owner.type	owner.type is required
conflict_error	Conflict request	owner.type	Invalid owner.type: {type}
conflict_error	Conflict request	owner.document	owner.document is required
conflict_error	Conflict request	owner.document.number	owner.document.number is required
conflict_error	Conflict request	owner.document.type	Validation for document type {documentType} is not supported
conflict_error	Conflict request	owner.document.type	Invalid document number {number} for type {documentType}
conflict_error	Conflict request	owner.firstName	owner.firstName is required for PERSON
conflict_error	Conflict request	owner.firstName	owner.firstName must be between 3 and 50 characters
conflict_error	Conflict request	owner.firstName	owner.firstName must not be provided for COMPANY
conflict_error	Conflict request	owner.lastName	owner.lastName is required for PERSON
conflict_error	Conflict request	owner.lastName	owner.lastName must be between 3 and 50 characters
conflict_error	Conflict request	owner.lastName	owner.lastName must not be provided for COMPANY
conflict_error	Conflict request	owner.companyName	owner.companyName is required for COMPANY
conflict_error	Conflict request	owner.companyName	owner.companyName must be between 3 and 80 characters
conflict_error	Conflict request	owner.companyName	owner.companyName must not be provided for PERSON
conflict_error	Conflict request	owner.phone.countryCode	owner.phone.countryCode must contain only digits and be between 1 and 4 characters
conflict_error	Conflict request	owner.phone.number	owner.phone.number must contain only digits and be between 1 and 14 characters

Validation Errors — Document & Country

Errors triggered by invalid document types or unsupported country/currency combinations.

type	summary	code	message
conflict_error	Conflict request	account.country	account.country is required for document validation
conflict_error	Conflict request	account.country	Country {country} is not supported for document validation
conflict_error	Conflict request	account.country	Invalid document type {documentType} for country {country}. Valid types are: {validTypes}

Validation Errors — Account Fields

Errors triggered by invalid or missing fields in the account object.

type	summary	code	message
validation_error	One or more fields failed validation	ERR_INVALID_FIELD	account is required
validation_error	One or more fields failed validation	ERR_INVALID_FIELD	account.category is required
validation_error	One or more fields failed validation	ERR_INVALID_FIELD	category is required
validation_error	One or more fields failed validation	ERR_INVALID_FIELD	category must be 'VIRTUAL'
validation_error	One or more fields failed validation	ERR_INVALID_FIELD	account.type is required
validation_error	One or more fields failed validation	ERR_INVALID_FIELD	Invalid account.name for selected account.type
validation_error	One or more fields failed validation	ERR_INVALID_FIELD	account.name length is invalid
validation_error	One or more fields failed validation	ERR_INVALID_FIELD	account.country is required
validation_error	One or more fields failed validation	ERR_INVALID_FIELD	account.country must be 3 characters (ISO 3166-1 alpha-3)
validation_error	One or more fields failed validation	ERR_INVALID_FIELD	country must be one of 'PER', 'MEX', or 'ARG'
validation_error	One or more fields failed validation	ERR_INVALID_FIELD	account.currency is required
validation_error	One or more fields failed validation	ERR_INVALID_FIELD	account.currency must be 3 characters (ISO 4217)
conflict_error	Conflict request	account	account is required
conflict_error	Conflict request	account.country	Country {country} is not supported for account.type validation
conflict_error	Conflict request	account.type	Invalid account.type '{type}' for country '{country}'. Valid value: '{validType}'
conflict_error	Conflict request	account.country	Country {country} is not supported for account.currency validation
conflict_error	Conflict request	account.currency	Invalid account.currency '{currency}' for country '{country}'. Valid value: '{validCurrency}'

Validation Errors — Status & Metadata

Errors triggered by invalid status values, status transitions, or malformed metadata.

type	summary	code	message
validation_error	One or more fields failed validation	ERR_INVALID_FIELD	status is required
validation_error	One or more fields failed validation	ERR_INVALID_FIELD	status must be one of: ACTIVE, FAILED_CREATION
validation_error	One or more fields failed validation	ERR_INVALID_FIELD	depositMode is required
validation_error	One or more fields failed validation	ERR_INVALID_FIELD	reason must be between 1 and 50 characters
validation_error	One or more fields failed validation	ERR_INVALID_FIELD	merchantId is required
validation_error	One or more fields failed validation	ERR_INVALID_FIELD	metadata must not contain more than 5 elements
validation_error	Error update account is {status}	B400	Error update account is {status}
validation_error	Error update account.name is same	B400	Error update account.name is same
conflict_error	Conflict request	metadata.key	metadata.key must not exceed 20 characters
conflict_error	Conflict request	metadata.key	metadata.key must contain only letters, digits, hyphen (-) or underscore (_)
conflict_error	Conflict request	metadata.value	metadata.value must not exceed 100 characters
conflict_error	Conflict request	metadata.value	metadata.value contains invalid characters. Allowed: letters, digits, spaces, - _ . : , / @, currency symbols

Conflict Errors — Merchant & Account State

Errors triggered by duplicate records, missing entities, or invalid state operations.

type	summary	code	message
conflict_error	Conflict request	B409	Conflict request
conflict_error	Conflict request	B409	Merchant not found
conflict_error	Conflict request	B409	Merchant account already exists
conflict_error	Conflict request	B409	Merchant Account was not found
conflict_error	Conflict request	B409	Merchant Account not found
conflict_error	Conflict request	B409	Merchant was not method configured for virtual account
conflict_error	Conflict request	B409	Account already exists for this merchant with the same referenceId and account type
conflict_error	Conflict request	B409	{statusCode} status was not found
conflict_error	Conflict request	request	Request cannot be null

Conflict Errors — Status Transitions

Errors triggered when a requested status change is not allowed given the account's current state.

type	summary	code	message
conflict_error	Invalid status request	B421	Invalid status request
conflict_error	Invalid status request	B421	Cannot update status for a deleted account
conflict_error	Invalid status request	B421	Target status must be ACTIVE or INACTIVE
conflict_error	Invalid status request	B421	Target status must be DELETED
conflict_error	Invalid status request	B421	Invalid status transition from {current} to {new}. Allowed transitions: ACTIVE -> INACTIVE, INACTIVE -> ACTIVE
conflict_error	Invalid status request	B421	Cannot update status to {status}, only accepts DELETED status

Provider Errors

Errors triggered by failures in downstream provider communication (e.g. GMoney).

type	summary	code	message
provider_error	Provider error	B502	Provider error
provider_error	Provider error	B502	Error communicating with provider: {error}
provider_error	Provider error	B502	Account creation failed in provider
provider_error	Provider error	B502	Error updating account status in provider: {error}
downstream_unavailable	Dependent service unavailable	ERR_DOWNSTREAM_UNAVAILABLE	A dependent service is unavailable or timed out
downstream_error	Downstream service error	ERR_DOWNSTREAM	A dependent service returned an error

Internal Errors

Errors caused by unexpected failures in the Virtual Account service.

type	summary	code	message
internal_error	General exception	B999	General exception
internal_error	General exception	B999	An error occurred while creating the MerchantAccount

Error Codes — Settlements

Validation Errors

Code	Message	Details
SET-001	Missing required field	currency is required
SET-002	Invalid currency format	currency must be ISO 4217 code
SET-003	Missing required field	amount is required
SET-004	Invalid amount format	amount must be numeric
SET-005	Invalid amount value	amount must be greater than 0

Business Errors

Code	Message	Details
SET-006	Insufficient balance	amount exceeds available balance
SET-007	Currency balance not found	merchant has no balance in requested currency
SET-008	Invalid merchant configuration	merchant not configured for balance settlement

State Transition Errors

Code	Message	Details
SET-010	Settlement not found	No settlement exists with the given ID
SET-011	Invalid status transition	Settlement is not in PENDING status

Merchant Errors

Code	Message	Details
SET-012	Merchant not found	No merchant exists with the given ID

General Errors

Code	Message	Details
SET-009	Internal server error	Unexpected processing error