Account Updater API
The 360 One Account Updater Service (AUS) helps merchants who do installment, recurring, or on-demand billing obtain updated credit card expiration dates and/or updated account numbers.
Contents
The API interface is a simple POST message, therefore language is up to the developer.
Introduction
By programmatically uploading a data file with account information to 360 One through a simple API, an inquiry will be made to both Visa and MasterCard; if the expiration date of the card has been changed, if the card has been reissued with a new account number, or if the account has been closed, that updated information will be made available in a response file that is also available through an API call.
Additioally, files can also be uploaded, checked, and retrieved manually through a web-based interface.
Certification
In order to begin utilizing the AUS, a certification process must be completed between the merchant and 360 One. A member of the 360 One certification team will be assigned to work directly with the merchant. The primary aim of certification is to validate that a request file can be formed accurately and transmitted successfully.
Technical Overview
AUS requests are uploaded in bulk to the Account Updater API. There are three sections to the upload file: one header record, one or more detail records, and one trailer record.
There are three request types available to AUS: Upload, Status Inquiry, and Download. Each are detailed below:
Example Upload request
In the upload file, periods have been added to represent spaces, and ¶ have been added to represent line breaks.
- POST /srv/api/ausUpload HTTP/1.1
Content–Type: multipart/form–data
Cache–Control: no–cache
Pragma: no–cache
User–Agent: Java/1.7.0_21
Host: www.merchante–solutions.com
Accept: text/html, image/gif, image/jpeg, *; q=.2, */*; q=.2
Connection: keep-alive
Content-Length: xxx—————————–41184676334
Content-Disposition: form-data; name=”userId”pjones
—————————–41184676334
Content-Disposition: form-data; name=”userPass”xxxxx
—————————–41184676334
Content-Disposition: form-data; name=”merchId”941000012345
—————————–41184676334
Content-Disposition: form-data; name=”reqFile”; filename=”upload_file.txt”
Content-Type: text/plainH1100000941000000000………………¶
D1VISA4805000000000009…………….1101ABC………………01¶
D1VISA4805000000000017…………….0901ABC………………02¶
D1VISA4805000000000025…………….1310ABC………………03¶
D1VISA4805000000000033…………….1409ABC………………04¶
D1VISA4805000000000041…………….1102ABC………………05¶
D1VISA4805000000000058…………….1103ABC………………06¶
D1MC 5133272000000004…………….1101ABC………………08¶
D1MC 5133272000000020…………….0901ABC………………09¶
D1MC 5133272000000038…………….1310ABC………………10¶
D1MC 5133272000000046…………….1409ABC………………11¶
D1MC 5133272000000053…………….1102ABC………………12¶
D1MC 5133272000000012…………….1106ABC………………13¶
T1000012…………………………¶
Example Upload response
The basic Upload response contains three fields: a code indicating success or failure, a plain text response message, and the system-generated ID for the uploaded file.
- rspCode=000&rspMessage=OK&reqfId=123
Example Status Inquiry request
- POST /srv/api/ausStatus HTTP/1.1
Content–Type: application/x–www–form–urlencoded
Cache–Control: no–cache
Pragma: no–cache
User–Agent: Java/1.7.0_21
Host: test.merchante–solutions.com
Accept: text/html, image/gif, image/jpeg, *; q=.2, */*; q=.2
Connection: keep-alive
Content-Length: xxxuserId=pjones&userPass=xxxxx&merchId=941000012345&reqfId=123
Example Status Inquiry response
- rspCode=000&rspMessage=OK&reqfId_0=123&reqfName_0=upload_file.txt&status_0=PENDING&systemCode_0=VAU&outboundFile_0=acq.out.a80006.s0242&outboundResponse_0=Received
This status result informs us that the file we uploaded is still in a pending status, and not ready for download yet.
Example Download request
A download may only occur when a status request returns a status of SUCCESS, and rspfId_x contains a download file ID.
- POST /srv/api/ausStatus HTTP/1.1
Content–Type: application/x–www–form–urlencoded
Cache–Control: no–cache
Pragma: no–cache
User–Agent: Java/1.7.0_21
Host: test.merchante–solutions.com
Accept: text/html, image/gif, image/jpeg, *; q=.2, */*; q=.2
Connection: keep-alive
Content-Length: xxxuserId=pjones&userPass=xxxxx&merchId=941000012345&rspfId=124
Example Download response
- H1100000941000000000………………¶
D1VISA4805000000000009…………….1101MC 5133272000000046.. ………1701NEWACCT………..03ABC..01.…………………….¶
D1MC 5133272000000004.……………1101MC 5133272000000012.………..1701NEWACCT………..03ABC..08.…………………….¶
D1MC 5133272000000020.……………0901MC 5133272000000020.………..1501NEWEXP…………03ABC..09.…………………….¶
D1MC 5133272000000038.……………1310.…………………………CLOSED…………….03ABC..10.…………………….¶
D1MC 5133272000000053.……………1102VISA4805000000000058.……….1702NEWACCT………..02ABC..12.…………………….¶
D1VISA4805000000000009…………….1101.…………………………CLOSED…….. …….02ABC..01.…………………….¶
D1VISA4805000000000017…………….0901VISA.4805000000000025.………1501NEWACCT…. ……02ABC..02.…………………….¶
T1000007…………………………¶
