Simulating Deposit Success

Complete Deposit Settlement Flow

Below is a step-by-step guide to complete (settle) your deposits. To simulate the full flow, you'll need two accounts:

  1. One to create payments (secondary account)

  2. Another to process payments (primary account with balance)

Step 1: Create a Secondary Virtual Account

  1. Go to menu: Account > Virtual Accounts

  2. On the listing page, click Create Virtual Account (top right corner)

  3. Select your real bank account (usually there's only one) and enter a simple description

Note:

  • Your first account starts with R$1,000,000.00 balance

  • The newly created account will have R$0.00 initially

Step 2: Create a QR Code Payment

Send a POST request to generate a dynamic QR Code pointing to the new account (with zero balance):

https://api.sandbox.aurixpay.ws/banking/v1/cashin/pix/qrcode/static

Payload:

{
  "amount": 1000,
  "reference": "PED-2025-001234",
  "bank_account_id": "0197676a-012d-725c-95fa-b9a54a4536b1",
  "currency": "BRL",
  "virtual_account_id": "0197676a-013e-7121-b1a5-e720b44c5c95"
}

Responses:

Success (HTTP 201):

{
  "txid": "f13733b4-673b-4411-ba9d-e3029a94d1d6",
  "qrcode": "data:image/png;base64,iVBORw0/ACA+z/Wg/8OA...",
  "brcode": "00020126860014br.gov.bcb.pix2564pix.ecomovi.com.br/qr/v3/at/f3daf9b4-86fe-4a63-9fc3-59f604818cf95204000053039865802BR5925DGDS_FERNANDES_COMERCIO_L6009SAO_PAULO62070503***6304C732",
  "expires_at": "2025-06-13T06:21:28.000000Z"
}

Details:

  • amount: Value in cents (e.g. 5000 = R$50.00)

  • The zero-balance account will receive a deposit of R$50.00

Step 3: Make the Payment

To pay the created deposit, use the primary account (with balance):

  1. Go to: Move Funds > PIX

  2. Select the source account (the first one, with available balance)

  3. Paste the hash generated in the deposit API request

  4. Follow the confirmation steps

Result:

  • The deposit will be settled

  • A webhook will be sent (if configured)

  • The transaction will appear in the transactions list

Flow Summary

  1. Create a secondary account (zero balance)

  2. Generate a dynamic QR Code for this account

  3. Use the primary account (with balance) to pay the QR Code

  4. The amount will be transferred to the secondary account

Next Steps:

  • Check the confirmation webhook

  • Review the transactions list to confirm settlement

Last updated