Multiple ID fields are now explicitly documented as int64 (64-bit integer). Please ensure your integration stores these IDs using the appropriate 64-bit type (e.g., Long in Java, BIGINT in SQL).
Key fields to note:
- transfer ID - approaching the
int32upper bound - recipient ID - approaching the
int32upper bound - card transaction ID - past the
int32upper bound - user ID
- profile ID
- balance ID
The detailed changelog of data type updates across API endpoints is listed below. Review to confirm your integration uses 64-bit data types where required.
| Endpoint | Updated fields |
|---|---|
| Address | profile, id |
| Balance | id |
| Balance Conversion | profileId, sourceBalanceId, targetBalanceId |
| Balance - Excess Money Account | profileId, recipientId, userProfileId |
| Balance Statement | balanceId, query.accountId |
| Bank Account Details | profileId, targetAccountId, id |
| Batch Group | profileId, version, shortId, userId, accountId, id, paymentInitiationId |
| Card | profileId, pageSize, pageNumber |
| Card Order | lifetimeLimit, cardHolderProfileId, id, profileId |
| Card Transaction | balanceTransactionId, balanceId |
| Case | id |
| Comparison | id |
| Disputes | profileId, transactionId |
| Direct Debit Account | id |
| Multi-Currency Account | id, profileId, recipientId |
| One Time Token | validity, userId |
| Profile | id, address.id, operationalAddresses[n].id |
| Quote Object | user, profile, option.price.priceSetId |
| Quote - Update a quote | targetAccount |
| Quote - Create authenticated quote | profileId, targetAccount |
| Recipient | id, creatorId, profileId, seekPosition |
| Recipient - Create Recipient Account | profile |
| Recipient - List Recipient Accounts | profileId, creatorId |
| Spend Controls | id |
| Transfer | profile |
| Transfer - Standard Transfer | id, user, targetAccount, sourceAccount, quote, business |
| Transfer - Originator Transfer | id, user, targetAccount, sourceAccount, business |
| Transfer - Create a Transfer | targetAccount, sourceAccount |
| Transfer - Create Third Party | targetAccount |
| Transfer - Partner License Transfer | targetAccount, sourceAccount |
| Transfer - List of completed payments | id |
| User | id, details.primaryAddress |
| User Security | id |
| 3DS challenge events (webhook event type) | data.resource.profile_id, data.challenge_expires_after |
| Account details order state change event (webhook event type) | data.profile_id |
| Account details payment state change event (webhook event type) | data.transfer.id |
| Additional verification state change event (webhook event type) | data.resource.id |
| Balance account state change event (webhook event type) | data.resource.id, data.resource.profile_id |
| Balance credit events (webhook event type) | data.resource.id, data.resource.profile_id |
| Balance update event (webhook event type) | data.resource.id, data.resource.profile_id, data.balance_id |
| Card order status change events (webhook event type) | data.resource.profile_id |
| Card production status change events (webhook event type) | data.resource.profile_id |
| Card status change events (webhook event type) | data.resource.profile_id |
| Card transaction state change events (webhook event type) | data.resource.profile_id, data.transaction_id, data.balance_transaction_id , data.debits[0].balance_id , data.credit.balance_id |
| KYC review state change event (webhook event type) | data.resource.profileId |
| Overdraft limit threshold event (webhook event type) | data.resource.id |
| Profile state change event (webhook event type) | data.resource.id |
| Swift receive credit events (webhook event type) | data.action.id, data.action.profile_id, data.action.account_id |
| Transaction disputes update events (webhook event type) | data.resource.profile_id, data.resource.transaction_id |
| Transfer active cases event (webhook event type) | data.resource.id, data.resource.profile_id, data.resource.account_id |
| Transfer payout failure event (webhook event type) | data.transfer_id, data.profile_id |
| Transfer refund event (webhook event type) | data.resource.id, data.resource.profile_id,data.resource.account_id |
| Transfer state change event (webhook event type) | data.resource.id, data.resource.profile_id,data.resource.account_id |
| User state change events (webhook event type) | data.resource.id |
| Verification state change event (webhook event type) | data.resource.id |