Payment QR MPM

Specification

The Following tabel is spesification for this API :

API Name	Payment QR MPM
Function	This API is used to payment QRIS from app merchant to Paydia as the issuer
Service Code	48
Method	POST
URL	/snap/v1.0/qr/qr-mpm-payment
Accept	application/json
Content Type	application/json
Related Service	QRIS MPM (Issuer)

Request

The following part will be describe about parameter of request in this API:

Request Parameter

The following table is a list of request parameter in this API:

Header

The following table is Header of Request Parameters :

No	Name	Type	Length	Required	Condition	Remarks
1	Content-Type	String	Variable, 127 max	Mandatory	-	Content type, value always application/json
2	Authorization	String	Variable	Mandatory	-	Contains B2B Bearer JWT Token, you've got it from Access Token B2B
3	Authorization-Customer	String	Variable, 64 max	Mandatory	-	Contains customer token, you've got it from Access Token B2B2C
4	X-TIMESTAMP	String	Fixed, 25 max	Mandatory	-	Transaction date time, in format YYYY-MM-DDTHH:mm:ss+07:00. Time must be in GMT+7 (Jakarta time)
5	X-PARTNER-ID	String	Variable, 36 max	Mandatory	-	ID for partner was generated by Paydia. Unique ID for a partner
6	X-EXTERNAL-ID	String	Variable, 36 max	Mandatory	-	Unique messaging reference ID generated by merchant. Numeric String. Reference number that should be unique in the same day
7	CHANNEL-ID	String	Variable, 5 max	Mandatory	-	Device identification on which the API services is currently being accessed by the end user (customer)
8	X-SIGNATURE	String	Variable	Mandatory	-	Signature need to be generated with Symmetric Signature method

Body

The following table is a body of request parameter:

No	Name	Type	Length	Required	Condition	Remarks
1	partnerReferenceNo	String	Variable, 64 max	Mandatory	-	Unique transaction identifier on partner system which assigned to each transaction
2	amount	Money	Variable	Conditional	Mandatory if QR static	Contains two sub-fields: Value: Transaction amount, including the cents Currency: Currency code based on ISO
3	feeAmount	Money	Variable	Optional	-	Contains two sub-fields: Value: Transaction feeAmount, including the cents Currency: Currency code based on ISO
4	additionalInfo	JSON Object	Variable	Mandatory	-	Additional information
5	additionalInfo.qrContent	String	Variable, 512 max	Mandatory	-	Additional information QR String MPM

Request Sample

The following script is a request sample of this API:

POST /snap/v1.0/qr/qr-mpm-payment
Authorization-Customer: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJQYXlkaWEiLCJpYXQiOjE3MjU4NzE0NDUsImV4cCI6MTc0MTYzOTQ0NSwianRpIjoiZmIyMDcyZmYxOTBhNmZhZmYwMWQ1OGI2MjVjYTFiYWJiYjI5OTkxZDZjOWNiYWFiMzU0YTJjZjQ5NTMwOTY1YSIsImNsaWVudF9pZCI6ImRVVT0iLCJtZXJjaGFudF9taWQiOiJja1FFUzFVREJBSUJBZ0p3UUFSSiIsInNjb3BlIjoiUFVCTElDX0lEIiwic3RhdGUiOiIzYWRmMWNmYi0wMTc2LTQ0OGUtYTA1My00NzQ4YjJkOWYyYjYifQ.by21Xj-h9-_OlfdvF1d4oSUvdUCmgevcQZVzXxB-GeY
X-TIMESTAMP: 2024-09-09T16:26:28+07:00
X-PARTNER-ID: 35d1a1127182a65e4fe0256242a40a6d
X-SIGNATURE: dPmK027FIibrU4UU3fbFJmo4tr88bnPt3wrPRpj7A4xfKheYTzRCBHNASge2lqsVyWjAt2o3qffdfaUOpZ6xwQ==
X-EXTERNAL-ID: 1725874065
CHANNEL-ID: 894
Content-Type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJQYXlkaWEiLCJpYXQiOjE3MjU4NzEzMjQsImV4cCI6MTcyNTk1NzcyNCwiZGF0YSI6eyJlbnYiOiJkZXZlbG9wbWVudCJ9fQ.fSgJY1OgymDxjiLJoxnehB4eZPLoFa5wij0PH6a1kTA

{
    "partnerReferenceNo": "cdfde219-6c5b-4ff7-afb5-7d825a8fd768",
    "amount": {
        "value": "10000.00",
        "currency": "IDR"
    },
    "additionalInfo": {
        "qrContent": "00020101021126650013ID.PAYDIA.WWW011893600818024021200102152402120010000000303UKE5204731153033605802ID5913  Firman Zain6008PONOROGO6105634916219071524021200100000063040DDA"
    }
}

Response

The following part will be describe about parameter of response in this API:

Response Parameter

The following table is a list of response parameter in this API:

Body

The following table is a body of response parameter:

No	Name	Type	Length	Required	Condition	Remarks
1	responseCode	String	Fixed, 7 max	Mandatory	-	Refer to response code list
2	responseMessage	String	Variable, 150 max	Mandatory	-	Refer to response code list
3	referenceNo	String	Variable, 64 max	Optional	-	Transaction identifier on Paydia
4	partnerReferenceNo	String	Variable, 64 max	Mandatory	-	Unique transaction identifier on partner system which assigned to each transaction
5	transactionDate	String	Variable, 25 max	Mandatory	-	Transaction date, in format YYYY-MM-DDTHH:mm:ss+07:00. Time must be in GMT+7 (Jakarta time)
6	amount	Money	Variable	Mandatory	-	Contains two sub-fields: Value: Transaction amount, including the cents Currency: Currency code based on ISO
7	feeAmount	Money	Variable	Mandatory	-	Contains two sub-fields: Value: Transaction feeAmount, including the cents Currency: Currency code based on ISO

Response Sample

The following script is a response sample of this API:

{
    "responseCode": "2005000",
    "responseMessage": "Success",
    "partnerReferenceNo": "cdfde219-6c5b-4ff7-afb5-7d825a8fd768",
    "referenceNo": "218c79e4f7db0b3f6d14f2f8764f55162ece6806deab9516aaa0e9e322d903a1",
    "transactionDate": "2024-09-09T16:26:41+07:00",
    "amount": {
        "value": "10000.00",
        "currency": "IDR"
    },
    "feeAmount": {
        "value": "0.00",
        "currency": "IDR"
    }
}

Response Code and Message

The following table is the list response code and message of Direct Debit Payment API:

No	Response Code	Response Message	Remarks
1	2005000	Request has been processed successfully	Success
2	4005000	Bad Request	General request failed error
3	4005001	Invalid Field Format	Invalid format for certain field
4	4005002	Invalid Mandatory Field	Missing or invalid format on mandatory field
5	4015000	Unauthorized. [reason]	General unauthorized error
6	4015001	Invalid Token (B2B)	Invalid or Expired Access Token
7	4035002	Exceeds Transaction Amount Limit	Exceeds Transaction Amount Limit
8	4035005	Do Not Honor	Account or User status is abnormal
9	4035014	Insufficient Funds	Insufficient Funds
10	4045001	Transaction Not Found	Transaction not found
11	4095000	Conflict	Cannot use same X-EXTERNAL-ID in same day
12	4095001	Duplicate partnerReferenceNo	Transaction has previously been processed indicates the same partnerReferenceNo already success
13	5005000	General Error	General Error
14	5005001	Internal Server Error	Unknown Internal Server Failure, Please retry the process again