Customer Trust Level

Get Customer's Trust Level and Restrictions

To get a customer's trust leveland restrictions, you need to send a GET request to the following endpoint:

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

{
  "document": "123.456.789-10"
}

Params Descriptions

Field	Description	Value Type	Requirement
document	Customer's document (CPF or CNPJ)	String	Required

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

{
  "customer_name": "John Doe",
  "customer_document": "123.456.789-10",
  "status_trust": 3,
  "status_trust_reasons": [
    "BL-02: Dispute - Customer or bank of origin disputed payment of transaction",
    "BL-04: Antifraud - Customer blocked by LG antifraud engine"
  ]
}

Response params descriptions

Param	Description	Value Type
customer_name	Customer's full name	string
customer_document	Customer's document	string
status_trust	Trust level associated with the customer.	integer (see notes below)
status_trust_reasons	List of strings describing the specific reasons for the status_trust.	array

• 0 - Normal; 1 - Whitelist; 2 - Graylist; 3 - Blacklist

If you submit a document that is not associated with any customer, you’ll receive an HTTP 404 error:

{
     "message": "Invalid document"
}