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

Key	Description
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.