API Docs

Appearance

API Transaction History List ​

API Transaction History List is used to retrieve transaction data within a specified time period.

API Information ​

FieldValue
Path/api/{version}/transaction-history-list
HTTP MethodPOST
Service Code12
Versionv1.0
TypeJSON
AuthenticationOAuth 2.0 with Access Token

Request Structure ​

Request Header ​

Details
Parameter / FieldMandatoryTypeDescription
Content-TypeMStringIndicates the media type of the resource. Use: application/json
AuthorizationMStringRepresents the access_token. Starts with "Bearer" followed by the access token. e.g.: Bearer eyJraWQiOi...
X-TIMESTAMPMStringClient's current local time in yyyy-MM-ddTHH:mm:ss.SSSTZD format
X-SIGNATUREMStringSymmetric signature using HMAC_SHA512. Formula: stringToSign = HTTPMethod + ":" + EndpointUrl + ":" + AccessToken + ":" + Lowercase(HexEncode(SHA256(minify(RequestBody)))) + ":" + TimeStamp. Notes: (1) Use full URL including all parameters. (2) If no Request Body, use empty string.
X-PARTNER-IDMStringUnique partner ID. Use the iFortepay Client ID obtained after onboarding.
X-EXTERNAL-IDMStringNumeric String. A unique reference number you generate. Must be unique on the same day.
ORIGINOStringOrigin domain registered on the iFortepay system.
CHANNEL-IDMStringDevice identification on which the API services are being accessed. Use value: api

M = Mandatory, O = Optional

Request Body ​

Details
Parameter / FieldMandatoryTypeLengthDescription
partnerReferenceNoOString64Transaction identifier on service consumer system
fromDateTimeOISODateTime (ISO-8601)25Start of time range. Defaults to today if empty.
toDateTimeOISODateTime (ISO-8601)25End of time range. Defaults to today if empty.
pageSizeOInt2Maximum number of transactions returned per page
additionalInfoOObject-Additional information. See Additional Info Object Detail.
filterOObject-Filter data based on given attributes. See Filter Object Detail.

Filter Object Detail ​

Parameter / FieldMandatoryTypeLengthDescription
originalPartnerReferenceNoOString64Original transaction identifier on service consumer system
originalReferenceNoOString64Original transaction identifier on service provider system
bankCodeOString8Transaction beneficiary bank code
amountOString-Disbursement amount
statusOString-Transaction status: INIT (in progress), SUCCESS (completed), CANCELLED (failed — balance refunded)
typeOString-Transaction type: SEND_MONEY, REFUND, TOP_UP, INQUIRY
beneficiaryAccountNoOString-Transaction beneficiary account number
beneficiaryAccountNameOString-Transaction beneficiary account name
directionOString-Transfer direction: DOMESTIC (Regular Merchant), DOMESTIC_SPECIAL_MERCHANT (PJP/PPOB Merchant)

Example Requests ​

Details
artifact
id: transaction-history-list-request
name: Example Requests - API Transaction History List
type: code.bash
content: |-
  # ── Without Filter ──────────────────────────────────────────────
  curl --location 'https://api-stage.senmo.id/api/v1.0/transaction-history-list' \
  --header 'Content-Type: application/json' \
  --header 'X-TIMESTAMP: 2023-02-21T15:44:35+07:00' \
  --header 'X-SIGNATURE: bUTwcmcNf8BgV7H7WBvCQWFd8N5/hBWQgj/LdChrGyLDZdq2DeeMWyZH3z3YldEljDJZytg9xIvg82KmPuQ49A==' \
  --header 'X-PARTNER-ID: MCPD00000012' \
  --header 'X-EXTERNAL-ID: 1676969075287' \
  --header 'CHANNEL-ID: api' \
  --header 'ORIGIN: https://www.mcpayment.co.id' \
  --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...' \
  --data '{
    "partnerReferenceNo": "20230221-0004",
    "fromDateTime": "2023-02-14T00:00:00+07:00",
    "toDateTime": "2023-02-21T17:59:59+07:00",
    "pageSize": 10,
    "pageNumber": 1,
    "additionalInfo": {}
  }'

  # ── With Filter ─────────────────────────────────────────────────
  curl --location 'https://api-stage.senmo.id/api/v1.0/transaction-history-list' \
  --header 'Content-Type: application/json' \
  --header 'X-TIMESTAMP: 2023-02-21T15:44:35+07:00' \
  --header 'X-SIGNATURE: bUTwcmcNf8BgV7H7WBvCQWFd8N5/hBWQgj/LdChrGyLDZdq2DeeMWyZH3z3YldEljDJZytg9xIvg82KmPuQ49A==' \
  --header 'X-PARTNER-ID: MCPD00000012' \
  --header 'X-EXTERNAL-ID: 1676969075287' \
  --header 'CHANNEL-ID: api' \
  --header 'ORIGIN: https://www.mcpayment.co.id' \
  --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...' \
  --data '{
    "partnerReferenceNo": "20230221-0004",
    "fromDateTime": "2023-02-14T00:00:00+07:00",
    "toDateTime": "2023-02-21T17:59:59+07:00",
    "pageSize": 10,
    "pageNumber": 1,
    "additionalInfo": {
      "filter": {
        "status": "SUCCESS"
      }
    }
  }'

Response Structure ​

Response Header ​

Details
Parameter / FieldMandatoryTypeDescription
Content-TypeMStringValue: application/json
X-TIMESTAMPMStringClient's current local time in yyyy-MM-ddTHH:mm:ss.SSSTZD format

Response Body ​

Details
Parameter / FieldMandatoryTypeLengthDescription
responseCodeMString7Response code
responseMessageMString150Response description
referenceNoMString64Transaction identifier on service provider system. Filled upon successful transaction.
partnerReferenceNoOString64Transaction identifier on service consumer system
detailDataMArray-Detail data of the transaction. See Detail Data section.
additionalInfoMObject-Additional information containing pagination info & filter attributes

Detail Data Array Detail ​

Parameter / FieldMandatoryTypeLengthDescription
dateTimeOString25Date and time of created transaction (ISO 8601)
amountOString-Transaction amount
amount.valueMString16,2Value of the transaction
amount.currencyMString3Currency of the transaction
remarkOString256Transaction description
sourceOfFundsOArray-Source of funds. iFortepay uses only BALANCE. See Source of Funds Detail.
statusMString32Transaction status: INIT, SUCCESS, CANCELLED
typeMString32Transaction type: SEND_MONEY, REFUND, TOP_UP, INQUIRY
additionalInfoOObject-Additional information from detailed transaction data. See Additional Info Object Detail.

Source Of Funds Array Detail ​

Parameter / FieldMandatoryTypeLengthDescription
sourceOString-Source of funds. iFortepay uses only BALANCE.
amountOObject-Total amount including transaction fee
amount.valueMString16,2Total amount value (including fee)
amount.currencyMString3Currency

Transaction Data Additional Info Object Detail ​

Parameter / FieldMandatoryTypeLengthDescription
originalReferenceNoOString64Original transaction identifier on service provider system
originalPartnerReferenceNoOString64Original transaction identifier on service consumer system
beneficiaryAccountNoMString34Beneficiary account number
beneficiaryAccountNameMString50Beneficiary name
bankCodeMString8Beneficiary bank code
bankNameOString-Beneficiary bank name
cancelledReasonCString-Cancellation reason. Filled only if transaction status is CANCELLED.
directionMString-Disbursement direction
feeMObject-Fee disbursement
fee.valueMString16,2Fee value of disbursement transaction
fee.currencyMString3Currency
timeServedOString-Date and time the transaction was processed
createdFromOString-Transaction creation source. Value: API (created via Open API)

Additional Info Object Detail (Pagination) ​

Parameter / FieldMandatoryTypeLengthDescription
totalDataMInteger-Total data returned across all pages
pageSizeMInteger-Total data returned on the current page
pageNumberMInteger-Current page number
totalPageMInteger-Total/max pages available
filterOObject-Filter data based on given attributes

Example Responses ​

Details

✅ Send Money — Success ​

json
{
  "responseCode": "2001200",
  "responseMessage": "Successful",
  "partnerReferenceNo": "20230221-0004",
  "referenceNo": "63f4841564c80e9691660ba3",
  "detailData": [{
    "dateTime": "2023-02-15T17:07:24+07:00",
    "amount": { "value": "50000.00", "currency": "IDR" },
    "remark": "Testing 1 - 15 Feb 23",
    "sourceOfFunds": [{ "source": "BALANCE", "amount": { "value": "54500.00", "currency": "IDR" } }],
    "status": "SUCCESS",
    "type": "SEND_MONEY",
    "additionalInfo": {
      "originalReferenceNo": "63ecaedc50f15ec3dafbfafa",
      "originalPartnerReferenceNo": "QA-20230215-001",
      "beneficiaryAccountNo": "8753293240",
      "beneficiaryAccountName": "Test BCA",
      "bankCode": "014",
      "bankName": "BCA",
      "cancelledReason": "",
      "direction": "DOMESTIC",
      "fee": { "value": "4500.00", "currency": "IDR" },
      "timeServed": "2023-02-15T16:53:18+07:00",
      "createdFrom": "API"
    }
  }],
  "additionalInfo": { "totalData": 1, "pageSize": 10, "pageNumber": 1, "totalPage": 1, "filter": {} }
}

❌ Send Money — Cancelled ​

json
{
  "responseCode": "2001200",
  "responseMessage": "Successful",
  "partnerReferenceNo": "20230221-0004",
  "referenceNo": "63f4841564c80e9691660ba3",
  "detailData": [{
    "dateTime": "2023-02-15T17:07:24+07:00",
    "amount": { "value": "50000.00", "currency": "IDR" },
    "remark": "Testing 1 - 15 Feb 23",
    "sourceOfFunds": [{ "source": "BALANCE", "amount": { "value": "54500.00", "currency": "IDR" } }],
    "status": "CANCELLED",
    "type": "SEND_MONEY",
    "additionalInfo": {
      "originalReferenceNo": "63ecaedc50f15ec3dafbfafa",
      "originalPartnerReferenceNo": "QA-20230215-001",
      "beneficiaryAccountNo": "8753293240",
      "beneficiaryAccountName": "Test BCA",
      "bankCode": "014",
      "bankName": "BCA",
      "cancelledReason": "CANCEL STG - 1",
      "direction": "DOMESTIC",
      "fee": { "value": "4500.00", "currency": "IDR" },
      "timeServed": "2023-02-15T16:53:18+07:00",
      "createdFrom": "API"
    }
  }],
  "additionalInfo": { "totalData": 1, "pageSize": 10, "pageNumber": 1, "totalPage": 1, "filter": {} }
}

💰 Top Up ​

json
{
  "responseCode": "2001200",
  "responseMessage": "Successful",
  "partnerReferenceNo": "20230221-0004",
  "referenceNo": "63f4841564c80e9691660ba3",
  "detailData": [{
    "dateTime": "2023-02-14T15:17:40+07:00",
    "amount": { "value": "0.00", "currency": "IDR" },
    "remark": "",
    "sourceOfFunds": [{ "source": "", "amount": { "value": "10000.00", "currency": "IDR" } }],
    "status": "SUCCESS",
    "type": "TOP_UP",
    "additionalInfo": {
      "originalReferenceNo": "63eb43a484af5f60fb33fc51",
      "timeServed": "2023-02-14T15:25:02+07:00",
      "fee": "{}"
    }
  }],
  "additionalInfo": { "totalData": 1, "pageSize": 10, "pageNumber": 1, "totalPage": 1, "filter": {} }
}

🔄 Refund ​

json
{
  "responseCode": "2001200",
  "responseMessage": "Successful",
  "partnerReferenceNo": "20230221-0004",
  "referenceNo": "63f4841564c80e9691660ba3",
  "detailData": [{
    "dateTime": "2023-02-20T09:59:46+07:00",
    "amount": { "value": "10000.00", "currency": "IDR" },
    "remark": "",
    "sourceOfFunds": [{ "source": "", "amount": { "value": "15000.00", "currency": "IDR" } }],
    "status": "SUCCESS",
    "type": "REFUND",
    "additionalInfo": {
      "originalReferenceNo": "63f2e22264c80e969166072c",
      "timeServed": "2023-02-17T15:13:10+07:00",
      "fee": { "value": "5000.00", "currency": "IDR" }
    }
  }],
  "additionalInfo": { "totalData": 1, "pageSize": 10, "pageNumber": 1, "totalPage": 1, "filter": {} }
}

🔍 Account Inquiry ​

json
{
  "responseCode": "2001200",
  "responseMessage": "Successful",
  "partnerReferenceNo": "20230221-0004",
  "referenceNo": "63f4841564c80e9691660ba3",
  "detailData": [{
    "dateTime": "2023-11-20T11:43:10+07:00",
    "amount": { "value": "0.00", "currency": "IDR" },
    "remark": "",
    "sourceOfFunds": [{ "source": "BALANCE", "amount": { "value": "1000.00", "currency": "IDR" } }],
    "status": "SUCCESS",
    "type": "INQUIRY",
    "additionalInfo": {
      "originalReferenceNo": "SAI23112000000000116",
      "originalPartnerReferenceNo": "QA-20231120-001",
      "beneficiaryAccountNo": "20231116001",
      "beneficiaryAccountName": "CIMBARJ BENEFICIA",
      "bankCode": "022",
      "bankName": "CIMB Niaga/CIMB Niaga Syariah",
      "fee": { "value": "1000.00", "currency": "IDR" },
      "timeServed": "2023-11-20T11:43:10+07:00",
      "createdFrom": "API"
    }
  }],
  "additionalInfo": { "totalData": 1, "pageSize": 10, "pageNumber": 1, "totalPage": 1, "filter": {} }
}

❌ Error Response ​

json
{
  "responseCode": "4011201",
  "responseMessage": "Invalid Token B2B"
}

iFortepay API Documentation

Copyright © 2024 PT. iForte Payment Infrastructure