Skip to main content

Endpoint

GET /partner/v1/pix-in

Request

Headers

NameTypeRequiredDescription
X-API-KeystringYesYour partner API key

Response

Success (200 OK)

{
  "pix_in": [
    {
      "amount_cents": 10000,
      "description": "Payment for services",
      "end_to_end_id": "E12345678202401011234abcdefghijkl",
      "method": "dict",
      "sender_name": "João Silva",
      "sender_tax_id": "12345678900",
      "sender_account_number": "12345",
      "sender_account_type": "checking",
      "sender_bank_code": "001",
      "sender_branch_code": "0001",
      "created_at": 1704067200,
      "last_updated_at": 1704067260,
      "status": "credited"
    }
  ]
}

Response fields

FieldTypeDescription
amount_centsintegerPayment amount in cents (BRL)
descriptionstringPayment description (optional)
end_to_end_idstringUnique Pix transaction identifier
methodstringHow the payment was initiated
sender_namestringSender’s name
sender_tax_idstringSender’s CPF/CNPJ
sender_account_numberstringSender’s account number
sender_account_typestringType of sender’s account
sender_bank_codestringSender’s bank ISPB code
sender_branch_codestringSender’s branch code
created_atintegerUnix timestamp of creation
last_updated_atintegerUnix timestamp of last update
statusstringCurrent status of the inflow

Payment methods

MethodDescription
manualManual bank transfer
dictUsing Pix key lookup
static_qr_codeStatic QR code payment
dynamic_qr_codeDynamic QR code payment
payer_qr_codePayer-generated QR code
initiatorPayment initiator service

Account types

TypeDescription
checkingChecking account
savingsSavings account
paymentPayment account
salarySalary account

Inflow statuses

StatusDescription
processingPayment is being processed
approvedPayment approved by the bank
deniedPayment was denied
successPayment completed successfully
creditedFunds credited to the user
failedPayment failed

Example

curl https://api.bipa.tech/partner/v1/pix-in \
  -H "X-API-Key: your_partner_api_key"