Skip to main content
Version: 1.1

Inter Account Transfers

POST https://api.fraudio.com/v1/transactions/inter-account-transfers

Endpoint Overview

Our Inter Account Transfers endpoint collects wallet transfers between-, in- and out of merchants' wallet accounts. These types of transactions provide us with more complete profiles of merchants which improves the quality of the Merchant Fraud and/or the AML product for you.

Account Bank Transfers are only applicable under the following circumstances:

  • you are using the Merchant Fraud product and/or the AML product
  • you have visibility over merchants' wallet accounts
  • the wallet transfers are initiated by the merchants (if the transfers are all scheduled and automated by default, then there is no need to send wallet transfers to this endpoint)

The inter-bank transfers can be sent either individually or in batch.

Request Parameters

Request parameters in JSON format

{
"data": [
{
"sender_transactionid": "cd99e97e-bb58-4148-caed-af26effefffd",
"receiver_transactionid": "d6a7b747-474f-bc95-98da-72b01855ba5b",
"sender_walletid": "893067473928",
"receiver_walletid": "783391316672",
"timestamp": 1646063615,
"sender_merchant": "cfbe1fc6-3069-b390-4287-f0d653acc3cc",
"receiver_merchant": "e2122240-ad11-471f-ada2-cd6cd4e6acdb",
"originalamount": 1.1,
"currency": "978"
}
]
}

Request parameters: Field Reference Table

FieldData TypePayment Fraud (Issuer)Payment Fraud (Acquirer / Processor)Merchant Fraud / AMLDescription
sender_transactionidStringn.a.n.a.Important
ID of the transaction for the sending wallet.
receiver_transactionidStringn.a.n.a.Important
ID of the transaction for the receiving wallet.
timestampDoublen.a.n.a.Important
The UTC time at which the transaction was made. When sending events in realtime, this will usually be 'now'. Only Unix Timestamps are accepted.
sender_merchantStringn.a.n.a.Important
The name or identifier of the merchant corresponding to the sender wallet. This field uniquely identifies the merchant, and should not be confused with the MID. Any name or unique identifier is accepted.
receiver_merchantStringn.a.n.a.Important
The name or identifier of the merchant corresponding to the receiving wallet. This field uniquely identifies the merchant, and should not be confused with the MID. Any name or unique identifier is accepted.
originalamountDoublen.a.n.a.Important
Amount/value of the transaction in the original currency. Must be a nonnegative value.
currencyStringn.a.n.a.Important
The 3-digit ISO code for the currency used in the transaction.
sender_walletidStringn.a.n.a.Supplementary
ID of the sending wallet.
receiver_walletidStringn.a.n.a.Supplementary
ID of the receiving wallet.

Response Parameters

200 OK Response
{
"created": 2,
"deleted": 0,
"errors": [],
"ignored": 0,
"received": 1,
"updated": 0
}
Status CodeStatus MessageDescriptionSchema
200OKStandard response for successful HTTP requests.200 OK - Data Collection Response
4xx, 500, 501, 502, 503, 504errorVarious error messages for unsuccessful HTTP requests.Problem response

Code samples

curl -X POST 'https://api.fraudio.com/v1/transactions/inter-account-transfers' \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
--data-raw '{"data":[{"sender_transactionid":"cd99e97e-bb58-4148-caed-af26effefffd","receiver_transactionid":"d6a7b747-474f-bc95-98da-72b01855ba5b","sender_walletid":"893067473928","receiver_walletid":"783391316672","timestamp":1646063615,"sender_merchant":"cfbe1fc6-3069-b390-4287-f0d653acc3cc","receiver_merchant":"e2122240-ad11-471f-ada2-cd6cd4e6acdb","originalamount":1.1,"currency":"978"}]}'