Payments
In the context of our API, a payment refers to the execution of transactions using interoperable QR codes and DICT Keys. This process includes identifying and validating the type of scanned QR code, ensuring the transaction conforms to the destination country's specifications and is efficient and secure.
Our API provides a suite of endpoints designed to manage payments efficiently, allowing for actions such as retrieving QR information, executing the corresponding payment, and verifying the payment status. These endpoints support the entire payment process, from the initial retrieval of QR data to the final confirmation of the transaction and its tracking, ensuring smooth international transactions with comprehensive oversight.
In addition to QR code payments, the API now supports transactions using DICT Keys, a popular method in Brazil through Pix. DICT Keys allow payments via unique identifiers such as CPF, CNPJ, email, or phone number, enhancing ease and security for users. This feature enables seamless processing of payments directly linked to these identifiers without needing to generate or scan a QR code.
Statuses of an Order
WAITING_AMOUNT
When the QR amount is open, the order remains waiting until the amount is sent.
PROCESS_LATER
This order status will only apply in Argentina. It occurs with static QRs where the merchant is expected to enter the QR amount. If the merchant has not provided the amount by the time the QR is scanned, the system will return this status.
CREATED
The order has been created.
PROCESSING
The payment was accepted and is being processed.
COMPLETED
The payment was successfully completed.
CANCELED
The preview was not accepted by the user or it expired.
REFUNDED
The order has been refunded.
PARTIALLY_REFUNDED
The order was partially refunded.
REJECTED
The payment has been rejected by the destination bank account.
FAILED
The payment failed due to an unexepcted error.
Order Expiration
An order expires 4 minutes after its creation.
However, if the order reaches the PROCESSING status, the expiration time is automatically extended to a total of 20 minutes.
This extension is designed to give the payment operation enough time to complete, preventing it from being prematurely REJECTED due to a previous CANCELED status.
Error Codes - FAILED Status Orders
PAYMENT_AUTHORIZATION_FAILED
Failed to authorize the payment.
INVALID_RETURN_ID
Invalid Return ID.
UNKNOWN_ERROR
An unknown error occurred.
INTERNAL_SERVER_ERROR
Error forwarding call to server.
ORDER_REJECTED_BY_RECEIVER_PSP
Order rejected by the Receiver's PSP.
SPI_TIMEOUT_CONTROL
SPI timeout control / Timeout limit exceeded at receiver PSP.
PROCESSING_ERROR
Transaction processing failed.
RECEIVER_PSP_ACCOUNT_LIMIT_EXCEEDED
Receiver's PSP account limit exceeded.
ACCOUNT_BLOCKED
The specified account is blocked.
CREDITOR_MEMBER_IDENTIFIER_INVALID
Creditor ClearingSystemMember Identifier invalid or non-existent.
INSUFFICIENT_FUNDS
Insufficient funds in customer pre-funded account.
Error Codes - REJECTED Status Orders
ERROR ACREDITACION | 0683
Payment network error (reversed guarantees)
ERROR ACREDITACION | 8414
TIME_OUT – Acquirer timeout.
VENCIDO | 0200
Notice sent
ERROR DEBITO | 0440
Other problems
ERROR DEBITO | 7299
System failure - Notice
Last updated