💸 Withdraw AUD

When you burn AUDD, the equivalent amount of Australian dollars (AUD) is credited to your Virtual Account balance. To complete the process, you’ll need to specify the external bank account where those funds should be withdrawn.

🚧

Bank Account Required:

Before you can initiate a withdrawal, the destination bank account must be added and approved in Mint. For setup instructions, see the External Bank Account Management guide.

💲 Withdrawing AUD

Withdrawals are made using the POST /bank-accounts/withdraw endpoint. This request tells the AUDD Mint how much AUD you’d like to withdraw, and which registered bank account it should be sent to. Request Body fields are defined as follows:

📤 Example Request:

curl -X POST [https://distributor-api-staging.audd.digital/bank-accounts/withdraw](https://distributor-api-staging.audd.digital/bank-accounts/withdraw)  
  -H "Authorization: Bearer <YOUR_API_KEY>"  
  -H "Content-Type: application/json"  
  -d '{  
    "srcBankAccountId": "<DEPOSIT_BANK_ACCOUNT_ID>",  
    "destBankAccountId": "<WITHDRAWAL_BANK_ACCOUNT_ID>",  
    "currency": "AUD",  
    "amount": 1 
  }'

📥 Example Response:

{
    "id": "withdraw id",
    "type": "WITHDRAWAL",
    "sourceBankAccount": {
        "id": "<deposit bank account public id>",
        "bsb": "",
        "accountNumber": "",
        "payId": null,
        "currency": "AUD",
        "balance": null,
        "type": "DISTRIBUTOR",
        "nickname": "<deposit bank account nickname>",
        "company": {
            "id": "<distributor company id>",
            "name": "<distributor company name>",
            "types": null
        },
        "subType": "DEPOSIT",
        "contactId": null,
        "providerType": "BANKING_CIRCLE",
        "status": "ACTIVE",
        "accountHolderName": "",
        "accountHolderFirstname": "",
        "accountHolderLastname": ""
    },
    "destinationBankAccount": {
        "id": "<withdrawal bank account id>",
        "bsb": "",
        "accountNumber": "",
        "payId": null,
        "currency": "AUD",
        "balance": null,
        "type": "DISTRIBUTOR",
        "nickname": "",
        "company": {
            "id": "<distributor company id>",
            "name": "<distributor company name>",
            "types": null
        },
        "subType": "WITHDRAWAL",
        "contactId": null,
        "providerType": "NONE",
        "status": "ACTIVE",
        "accountHolderName": null,
        "accountHolderFirstname": null,
        "accountHolderLastname": null
    },
    "amount": 1,
    "fee": 0.01,
    "currency": "AUD",
    "status": "IN_PROGRESS",
    "approver": null,
    "createdBy": {
        "id": "",
        "firstName": "",
        "lastName": "",
        "email": "",
        "phone": ""
    },
    "distributorCompany": {
        "id": "",
        "name": "",
        "types": null
    },
    "createdAt": "2025-09-05T07:39:00.689+00:00",
    "reference": "ZTLPAQO",
    "description": null,
    "bankTransactionId": null,
    "transactionId": null,
    "metadata": null,
    "refundTransactionId": null,
    "holdUntilDate": null,
    "adjustment": false,
    "privateAdjustment": false
}

❗️

Fees May Apply:

Withdrawal fees may be deducted automatically from the withdrawal amount, meaning the funds received will be the requested amount minus fees. For more details on how this is handled, refer to the Fees and Charges Guide.

Fee Behaviour

When funds are withdrawn from a Virtual Account (VA) to an external bank account, a withdrawal fee is applied. In staging, this fee is credited to TestMintFee, which may result in an additional transaction showing funds moving from the bank account to TestMintFee. This behavior is expected and reflects the VA withdrawal fee settlement mechanism.

Simulating Outcomes

Withdrawal transactions make their way through the Banking Circle Sandbox, which follows the simulated payment behavior described in the Banking Circle documentation for certain transaction values.