Transfer Status

Specification

The Following tabel is spesification for this API :

API Name	Transfer Status
Function	This API is used for merchant to do check transfer status via Paydia Bisnis
Service Code	36
Method	POST
URL	/snap/v1.0/transfer/status
Accept	application/json
Content Type	application/json
Related Service	Transfer to Bank

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	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)
4	X-PARTNER-ID	String	Variable, 36 max	Mandatory	-	ID for partner was generated by Paydia. Unique ID for a partner
5	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
6	CHANNEL-ID	String	Variable, 5 max	Mandatory	-	Device identification on which the API services is currently being accessed by the end user (customer)
7	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	originalPartnerReferenceNo	String	Variable, 64 max	Mandatory	-	Original transaction identifier on service consumer system
2	originalReferenceNo	String	Variable, 64 max	Optional	-	Original transaction identifier on service consumer system
3	originalExternalId	String	Variable, 32 max	Optional	-	Original External-ID on header message
4	serviceCode	String	Variable, 2 max	Mandatory	-	Transaction type indicator (service code of the original transaction request)
5	transactionDate	String	Variable, 25 max	Optional	-	Transaction date, in format YYYY-MM-DDTHH:mm:ss+07:00. Time must be in GMT+7 (Jakarta time)
6	amount	Money	Variable	Optional	-	Contains two sub-fields: Value: Transaction amount, including the cents Currency: Currency code based on ISO

Request Sample

The following script is a request sample of this API:

POST /snap/v1.0/transfer/status
X-TIMESTAMP: 2024-08-03T16:16:24+07:00
X-PARTNER-ID: 4abbcb6ce30229994c76169006e0dc9c
X-SIGNATURE: OioNbBoxb/O6fJJGj4Wh43WrppvEWLrGW38UEGsMYbEKEOl6pZGF07S2hSvDSpbCAtRg98eLn4Oe7bZsDECU8Q==
X-EXTERNAL-ID: 1722676675
CHANNEL-ID: 107
Content-Type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJQYXlkaWEiLCJpYXQiOjE3MjI2NzM0NzksImV4cCI6MTcyMjc1OTg3OSwiZGF0YSI6eyJlbnYiOiJwcm9kdWN0aW9uIn19.S6vpO_TFlsIgbUN3H3Hq7yDjhka1g3unLnOrDbDvWF0

{
    "originalPartnerReferenceNo": "67d6fc85-9b4d-42be-85a2-b8abdca68a80",
    "originalReferenceNo": "a63807c0-583d-4750-8528-7b8c9d930220",
    "originalExternalId": "1722675726",
    "serviceCode": "43",
    "amount": {
        "value": "15000.00",
        "currency": "IDR"
    }
}

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	originalReferenceNo	String	Fixed, 7 max	Mandatory	-	Original transaction identifier on partner system
4	originalPartnerReferenceNo	String	Fixed, 7 max	Mandatory	-	Original transaction identifier on partner system
5	originalExternalId	String	Variable, 32 max	Mandatory	-	Original External-ID on header message
6	serviceCode	String	Variable, 2 max	Mandatory	-	Transaction type indicator (service code of the original transaction request)
7	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)
8	amount	Money	Variable	Mandatory	-	Contains two sub-fields: Value: Transaction amount, including the cents Currency: Currency code based on ISO
9	beneficiaryAccountNumber	String	Variable, 32 max	Mandatory	-	Destination account number
10	beneficiaryBankCode	String	Variable, 8 max	Mandatory	-	Beneficiary Bank code
11	latestTransactionStatus	String	Fixed, 2 max	Mandatory	-	Transaction status. Contains values: 00: Success 03: Pending 06: Failed
12	transactionStatusDesc	String	Variable, 32 max	Mandatory	-	Transaction status description. Contains values: 00: Success 03: Pending 06: Failed
13	additionalInfo	JSON Object	Variable	Mandatory	-	Additional information

Response Sample

The following script is a response sample of this API:

{
    "responseCode": "2003600",
    "responseMessage": "Successful",
    "originalReferenceNo": "a63807c0-583d-4750-8528-7b8c9d930220",
    "originalPartnerReferenceNo": "67d6fc85-9b4d-42be-85a2-b8abdca68a80",
    "originalExternalId": "1722675726",
    "serviceCode": "43",
    "transactionDate": "2024-08-03T16:02:06+07:00",
    "amount": {
        "value": "15000.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNumber": "3647075923",
    "beneficiaryBankCode": "014",
    "latestTransactionStatus": "00",
    "transactionStatusDesc": "Success",
    "additionalInfo": []
}

Response Code and Message

The following table is the list response code and message of Transfer Status API:

No	Response Code	Response Message	Remarks
1	2003600	Successful	Success to be processed
2	4003601	Invalid Field Format	Invalid format for certain field
3	4003602	Invalid Mandatory Field	Missing or invalid format on mandatory field
4	4013600	Unauthorized. [reason]	General unauthorized error
5	4013601	Invalid Token (B2B)	Invalid or Expired Access Token
6	4043601	Transaction Not Found	Transaction not found
7	5003602	Backend system failure	500 internal server error