We'd love to know more about you!

Invalid email

Invalid full name, must include first and last name.

Invalid company name.

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.

Note

We offer and host SFTP servers if you do not wish to host your own.

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 "​​MyCasino" ​​processed​ ​the 9:th​ ​of​ Feb 2024.

Request:

wget​ '​https://example.com/transactions/MYCASINO/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
“MyCasino”,”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​”,

Note

Commas in a field must be scaped using '\,'

Transaction fields

ParameterDescriptionTypeRequiredExample
operatorThe name of the operator/brand in lowercasestringtruemybrand
providerThe name of the provider in lowercasestringtrueskrill
txRefTransaction reference used when communication with providerstringtrue
amountAmount debited or credited the user's account. A negative amount has decreased the user's account balancestringtrue100.00 EUR
txAmountAmount sent to provider. It might be in another currency than the `amount`stringtrue100.00 EUR
feeFee charged the userstringtrue10.00 SEK
createdCreation date of transactiondatetrue 2024-03-15 01:00:00
bookedDate when the transaction was booked (when the transaction was finalized and money was added or deducted)datetrue 2024-03-15 01:00:00
txTypeTransaction type. it must be one of the following: DEPOSIT, WITHDRAWAL, REFUND, CHARGEBACK, CANCELstringtrueDEPOSIT
amountBaseAmount in base currency debited or credited the user's account. A negative amount has decreased the user's account balance.stringfalse100.00 SEK
txAmountBase Amount in base currency sent to provider. It might be in another currency than the `amount`. A negative amount has decreased the user's account balancestringfalse10.00 EUR
feeBaseFee in base currency the user was charged withstringtrue0.25 EUR
txIdInternal transction id used in your system. This field is only necessary if it is not the same as txRefstringfalse
providerRefProvider's transaction id. Only available for some providersstringfalse
method Custom string of payment methodstringfalseVisa,VOUCHER,E-WALLET