Refund Transaction - API E-Wallet (Direct Debit) SNAP

7min

Tentang Refund Transaction - API E-Wallet (Direct Debit) SNAP
﻿
API ini digunakan untuk mengajukan proses refund dari transaksi yang dilakukan dengan metode pembayaran E-Wallet dengan Fitur Direct Debit Host to Host yang sesuai standar SNAP BI.
﻿
Refund Transaction - API E-Wallet (Direct Debit) SNAP
﻿
Silakan mengajukan akses token terlebih dahulu untuk melakukan autentikasi melalui bagian Request Access Token API - SNAP﻿.
Service Code
58
API Endpoint
﻿/api/v1.0/debit/refund﻿
HTTP Method
POST
Description
Request refund transaction for authentication 
Content-type
application/json
﻿
Request Refund Header Parameter
Parameter
Tipe
Ukuran
Kebutuhan
Deskripsi
Content-Type
String
127
Mandatory
Application/Json
Authorization
String
Variable
Mandatory
Bearer “accessToken”
X-TIMESTAMP
String
25
Mandatory
Using ISO 8601 as timestamp format.
Transaction date time, in format YYYYMMDDTHH:mm:ss+07:00.
Time must be in GMT+7 (Jakarta time).
2022-03-21T10:11:40+07:00.
X-SIGNATURE
String
Variable
Mandatory
X-SIGNATURE: created using asymmetric signature SHA256withRSA algorithm (Private_Key, stringToSign)
stringToSign = client ID + “|” + X-TIMESTAMP
X-PARTNER-ID
String
20
Mandatory
X-PARTNER-ID = CLIENT_ID
X-EXTERNAL-ID
String
40
Mandatory
Unique Reference Number
(41807553358950093184)
CHANNEL-ID
String
5
Mandatory
Channel Identification with name of Merchant + 2 digits number (mid01)
﻿
Request Refund Body Parameter
Parameter
Tipe
Ukuran
Kebutuhan
Deskripsi
merchantId
String
10
Mandatory
Merchant identifier that is unique per each Merchant
subMerchantId
String
32
Optional
Sub Merchant ID
originalReferenceNo
String
40
Mandatory
Original transaction identifier on service provider system
originalPartnerReferenceNo
String
40
Mandatory
Original transaction identifier on consumer system
partnerRefundNo
String
40
Mandatory
Reference number from Merchant for the refund
refundAmount
Array of JSON Object
Variable
Mandatory
Amount of refund
"refundAmount": {
        "value": "10000.00",
        "currency": "IDR"
    }
value
String
12
Mandatory
Value
currency
String
3
Mandatory
Currency
externalStoreId
String
32
Optional
Unique identifier of Shop ID in Client system
reason
String
256
Optional
Refund reason
additionalInfo
JSON Object
Variable
Optional
Additional information
"additionalInfo": {
        "refundType": "1"
    }
refundType
String
2
Mandatory
Refund Type:
1: Full Refund
2: Partial Refund
﻿
Response Refund Parameter
Parameter
Tipe
Ukuran
Kebutuhan
Deskripsi
responseCode
String
7
Mandatory
Refer to General Response Code and Message - API SNAP﻿ list
responseMessage
String
150
Mandatory
Refer to General Response Code and Message - API SNAP﻿ list
originalReferenceNo
String
40
Mandatory
Original transaction identifier on service provider system
originalPartnerReferenceNo
String
40
Mandatory
Original transaction identifier on service provider system
Must be filled upon successful transaction
refundNo
String
40
Mandatory
Refund number identifier on service provider system reference Number
partnerRefundNo
String
40
Mandatory
Reference number from Merchant for the refund
refundAmount
Array of JSON Object
Variable
Mandatory
Amount of refund
"refundAmount": {
        "value": "10000.00",
        "currency": "IDR"
    }
value
String
12
Mandatory
Value
currency
String
3
Mandatory
Currency
refundTime
String
25
Mandatory
Refund time ISO-8601, in format YYYYMMDDTHH:mm:ss+07:00
Time must be in GMT+7 (Jakarta time)
additionalInfo
JSON Object
Variable
Optional
Additional Information
"additionalInfo": {
        "refundType": "1"
    }
refundType
String
2
Mandatory
Refund Type:
1: Full Refund
2: Partial Refund
Sample Parameter
Sample Request
Sample Response
{
    "responseCode": "2005800",
    "responseMessage": "Successful",
    "originalPartnerReferenceNo": "2020102900000000000001",
    "originalReferenceNo": "TNICEEW05105202210141451109841",
    "refundNo": "REF993883",
    "partnerRefundNo": "239850918204981205970",
    "refundAmount": {
        "value": "10000.00",
        "currency": "IDR"
    },
    "refundTime": "2020-12-21T17:21:41+07:00",
    "additionalInfo": {
        "refundType": "1"
    }
}
{
    "responseCode": "2005800",
    "responseMessage": "Successful",
    "originalPartnerReferenceNo": "2020102900000000000001",
    "originalReferenceNo": "TNICEEW05105202210141451109841",
    "refundNo": "REF993883",
    "partnerRefundNo": "239850918204981205970",
    "refundAmount": {
        "value": "10000.00",
        "currency": "IDR"
    },
    "refundTime": "2020-12-21T17:21:41+07:00",
    "additionalInfo": {
        "refundType": "1"
    }
}
﻿
﻿

Service Code	58
API Endpoint	/api/v1.0/debit/refund
HTTP Method	POST
Description	Request refund transaction for authentication
Content-type	application/json

Parameter	Tipe	Ukuran	Kebutuhan	Deskripsi
Content-Type	String	127	Mandatory	Application/Json
Authorization	String	Variable	Mandatory	Bearer “accessToken”
X-TIMESTAMP	String	25	Mandatory	Using ISO 8601 as timestamp format. Transaction date time, in format YYYYMMDDTHH:mm:ss+07:00. Time must be in GMT+7 (Jakarta time). 2022-03-21T10:11:40+07:00.
X-SIGNATURE	String	Variable	Mandatory	X-SIGNATURE: created using asymmetric signature SHA256withRSA algorithm (Private_Key, stringToSign) stringToSign = client ID + “\|” + X-TIMESTAMP
X-PARTNER-ID	String	20	Mandatory	X-PARTNER-ID = CLIENT_ID
X-EXTERNAL-ID	String	40	Mandatory	Unique Reference Number (41807553358950093184)
CHANNEL-ID	String	5	Mandatory	Channel Identification with name of Merchant + 2 digits number (mid01)

Parameter	Tipe	Ukuran	Kebutuhan	Deskripsi
merchantId	String	10	Mandatory	Merchant identifier that is unique per each Merchant
subMerchantId	String	32	Optional	Sub Merchant ID
originalReferenceNo	String	40	Mandatory	Original transaction identifier on service provider system
originalPartnerReferenceNo	String	40	Mandatory	Original transaction identifier on consumer system
partnerRefundNo	String	40	Mandatory	Reference number from Merchant for the refund
refundAmount	Array of JSON Object	Variable	Mandatory	Amount of refund "refundAmount": { "value": "10000.00", "currency": "IDR" }
value	String	12	Mandatory	Value
currency	String	3	Mandatory	Currency
externalStoreId	String	32	Optional	Unique identifier of Shop ID in Client system
reason	String	256	Optional	Refund reason
additionalInfo	JSON Object	Variable	Optional	Additional information "additionalInfo": { "refundType": "1" }
refundType	String	2	Mandatory	Refund Type: 1: Full Refund 2: Partial Refund

Parameter	Tipe	Ukuran	Kebutuhan	Deskripsi
responseCode	String	7	Mandatory	Refer to General Response Code and Message - API SNAP list
responseMessage	String	150	Mandatory	Refer to General Response Code and Message - API SNAP list
originalReferenceNo	String	40	Mandatory	Original transaction identifier on service provider system
originalPartnerReferenceNo	String	40	Mandatory	Original transaction identifier on service provider system Must be filled upon successful transaction
refundNo	String	40	Mandatory	Refund number identifier on service provider system reference Number
partnerRefundNo	String	40	Mandatory	Reference number from Merchant for the refund
refundAmount	Array of JSON Object	Variable	Mandatory	Amount of refund "refundAmount": { "value": "10000.00", "currency": "IDR" }
value	String	12	Mandatory	Value
currency	String	3	Mandatory	Currency
refundTime	String	25	Mandatory	Refund time ISO-8601, in format YYYYMMDDTHH:mm:ss+07:00 Time must be in GMT+7 (Jakarta time)
additionalInfo	JSON Object	Variable	Optional	Additional Information "additionalInfo": { "refundType": "1" }
refundType	String	2	Mandatory	Refund Type: 1: Full Refund 2: Partial Refund

Updated 22 Oct 2024

Did this page help you?

Check Status Transaction - API E-Wallet (Direct Debit) SNAP

Notification Transaction - API E-Wallet (Direct Debit) SNAP

Refund Transaction - API E-Wallet (Direct Debit) SNAP

Tentang Refund Transaction - API E-Wallet (Direct Debit) SNAP

Refund Transaction - API E-Wallet (Direct Debit) SNAP

Request Refund Header Parameter

Request Refund Body Parameter

Response Refund Parameter

Sample Parameter

Selamat Datang di NICEPAY DOCS