• Multiple budget cards can be issued under a single budget, sharing the same balance. A budget wallet must be created before issuing any budget cards.
• Budget cards only define spending limits; they do not hold a balance themselves. Fees, transactions, and refunds directly affect the balance of the associated budget.
• Transfers in and out of a budget balance are directly linked to the Infinity Account balance.

Create and Query Budget

The initial budget balance can be 0. The name field undergoes a uniqueness validation. If the budget is created successfully, the UUID of the budget will be returned, which can be used to query its details directly via the List all budgets API.It can also be used with the List all budget transactions API to query transaction details for the budget. The start and end time format should follow the format of the transactionTime field.

Card Balance Control

Prepaid Card

The balance of a prepaid card is linked to the user's Infinity Account. To increase the prepaid card balance, funds from the Infinity Account can be transferred into the prepaid card via the Infinity Card transfer inAPI. To decrease the prepaid card balance, funds from the prepaid card can be transferred back into the Infinity Account via the Infinity Card transfer outAPI.

• Ensure that the card you are working with is a Prepaid Card.
• clientTransactionId is a custom identifier set by the user, and it will be returned in the callback.

Budget Card

A Budget Card does not hold a balance and cannot be used for fund transfers. It is managed through the Velocity Control API, which allows you to set spending limits according to daily, weekly, monthly, or yearly spending cycles.

Modify the Budget

The Update a budget API is used to modify the budget name, with a uniqueness validation in place.

The Increase budget balance and Decrease budget balance APIs are used to adjust the budget balance. The cost field must be greater than 0.