Real-Time Account Updater Enterprise
Account Updater is an Enterprise feature. Request access in the portal.
Real-Time Update
Attempts to retrieve updates to a single card
token in real-time. Possibly returns a new card
token if there were updates available.
POST
https://api.basistheory.com/account-updater/real-timePermissions
account-updater:real-time:invoke
Request
- cURL
- Node
- C#
- Java
- Python
- Go
curl "https://api.basistheory.com/account-updater/real-time" \
-H 'Content-Type: application/json' \
-H 'BT-API-KEY: ...' \
-X POST \
-d '{
"token_id": "b4b89606-794a-4652-b375-f4e1d717a5db"
}'
await client.accountUpdater.realTime.invoke({
tokenId: 'b4b89606-794a-4652-b375-f4e1d717a5db',
});
await client.AccountUpdater.RealTime.InvokeAsync(new RealTimeAccountUpdaterRequest
{
TokenId = "b4b89606-794a-4652-b375-f4e1d717a5db"
});
AccountUpdaterRealTimeResponse response = new AccountUpdaterClient(ClientOptions.builder().build())
.realTime()
.invoke(AccountUpdaterRealTimeRequest.builder()
.tokenId("b4b89606-794a-4652-b375-f4e1d717a5db")
.build());
client.account_updater.real_time.invoke(
token_id = "b4b89606-794a-4652-b375-f4e1d717a5db"
)
client.AccountUpdater.RealTime.Invoke(ctx, &basistheory.RealTimeAccountUpdaterRequest{
TokenId: "b4b89606-794a-4652-b375-f4e1d717a5db",
})
Request Parameters
Attribute | Required | Type | Description |
---|---|---|---|
token_id | true | string | Card Token identifier |
expiration_month | false | integer | The 2-digit expiration month of the account number. Not required if the card token already stores this value. |
expiration_year | false | integer | The 4-digit expiration year of the account number. Not required if the card token already stores this value. |
The token_id
must correspond to a card
token in your tenant and the card must contain a number
valid for the Visa or Mastercard networks.
If the card number corresponds to a different network, the WRN_UNSUPPORTED_NETWORK
result code will be returned.
If the card
token is missing an expiration date, the expiration_month
and expiration_year
parameters must be provided.
If the token already contains an expiration date, these parameters will override the token's expiration date when requesting updates from the network.
Response
Property | Type | Description |
---|---|---|
new_token | object | Returns a new token if an update was found. |
result_code | string | The result code of this update request |
{
"new_token": {
"id": "c06d0789-0a38-40be-b7cc-c28a718f76f1",
"tenant_id": "77cb0024-123e-41a8-8ff8-a3d5a0fa8a08",
"type": "card",
"card": {
"bin": "42424242",
"last4": "4242",
"expiration_month": 12,
"expiration_year": 2027,
"brand": "visa",
"funding": "credit",
"issuer_country": {
"alpha2": "PL",
"name": "Bermuda",
"numeric": "369"
},
"authentication": "sca_required"
},
...
},
"result_code": "UPD_PAN"
}