Deposit

Introduction

Deposits in Brazil enable individuals to smoothly transfer funds, combining the security of safeguarding money with the convenience of sending payments. Highly utilized across the country, it's a testament to its reliability and ease of use for financial transactions.

Getting Started

• Generate Orders
• List banks information

Generate Orders

To generate a Deposit order, you need to send a POST request to the following endpoint:

POST /api/v1/order
Host: binance.latamgateway.com
Content-Type: "application/json"
ACCOUNT_TOKEN: "<token>"

{
  "customer": {
    "name": "Customer’s full name",
    "document": "111.222.333-44",
    "email": "[email protected]",
    "phone": "11999999999",
    "birth": "1996-03-09",
    "kyc_level_merchant": "Kyc_10k"
  },
  "order": {
    "code": "123",
    "notification_url": "your_payback_notification_url.com",
    "value": 50.00,
    "additional_info": "Some description of your order as String",
    "ocbs": false,
    "payment_method": "deposit",
    "bank_slug": "bank",
  }
}

Params descriptions

Field	Description	Value Type	Requirement
customer.name	Customer's full name	String	Required
customer.document	Customer's document	String	Required (see notes below)
customer.email	Customer's email address	String	Required
customer.phone	Customer's phone number	String	Required
customer.birth	Customer's date of birth	String	Required
customer.kyc_level_merchant	Customer's KYC level	String	Optional
order.code	Order reference in your system	String	Required
order.notification_url	URL to notify when status changes	String	Required
order.value	Total order value	Number (decimal)	Required
order.additional_info	Additional description of the order	String	Required
order.ocbs	Binance’s internal control	Boolean	Optional
order.payment_method	Payment method	String	Required
order.bank_slug	Bank identifier	String	Required

Note 1: The document can be a valid CPF or CNPJ. If CNPJ is used, the company name must be passed in the name parameter.

Note 2: CPF and CNPJ are the Brazilian individual and company identification numbers, respectively.

On a successful request HTTP 200 status code, the response will include the following parameters:

{
  "latam_id": "7c0b8129-f556-4357-bb6e-8189c2943024",
  "code": "order_id_in_your_system",
  "confirmation_url": "https://binance.latamgateway.com/7c0b8129-f556-4357-bb6e-8189c2943024",
}

Business errors due to incorrect or missing parameters are returned with an HTTP 400 status code. The response will indicate which parameter is invalid or missing.

{
     "message": "Invalid document"
}

KYC errors are returned with an HTTP 403 status code. The response will contain the following parameters:

{
  "latam_id": "7c0b8129-f556-4357-bb6e-8189c2943024",
  "message": "kyc message table below",
  "code": "kyc code table below"
}

KYC Response Codes Descriptions

Code	Message
KYC110	Invalid CPF, please verify your date of birth and CPF number.
KYC110	CPF document not found.
KYC110	CPF document belongs to a deceased holder. Year of death: 2024.
KYC110	CPF document is suspended.
KYC111	Invalid CNPJ, please verify your CNPJ number.
KYC112	Different name from the federal revenue register of natural persons.

List banks information

As you need to show your customer the available banks and the selected bank in bank_slug, this endpoint provides all the information needed in your form.

GET /api/v1/banks
Host: binance.latamgateway.com
Content-Type: "application/json"
ACCOUNT_TOKEN: "<token>"

{
  "banks": [
    {
      "name": "BS2 S.A.",
      "slug": "banco_bs2",
      "owner": "Lta Gateway Intermediacao Financeira Ltda.",
      "document": "33.630.661/0001­-50",
      "agency": "0001",
      "account_number": "1085226-3",
      "logo_url": "https://binance.latamgateway.com/assets/bank_logo/bs2-025d04fddaf735a529ce47776b44e342e0ca16fd5a6bf2f133e792cc8bd35922.png",
      "operation": "218"
    },
    {
      "name": "Simpaul",
      "slug": "ted_simpaul",
      "owner": "Lta Gateway Intermediacao Financeira Ltda.",
      "document": "33.630.661/0001­-50",
      "agency": 0001,
      "account_number": "33-7",
      "logo_url": "https://binance.latamgateway.com/assets/bank_logo/simpaul-0a9ecaf765bb5b6aa8a498121b7e90be0f4db592d85b7e39bcd1c5e4b118e1c2.png",
      "operation": "365"
    },
  ]
}