Update the fiat stock

Availability of this endpoint may vary based on the settlement process agreed upon between Bitpanda and its partners.

This is only applicable for the settlement type where fiat money is transferred between users’ and Bitpanda’s bank accounts every time users trade. The partner will use this endpoint to notify Bitpanda about any new bank transfer of fiat money related to a transaction.

SecuritybearerAuth
Request
Request Body schema: application/json

Request details

reference
required
string <uuid>

The reference that is used to make the payment. Reference shall have the same value as the id of a successful trade or the same value as the id of a tax refund in order to be reflected in the settlement

transaction_id
string <uuid>

Bitpanda offer_id (trade_id), to which the bank transfer relates

amount
required
string
currency
required
string
balance_after
string

The account balance immediately following a transaction. It reflects the total available funds after the transaction has been processed.

status
required
string
Value: "finished"
direction
required
string

For Buy trades the expected direction is Debit. The amount in the Partner's corporate wallet will be increased with the amount in the settlement transaction. For Sell trades, the expected direction is Credit. The amount in the Partner's corporate wallet will be decreased with the amount in the settlement transaction.

Enum: "debit" "credit" "refund"
timestamp
string
Responses
200

New transaction has been created

401

Unauthorized

422

Error

429

Too Many Requests

500

Error

503

Maintenance or Service unavailable

post/v1/fiat-stock
Request samples
application/json
{
  • "reference": "ca9d287e-6e2f-4ac5-9e8f-eedfa5aa2db5",
  • "transaction_id": "a5caa443-831b-4b07-8db6-cb4577aca298",
  • "amount": "123.45",
  • "currency": "EUR",
  • "balance_after": "22.46",
  • "status": "finished",
  • "direction": "debit",
  • "timestamp": "2022-03-07T11:08:06+01:00"
}
Response samples
application/json
{
  • "data": {
    }
}