Integrating into AccountIQ

Introduction

The​ ​intended​ ​audience​ ​for​ ​this​ ​document​ ​is​ ​the​ ​person​ ​responsible​ ​for​ ​the​ ​technical​ ​integration. Basic​ ​knowledge​ ​of​ ​networking​ ​programming​ ​and​ ​monetary​ ​transactions​ ​are​ ​required.​ ​All requests​ ​and​ ​responses​ ​must​ ​be​ ​encoded​ ​using​ ​UTF-8.

Integration methods

There are two established methods to integrate into AccountIQ. SFTP or API and this is largely determined by you, and the solution you prefer.

Security

HTTPS with ​basic ​a​uthorization, OAuth2, private / pub key pair, ​​or ​​other ​​agreed ​​authorization ​​method

Getting Transaction data

API Request​ ​parameters and response format

If you choose the API route we will make one or multiple GET requests for each provider configured. You need to take two path parameters brand and provider, additionally we will send to query parameters from and to in the date format YYYY-MM-DD hh:mm:ss. On response AccountIQ expects you to respond in a CSV format with the appropiate mime type text/csv.

Example​

The​ ​request ​w​ill ​​download​​ all ​​Skrill ​​transactions ​​for ​the brand "​​MyBrand" ​​processed​ ​the 9:th​ ​of​ Feb 2024.

Request:

wget​ '​https://example.com/transactions/MyBrand/SKRILL?from=2024-02-09 00:00:00&to=2024-02-10​ ​00:00:00'

Response:

operator,provider,txRef,txId,providerRef,created,booked,amount,txAmount,fee,method,txType,u serId,originTxRef
“MyBrand”,”SKRILL”,”1231231231”,””,””,”2015-05-09​ ​23:01:10”,”2015-05-09​ ​23:02:35”,”20.5 EUR”,”22.5​ ​EUR”,”2.0​ ​EUR”,”VISA”,”DEPOSIT”,”​johndoe@exmaple.com​”,

Transaction fields