Payment Optimization
...
Integration Guides
Batch Account Updater
10 min
batch account updater is not enabled by default, please reach out to your account manager to activate how to upload a file you can use forter's batch account updater by uploading a batch file securely via file account transfer to your designated s3 bucket obtain your credentials from your forter implementation engineer in case you're not using forter tokens, upload your public gpg key to account updater/{env}/keys/public asc this key will be used to encrypt your response file upload your file sandbox account updater/sandbox/in production account updater/production/in note that the maximum file size should be 1gb the response file will be available at account updater/{env}/out typically after 72 hours for sandbox it can take up to a few minutes file structure forter simplifies the process of generating the account updater file format required by visa, mastercard, american express, and discover you only need to provide a straightforward csv file containing forter tokens or card numbers and expiration dates forter returns the account updater response file in the same format forter tokens forter token ftr1d8a56cfa6b3745a39e4a42d5ab1048c8 ftr12241491181084ba18ef5eb79b2af1ac3 standalone pci (pci aoc required) card number expiry date (mmyy) sequence number (optional) 4111111111111111 0127 01 5454545454545454 0227 02 response file structure forter tokens forter token updated last 4 updated expiration response code ftr1d8a56cfa6b3745a39e4a42d5ab1048c8 3254 0329 account number updated ftr12241491181084ba18ef5eb79b2af1ac3 no update standalone pci (pci aoc required) card number expiration date sequence number (optional) updated card number updated expiration response code 4111111111111111 0127 01 4111111111112222 0229 account number updated 5454545454545454 0227 02 no update response codes code description no update no update available account expiration updated the expiration date has been updated account number updated the card number was updated, possibly along the expiration date account is closed account is no longer available for processing contact cardholder the consumer has requested not to have account details updated no match there is no known update available currently the card brand may not have a matching card on file, potentially because there is no update invalid card type the merchant was not enrolled with the card brand for which this card is being requested for updates error an error occurred testing batch account updater testing is possible using the sandbox environment create a batch file using test cards tokenize the test cards beforehand if you use forter tokens encrypt the file using forter's public key if you use standalone pci card numbers upload the batch file to your secure bucket, to the account updater/sandbox/in folder the response file will be available after a few moments in the account updater/sandbox/out folder test cards 4444555566660014 no update 4444555566660022 account expiration updated 4444555566660030 account number updated 4444555566660048 account is closed 4444555566660055 contact cardholder 4444555566660071 no match 4444555566660063 error