Create card custom booking

Here, you will learn how to create a card custom booking in Tuum.

Use case

In this example, we will demonstrate how to make a card top-up using a custom booking, automatically applying the service fee from the card's associated price list.

The example below applies when the card balance is held on the account managed by the Card API. If the account balance is maintained within Tuum Core, a similar endpoint from that respective API should be used instead.

Use case data	API parameters with values
The card account ID to which the funds are added.	...accounts/C001664282649/custom-bookings
The ID of the card to which the funds are to be added. Note: It is recommended to always provide the card ID. This is necessary to identify the correct card-level price list in cases where multiple cards are associated with the same account.	"cardId": "C001664282657"
The transaction type code. Note: Only a subset of transaction types is available for custom bookings. For more information, refer to the transaction type setup in the Tuum developer portal.	"transactionTypeCode": "CARD_TOPUP"
The amount of money that will be added to the card account.	"money": { "amount": 10000, "currencyCode": "EUR" },
Fees must be charged. Note: This applies only if a fee has been specified for the transaction type and if the current price list for the card includes a price for that fee.	"applyFee": true

Sample API call

To create a new card custom booking, use the following endpoint:

https://card-api.sandbox.tuumplatform.com/api/v1/accounts/{accountId}/custom-bookings

Learn more about the create custom booking endpoint in the Tuum developer portal.

Sample request

The sample request body is as follows:

JSON

{
  "cardId": "C001664282657",
  "transactionTypeCode": "CARD_TOPUP",
  "valueDateRule": "APPROVAL_DATE",
  "valueDate": "2025-07-08",
  "money": {
    "amount": 10000,
    "currencyCode": "EUR"
  },
  "applyFee": true,
  "details": "Adding funds to card account"
}

cURL

Sample response

Below you will find the response to the API request:

Response

{
    "errors": null,
    "validationErrors": null,
    "data": {
        "customBookingId": "ID-000000001011",
        "statusCode": "PROCESSED",
        "customBookingTypeCode": "BOOKING",
        "accountId": "C001664282649",
        "postingDate": "2025-09-15",
        "valueDateRule": "APPROVAL_DATE",
        "valueDate": "2025-09-15",
        "rejectionReasonCode": null,
        "reversedIds": [],
        "details": "Adding funds to card account",
        "transactionTypeCode": "CARD_TOPUP",
        "money": {
            "amount": 10000.00,
            "currencyCode": "EUR"
        },
        "feeTransactionTypeCode": "CARD_TOPUP_FEE",
        "feeMoney": {
            "amount": 4.00,
            "currencyCode": "EUR"
        },
        "initiatedEmployeeId": "ID-1100",
        "negativeBalanceAllowed": false,
        "transactionDirectionCode": "IN",
        "feeTransactionDirectionCode": "OUT",
        "insertedBy": "test kasutaja"
    }
}

Result

The result includes the full set of custom booking data, including the calculated fee of 4 EUR.