Glossary

• Account and accountId

  An accountId is an unique identifier for a Transfero account.

  An account is created for each client-currency pair, which means that, if a Transfero's client wants to work with BRL and BRZ, for example, this client will have 2 accounts, being one for BRL transactions and the second for BRZ transactions.

   Every client's accountId is provided by Transfero, and linked to a specific clientId.

• CBU/CVU accounts and ALIAS

  CBU (Clave Bancaria Uniforme) is an Argentine unique bank identifier that corresponds to one specific bank account. It is always provided by a regulated argentine bank.

  • CBUs are always a 22 digits number, separated into two blocks. The first block has a 3-digit entity number, a 4-digit branch number and a check digit. The second block has a 13-digit number that identifies the account within the institution and the branch, plus a check digit.

  CVU (Clave Virtual Uniforme), instead, is an Argentine unique virtual Key that corresponds to one specific virtual account. It is always provided by a regulated argentine payment processor or digital wallet. When depositing into the CVU, money is credited to the main CBU account, and a virtual balance is credited to the CVU virtual account.

  • CVUs are always a 2 blocks number, where the first block (digits 1 to 8) identifies the PSP (payment service provider) to which it belongs and the second block (digits 9 to 22) identifies the user.

  ALIAS is a "nickname" associated with an argentine bank account that works as an alternative to the CBU/CVU number when a transfer is made. When someone type the ALIAS into a banking platform, all the information regarding to the associated bank account will show up, simplifying the transaction process.

  • ALIAS must have between 6 to 20 alphanumeric characters. The user may assign an Alias to each of his/her bank accounts. All bank accounts have a default alias assigned to them, that can be changed by the user.

• ClientId

  A clientId is the client's unique identification in Transfero, It is always provided by Transfero to its clients.

• Deposit Order

  A deposit order is an intention to receive a deposit, an invoice created with open status, waiting for a credit transaction to be completed. Every deposit intention has a reference id for reconciliation (see more about reference id below).

  For brazilian pay-ins, the Pix payment method allows the generation of deposit orders with QR Codes. For Argentina, however, the central bank has not yet developed a technology to fully offer deposits through QR codes. That is not something that depends on Transfero, but actually on Argentina's banking system.

• Payment/Withdraw/Payout and Payment Groups

   A payment (payout/withdraw) is a simple debit transaction. A Payment Group is just a list of Payments.

  Payouts are always made from the Account corresponding to the {accountId} in the URL path to the account(s) in the body of the POST request. Payments can only be done from the same currency account as the destination account.

  Two simple examples would be:

  • A person that wants to withdraw 100BRL from Transfero Crypto to his/her bank account, would request a Payment operation  

  • Or if this person needs to transfer some BTC to another person's wallet, then to do so, you can simply create a new Payment requesting this transfer.

• ReferenceId

  A referenceId is a unique id created by Transfero to identify a Deposit Order. When a pay-in is identified by Transfero, a credit transaction is created with the same referenceId as the deposit order that generated that pay-in. That reference is used to facilitate the conciliation process.

  If the client wants, an externalId can also be created to identify a deposit order. If that's case, the same externalId will also be added to the credit transaction document, whenever Transfero receive's a payin for that deposit order.

• TaxId

  A taxpayer identification number, also known as a TaxId, is a unique number that represent individuals and organizations. This number is issued by each country's federal government and it's primarily needed in order to track all tax obligations from any payments or incomes made or received by those individuals and organizations.

  Each country has its own system and pattern, and some of them have distinct types of TaxIds to indicate different types of "entities", e.g. businesses, citizens, foreigners, etc.

  Examples of TaxIds used in different countries:

  • Brazil - CPF (used for brazilian citizens) / CNPJ (used for brazilian businesses)

  • Argentina - CUIT (used for both argentine citizens and businesses)

  • United States - SSN (american citizens) or EIN (american businesses and non-profit organizations) or ITIN (non-U.S. citizens currently residing, and often working, in the U.S.)

• TaxIdCountry or TaxCountry

  A TaxIdCountry is a unique number or 3-digit code used to identify a country, instead of using its name. Transfero uses the code pattern described by ISO 3166. This code can be found here. Obs.: If for some reason this address is down, you can find the respective Tax Country by searching 'ISO 3166 country code' on your prefered search tool in your browser.

  Examples of TaxIdCountry:

  • Brazil - 76 or BRA

  • Argentina - 32 or ARG

  • United States - 840 or USA

  The parameter TaxIdCountry is an enum thar accepts either the numeric or the alpha-3-code format. For some endpoints, this code will also be used to validate the Tax ID value.

• Transaction

  A transaction is an object that defines any currency movement made to/from Transfero systems. Completed pay-ins/deposits generate credit transactions, whereas successful pay-outs/withdraws generate debit transactions.