Brazil

Retrieve recipient data from QRCODE

POST https://sandbox.transfersmile.com/api/payout/bank-account-list

This endpoint allows you to retrieve the recipient's data from QRCODE.

Headers

Name	Type	Description
Content-Type*	string	application/json; charset=UTF-8
AppId*	string	Get AppId from dashboard
Authorization*	string	signature, generated by SHA256($sorted_params + $app_key)

Request Body

Name	Type	Description
country*	string	Country Code. - BRA
method*	string	Method - Fixed value: QRCODE -
account_type*	string	Account type - Fixed value: QRCode
account*	string	Beneficiary's QRCode
timestamp*	Integer	unix timestamp, e.g. 1628512575
buyer_id	string	merchant user's id
email	string	User's email - Max. 200 chars -

200 success

{
	"code": 200,
	"msg": "success",
	"time": 1780569833,
	"data": [
		{
			"name": "Pagsmile test",
			"document_id": "59*****85",
			"document_type": "CNPJ",//CPF or CNPJ for Brazil
			"bank_code": "1*****5",//8-digits Bank ISPB Code for Brazil
			"bank_name": "MAGEN IP",
			"bank_number": "1*****5",
			"account": "*****",
			"account_type": "PAYMENT",
			"amount": "0.03",
			"scan_id": "QH2026**************",
			"qrcode_type": "DYNAMIC_INSTANT_PAYMENT"// or "STATIC"
		}
	]
}

500 system error

Example

curl --location --request POST 'https://sandbox.transfersmile.com/api/payout/bank-account-list' \
--header 'AppId: 94FAC**********************68548' \
--header 'Authorization: d6181db0d6548b94b162e75d095b59147172d914699f83b2bd17951a671b6302' \
--header 'Content-Type: application/json' \
--data-raw '{
    "country": "BRA", //BRA
    "method": "QRCODE",
    "account": "00020101021226880014br.gov.bcb.pixqrcode.com.br/pix/2e731667****",
    "account_type": "qrcode",
    "timeStamp": "1733992186",
    "buyer_id": "********",
    "email": "[e-mail]"
}'

Note: 94FAC*********************68548 is pagsmile's test merchant id for sandbox, and d6181db0d6548b94b162e75d095b59147172d914699f83b2bd17951a671b6302 is authorization token associated with the test App ID.

Sandbox QR Code Test Data

Use the following QR codes to test different QRCode retrieval scenarios in the sandbox environment.

Static QR Code without Fixed Amount

Use this QR code to test a static QR code without a fixed amount.

00020101021226990014br.gov.bcb.pix2577qrcode.pagsmile.com.br/qrs1/v2/01HRBqBVWXZ55OeHdj7fMfKunhXTFOi29ccSiRDLmmePXm52040000530398654045.695802BR5911LUXTUK LTDA6009Sao Paulo62070503***STATIC

Response sample:

{
  "code": 200,
  "msg": "success",
  "time": 1783582034,
  "data": [
    {
      "name": "Test User NameAA",
      "document_id": "11********82",
      "document_type": "CPF",
      "bank_code": "******",
      "bank_name": "BANCO GENIAL",
      "bank_number": "45246410",
      "account": "52********20",
      "account_type": "CURRENT",
      "amount": "0.00",
      "scan_id": "*************************",
      "qrcode_type": "STATIC"
    }
  ]
}

Blocked QR Code

Use this QR code to test the scenario where the receiver bank account is blocked.

00020101021226990014br.gov.bcb.pix2577qrcode.pagsmile.com.br/qrs1/v2/01HRBqBVWXZ55OeHdj7fMfKunhXTFOi29ccSiRDLmmePXm52040000530398654045.695802BR5911LUXTUK LTTT6009Sao Paula62070503***

Response sample:

{
  "code": 4001015,
  "msg": "account is blocked",
  "time": 1783580173,
  "data": {
    "err": "receiver bank account blocked"
  }
}

Invalid or Expired QR Code

Use this QR code to test the scenario where the QR code is invalid or expired.

00020101021226990014br.gov.bcb.pix2577qrcode.pagsmile.com.br/qrs1/v2/01HRBqBVWXZ55OeHdj7fMfKunhXTFOi29ccSiRDLmmePXm52040000530398654045.695802BR5911LUXTUK LTDA6009Sao Paulo62070503***Invalid/Expired

Response sample:

{
  "code": 400,
  "msg": "Invalid QR Code",
  "time": 1783582212,
  "data": {}
}