💸 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.

💲 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": "<AUDD to provide>",
        "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
}

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 behaviour is expected and reflects the VA withdrawal fee settlement mechanism.

Simulating Withdrawal Outcomes

Withdrawal transactions in Sandbox are processed through our banking provider's test environment. You can trigger specific payment outcomes by using certain transaction amounts when creating a withdrawal.

This allows you to test how your integration handles different withdrawal statuses using the same request structure you would use in Production.

These simulated outcomes are available in Sandbox only and are intended for integration testing. They do not affect Production withdrawals.