Creating fiat withdrawal

POST /api/public/v1/bank_withdrawal_transactions

This endpoint creates a fiat withdrawal.

Headers

Name	Value
Content-Type	application/vnd.api+json
Authorization	Bearer <api_key>

Request Body

{
  "data": {
    "type": "bankWithdrawalTransactions",
    "attributes": {
      "absorb_fees": false,
      "account_id": "acd50522-de49-4aaa-a183-dc046ff27fd5",
      "bank_account_id": "f96d0db2-3e5d-42b4-8e36-7a0ea2a951fe",
      "amount": 1000.55,
      "reference": "Reference number for this particular withdrawal"
    }
  }
}

Name	Type	Required	Description
data.type	string	Yes	Can only be bankWithdrawalTransactions.
data.attributes.reference	string	Yes	The custom reference ID to tie the request to end-user or their account who gets paid. This can be anything you choose.
data.attributes.amount	number	Yes	Withdrawal amount.
data.attributes.account_id	string	Yes	Account ID on the Txn platform, e.g. your Euro account, which Txn will debit funds from.
data.attributes.bank_account_id	string	Yes	Beneficiary (bank account) ID. Refer to Listing Beneficiaries.
absorbFees	boolean	No	If false or omitted, the service fee is deducted from the transaction amount. If true, the service fee is deducted from your account balance.

Response Body

HTTP 201

{
  "data": {
    "id": "6717ff12-7eea-44bf-9cbf-4a363e36be03",
    "type": "bank_withdrawal_transactions",
    "attributes": {
      "absorbFees": true,
      "createdAt": "2024-11-19T15:26:36.205Z",
      "updatedAt": "2024-11-19T15:26:36.205Z",
      "state": "pending",
      "iban": "GB94BARC10201530093459",
      "beneficiaryName": "Acme LLC",
      "reference": "Reference number for this particular withdrawal",
      "paymentStatus": "created",
      "currency": "EUR",
      "amount": "1010.56",
      "payAmount": "1000.55",
      "fee": "10.01"
    },
    "relationships": {
      "bankAccount": {
        "meta": {
          "included": false
        }
      },
      "account": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {},
  "jsonapi": {
    "version": "1.0"
  }
}