Query Payment
This API is used by PJP AIS to send the final status of a QRIS MPM transaction (success or failure) to the party that initiated the transaction, ensuring accurate and timely completion updates.
Technical Specification
Service Code: 51Required Headers
Use the standard Linkage authentication headers, signature, and device context on every request.
1
Content-Type
String
M
Fill with application/json
2
Authorization
String
M
Access token B2B
3
Authorization-Customer
String
M
Access token B2B2C
4
X-TIMESTAMP
String
M
Timestamp in RFC3339 format: yyyy-MM-ddTHH:mm:ssTZD
5
X-PARTNER-ID
String
M
Client ID provided by Finnet
7
X-EXTERNAL-ID
String
M
Random string that must be unique within a day for each partner with max 36 characters
8
CHANNEL-ID
String
M
Device identification on which the API services is currently being accessed by the End User (Customer)
9
ORIGIN
String
M
The domain of the calling application
10
X-IP-ADDRESS
String
M
The IP address of the device
11
X-DEVICE-ID
String
M
The unique identifier of the device
12
X-LATITUDE
String
M
The latitude coordinate from the device’s GPS
13
X-LONGITUDE
String
M
The longitude coordinate from the device’s GPS
Body Request
1
originalReferenceNo
String
M
1
64
Original transaction identifier on service provider system
2
originalPartnerReferenceNo
String
M
1
64
Transaction identifier number from partner
3
serviceCode
String
M
2
2
To identify which transaction that needs to be checked, must be filled with 54
4
merchantId
String
M
1
64
Identifier provided at the time of linking
Sample Request
Body Response
1
responseCode
String
M
1
7
Response code
2
responseMessage
String
M
1
150
Response description
3
originalReferenceNo
String
C
1
64
Transaction identifier/reference generated by PJP AIS Selain Bank. Mandatory if redirect
4
originalPartnerReferenceNo
String
O
1
64
Transaction identifier on service consumer system
5
serviceCode
String
M
2
2
To identify which transaction that needs to be checked, must be filled with 54
6
latestTransactionStatus
String
M
2
2
Latest transaction status labelled with constants
7
transactionStatusDesc
String
O
1
50
Transaction status description
8
paidTime
String
C
1
25
Format: YYYY-MM-DDThh:mm:ss
Mandatory for success transaction
9
amount
Object
O
1
2
10
amount.value
String
M
1
16,2
Net amount of the transaction. If it's IDR then value includes 2 decimal digits. e.g. IDR 10.000,- will be placed with 10000.00
11
amount.currency
String
M
3
3
Currency (ISO 4217)
12
feeAmount
Object
O
1
2
13
feeAmount.value
String
M
1
16,2
Net amount of the transaction. If it's IDR then value includes 2 decimal digits. e.g. IDR 10.000,- will be placed with 10000.00
14
feeAmount.currency
String
M
3
3
Currency (ISO 4217)
15
terminalId
String
O
1
16
Terminal identification
16
additionalInfo
Object
O
1
6
Additional information for custom use that are not provided by SNAP
17
additionalInfo.merchantName
String
M
1
19
Merchant PAN, Mandatory if using H2H mode for transaction
18
additionalInfo.acquirerName
String
M
1
50
Acquirer Name, Mandatory if using H2H mode for transaction
19
additionalInfo.merchantLocation
String
C
1
25
Merchant location Mandatory if H2H mode
20
additionalInfo.merchantPAN
Numeric
M
1
19
Merchant PAN, Mandatory if using H2H mode for transaction
21
additionalInfo.customerPAN
Numeric
M
1
19
Customer PAN, Mandatory if using H2H mode for transaction
22
additionalInfo.transactionDate
String
M
1
25
Transaction date and time in ISO 8601 format.
YYYY-MM-DDThh:mm:ssZ
Sample Response
Response Code & Message
1
200
2005100
Successful
2
400
4005100
Bad request
3
400
4005101
Invalid field format {field}
4
400
4005102
Invalid mandatory field {field}
5
401
4015101
Invalid token (B2B)
6
401
4015100
Unauthorised. [Reason]
7
401
4015102
Invalid Customer Token
8
401
4015103
Token Not Found (B2B)
9
401
4015104
Customer Token Not Found
10
403
4035101
Feature not allowed
11
403
4035104
Activity count limit exceeded
12
403
4035114
Insufficient Funds
13
404
4045108
Invalid merchant
14
500
5005100
General error
15
500
5005101
Internal Server Error
16
500
5005102
External Server Error
17
504
5045100
Timeout
Last updated