Skip to content

Query Receiving Trans List

Function Description

  • Query receiving trans list

Query Receiving Trans List API

Request URL

  • /virtualAccount/receivingTrans/list

Request Method

  • GET

Request Parameters

The request parameters are as follows:

ParameterRequiredTypeDefault ValueDescription
pagenoNnumber1Page number, supports up to 1000 pages
pagesizeNnumber20Display the number of items per page, supporting a maximum of 100 items
starttimeNnumber-Transaction start time, second level timestamp
endtimeNnumber-Transaction end time, second level timestamp
accountNstring-Receiving account, length limit 34 characters
uuidNstring-SGate transaction serial number, length limit 36 characters

Response Parameters

The response parameters are as follows:

  • Response Body
ParameterTypeDescription
uuidstringSGate transaction serial number
transactiontimestringtransaction time YYYY-mm-dd HH:ii:ss
accountstringIBAN of the payee account
amountfloatAmount
currencystringCurrency
exchangeinfoobjectTransaction information
exchangeinfo.custnamestringName of payer
exchangeinfo.custaccstringIBAN of the payer account
exchangeinfo.bankbicstringBank identification code of the payer account
exchangeinfo.channelreferencestringPayee bank serial number
exchangeinfo.paymentremarksstringRemarks of the payee bank

Response Parameter Example

json
{
  "code": 200,
  "message": "Request succeeded.",
  "data": [
    {
      "uuid": "0FE4B054-A1FE-11ED-9A3D-F23C925C00BC",
      "transactiontime": "2023-01-29 01:56:13",
      "account": "SA9080000000000000000001",
      "amount": 50,
      "currency": "SAR",
      "exchangeinfo": {
        "custname": "Muhammad Ali",
        "custacc": "SA9080000000000000000002",
        "bankbic": "RJHISARI",
        "channelreference": "2024042500060801002869000004",
        "paymentremarks": "B2B/FRACCT/SA9080000000000000000002/Muhammad Ali/B2B"
      }
    }
  ],
  "sensitiveFields": {},
  "requestId": "4833DD916F788D654AABC9B5BDDECD49"
}