Virtual Cash Balances

Download Spec

All virtual cash balances related paths

Trigger a virtual cash increase

post /virtual_cash_balances/increases

Trigger a virtual cash increase

account_group_id

string

uuid

required

Account group unique identifier.

amount

string

^[0-9]{1,9}(\.[0-9]{2})?$

required

currency

string

required

Alphabetic three-letter ISO 4217 currency code.

  • EUR - Euro
Default
"EUR"
Enum
  • EUR

Request

{
  "account_group_id": "2596db3b-0d03-4651-9eda-970910479dfb",
  "amount": "200.00",
  "currency": "EUR"
}

Response

ExamplesSchema

Virtual Cash Balances Increase

{
  "id": "6ffa6b16-2380-4e7a-88b2-ae625c8eef99",
  "created_at": "2020-08-24T14:15:22Z",
  "updated_at": "2020-08-24T14:15:22Z",
  "account_group_id": "ac1c39e9-2101-46b8-a624-d10a9e351b6c",
  "amount": "200.00",
  "currency": "EUR",
  "status": "ISSUED"
}

Trigger a virtual cash decrease

post /virtual_cash_balances/decreases

Trigger a virtual cash decrease

account_group_id

string

uuid

required

Account group unique identifier.

amount

string

^[0-9]{1,9}(\.[0-9]{2})?$

required

currency

string

required

Alphabetic three-letter ISO 4217 currency code.

  • EUR - Euro
Default
"EUR"
Enum
  • EUR

Request

{
  "account_group_id": "2596db3b-0d03-4651-9eda-970910479dfb",
  "amount": "200.00",
  "currency": "EUR"
}

Response

ExamplesSchema

Virtual Cash Balances Decrease

{
  "id": "6ffa6b16-2380-4e7a-88b2-ae625c8eef99",
  "created_at": "2020-08-24T14:15:22Z",
  "updated_at": "2020-08-24T14:15:22Z",
  "account_group_id": "ac1c39e9-2101-46b8-a624-d10a9e351b6c",
  "amount": "200.00",
  "currency": "EUR",
  "status": "ISSUED"
}

Cancel virtual cash decrease by ID

delete /virtual_cash_balances/decreases/{virtual_cash_decrease_id}

Cancels a virtual cash decrease specified by its ID. It is only possible to cancel a virtual cash decrease if it has the status ISSUED or QUEUED.

virtual_cash_decrease_id

string

uuid

required

Virtual cash unique identifier

Response

ExamplesSchema

Request has been processed successfully.

Empty response

id

string

uuid

required

Event unique identifier

created_at

string

date-time

required

Date and time when the event was created. RFC 3339-5, ISO8601 UTC

type

string

required

Event type

Enum
  • VIRTUAL_CASH_INCREASE.ISSUED
  • VIRTUAL_CASH_INCREASE.CONFIRMED

object

object (object)

required

webhook_id

string

uuid

required

Webhook unique identifier.

Request

{
  "id": "8962b496-8d42-4560-bfab-10490dd1a721",
  "created_at": "2021-07-21T14:10:00.00Z",
  "type": "VIRTUAL_CASH_INCREASE.ISSUED",
  "object": {
    "id": "6ffa6b16-2380-4e7a-88b2-ae625c8eef99",
    "created_at": "2020-08-24T14:15:22Z",
    "updated_at": "2020-08-24T14:15:22Z",
    "account_group_id": "ac1c39e9-2101-46b8-a624-d10a9e351b6c",
    "amount": "200.00",
    "currency": "EUR",
    "status": "ISSUED"
  },
  "webhook_id": "9df39835-be87-4243-9018-f2500b39cee6"
}

Response

ExamplesSchema

Request has been processed successfully.

Empty response

id

string

uuid

required

Event unique identifier

created_at

string

date-time

required

Date and time when the event was created. RFC 3339-5, ISO8601 UTC

type

string

required

Event type

Enum
  • VIRTUAL_CASH_DECREASE.ISSUED
  • VIRTUAL_CASH_DECREASE.CONFIRMED
  • VIRTUAL_CASH_DECREASE.QUEUED
  • VIRTUAL_CASH_DECREASE.CANCELLED

object

object (object)

required

webhook_id

string

uuid

required

Webhook unique identifier.

Request

{
  "id": "8962b496-8d42-4560-bfab-10490dd1a721",
  "created_at": "2021-07-21T14:10:00.00Z",
  "type": "VIRTUAL_CASH_DECREASE.ISSUED",
  "object": {
    "id": "6ffa6b16-2380-4e7a-88b2-ae625c8eef99",
    "created_at": "2020-08-24T14:15:22Z",
    "updated_at": "2020-08-24T14:15:22Z",
    "account_group_id": "ac1c39e9-2101-46b8-a624-d10a9e351b6c",
    "amount": "200.00",
    "currency": "EUR",
    "status": "ISSUED"
  },
  "webhook_id": "9df39835-be87-4243-9018-f2500b39cee6"
}

Response

ExamplesSchema

Request has been processed successfully.

Empty response

Was this page helpful?