Balance

Balance events are additional events that can be sent on the FT CRM Integration API. These further enhance the functionality of FT CRM from basic integration.

REST API

RabbitMQ Connector

RabbitMQ Message Properties

key	value
type	USER_BALANCES_UPDATE

The type is expected as a property (but not in the payload) of the RabbitMQ Message. Any header will be ignored.

Kafka Connector

Kafka Message Headers

key	value
type	USER_BALANCES_UPDATE

⬆️ POST /v1/integration/user/balances

The balance request is dynamic and several "balances/wallets" can be updated at the same time.

The minimum amount of wallets that needs to be sent is real_money & bonus_money

Sample Request for a balance update

{
  "balances": [
    {
      "amount": 50,
      "currency": "EUR",
      "key": "real_money",
      "exchange_rate": 1
    },
    {
      "amount": 50,
      "currency": "EUR",
      "key": "bonus_money",
      "exchange_rate": 1
    }
  ],
  "origin": "example.com",
  "timestamp": "2019-07-16T12:00:00Z",
  "user_id": "1234"
}

Key	Type	Required?	Accepted Values	Description
amount	float	Yes	N/A	Amount of balance
currency	string	Yes	Format: ISO 4217 e.g. "EUR"	Currency
key	string	Yes	"real_money", "bonus_money"	Wallet type
exchange_rate	float	Yes	N/A	Exchange rate
origin	string	Yes	e.g. www.brand.com	Origin
timestamp	string	Yes	Format: RFC 3339	Timestamp
user_id	string	Yes	N/A	User id