Skip to content


PIX Payment

PIX is the system created by the Brazilian Central Bank to bring instant payments to life. It is through PIX that all wallets that use QR Codes will be interoperable, meaning transfers and payments will be allowed from one e-wallet to another in real-time, 24/7.

HTTP Request

POST /v1/payments/payouts/pix

Request Headers
    "Content-Type": "application/json",
    "Authorization": "Bearer {{access_token}}",
    "x-api-key": "{{api_key}}"
Request Body
    "idempotencyKey": "idempotency-key",
    "country": "BR",
    "targetName": "test user a",
    "targetEmail": "",
    "targetDocument": "24988496880",
    "targetPixKey": "",
    "targetPixKeyType": "email",
    "amountInCents": 100,
    "currency": "BRL",
    "callbackUrl": "",
    "subMerchantId": "UUID"
Content-Type: application/json
    "idempotencyKey": "idempotency-key",
    "statusCode": 200,
    "errorMsg": "",
    "transferStatus": "IN_PROGRESS",
    "transferStatusCode": 200,
    "transferErrorMsg": ""

HTTP Headers Details

Key Value
Content-Type application/json
Authorization "bearer"+ "" + {{access_token}}
x-api-key {{api_key}}

Request Body Details

Parameter Required Type Description
idempotencyKey String Unique key to ensure idempotent requests
country String Country code, enum value as BR
targetName String Target account holder full name
targetLastName String Target account holder Last Name
targetEmail String Target account holder email
targetPhone String Target account holder phone . ps: +55xxxxxxxxx
targetBirthDate String Target account holder BirthDate, format: yyyy-MM-dd
targetDocument String Target account holder identity, it can be a 11-digit CPF or a 14-digit CNPJ.
targetPixKey String Target PIX Key
targetPixKeyType String The type of target PIX key, enum value as email, phone, document or random
amount String DEPRECATED. The transfer amount. note: 1 = 1BRL. Please use amountInCents instead. amountInCents will be preferred if both exist.
amountInCents Long The transfer amount. note: 100 = 1BRL/1USD
currency String The currency code of the transferred fund. enum value as BRL, USD
callbackUrl String URL where Liquido will send notifications associated to changes to this payment. will receive a post request.
subMerchantId String The sub merchant ID. Required for PSPs.

Response Body Details

Parameter Type Description
idempotencyKey String Unique key to ensure idempotent requests
statusCode Integer 200 Success, 401 Access denied, 422 Required fields missing or invalid data, 500 internal error
errorMsg String Error message if failed
transferStatus String Transfer status, SETTLED, IN_PROGRESS, FAILED or REJECTED, We should use transferStatus to judge the payment status
transferStatusCode Integer Transfer status code, TransferErrorCode
transferErrorMsg String Transfer error message if failed
Back to top