[space] NICEPAY Docs [title] API Playground [path] NICEPAY API/ # Tentang API Playground *** Playground merupakan wadah menyediakan fitur uji coba ( dan ) melalui secara *real-time* sebelum memulai dengan . Fitur tersedia pada Playground ini dapat membantu memahami alur transaksi dan melakukan *debugging *lebih mudah agar implementasi berjalan sesuai kebutuhan sebelum memulai tahap *development*. # Lingkup API Playground *** Fitur tersedia pada Playground dapat diakses melalui berikut. ::::LinkArray :::LinkArrayItem{headerType="COLOR" headerColor="#0C121D"} [Postman Collection](docId\:AWtiMVRS5SNFvZsXc1BFE) Koleksi dapat diakses melalui Postman. ::: :::LinkArrayItem{headerType="COLOR" headerColor="#0C121D"} [SNAP API Testing](docId\:UZex33ReLyENKOgbJJnYp) Uji coba berbasis SNAP dalam format Swagger. ::: :::: [title] Create QRIS [path] NICEPAY API/API Playground/SNAP API Testing/QRIS/ { "id": "ubtvFt-Krzp59aZe8xsQa", "type": "api-oas-v2", "data": { "method": "POST", "url": "https://dev.nicepay.co.id/nicepay/api/v1.0/qr/qr-mpm-generate", "servers": [ { "url": "https://dev.nicepay.co.id/nicepay/api/v1.0/qr/qr-mpm-generate" }, { "url": "https://staging.nicepay.co.id/nicepay/api/v1.0/qr/qr-mpm-generate" }, { "url": "https://www.nicepay.co.id/nicepay/api/v1.0/qr/qr-mpm-generate" } ], "name": "Create QRIS", "description": "", "contentType": "application/json", "request": { "pathParameters": [], "headerParameters": [ { "kind": "required", "name": "X-TIMESTAMP", "type": "string", "example": "2022-08-04T23:59:59+07:00" }, { "kind": "required", "name": "X-SIGNATURE", "type": "string", "default": "RtZh3JLTde3laYpjI2zpLW854Dg7aPMXKH4PTnqVsgxUIOV0BVeBRQkG0CCpSSaJGKp16122ReEM9w2no4u4sg==" }, { "kind": "required", "name": "X-PARTNER-ID", "type": "string", "example": "TNICEQR081" }, { "kind": "required", "name": "X-EXTERNAL-ID", "type": "string", "example": "20230804230101" }, { "kind": "required", "name": "CHANNEL-ID", "type": "string", "example": "TNICEQR081" } ], "queryParameters": [], "bodyDataParameters": [ { "kind": "optional", "name": "body", "type": "object", "example": "{\"partnerReferenceNo\":\"ncpy20221017161458\",\"merchantId\":\"TNICEQR081\",\"storeId\":\"NicepayStoreID1\",\"amount\":{\"value\":\"10000.00\",\"currency\":\"IDR\"},\"additionalInfo\":{\"goodsNm\":\"Jhon Doe\",\"billingNm\":\"John Doe\",\"billingPhone\":\"082111111111\",\"billingEmail\":\"merchant@gmail.com\",\"billingCity\":\"Jakarta\",\"billingState\":\"DKI Jakarta\",\"billingPostCd\":\"12345\",\"billingCountry\":\"Indonesia\",\"callBackUrl\":\"https://dev.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp\",\"dbProcessUrl\":\"https://dev.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp\",\"mitraCd\":\"QSHP\",\"cartData\":{\"count\":\"1\",\"item\":[{\"img_url\":\"http://www.jamgora.com/media/avatar/noimage.png\",\"goods_detail\":\"BB12345678\",\"goods_name\":\"Pasar Modern\",\"goods_amt\":\"10000\",\"goods_quantity\":\"1\"}]},\"msId\":\"\",\"msfee\":\"\",\"msfeetype\":\"\",\"mbfee\":\"\",\"mbfeetype\":\"\"}}", "description": "", "customType": "qrmpmgenerate_body", "schema": [ { "name": "partnerReferenceNo", "kind": "required", "type": "string", "example": "" }, { "name": "amount", "kind": "required", "type": "object", "modelRef": "#/components/schemas/amount", "customType": "amount", "schema": [ { "name": "value", "kind": "optional", "type": "string", "example": "" }, { "name": "currency", "kind": "optional", "type": "string", "example": "" } ] }, { "name": "merchantId", "kind": "required", "type": "string", "example": "" }, { "name": "storeId", "kind": "required", "type": "string", "example": "" }, { "name": "additionalInfo", "kind": "optional", "type": "object", "modelRef": "#/components/schemas/additionalInfoCreate", "customType": "additionalInfoCreate", "schema": [ { "name": "goodsNm", "kind": "optional", "type": "string", "example": "" }, { "name": "billingNm", "kind": "optional", "type": "string", "example": "" }, { "name": "billingPhone", "kind": "optional", "type": "string", "example": "" }, { "name": "billingEmail", "kind": "optional", "type": "string", "example": "" }, { "name": "billingCity", "kind": "optional", "type": "string", "example": "" }, { "name": "billingState", "kind": "optional", "type": "string", "example": "" }, { "name": "billingPostCd", "kind": "optional", "type": "string", "example": "" }, { "name": "billingCountry", "kind": "optional", "type": "string", "example": "" }, { "name": "callBackUrl", "kind": "optional", "type": "string", "example": "" }, { "name": "dbProcessUrl", "kind": "optional", "type": "string", "example": "" }, { "name": "cartData", "kind": "optional", "type": "string", "example": "" }, { "name": "mitraCd", "kind": "optional", "type": "string", "example": "" } ] } ], "modelRef": "#/components/schemas/qrmpmgenerate_body", "complexItems": [ { "name": "object", "schema": [ { "name": "partnerReferenceNo", "kind": "required", "type": "string", "example": "" }, { "name": "amount", "kind": "required", "type": "object", "modelRef": "#/components/schemas/amount", "customType": "amount", "schema": [ { "name": "value", "kind": "optional", "type": "string", "example": "" }, { "name": "currency", "kind": "optional", "type": "string", "example": "" } ] }, { "name": "merchantId", "kind": "required", "type": "string", "example": "" }, { "name": "storeId", "kind": "required", "type": "string", "example": "" }, { "name": "additionalInfo", "kind": "optional", "type": "object", "modelRef": "#/components/schemas/additionalInfoCreate", "customType": "additionalInfoCreate", "schema": [ { "name": "goodsNm", "kind": "optional", "type": "string", "example": "" }, { "name": "billingNm", "kind": "optional", "type": "string", "example": "" }, { "name": "billingPhone", "kind": "optional", "type": "string", "example": "" }, { "name": "billingEmail", "kind": "optional", "type": "string", "example": "" }, { "name": "billingCity", "kind": "optional", "type": "string", "example": "" }, { "name": "billingState", "kind": "optional", "type": "string", "example": "" }, { "name": "billingPostCd", "kind": "optional", "type": "string", "example": "" }, { "name": "billingCountry", "kind": "optional", "type": "string", "example": "" }, { "name": "callBackUrl", "kind": "optional", "type": "string", "example": "" }, { "name": "dbProcessUrl", "kind": "optional", "type": "string", "example": "" }, { "name": "cartData", "kind": "optional", "type": "string", "example": "" }, { "name": "mitraCd", "kind": "optional", "type": "string", "example": "" } ] } ], "modelRef": "#/components/schemas/CreateQRis", "customType": "CreateQRis" }, { "name": "object", "schema": [] } ], "complexType": "allOf", "isExpanded": true } ], "formDataParameters": [], "oAuthParameters": [ { "id": "Authorization", "name": "Authorization", "kind": "optional", "type": "http", "scheme": "bearer" } ] }, "responses": [ { "statusCode": "200", "description": "Successful", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "GENERATED", "code": "// Successful \n{\n \"responseCode\": \"2004700\",\n \"responseMessage\": \"Successful\",\n \"referenceNo\": \"TNICEQR08108202309061901268443\",\n \"partnerReferenceNo\": \"ncpy20221017161458\",\n \"qrContent\": \"00020101021226610016ID.CO.SHOPEE.WWW01189360091800202508660208202508660303UMI520412345303360540810000.005802ID5913NicepayStore16015KAB. ACEH BARAT61052365962360520082023090619012646840708T00000026304A332\",\n \"qrUrl\": \"https://mapi.gw.uat.airpay.co.id/v3/merchant-host/qr/download?qr=4h4w4yyYAC4mMHWjHxFC99F2PoDgytUta9P2Epf6Qg\",\n \"trxId\": \"2023123100000000000001\",\n \"additionalInfo\": {\n \"goodsNm\": \"Jhon Doe\",\n \"billingNm\": \"Jhon Doe\",\n \"mitraCd\": \"QSHP\",\n \"validityPeriod\": \"2023-09-06T19:06:26+07:00\"\n }\n}" }, { "label": "Successful", "code": "{\n \"responseCode\": \"2004700\",\n \"responseMessage\": \"Successful\",\n \"referenceNo\": \"TNICEQR08108202309061901268443\",\n \"partnerReferenceNo\": \"ncpy20221017161458\",\n \"qrContent\": \"00020101021226610016ID.CO.SHOPEE.WWW01189360091800202508660208202508660303UMI520412345303360540810000.005802ID5913NicepayStore16015KAB. ACEH BARAT61052365962360520082023090619012646840708T00000026304A332\",\n \"qrUrl\": \"https://mapi.gw.uat.airpay.co.id/v3/merchant-host/qr/download?qr=4h4w4yyYAC4mMHWjHxFC99F2PoDgytUta9P2Epf6Qg\",\n \"additionalInfo\": {\n \"goodsNm\": \"Jhon Doe\",\n \"billingNm\": \"John Doe\",\n \"mitraCd\": \"QSHP\",\n \"validityPeriod\": \"2023-09-06T19:06:26+07:00\"\n }\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "SuccessfulCreateQris", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "2004700" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Successful" }, { "name": "referenceNo", "kind": "optional", "type": "string", "description": "ReferenceNo", "example": "TNICEQR08108202309061901268443" }, { "name": "partnerReferenceNo", "kind": "optional", "type": "string", "description": "Partner ReferenceNo", "example": "ncpy20221017161458" }, { "name": "qrContent", "kind": "optional", "type": "string", "description": "QR Content", "example": "00020101021226610016ID.CO.SHOPEE.WWW01189360091800202508660208202508660303UMI520412345303360540810000.005802ID5913NicepayStore16015KAB. ACEH BARAT61052365962360520082023090619012646840708T00000026304A332" }, { "name": "qrUrl", "kind": "optional", "type": "string", "description": "QR Url", "example": "https://mapi.gw.uat.airpay.co.id/v3/merchant-host/qr/download?qr=4h4w4yyYAC4mMHWjHxFC99F2PoDgytUta9P2Epf6Qg" }, { "name": "trxId", "kind": "optional", "type": "string", "description": "trxId", "example": "2023123100000000000001" }, { "name": "additionalInfo", "kind": "optional", "type": "object", "modelRef": "#/components/schemas/additionalInfoResponseCreateQris", "customType": "additionalInfoResponseCreateQris", "schema": [ { "name": "goodsNm", "kind": "optional", "type": "string", "description": "goodsNm", "example": "Jhon Doe" }, { "name": "billingNm", "kind": "optional", "type": "string", "description": "billingNm", "example": "Jhon Doe" }, { "name": "mitraCd", "kind": "optional", "type": "string", "description": "mitraCd", "example": "QSHP" }, { "name": "validityPeriod", "kind": "optional", "type": "string", "description": "validityPeriod", "example": "2023-09-06T19:06:26+07:00" } ] } ], "modelRef": "#/components/schemas/SuccessfulCreateQris", "isExpanded": true } ] }, { "statusCode": "202", "description": "Request In Progress", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "GENERATED", "code": "// Request In Progress \n{\n \"responseCode\": \"202XX00\",\n \"responseMessage\": \"Request In Progress\"\n}" }, { "label": "Request In Progress", "code": "{\n \"responseCode\": \"202XX00\",\n \"responseMessage\": \"Request In Progress\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "RequestInProgress", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "202XX00" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Request In Progress" } ], "modelRef": "#/components/schemas/RequestInProgress", "isExpanded": true } ] }, { "statusCode": "409", "description": "Duplicate partnerReferenceNo", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "GENERATED", "code": "// Duplicate partnerReferenceNo \n{\n \"responseCode\": \"409XX01\",\n \"responseMessage\": \"Duplicate partnerReferenceNo\"\n}" }, { "label": "Duplicate partnerReferenceNo", "code": "{\n \"responseCode\": \"409XX01\",\n \"responseMessage\": \"Duplicate partnerReferenceNo\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "DuplicatePartnerReferenceNo", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "409XX01" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Duplicate partnerReferenceNo" } ], "modelRef": "#/components/schemas/DuplicatePartnerReferenceNo", "isExpanded": true } ] }, { "statusCode": "500", "description": "General Error", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "GENERATED", "code": "// General Error \n{\n \"responseCode\": \"500XX00\",\n \"responseMessage\": \"General Error\"\n}" }, { "label": "General Error", "code": "{\n \"responseCode\": \"500XX00\",\n \"responseMessage\": \"General Error\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "GeneralError", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "500XX00" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "General Error" } ], "modelRef": "#/components/schemas/GeneralError", "isExpanded": true } ] }, { "statusCode": "504", "description": "Request Timeout", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "GENERATED", "code": "// Request Timeout \n{\n \"responseCode\": \"504XX00\",\n \"responseMessage\": \"Request Timeout\"\n}" }, { "label": "Request Timeout", "code": "{\n \"responseCode\": \"504XX00\",\n \"responseMessage\": \"Request Timeout\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "RequestTimeout", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "504XX00" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Request Timeout" } ], "modelRef": "#/components/schemas/RequestTimeout", "isExpanded": true } ] } ], "examples": { "selectedLanguageId": "qAIksykUcCa2lgrBL4INX", "languages": [ { "id": "qAIksykUcCa2lgrBL4INX", "language": "curl", "label": "cURL", "code": "curl --location 'https://dev.nicepay.co.id/nicepay/api/v1.0/qr/qr-mpm-generate' \\\n--header 'Accept: application/json' \\\n--header 'Content-Type: application/json' \\\n--header 'X-SIGNATURE: RtZh3JLTde3laYpjI2zpLW854Dg7aPMXKH4PTnqVsgxUIOV0BVeBRQkG0CCpSSaJGKp16122ReEM9w2no4u4sg==' \\\n--data '{\n \"partnerReferenceNo\": \"\",\n \"amount\": {\n \"value\": \"\",\n \"currency\": \"\"\n },\n \"merchantId\": \"\",\n \"storeId\": \"\",\n \"additionalInfo\": {\n \"goodsNm\": \"\",\n \"billingNm\": \"\",\n \"billingPhone\": \"\",\n \"billingEmail\": \"\",\n \"billingCity\": \"\",\n \"billingState\": \"\",\n \"billingPostCd\": \"\",\n \"billingCountry\": \"\",\n \"callBackUrl\": \"\",\n \"dbProcessUrl\": \"\",\n \"cartData\": \"\",\n \"mitraCd\": \"\"\n }\n}'" }, { "id": "OrtCsVxiG20e148TaJ0im", "language": "javascript", "label": "javascript", "code": "var myHeaders = new Headers();\nmyHeaders.append(\"Accept\", \"application/json\");\nmyHeaders.append(\"Content-Type\", \"application/json\");\nmyHeaders.append(\"X-SIGNATURE\", \"RtZh3JLTde3laYpjI2zpLW854Dg7aPMXKH4PTnqVsgxUIOV0BVeBRQkG0CCpSSaJGKp16122ReEM9w2no4u4sg==\");\n\nvar raw = JSON.stringify({\n \"partnerReferenceNo\": \"\",\n \"amount\": {\n \"value\": \"\",\n \"currency\": \"\"\n },\n \"merchantId\": \"\",\n \"storeId\": \"\",\n \"additionalInfo\": {\n \"goodsNm\": \"\",\n \"billingNm\": \"\",\n \"billingPhone\": \"\",\n \"billingEmail\": \"\",\n \"billingCity\": \"\",\n \"billingState\": \"\",\n \"billingPostCd\": \"\",\n \"billingCountry\": \"\",\n \"callBackUrl\": \"\",\n \"dbProcessUrl\": \"\",\n \"cartData\": \"\",\n \"mitraCd\": \"\"\n }\n});\n\nvar requestOptions = {\n method: 'POST',\n headers: myHeaders,\n body: raw,\n redirect: 'follow'\n};\n\nfetch(\"https://dev.nicepay.co.id/nicepay/api/v1.0/qr/qr-mpm-generate\", requestOptions)\n .then(response => response.text())\n .then(result => console.log(result))\n .catch(error => console.log('error', error));" }, { "id": "O3A5bWb-33Xn-tBlQ07Xd", "language": "ruby", "label": "Ruby", "code": "require \"uri\"\nrequire \"json\"\nrequire \"net/http\"\n\nurl = URI(\"https://dev.nicepay.co.id/nicepay/api/v1.0/qr/qr-mpm-generate\")\n\nhttps = Net::HTTP.new(url.host, url.port)\nhttps.use_ssl = true\n\nrequest = Net::HTTP::Post.new(url)\nrequest[\"Accept\"] = \"application/json\"\nrequest[\"Content-Type\"] = \"application/json\"\nrequest[\"X-SIGNATURE\"] = \"RtZh3JLTde3laYpjI2zpLW854Dg7aPMXKH4PTnqVsgxUIOV0BVeBRQkG0CCpSSaJGKp16122ReEM9w2no4u4sg==\"\nrequest.body = JSON.dump({\n \"partnerReferenceNo\": \"\",\n \"amount\": {\n \"value\": \"\",\n \"currency\": \"\"\n },\n \"merchantId\": \"\",\n \"storeId\": \"\",\n \"additionalInfo\": {\n \"goodsNm\": \"\",\n \"billingNm\": \"\",\n \"billingPhone\": \"\",\n \"billingEmail\": \"\",\n \"billingCity\": \"\",\n \"billingState\": \"\",\n \"billingPostCd\": \"\",\n \"billingCountry\": \"\",\n \"callBackUrl\": \"\",\n \"dbProcessUrl\": \"\",\n \"cartData\": \"\",\n \"mitraCd\": \"\"\n }\n})\n\nresponse = https.request(request)\nputs response.read_body\n" }, { "id": "dfIoaoOnYRogoq-tPjriX", "language": "python", "label": "Python", "code": "import requests\nimport json\n\nurl = \"https://dev.nicepay.co.id/nicepay/api/v1.0/qr/qr-mpm-generate\"\n\npayload = json.dumps({\n \"partnerReferenceNo\": \"\",\n \"amount\": {\n \"value\": \"\",\n \"currency\": \"\"\n },\n \"merchantId\": \"\",\n \"storeId\": \"\",\n \"additionalInfo\": {\n \"goodsNm\": \"\",\n \"billingNm\": \"\",\n \"billingPhone\": \"\",\n \"billingEmail\": \"\",\n \"billingCity\": \"\",\n \"billingState\": \"\",\n \"billingPostCd\": \"\",\n \"billingCountry\": \"\",\n \"callBackUrl\": \"\",\n \"dbProcessUrl\": \"\",\n \"cartData\": \"\",\n \"mitraCd\": \"\"\n }\n})\nheaders = {\n 'Accept': 'application/json',\n 'Content-Type': 'application/json',\n 'X-SIGNATURE': 'RtZh3JLTde3laYpjI2zpLW854Dg7aPMXKH4PTnqVsgxUIOV0BVeBRQkG0CCpSSaJGKp16122ReEM9w2no4u4sg=='\n}\n\nresponse = requests.request(\"POST\", url, headers=headers, data=payload)\n\nprint(response.text)\n" } ] }, "results": { "selectedLanguageId": "KDT_wAYLvkGLFnugijovP", "languages": [ { "id": "KDT_wAYLvkGLFnugijovP", "language": "200", "code": "// Successful \n{\n \"responseCode\": \"2004700\",\n \"responseMessage\": \"Successful\",\n \"referenceNo\": \"TNICEQR08108202309061901268443\",\n \"partnerReferenceNo\": \"ncpy20221017161458\",\n \"qrContent\": \"00020101021226610016ID.CO.SHOPEE.WWW01189360091800202508660208202508660303UMI520412345303360540810000.005802ID5913NicepayStore16015KAB. ACEH BARAT61052365962360520082023090619012646840708T00000026304A332\",\n \"qrUrl\": \"https://mapi.gw.uat.airpay.co.id/v3/merchant-host/qr/download?qr=4h4w4yyYAC4mMHWjHxFC99F2PoDgytUta9P2Epf6Qg\",\n \"trxId\": \"2023123100000000000001\",\n \"additionalInfo\": {\n \"goodsNm\": \"Jhon Doe\",\n \"billingNm\": \"Jhon Doe\",\n \"mitraCd\": \"QSHP\",\n \"validityPeriod\": \"2023-09-06T19:06:26+07:00\"\n }\n}", "subExamples": [ { "label": "GENERATED", "code": "// Successful \n{\n \"responseCode\": \"2004700\",\n \"responseMessage\": \"Successful\",\n \"referenceNo\": \"TNICEQR08108202309061901268443\",\n \"partnerReferenceNo\": \"ncpy20221017161458\",\n \"qrContent\": \"00020101021226610016ID.CO.SHOPEE.WWW01189360091800202508660208202508660303UMI520412345303360540810000.005802ID5913NicepayStore16015KAB. ACEH BARAT61052365962360520082023090619012646840708T00000026304A332\",\n \"qrUrl\": \"https://mapi.gw.uat.airpay.co.id/v3/merchant-host/qr/download?qr=4h4w4yyYAC4mMHWjHxFC99F2PoDgytUta9P2Epf6Qg\",\n \"trxId\": \"2023123100000000000001\",\n \"additionalInfo\": {\n \"goodsNm\": \"Jhon Doe\",\n \"billingNm\": \"Jhon Doe\",\n \"mitraCd\": \"QSHP\",\n \"validityPeriod\": \"2023-09-06T19:06:26+07:00\"\n }\n}" }, { "label": "Successful", "code": "{\n \"responseCode\": \"2004700\",\n \"responseMessage\": \"Successful\",\n \"referenceNo\": \"TNICEQR08108202309061901268443\",\n \"partnerReferenceNo\": \"ncpy20221017161458\",\n \"qrContent\": \"00020101021226610016ID.CO.SHOPEE.WWW01189360091800202508660208202508660303UMI520412345303360540810000.005802ID5913NicepayStore16015KAB. ACEH BARAT61052365962360520082023090619012646840708T00000026304A332\",\n \"qrUrl\": \"https://mapi.gw.uat.airpay.co.id/v3/merchant-host/qr/download?qr=4h4w4yyYAC4mMHWjHxFC99F2PoDgytUta9P2Epf6Qg\",\n \"additionalInfo\": {\n \"goodsNm\": \"Jhon Doe\",\n \"billingNm\": \"John Doe\",\n \"mitraCd\": \"QSHP\",\n \"validityPeriod\": \"2023-09-06T19:06:26+07:00\"\n }\n}" } ] }, { "id": "r72j9kmvRRXirnAd8uzOq", "language": "202", "code": "// Request In Progress \n{\n \"responseCode\": \"202XX00\",\n \"responseMessage\": \"Request In Progress\"\n}", "subExamples": [ { "label": "GENERATED", "code": "// Request In Progress \n{\n \"responseCode\": \"202XX00\",\n \"responseMessage\": \"Request In Progress\"\n}" }, { "label": "Request In Progress", "code": "{\n \"responseCode\": \"202XX00\",\n \"responseMessage\": \"Request In Progress\"\n}" } ] }, { "id": "InhjWAFpLMKePAARYotYt", "language": "409", "code": "// Duplicate partnerReferenceNo \n{\n \"responseCode\": \"409XX01\",\n \"responseMessage\": \"Duplicate partnerReferenceNo\"\n}", "subExamples": [ { "label": "GENERATED", "code": "// Duplicate partnerReferenceNo \n{\n \"responseCode\": \"409XX01\",\n \"responseMessage\": \"Duplicate partnerReferenceNo\"\n}" }, { "label": "Duplicate partnerReferenceNo", "code": "{\n \"responseCode\": \"409XX01\",\n \"responseMessage\": \"Duplicate partnerReferenceNo\"\n}" } ] }, { "id": "B05o8Oq6XfIM7tAmFx58b", "language": "500", "code": "// General Error \n{\n \"responseCode\": \"500XX00\",\n \"responseMessage\": \"General Error\"\n}", "subExamples": [ { "label": "GENERATED", "code": "// General Error \n{\n \"responseCode\": \"500XX00\",\n \"responseMessage\": \"General Error\"\n}" }, { "label": "General Error", "code": "{\n \"responseCode\": \"500XX00\",\n \"responseMessage\": \"General Error\"\n}" } ] }, { "id": "o5HoYp34oc4CeDxrZitI5", "language": "504", "code": "// Request Timeout \n{\n \"responseCode\": \"504XX00\",\n \"responseMessage\": \"Request Timeout\"\n}", "subExamples": [ { "label": "GENERATED", "code": "// Request Timeout \n{\n \"responseCode\": \"504XX00\",\n \"responseMessage\": \"Request Timeout\"\n}" }, { "label": "Request Timeout", "code": "{\n \"responseCode\": \"504XX00\",\n \"responseMessage\": \"Request Timeout\"\n}" } ] } ] } }, "children": [ { "text": "" } ] } [title] Hands On API [path] Mulai Segera/ Nikmati produk dan layanan NICEPAY dengan *single integrated *API dari kami yang aman serta mudah untuk integrasi dengan bisnis Anda. Mulai dengan proses integrasi yang cepat hanya dalam 15 menit! # Prasyarat *** 1. MID/iMid (Merchant ID). 2. API Key (Merchant Key). 3. NICEPAY SDK *- *Optional*.* :::hint{type="info"} Silakan periksa prasyarat pada halaman [Authentication](docId:_D-kQ0wA0XWRFReEX8mQd) terlebih dahulu. ::: # Alur Pembayaran *** ![](https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-SP0ELo5L25srBTg1gAbja-20240821-024827.jpg "Alur Pembayaran Checkout Credit Card") Deskripsi langkah alur pembayaran kartu kredit redirect dengan 3Ds: 1. Pelanggan melakukan *checkout*. 2. Pelanggan mengirim data *checkout* kepada Merchant. 3. Merchant mengajukan *checkout *menggunakan API Registration kepada NICEPAY. 4. NICEPAY mendaftarkan data *checkout*. 5. NICEPAY mengalihkan pembayaran kepada halaman milik NICEPAY kepada Merchant. 6. Merchant mengirimkan halaman pembayaran NICEPAY kepada Pelanggan. 7. Pelanggan memilih metode pembayaran. 8. Pelanggan memasukkan data kartu. 9. Pelanggan mengirimkan Informasi data kartu kepada NICEPAY. 10. NICEPAY memproses kalkulasi FDS. 11. NICEPAY mengajukan 3Ds kepada Bank. 12. Bank melakukan validasi 3Ds. 13. Bank mengirimkan *response *URL 3Ds kepada NICEPAY. 14. NICEPAY menerima *response *verifikasi. 15. NICEPAY mengalihkan Pelanggan kepada halaman autentikasi ACS. 16. Bank membuat *response *OTP. 17. Bank mengirimkan OTP kepada Pelanggan. 18. Pelanggan menerima OTP. 19. Pelanggan memasukkan OTP. 20. Pelanggan mengirimkan OTP kepada Bank. 21. Bank melakukan verifikasi OTP. 22. Bank mengirimkan hasil 3Ds kepada NICEPAY. 23. NICEPAY menerima hasil pemeriksaan. 24. NICEPAY mengajukan pembayaran kepada Bank. 25. Bank melakukan proses pembayaran. 26. Bank mengirimkan notifikasi pembayaran kepada NICEPAY. 27. NICEPAY melakukan *redirect* `callbackUrl` kepada Merchant. 28. Merchant menampilkan hasil `callbackUrl` kepada Pelanggan. 29. NICEPAY mengirim notifikasi pembayaran kepada Merchant. 30. Merchant menerima notifikasi. 31. Merchant melakukan pengajuan inquiry ke NICEPAY. 32. NICEPAY menerima pengajuan. 33. NICEPAY secara otomatis mengirimkan *response *inquiry kepada Merchant. 34. Merchant menerima status terakhir. 35. Merchant mengirim halaman hasil transaksi kepada Pelanggan. # Integrasi Pembayaran *** Dalam proses ini, Anda akan menggunakan produk [Checkout](docId\:yxIg_kKwRUKCb_lTM_1bc) kami. Seluruh transaksi pada [API Checkout](docId\:Djp90D-rlCNeDCzKwGC-d) akan melakukan *redirect* ke **NICEPAY Secure Payment Page** sebagai proses pembayaran. Ikuti lima langkah mudah di bawah ini untuk melakukan integrasi pembayaran dengan NICEPAY. 1. Melakukan panggilan API **Transaction Registration**. 2. Redirect ke **NICEPAY** **Secure Payment Page**. 3. Proses Pembayaran di **NICEPAY Secure Payment Page**. 4. **NICEPAY** akan melakukan* redirect End-User *ke `callbackUrl` Merchant. 5. Merchant melakukan panggilan API **Status Inquiry API**. ## Transaction Registration *** | **API End Point** | [`https://dev.nicepay.co.id/nicepay/redirect/v2/registration`](https://dev.nicepay.co.id/nicepay/redirect/v2/registration) | | ------------------ | -------------------------------------------------------------------------------------------------------------------------- | | **Request Method** | **POST****** | | **Header** | `Content-Type: application/json` | | **Description** | Perform Transaction Registration | | **Merchant Token** | `SHA256(timeStamp+iMid+referenceNo+amt+merchantKey)` | :::CodeblockTabs Request ```json { "timeStamp":"20221012080918", "iMid":"IONPAYTEST", "payMethod":"00", "currency":"IDR", "amt":"10000", "referenceNo":"ORDER20221012080918", "callBackUrl":"https://dev.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp", "goodsNm":"Test Transaction Nicepay", "billingNm":"John Doe", "billingPhone":"081288998899", "billingEmail":"john.doe@example.com", "billingAddr":"Jln. Raya Kasablanka Kav.88", "billingCity":"South Jakarta", "billingState":"DKI Jakarta", "billingPostCd":"12800", "billingCountry":"Indonesia", "deliveryNm":"delivery@example.com", "deliveryPhone":"081288998899", "deliveryAddr":"Jln. Raya Kasablanka Kav.88", "deliveryCity":"South Jakarta", "deliveryState":"DKI Jakarta", "deliveryPostCd":"12800", "deliveryCountry":"Indonesia", "dbProcessUrl":"https://merchant.com/api/dbProcessUrl/Notif", "merchantToken":"d8d0968892c568bc6ff5adc17cd755f85334a0b58fce85392682993a9ba653ed", "userIP":"127.0.0.1", "cartData": "{\"count\":3,\"item\":[{\"goods_id\":30,\"goods_name\":\"Beanie\",\"goods_type\":\"Accessories\",\"goods_amt\":1000,\"goods_sellers_id\":\"NICEPAY-NamaMerchant\",\"goods_sellers_name\":\"NICEPAYSHOP\",\"goods_quantity\":1,\"goods_url\":\"http://www.nicestore.com/product/beanie/\"},{\"goods_id\":31,\"goods_name\":\"Belt\",\"goods_type\":\"Accessories\",\"goods_amt\":5000,\"goods_sellers_id\":\"NICEPAY-NamaMerchant\",\"goods_sellers_name\":\"NICEPAYSHOP\",\"goods_quantity\":1,\"goods_url\":\"http://www.nicestore.store/product/belt/\"},{\"img_url\":\"http://www.jamgora.com/media/avatar/noimage.png\",\"goods_name\":\"Shipping Fee\",\"goods_id\":\"Shipping for Ref. No. 278\",\"goods_detail\":\"Flat rate\",\"goods_type\":\"Shipping with Flat rate\",\"goods_amt\":\"4000\",\"goods_sellers_id\":\"NICEPAY-NamaMerchant\",\"goods_sellers_name\":\"NICEPAYSHOP\",\"goods_quantity\":\"1\",\"goods_url\":\"https://wwww.nicestore.store\"}]}", "sellers":"[{\"sellersId\":\"NICEPAY-NamaMerchant\",\"sellersNm\":\"NICEPAYSHOP\",\"sellersUrl\":\"http://nicestore.store/product/beanie/\",\"sellersEmail\":\"Nicepay@nicepay.co.id\",\"sellersAddress\":{\"sellerNm\":\"NICEPAYSHOP\",\"sellerLastNm\":\"NICEPAYSHOP\",\"sellerAddr\":\"Jln. Kasablanka Kav 88\",\"sellerCity\":\"Jakarta\",\"sellerPostCd\":\"14350\",\"sellerPhone\":\"082111111111\",\"sellerCountry\":\"ID\"}}]", "instmntType": "2", "instmntMon": "1", "recurrOpt":"0", "bankCd":"", "mitraCd":"", "merFixAcctId":"", "vacctValidDt":"", "vacctValidTm":"" } ``` Response ```json { "resultCd": "0000", "resultMsg": "SUCCESS", "tXid": "IONPAYTEST00202212191025073439", "referenceNo": "ORDER20221012080918", "payMethod": "00", "amt": "10000", "transDt": "20221219", "transTm": "102508", "description": null, "currency": "IDR", "goodsNm": "Test Transaction Nicepay", "billingNm": "John Doe", "payValidDt": null, "payValidTm": null, "paymentURL": "https://dev.nicepay.co.id/nicepay/redirect/v2/payment" } ``` ::: :::hint{type="success"} Akses spesifikasi API lebih lengkap di [Registration - API Checkout](docId:1y_mEI3eZUS-XW2YPhGyp). ::: ## Transaction Payment *** | **API End Point** | [`https://dev.nicepay.co.id/nicepay/redirect/v2/payment`](https://dev.nicepay.co.id/nicepay/redirect/v2/payment) | | ------------------ | ---------------------------------------------------------------------------------------------------------------- | | **Request Method** | ******GET****** | | **Header** | `Content-Type: application/Form-UrlEncoded` | | **Description** | Perform Transaction Registration | | **Merchant Token** | `SHA256(timeStamp+iMid+referenceNo+amt+merchantKey)` | Setelah mendapatkan *response*, Anda dapat mengalihkan Pelanggan menuju halaman pembayaran NICEPAY. Tautan tersebut merupakan penggabungan *Response Parameter* `paymentURL`+`tXid` `https://dev.nicepay.co.id/nicepay/redirect/v2/payment?tXid=IONPAYTEST00202212191025073439`. ![NICEPAY Payment Page](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/ohh_r6otn4iPQSs_4RfL1_image-id-nicepay-secure-payment-page-main-dashboard.jpg "NICEPAY Payment Page") ![NICEPAY Payment Page](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/ojhnI_sZwKQea4vXtTgBj_image-id-kartu-kredit-success-secure-payment-page.jpg "NICEPAY Payment Page") :::hint{type="success"} Contoh di atas merupakan **Transaction Payment** menggunakan metode pembayaran Kartu Kredit. Temukan spesifikasi API lebih lengkap di [Credit Card - API Checkout](docId\:uue8Nk9jvMflKwGFDjm2J). ::: ## Callback Handling *** Setelah *User *memilih metode pembayaran Kartu Kredit, *User *akan dikembalikan ke halaman Merchant `callbackUrl` dengan metode **POST** dan pengiriman parameter. ::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/qgAGxkBa5Rgo1C8R-PhJL_nicepay-api-checkout-api-callback-handling-flow-1.png" size="50" width="370" height="361" caption="Callback Handling" position="center" darkWidth="370" darkHeight="361" showCaption="true"} :::hint{type="success"} Saat Callback diterima `callbackUrl` Anda, kami merekomendasikan Merchant untuk melakukan verifikasi Status dengan menggunakan [Status Inquiry - API Credit Card](docId\:voJ9rhAQRLcF-_74cYrFi). ::: :::hint{type="warning"} `CallBack Handling` sangat penting untuk membantu meminimalisir tindakan *Fraud*. Kami sangat merekomendasikan Merchant untuk melakukan verifikasi menggunakan `callBack parameter`. ::: :::CodeblockTabs callbackUrl ```json "callbackUrl" : "https://www.merchant.com/callbackUrl/" ``` Callback Parameter ```json { "resultCd":"0000", "resultMsg":"SUCCESS", "tXid":"IONPAYTEST01202212141112221428", "referenceNo":"", "payMethod":"01", "amt":"10000", "transDt":"20221212", "transTm":"121212", "description":"Testing Credit Card Transaction", "authNo":"080623", "issuBankCd":"OTHR" "acquBankCd":"BMRI", "cardNo":"453211*****1111", "goodsNm":"Test Transaction Nicepay" "billingNm":"John Doe", "currency":"IDR", "timeStamp":"20221212121212", "merchantToken":"2035d2295d9578fffb40137186f0203474142ae3e57992d4847826c5fcaffce6", "cardExpYymm":"2712", "instmntMon":"1", "instmntType":"1", "ccTransType":"1" } ``` ::: Selamat! Anda telah berhasil melakukan percobaan integrasi! Jelajahi lebih jauh melalui tautan di bawah ini. # See Also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem Temukan penjelasan terkait metode pembayaran dan produk kustomisasi pada halaman [Payment](docId\:cN5a57Nq9RzMUjE9FDnWm). ::: :::VerticalSplitItem Temukan penjelasan terkait produk yang sudah disediakan NICEPAY pada halaman [Checkout](docId\:yxIg_kKwRUKCb_lTM_1bc). ::: :::: ::::VerticalSplit{layout="middle"} :::VerticalSplitItem Kunjungi halaman [Payout](docId:_tBoQGqS-T6sk-ziXQl55) untuk mempelajari produk terbaru NICEPAY. ::: :::VerticalSplitItem Kunjungi halaman [Messaging](docId\:TUr_6cb3iEKRgA0L6OO46) untuk mempelajari layanan mengirim pesan yang dimiliki NICEPAY. ::: :::: [title] Daftar Sebagai Merchant [path] Mulai Segera/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/7FnzkU1aQuAkPbGRJScQA_microsoftteams-image-25.png "Daftar Sebagai Merchant") Untuk mendaftarkan sebagai di , diperlukan beberapa syarat dan dokumen perlu siapkan bergantung dari tipe dijalankan. # Dokumen Persyaratan *** | **Jenis Dokumen** | **Individu** | **PT Perorangan** | **Perusahaan (Firma, CV, PT) ** | **NPO (Yayasan)** | **Catatan** | | ------------------------------------------------- | ------------ | ----------------- | ------------------------------------ | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Merchant Application Form (MAF)** ** | ✅ | ✅ | ✅ | ✅ | Akan diberikan oleh tim Sales saat mendaftarkan diri pertama kali ke | | Perjanjian Kerja Sama (PKS) | ✅ | ✅ | ✅ | ✅ | Akan diberikan oleh tim Sales saat mendaftarkan diri pertama kali ke | | KTP Pemilik / Direktur | ✅ | ✅ | ✅ | ✅ | Nama lengkap di kartu identitas harus sesuai dengan nama di rincian orang berwenang | | NPWP Pemilik / Direktur | ✅ | ✅ | ✅ | ✅ | Nama lengkap di NPWP harus sesuai dengan nama di rincian orang berwenang (Persyaratan ini bersifat opsional bagi bisnis individu) | | NPWP Perusahaan | ❌ | ✅ | ✅ | ✅ | | | Bukti Brand (Website / Media Sosial) | ✅ | ✅ | ✅ | ✅ | 1. Harus dapat diakses 2. Isi kontennya harus sesuai dengan kategori didaftarkan | | Foto *Cover *Buku Tabungan | ✅ | ✅ | ✅ | ✅ | Mohon sertakan nama | | Mutasi Rekening | ✅ | ✅ | ✅ | ✅ | 3 bulan terakhir | | Foto Ruang Kerja | ✅ | ✅ | ✅ | ✅ | | | Foto Luar Kantor | ✅ | ✅ | ✅ | ✅ | Foto bentuk bangunan | | SIUP (Izin Usaha) atau Nomor Induk Berusaha (NIB) | ❌ | ✅ | ✅ | ✅ | - Bagi didirikan pada tahun 2022, tidak perlu melampirkan SIUP akan tetapi diganti NIB - Sedangkan bagi didirikan sebelum 2022, mohon lampirkan SIUP-nya - Bagi berbadan hukum Yayasan, SIUP bisa diganti dengan Izin Operasional Yayasan dan Tanda Daftar Yayasan diterbitkan oleh Dinas Sosial | | Akta Pendirian Perusahaan | ❌ | ❌ | ✅ | ✅ | | | Akta Perubahan Perusahaan | ❌ | ❌ | ✅ | ✅ | Wajib dilampirkan jika ada perubahan pada Akta Pendirian | | SK Kemenkumham | ❌ | ❌ | ✅ | ✅ | | | Bukti Pendaftaran Kemenkumham | ❌ | ✅ | ❌ | ❌ | Berisi lampiran data perseroan dan sertifikat pendaftaran perseroan perorangan | | SK Domisili Yayasan | ❌ | ❌ | ❌ | ✅ | | | Bukti Pendaftaran PSE Lingkup Privat | ❌ | ✅ | ✅ | ✅ | Wajib dilampirkan apabila memenuhi kriteria sebagai PSE Lingkup Privat. Bukti dapat berupa Tanda Daftar PSE / bukti pendaftaran PSE sesuai dengan sistem elektronik digunakan . | :::hint{type="warning"} Kriteria PSE: 1. Bagi yang memiliki portal, situs, atau aplikasi melalui **internet ** digunakan untuk menyediakan, mengelola, dan/atau mengoperasikan penawaran dan/atau perdagangan barang dan/atau jasa; 2. Menyediakan, mengelola, dan/atau mengoperasikan layanan transaksi keuangan; 3. Pengiriman materi atau muatan digital berbayar melalui jaringan data baik dengan cara unduh melalui portal atau situs, pengiriman lewat surat elektronik, atau melalui aplikasi lain ke perangkat Pengguna Sistem Elektronik; 4. Layanan mesin pencari, layanan penyediaan Informasi Elektronik berbentuk tulisan, suara, gambar, animasi, musik, video, film, dan permainan atau kombinasi dari sebagian dan/atau seluruhnya; 5. Pemrosesan Data Pribadi untuk kegiatan operasional melayani masyarakat terkait dengan aktivitas Transaksi Elektronik; dan 6. Kriteria lainnya sebagaimana yang diatur dalam Permenkominfo 5/2020 beserta perubahannya dari waktu ke waktu. ::: # Langkah Pendaftaran *** ## Melalui Sales NICEPAY 1. daftar melalui [halaman ini](https://nicepay.co.id/id/contact-sales/). 2. Mohon lengkapi formulir yang tersedia. - Mohon mengisi nomor telepon kantor atau ponsel yang tersambung dengan Whatsapp. - alasan mengisi formulir tersebut melalui *dropdown *`Bagaimana kami dapat membantu?`. Pilihan `Saya ingin registrasi di NICEPAY` akan otomatis terpilih jika tidak ada perubahan. - alasan ketertarikan pada melalui *dropdown *`Produk atau layanan yang Anda minati`. 3. `Send` untuk mengirim formulir kepada . 4. Tim Sales akan menghubungi dalam waktu paling lama 1 hari kerja mengenai pendaftaran sebagai . # Kategori Bisnis Terlarang *** :::hint{type="danger"} ⚠️ melayani penerimaan untuk berbagai , kecuali badan usaha menjual /menyediakan jasa di bawah ini: 1. Perjudian. 2. Produk Tembakau. 3. Minuman beralkohol. 4. Pornografi. 5. Obat Terlarang. 6. Melakukan kegiatan usaha menjadikan BitCoin (*Digital Gold*) sebagai alat selain untuk kegiatan usaha jual beli asset kripto sebagaimana diatur serta sepanjang diperbolehkan dalam peraturan perundang-undangan berlaku. 7. Senjata api dan tajam. 8. Uang tunai dimuka. 9. Barang-barang artifisial melanggar Hak Kekayaan Intelektual. 10. Barang atau jasa melanggar hukum, perundang-undangan, dan/atau ketertiban umum. 11. Barang atau jasa melanggar norma-norma sosial, agama, dan/atau moral. 12. Dompet digital dapat diisi oleh melalui kartu kredit. 13. Tidak bergerak dalam bidang *multi level marketing* memiliki skema *money games* atau skema ponzi atau skema lain sejenis dibuktikan dengan sertifikat asosiasi penjual langsung (APLI) atau hasil *on-site*. ::: melihat [Syarat dan Ketentuan](https://nicepay.co.id/id/privacy-policy/) untuk mengetahui lebih lengkap. [title] NICEPAY API [path] / ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/7frcND5LbvGXsDy7C1Jk0_api.jpg "NICEPAY API") # Selamat datang di dokumentasi NICEPAY API! berkomitmen menjadi penyedia jasa *online* dapat memenuhi segala kebutuhan sebagai . Kami menyediakan berbagai jenis dengan berbagai yang dapat diintegrasikan sesuai dengan kebutuhan . Mulai dari pembayaran berstandar dari hingga untuk laporan , terus berupaya menciptakan lingkungan aman dan efisien sehingga akan terasa nyaman bagi . ::::LinkArray{contentSource="CUSTOM"} :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-qpjf4hCFN4xYeD9z-SVmE-20240821-064823.jpg"} [NICEPAY Library](docId:-LENDLmgn8oCjvBWCXVoo) mempermudah dan mempercepat melalui SDK bisa digunakan untuk berbagai bahasa pemrograman digunakan oleh . ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-FUCcqdVIFEboeB-UvrGdM-20250827-064230.jpg"} [API Playground](docId\:IOnj2nAkSJepzpZcVwvS5) menyediakan fitur uji coba terhadap untuk secara *real-time*. ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/CL75ysCkuHSVBCxQpAY3A_header-nicepay-api-api-snap.jpg"} [API SNAP](docId\:Rz9KHBT6vz0PGg0jszAgn) telah menyesuaikan kebijakan dan berpedoman pada standar . berstandar meliputi **Virtual** **Account, E-wallet, QRIS** serta **Payout**. Sesuai pedoman dari , untuk 4 Layanan tersebut diwajibkan menggunakan berstandar . ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/FKVcyp68n008o8xAPD3J5_api-non-snap.jpg"} [API Non-SNAP](docId\:kXzqsXIH06f-mIhtUQ7GN) menawarkan terdepan dengan pilihan lebih bervariasi dan berbagai fitur memenuhi kebutuhan . Metode pembayaran pada versi ini meliputi **Kartu Kredit, Convenience Store, Direct Debit, Paylater, **dan **GPN **serta **Payout**. ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-2Md_RMvRuCADx5YhpWoHJ-20240821-064927.jpg"} [API Laporan Bisnis](docId\:a6SQXLBv2JHFEkKMeWLgS) membantu untuk memeriksa riwayat dan settlement secara programatis menggunakan . ::: :::: # Halaman Pembayaran *** Hingga saat ini kami memiliki dua versi API pembayaran yang memungkinkan Anda untuk menggunakan API sesuai dengan kebutuhan bisnis Anda. Berikut daftar lengkapnya: | **API** | **Payment Page** | | ------------------------------------ | ---------------------------- | | Checkout API (Redirect/Professional) | NICEPAY Secure Payment Page | | Payment API (Direct/Enterprise) | Merchant-hosted payment page | # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem Temukan penjelasan terkait dan kustomisasi pada [Payment](docId\:cN5a57Nq9RzMUjE9FDnWm). ::: :::VerticalSplitItem Temukan penjelasan terkait sudah disediakan pada [Checkout](docId\:yxIg_kKwRUKCb_lTM_1bc). ::: :::: ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Payout](docId:_tBoQGqS-T6sk-ziXQl55) untuk mempelajari terbaru . ::: :::VerticalSplitItem [Messaging](docId\:TUr_6cb3iEKRgA0L6OO46) untuk mempelajari mengirim pesan dimiliki . ::: :::: [title] API Checkout [path] NICEPAY API/ Pada **API Checkout**, fitur *payment page *atau laman saat melakukan *checkout* akan disediakan oleh sehingga akan lebih mudah dan lebih cepat dalam melakukan dengan kami. juga tidak diperlukan untuk secara satu per satu pada tersedia, hanya dengan melakukan dengan dan semua dibutuhkan akan dapat digunakan. sangat cocok digunakan untuk dengan tipe *Small Medium Enterprise* (SME) seperti *start-up.* # Alur Proses API Checkout ::::LinkArray{contentSource="CUSTOM" customOrder="K9Gly0Y-XMJtCdpbw2E7_,IHz1MyFpStQF2s4VMSajH,on97NGKrtYvQ9YByV1Gws,7M9e2JoOPO1tA3CzcR9Px,3L5AaE-KsKcZM3huXTFkd,lcbIpjzsbMrRUXQC4orm1"} :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/00qkPPJwHbIZqzvEWfWLA-20260423-090211.jpg"} [Authentication - API Checkout](docId\:BPEqe9ulITs-hCYNKGlYM) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/4i7VI2wemvNWwALSUAWFe-20260423-102816.jpg"} [Registration - API Checkout](docId:1y_mEI3eZUS-XW2YPhGyp) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/gCqvGM6yQwrKwvWZsmU-v-20260423-102840.jpg"} [Payment - API Checkout](docId\:YnNFZr9aonpJ7ZIKAFYSx) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/DLVw9dvupbdd0NxGG5tTc-20260423-102856.jpg"} [Status Inquiry - API Checkout](docId\:K9vBS87ev9_w5oJAU0et3) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/tJxX-B9TFtgaNviFfZ5BF-20260423-102908.jpg"} [Notification - API Checkout](docId:0BfdvETd5MPDBAkFzIVBE) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/E7zzcfiWwyJVYxGnQSUOi-20260423-102922.jpg"} [Cancel - API Checkout](docId\:MMmlusWDkyUsJxF421yKn) ::: :::: # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [API SNAP](docId\:Rz9KHBT6vz0PGg0jszAgn) untuk mengetahui terkait dengan standar . ::: :::VerticalSplitItem [API Non-SNAP](docId\:kXzqsXIH06f-mIhtUQ7GN) untuk mengetahui terkait versi Non-. ::: :::: ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [NICEPAY Code](docId\:kYd45uYYIjwzVs3dt8_rk) untuk mengetahui arti kode digunakan oleh . ::: :::VerticalSplitItem ::: :::: [title] Convenience Store - API Checkout [path] NICEPAY API/API Checkout/Payment - API Checkout/ # Tentang Convenience Store - API Checkout *** ini digunakan oleh untuk melakukan pengajuan kepada untuk menggunakan . # Alur Proses *** ![Alur Pembayaran CVS](https://app.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/UfP4TEy_tZh3bHthmsF8v_nicepay-archbee-payment-cvs-1-1.png "Alur Pembayaran CVS") Deskripsi langkah pendaftaran pada CVS: 1. melakukan *request* . 2. mengirimkan data kepada . 3. mendaftarkan *checkout* melalui Registration kepada . 4. melakukan validasi dan *generate *nomor . 5. mengirim nomor harus dibayarkan kepada . 6. mengirim nomor harus dibayarkan kepada . 7. memberikan nomor CVS. 8. mengirim data CVS number kepada CVS. 9. CVS mengirim data inquiry ke . 10. mem *request* inquiry. 11. mengirim *inquiry* ke CVS. 12. melakukan . 13. melakukan pada CVS. 14. CVS mem bukti . 15. CVS mengirim bukti ke . 16. CVS mengirimkan kepada . 17. memperbarui . 18. mengirim kepada . 19. *request* pemeriksaan kepada . 20. menerima *request* cek dari . 21. mengirimkan *response *kepada . 22. menerima terakhir. 23. mengirimkan hasil pesanan kepada . # NICEPAY Secure Payment Page *** ![Secure Payment Page](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/ohh_r6otn4iPQSs_4RfL1_image-id-nicepay-secure-payment-page-main-dashboard.jpg "Secure Payment Page") Gambar di atas adalah contoh dengan metode menggunakan Secure Page. ![Convenience Store - Secure Payment Page](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/f7ViaUdYPIFmeY7hhc7rD_image-id-convenience-store-secure-payment-page.jpg "Convenience Store - Secure Payment Page") Setelah memilih metode , akan disediakan daftar (Indomaret & Alfamart) dapat dipilih untuk melanjutkan . ![Success - Secure Payment Page](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/Iv-gqnRGcm10Ri88DASe0_image-id-convenience-store-success-secure-payment-page.jpg "Success - Secure Payment Page") Proses pengajuan pendaftaran telah selesai, dapat melanjutkan sampai dengan penyelesaian dengan mengikuti [Panduan Bayar CVS](docId:_dY8vW1ygeXkx0NQ0J4GB). # API Checkout Transaction Payment *** | **API URL** | `/nicepay/redirect/v2/payment` | | ------------------- | ------------------------------------------- | | **Request Method** | `Redirect-GET` | | **Header** | `Content-Type: application/Form-UrlEncoded` | ## Request Parameters for Convenience Store - API Checkout (CallbackUrl) *** | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | --------------------------------------------------------- | -------- | ---------- | --------------------- | ----------------------------------------------------------- | | `paymentURL`
Required | ANS | 14 | URL
Required | https\://dev.nicepay.co.id/nicepay/redirect/v2/payment | | `tXid`
Required | AN | 30 | Transaction ID
| IONPAYTEST00202212231106386098 | ## Response Parameter for Convenience Store - API Checkout (CallbackUrl) *** | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ------------- | -------- | ---------- | ----------------------------------------------------------- | ------------------------------------------------------ | | `resultCd` | N | 4 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | 0000 | | `resultMsg` | AN | 255 | Result Message: [Error Code](docId\:yEh1VA9k2y6sL1kQF2aWD) | SUCCESS | | `tXid` | AN | 30 | Transaction ID | IONPAYTEST00202212231106386098

When Success | | `referenceNo` | ANS | 40 | Order Number | ordNo20221223111252

When Success | | `amt` | N | 12 | Transaction Amount | 10000

When Success | | `payNo`
| N | 20 | Number | 9041231106386098

When Success | | `mitraCd` | AN | 4 | [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8) | ALMA

When Success | | `transDt` | N | 8 | Transaction Date (`YYYYMMDD`) | 20221223

When Success | | `transTm` | N | 6 | Transaction Time (`HH24MISS`) | 110638

When Success | :::hint{type="info"} Catatan: *Response* akan dikirimkan melalui `callBackurl` dengan Content-type: `application/json`dan metode: `POST Parameter`. ::: ## Sample Parameter for Convenience Store - API Checkout (CallbackUrl) *** :::hint{type="success"} Pada saat *Checkout*, *response *dari *request * di-*hit *adalah Callback URL. ::: ### Request Parameter :::CodeblockTabs cURL ```curl curl -X GET "https://www.merchant.com/callbackUrl?tXid=IONPAYTEST00202212231106386098&referenceNo=ordNo20221223111252&amount=10000&transDt=20221223&transTm=110638&payNo=9041231106386098&mitraCd=ALMA&resultCd=0000&resultMsg=SUCCESS" ``` ::: ### Callback Parameter :::CodeblockTabs Response Callback ```curl tXid=IONPAYTEST00202212231106386098 referenceNo=ordNo20221223111252 amount=10000 transDt=20221223 transTm=110638 payNo=9041231106386098 mitraCd=ALMA resultCd=0000 resultMsg=SUCCESS ``` ::: ## Callback Handling API Checkout Payment *** :::hint{type="success"} Saat *Callback* diterima `callbackUrl` , kami merekomendasikan untuk melakukan verifikasi dengan menggunakan [Status Inquiry - API Checkout](docId\:K9vBS87ev9_w5oJAU0et3). ::: :::hint{type="warning"} `Callback Handling` sangat penting untuk membantu meminimalisir tindakan *Fraud*. Kami sangat merekomendasikan untuk melakukan verifikasi menggunakan `Callback parameter`. ::: ::Image[]{src="https://app.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/JJ84170Irn8FzuQoufY8W_nicepay-api-checkout-api-callback-handling-flow-1.png" size="50" width="370" height="361" position="center" caption="Alur Callback Handling" alt="Alur Callback Handling" showCaption="true"} :::CodeblockTabs URL Callback ```json "callbackUrl" : "https://www.merchant.com/callbackUrl/" ``` Response Callback ```json tXid:CVSNORMAL000202212211000494698 referenceNo:OrdNo-20221221101233 amount:10000 transDt:20221221 transTm:100049 payNo:504100002557 mitraCd:ALMA resultCd:0000 resultMsg:SUCCESS ``` ::: [title] API Virtual Account SNAP [path] NICEPAY API/API SNAP/Payment API - SNAP/ # Tentang API Virtual Account SNAP *** Bagian ini berisi informasi terkait API Virtual Account dengan standar SNAP. # Daftar API Virtual Account SNAP *** ::::LinkArray :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-PfHgiCmIvGTNYWbtzUkB1-20240806-031943.jpg"} [Registration - API Virtual Account SNAP](docId\:K4DeuHcQ_4pSto2beLqb7) digunakan untuk mengajukan pendaftaran pembayaran. ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-ulrBlDu3n4cPcoT3ek8VM-20240806-032015.jpg"} [Notification - API Virtual Account SNAP](docId\:aZ2eut5rCfR9fRCIojK7-) digunakan untuk mengirimkan notifikasi transaksi pembayaran. ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-PycUycqzrluMX2gJyaSe3-20240827-041822.jpg"} [Check Status Transaction - API Virtual Account SNAP](docId\:xaW0SxwKv9j7b5zLbtVpR) digunakan untuk mengajukan status inquiry suatu transaksi pembayaran. ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-2ZoOpeH4dRoY6jfISdkK7-20240806-032050.jpg"} [Cancel - API Virtual Account SNAP](docId\:vN3l9wxp-CA7deDK7AtM8) digunakan untuk melakukan pembatalan transaksi pembayaran. ::: :::: # Alur Proses *** ![](https://archbee-image-uploads.s3.amazonaws.com/ho7Cq0xJG60lzOZLT7xI3-MqlNWMI-66XWksvAhHc2o-20240826-091949.jpg "Alur Proses API Virtual Account SNAP") Deskripsi Langkah: 1. Pelanggan mengirimkan data *checkout *kepada Merchant. 2. Merchant mengajukan *access token* kepada NICEPAY. 3. NICEPAY melakukan *generate access token*. 4. NICEPAY mengirimkan *response access token* kepada Merchant. 5. Merchant menerima *access token*. 6. Merchant mengajukan registrasi kepada NICEPAY. 7. NICEPAY melakukan *generate *VA. 8. NICEPAY mengirimkan nomor VA kepada Merchant. 9. Merchant menerima nomor VA. 10. Merchant menampilkan nomor VA kepada Pelanggan. 11. Pelanggan memasukkan VA dan mengirimkan data tersebut kepada Bank. 12. Bank melakukan proses pada nomor VA yang dikirimkan. 13. Bank mengirimkan inquiry kepada NICEPAY. 14. NICEPAY memeriksa transaksi. 15. NICEPAY mengirimkan informasi kepada Bank. 16. Bank mengirimkan pengajuan pembayaran kepada Pelanggan. 17. Pelanggan melakukan pembayaran kepada Bank. 18. Bank melakukan proses pembayaran. 19. Bank mengirimkan notifikasi pembayaran/pesan pembayaran kepada NICEPAY. 20. NICEPAY memperbaharui status pembayaran kepada Merchant. 21. NICEPAY mengirimkan notifikasi melalui `dbProcessUrl` kepada Merchant. 22. Merchant menerima notifikasi. 23. Merchant mengajukan pemeriksaan status API. 24. NICEPAY mengirim *response *pemeriksaan status kepada Merchant. 25. Merchant menerima status akhir. 26. Merchant menampilkan hasil status kepada Pelanggan. # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem Kunjungi halaman [API QRIS SNAP](docId:2fWhBt1oPDQeRmQJBODlU) untuk mengetahui informasi terkait standar API SNAP pada metode pembayaran QRIS. ::: :::VerticalSplitItem Kunjungi halaman [API E-Wallet (Direct Debit) SNAP](docId:24TJozvWeUtfoWWb2WN94) untuk mengetahui informasi terkait standar API SNAP pada metode pembayaran E-Wallet. ::: :::: [title] Registration - API QRIS SNAP [path] NICEPAY API/API SNAP/Payment API - SNAP/API QRIS SNAP/ # Tentang Registration - API QRIS SNAP *** API dengan standar SNAP ini digunakan untuk mengajukan pendaftaran pesanan sebelum melakukan pembayaran menggunakan metode pembayaran QRIS. # Registration - API QRIS SNAP *** :::hint{type="warning"} Silakan mengajukan akses token terlebih dahulu untuk melakukan autentikasi melalui bagian [Request Access Token API - SNAP](docId\:GcGqBIYXG1Etcd0Ji9cHX). ::: | **Service Code** | `47` | | ---------------- | ------------------------------------------- | | **API Endpoint** | `/api/v1.0/qr/qr-mpm-generate` | | **HTTP Method** | **POST** | | **Description** | Merchant Request Registration API QRIS | | **Content-type** | `application/json` | ## Request Header Parameter for Registration - API QRIS SNAP *** | **Nama Parameter Header** | **Tipe** | **Kebutuhan** | **Deskripsi** | **Contoh** | | ------------------------- | ----------------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | | `Content-Type` | String (127) | Mandatory | Type of the content. | `Application/Json` | | `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`. | | | `Authorization` | String (Variable) | Mandatory | "Bearer" + \{`access_token`} | | | `X-SIGNATURE` | String (Variable) | Mandatory | Signature will be generated by Merchant.
[Panduan X-Signature - Symmetric](docId\:UZex33ReLyENKOgbJJnYp) | | | `X-PARTNER-ID` | String
(20) | Mandatory | NICEPAY Client ID (`MID`) | IONPAYTEST | | `X-EXTERNAL-ID` | String
(40) | Mandatory | Unique messaging Reference ID generated by Merchant. Numeric String. Reference number that should be unique in every transaction in One Day. | | | `CHANNEL-ID` | String
(20) | Mandatory | Unique Channel Merchant Credential ID Number.
Client ID + "01" = Channel ID
`"IONPAYTEST" + "01" = "IONPAYTEST01"` | IONPAYTEST01 | ## Request Body Parameter for Registration - API QRIS SNAP *** | **Nama Parameter BI** | **Tipe Parameter** | **Kebutuhan** | **Parameter NICEPAY** | **Deskripsi** | **Contoh** | | --------------------- | ------------------ | ------------- | ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------- | | `partnerReferenceNo` | String (40) | Mandatory | `referenceNo` | Unique Transaction ID from Merchant | OrdNo20230303001 | | `amount` | Object | Mandatory | - | `"amount": { `
` "value":"100", `
` "currency":"IDR" `
` }` | - | | `value` | String (12) | Mandatory | `amt` | Transaction Amount
Note: Amount Format, currently only supported IDR (Indonesian Currency Rupiah) then value includes 2 decimal digits which are seperated by a dot (.) | 10000.00 | | `currency` | String (3) | Mandatory | `currency` | Default Value: IDR | IDR | | `merchantId` | String (10) | Mandatory | `iMid` | Merchant Identifier | | | `storeId` | String (32) | Optional | `storeCd` / `shopId` | Merchant ID from Acquirer Pay Side | | | `validityPeriod` | String (25) | Mandatory | `paymentExpDt`
`paymentExpTm` | Set Default: 5 minutes
Maximum: 20 minutes

Using ISO 8601 Timestamp Format | | | `additionalInfo` | Object | Mandatory | - | `"additionalInfo": { `
` ..., `
` "cartData":"{...}", `
` "mitraCd":"QSHP" `
` }` | - | | - `goodsNm` | String (200) | Mandatory | - | Goods Name | | | - `billingNm` | String (100) | Mandatory | - | Buyer Name | | | - `billingPhone` | String (20) | Mandatory | - | Buyer Phone Number | | | - `billingEmail` | String (100) | Mandatory | - | Buyer Email | | | - `billingCity` | String (50) | Mandatory | | Buyer City | | | - `billingState` | String (50) | Mandatory | - | Buyer State | | | - `billingPostCd` | String (10) | Mandatory | - | Buyer Post Number | | | - `billingCountry` | String (10) | Mandatory | - | Buyer Country | | | - `callBackUrl` | String (500) | Conditional | - | | | | - `dbProcessUrl` | String (500) | Mandatory | - | Payment Notification URL (Async Notification) | | | - `userIP` | String (64) | Mandatory | - | User IP (Customer) | | | - `cartData` | String (4000) | Mandatory | - | JSON String
`"cartData":"{...}"` | | | - `mitraCd` | String (4) | Mandatory | - | [Mitra Code - API SNAP](docId\:mebNfCDEq1GFUs9oE_MOF) | | | - `msId` | String (20) | Optional | - | Merchant Seller ID | | | - `msFee` | String (7) | Optional | - | Merchant Seller Fee | | | - `msFeeType` | String (2) | Optional | - | Merchant Seller Fee Type | | | - `mbFee` | String (7) | Optional | - | Merchant Balance Fee | | | - `mbFeeType` | String (2) | Optional | - | Merchant Balance Fee Type | | ## Request Cart Data Parameter for Registration - API QRIS SNAP *** | **Parameter** | **Deskripsi** | **Contoh** | | ------------------- | --------------------------------------- | ----------------------------------- | | `count` | Total Cart Data Count | 1 | | `item` | | | | - `img_url` | Goods Image URL (Image Size 50px\*50px) | `https://merchant.com/goodsImg.png` | | - `goods_name` | Goods Name | Merchant Goods | | - `goods_detail` | Goods Detail Description | Goods Type 001 | | - `goods_amt` | Goods Payment Amount | 100 | | - `goods_quantity` | Goods Quantity | 1 | ## Response Parameter for Registration - API QRIS SNAP *** | **Nama Parameter BI** | **Tipe Parameter** | **Kebutuhan** | **Parameter NICEPAY** | **Deskripsi** | **Contoh** | | --------------------- | ------------------ | ------------- | ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `responseCode` | String (7) | Mandatory | `responseCode` | Error code to specify the error returned
[General Response Code and Message - API SNAP](docId\:lKqJXSl5CMKdXYXxHYYSs) | 2004700 | | `responseMessage` | String (150) | Mandatory | `responseMsg` | Debug message to provide more information | Successful | | `referenceNo` | String (40) | Mandatory | `tXid` | NICEPAY Transaction ID or Identifier | IONPAYTEST08202106091121206416 | | `partnerReferenceNo` | String (40) | Mandatory | `referenceNo` | Transaction Identifier on Merchant side | ncpy20221017161458 | | `qrContent` | String (360) | Mandatory | `qrContent` | QR string in plain text | "000201010212265400161D.CO.SHOPEE.WWWO11893600918002024585002082024585052041234530
336054041.0058021D5911test6007Bandung61054016362200516-1- July 20-126304D0A9 | | `qrUrl` | String (360) | Mandatory | `qrUrl` | URL to download QR image, URL is valid for 5 minutes | https: //xxx.co.id/v3/merchant-host/qr/download?
4aRLCjAqjXYxIFavFxz0EPRX5C£G4nnzgEauyn1rL" | | `additionalInfo` | Object | Mandatory | - | `"additionalinfo": { `
` ... `
` }` | | | - `goodsNm` | String (200) | Mandatory | - | Goods Name | Merchant Goods 1 | | - `billingNm` | String (100) | Mandatory | - | Buyer Name | John Doe | | - `validityPeriod` | String (25) | Mandatory | `paymentExpDt`,
`paymentExpTm` | Transaction date ISO-8601 | 2023-03-08T07:15:00+07:00 | | - `mitraCd` | String (4) | Mandatory | | [Mitra Code - API SNAP](docId\:mebNfCDEq1GFUs9oE_MOF) | QSHP | | - `msId` | String (20) | Optional | | Merchant Seller ID | 123 | | - `msFee` | String (7) | Optional | | Merchant Seller Fee | 2000 | | - `msFeeType` | String (2) | Optional | | Merchant Seller Fee Type | 2 | | - `mbFee` | String (7) | Optional | | Merchant Balance Fee | 2000 | | - `mbFeeType` | String (2) | Optional | | Merchant Balance Fee Type | 2 | ## Sample Parameter for Registration - API QRIS SNAP *** ### Request Parameter :::CodeblockTabs cURL ```curl curl -X POST \ 'https://dev.nicepay.co.id/nicepay/api/v1.0/qr/qr-mpm-generate' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJUTklDRVFSMDgxIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJOSUNFUEFZIiwiZXhwIjoiMjAyNC0wNC0xOFQwMjozMToyOVoifQ==.5F1rppWeObC_EqJyW64W87F3M1_TLS5DzfzFhjxPZSs=' \ -H 'X-TIMESTAMP: 2022-04-18T09:00:40+07:00' \ -H 'X-SIGNATURE: SbvRKrqxRzvJtR/7rwtheRtEYYdS5NGUOtyFDCeGt1noVZUhf/uy25rVGGvzMzQdKX6TiVN9CmYTRVXhWLGFzQ==' \ -H 'X-PARTNER-ID: TNICEQR081' \ -H 'X-EXTERNAL-ID: 09041220240418' \ -H 'CHANNEL-ID: TNICEQR08101' \ -d '{"partnerReferenceNo":"ordNo2022120215134035","amount":{"value":"100.00","currency":"IDR"},"merchantId":"TNICEQR081","storeId":"NicepayStoreID1","validityPeriod":"2024-04-18T10:31:33+07:00","additionalInfo":{"goodsNm":"Test SNAP Transaction Nicepay","billingNm":"John Doe","billingPhone":"082213561712","billingEmail":"email@merchant.com","billingCity":"Jakarta","billingAddr":"Jalan Bukit Berbunga 22","billingState":"DKI Jakarta","billingPostCd":"12345","billingCountry":"Indonesia","callBackUrl":"https://ptsv2.com/t/jhon/post","dbProcessUrl":"https://ptsv2.com/t/jhon/post","userIP":"127.0.0.1","cartData":"{\"count\":1,\"item\":[{\"img_url\":\"https://d3nevzfk7ii3be.cloudfront.net/igi/vOrGHXlovukA566A.medium\",\"goods_name\":\"Nokia 3360\",\"goods_detail\":\"Old Nokia 3360\",\"goods_amt\":\"100\",\"goods_quantity\":\"1\"}]}","mitraCd":"QSHP","msId":"","msFee":"","msFeeType":"","mbFee":"","mbFeeType":""}}' ``` Node.js ```nodejs const config = { isProduction: false, // set true if using prod privateKey: cons.privateKey, clientSecret: cons.clientSecret, clientId: "TNICEQR081", isCloudServer: false, }; const accessToken = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJUTklDRVFSMDgxIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJOSUNFUEFZIiwiZXhwIjoiMjAyNC0wNC0xOFQwMjozMToyOVoifQ==.5F1rppWeObC_EqJyW64W87F3M1_TLS5DzfzFhjxPZSs="; const parameter = { body: { partnerReferenceNo: "ordNo2022120215134035", amount: { value: "100.00", currency: "IDR" }, merchantId: "TNICEQR081", storeId: "NicepayStoreID1", validityPeriod: "2024-04-18T10:31:33+07:00", additionalInfo: { goodsNm: "Test SNAP Transaction Nicepay", billingNm: "John Doe", billingPhone: "082213561712", billingEmail: "email@merchant.com", billingCity: "Jakarta", billingAddr: "Jalan Bukit Berbunga 22", billingState: "DKI Jakarta", billingPostCd: "12345", billingCountry: "Indonesia", callBackUrl: "https://ptsv2.com/t/jhon/post", dbProcessUrl: "https://ptsv2.com/t/jhon/post", userIP: "127.0.0.1", cartData: "{\"count\":1,\"item\":[{\"img_url\":\"https://d3nevzfk7ii3be.cloudfront.net/igi/vOrGHXlovukA566A.medium\",\"goods_name\":\"Nokia 3360\",\"goods_detail\":\"Old Nokia 3360\",\"goods_amt\":\"100\",\"goods_quantity\":\"1\"}]}", mitraCd: "QSHP", msId: "", msFee: "", msFeeType: "", mbFee: "", mbFeeType: "" } }, headers: { X_EXTERNAL_ID: "09041220240418", CHANNEL_ID: "TNICEQR08101", }, }; // Initialize Snap and make the request let snap = new Snap(config); let endPoint = `/api/v1.0/qr/qr-mpm-generate`; let response = snap .requestSnapTransaction(parameter, endPoint, accessToken, "POST"); ``` ```java // --- 1. Configure the NICEPay client --- NICEPay config = NICEPay.builder() .isProduction(false) .clientSecret("YOUR_CLIENT_SECRET") .partnerId("TNICEQR081") .externalID("09041220240418") .timestamp("2022-04-18T09:00:40+07:00") .privateKey("YOUR_PRIVATE_KEY") .build(); // --- 2. Set the Access Token --- String accessToken = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJUTklDRVFSMDgxIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJOSUNFUEFZIiwiZXhwIjoiMjAyNC0wNC0xOFQwMjozMToyOVoifQ==.5F1rppWeObC_EqJyW64W87F3M1_TLS5DzfzFhjxPZSs="; // --- 3. Build the Qris request body --- String cartDataJson = "{\"count\":1,\"item\":[{\"img_url\":\"https://d3nevzfk7ii3be.cloudfront.net/igi/vOrGHXlovukA566A.medium\",\"goods_name\":\"Nokia 3360\",\"goods_detail\":\"Old Nokia 3360\",\"goods_amt\":\"100\",\"goods_quantity\":\"1\"}]}"; Qris qris = Qris.builder() .merchantId("TNICEQR081") .storeId("NicepayStoreID1") .amount("100.00", "IDR") .partnerReferenceNo("ordNo2022120215134035") .validityPeriod("2024-04-18T10:31:33+07:00") .additionalInfo( "Test SNAP Transaction Nicepay", "John Doe", "082213561712", "email@merchant.com", "Jakarta", "Jalan Bukit Berbunga 22", "DKI Jakarta", "12345", "Indonesia", "https://ptsv2.com/t/jhon/post", "https://ptsv2.com/t/jhon/post", "127.0.0.1", cartDataJson, "QSHP", "", // msId "", // msFee "", // msFeeType "", // mbFee "" // mbFeeType ) .build(); // --- 4. Make the API call --- NICEPayResponse response = SnapQrisService.callServiceQrisRegist(qris, accessToken, config); ``` ```python # --- 1. Define the token request body --- bodyCreateToken = ( builderAccessToken.BuildAccessToken() .setGrantType("client_credentials") .setAdditionalInfo("") .build() ) # --- 2. Define the Qris request body components --- amount = { "value": "100.00", "currency": "IDR" } cart_data_string = '{"count":1,"item":[{"img_url":"https://d3nevzfk7ii3be.cloudfront.net/igi/vOrGHXlovukA566A.medium","goods_name":"Nokia 3360","goods_detail":"Old Nokia 3360","goods_amt":"100","goods_quantity":"1"}]}' additionalInfo = { "goodsNm": "Test SNAP Transaction Nicepay", "billingNm": "John Doe", "billingPhone": "082213561712", "billingEmail": "email@merchant.com", "billingAddr": "Jalan Bukit Berbunga 22", "billingCity": "Jakarta", "billingState": "DKI Jakarta", "billingCountry": "Indonesia", "billingPostCd": "12345", "callBackUrl": "https://ptsv2.com/t/jhon/post", "dbProcessUrl": "https://ptsv2.com/t/jhon/post", "userIP": "127.0.0.1", "msId": "", "msFee": "", "msFeeType": "", "mbFee": "", "mbFeeType": "", "cartData": cart_data_string, "mitraCd": "QSHP" } # --- 3. Build the main Qris request body --- bodyQris = ( builderQris.BuildQris() .setMerchantId("TNICEQR081") .setPartnerReferenceNo("ordNo2022120215134035") .setStoreId("NicepayStoreID1") .setValidityPeriod("2024-04-18T10:31:33+07:00") .setAmount(amount) .setAdditionalInfo(additionalInfo) .build() ) # --- 4. Set the environment --- environment = (builderEnvironment.BuildEnvironment() .isCloud(False) .isProduction(False) .build()) # --- 5. Make the API call --- result = SnapService.serviceTransaction( bodyCreateToken.jsonAccessToken(), bodyQris.jsonQris(), ConstantsEndpoints.qris(), environment ) ``` C# ```csharp string clientId = "TNICEQR081"; string privateKey = config.PrivateKey; string clientSecret = config.ClientSecret; string timestampString = "2022-04-18T09:00:40+07:00"; DateTimeOffset timestamp = DateTimeOffset.Parse(timestampString); string formattedTimestamp = timestamp.ToString("yyyy-MM-ddTHH:mm:sszzz"); string channelId = "TNICEQR08101"; string accessToken = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJUTklDRVFSMDgxIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJOSUNFUEFZIiwiZXhwIjoiMjAyNC0wNC0xOFQwMjozMToyOVoifQ==.5F1rppWeObC_EqJyW64W87F3M1_TLS5DzfzFhjxPZSs="; string externalId = "09041220240418"; ApiEndpoints apiEndpoints = new ApiEndpoints(); APIService qrisService = new APIService(apiEndpoints, clientSecret, clientId, channelId, isProduction, isCloudServer); var bodyBuilder = new QrisBuilder() .SetQrisSnap( partnerReferenceNo: "ordNo2022120215134035", merchantId: "TNICEQR081", storeId: "NicepayStoreID1", validityPeriod: "2024-04-18T10:31:33+07:00", value: "100.00", currency: "IDR", goodsNm: "Test SNAP Transaction Nicepay", billingNm: "John Doe", billingPhone: "082213561712", billingEmail: "email@merchant.com", billingCity: "Jakarta", billingState: "DKI Jakarta", billingPostCd: "12345", billingCountry: "Indonesia", callBackUrl: "https://ptsv2.com/t/jhon/post", dbProcessUrl: "https://ptsv2.com/t/jhon/post", mitraCd: "QSHP", userIP: "127.0.0.1", cartData: "{\"count\":1,\"item\":[{\"img_url\":\"https://d3nevzfk7ii3be.cloudfront.net/igi/vOrGHXlovukA566A.medium\",\"goods_name\":\"Nokia 3360\",\"goods_detail\":\"Old Nokia 3360\",\"goods_amt\":\"100\",\"goods_quantity\":\"1\"}]}" ).Build(); string jsonPayload = Newtonsoft.Json.JsonConvert.SerializeObject(bodyBuilder, Newtonsoft.Json.Formatting.Indented); string createResponse = await qrisService.SendPostRequest( apiEndpoints.GenerateQris, accessToken, formattedTimestamp, bodyBuilder, externalId ); Console.WriteLine("Generate Qris Response: " + createResponse); ``` Laravel ```php create_qris_endpoint = '/api/v1.0/qr/qr-mpm-generate'; $this->client_id = 'TNICEQR081'; $this->client_secret = 'YOUR_CLIENT_SECRET'; // Replace with your actual client secret $this->access_token = 'eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJUTklDRVFSMDgxIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJOSUNFUEFZIiwiZXhwIjoiMjAyNC0wNC0xOFQwMjozMToyOVoifQ==.5F1rppWeObC_EqJyW64W87F3M1_TLS5DzfzFhjxPZSs='; $this->store_id = 'NicepayStoreID1'; $this->amt = '100.00'; // --- 1. Setup request parameters --- $url = HttpUtil::getNicepayDomain($this->useProd, $this->useCloud) . $this->create_qris_endpoint; $helper = new Helpers(); $http_method = "POST"; $x_time_stamp = "2022-04-18T09:00:40+07:00"; $validity_period = "2024-04-18T10:31:33+07:00"; $partner_id = $this->client_id; $client_secret = $this->client_secret; $access_token = $this->access_token; $channel_id = "TNICEQR08101"; $store_id = $this->store_id; $result = array(); $external_id = "09041220240418"; // From X-EXTERNAL-ID $reference_no = "ordNo2022120215134035"; // From partnerReferenceNo $totalAmount = [ "value" => $this->amt, "currency" => "IDR" ]; $cartData = [ "count" => 1, "item" => [ [ "img_url" => "https://d3nevzfk7ii3be.cloudfront.net/igi/vOrGHXlovukA566A.medium", "goods_name" => "Nokia 3360", "goods_detail" => "Old Nokia 3360", "goods_amt" => "100.00", "goods_quantity" => "1" ] ] ]; $additionalInfo = [ "goodsNm" => "Test SNAP Transaction Nicepay", "billingNm" => "John Doe", "billingPhone" => "082213561712", "billingEmail" => "email@merchant.com", "billingCity" => "Jakarta", "billingAddr" => "Jalan Bukit Berbunga 22", "billingState" => "DKI Jakarta", "billingPostCd" => "12345", "billingCountry" => "Indonesia", "dbProcessUrl" => "https://ptsv2.com/t/jhon/post", "callBackUrl"=> "https://ptsv2.com/t/jhon/post", "userIP" => "127.0.0.1", "cartData" => json_encode($cartData), "mitraCd" => "QSHP" ]; $body = [ "partnerReferenceNo" => $reference_no, "amount" => $totalAmount, "merchantId" => $partner_id, "storeId" => $store_id, "validityPeriod" => $validity_period, "additionalInfo" => $additionalInfo ]; // --- 2. Generate Signature --- $string_to_sign = $helper->generateStringToSign( $http_method, $this->create_qris_endpoint, $access_token, $body, $x_time_stamp ); $signature = $helper->hmacSHA512Encoded( $string_to_sign, $client_secret, OPENSSL_ALGO_SHA512 ); // --- 3. Generate Header --- $header = $helper->generateHeader( $access_token, $x_time_stamp, $signature, $partner_id, $external_id, $channel_id ); // --- 4. Send Request --- try { $response = HttpUtil::postJsonRequestWithHeader($url, $body, $header); // Handle response } catch (Exception $e) { // Handle exception } ``` PHP Native ```php setIsProduction(false) ->setClientSecret('YOUR_CLIENT_SECRET') // Replace with your actual client secret ->setPartnerId('TNICEQR081') ->setExternalID('09041220240418') ->setTimestamp('2022-04-18T09:00:40+07:00') ->setPrivateKey('YOUR_PRIVATE_KEY') // Replace with your actual private key ->build(); // --- 2. Set the Access Token --- $accessToken = 'eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJUTklDRVFSMDgxIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJOSUNFUEFZIiwiZXhwIjoiMjAyNC0wNC0xOFQwMjozMToyOVoifQ==.5F1rppWeObC_EqJyW64W87F3M1_TLS5DzfzFhjxPZSs='; // --- 3. Build the Qris request body --- $cartDataJson = '{"count":1,"item":[{"img_url":"https://d3nevzfk7ii3be.cloudfront.net/igi/vOrGHXlovukA566A.medium","goods_name":"Nokia 3360","goods_detail":"Old Nokia 3360","goods_amt":"100","goods_quantity":"1"}]}'; $requestBody = Qris::builder() ->partnerReferenceNo('ordNo2022120215134035') ->amount('100.00', 'IDR') ->merchantId('TNICEQR081') ->storeId('NicepayStoreID1') ->validityPeriod('2024-04-18T10:31:33+07:00') ->additionalInfo( "Test SNAP Transaction Nicepay", "John Doe", "082213561712", "email@merchant.com", "Jakarta", "Jalan Bukit Berbunga 22", "DKI Jakarta", "12345", "Indonesia", "https://ptsv2.com/t/jhon/post", "https://ptsv2.com/t/jhon/post", "127.0.0.1", $cartDataJson, "QSHP" ) ->build(); // --- 4. Make the API call --- $qrisService = new SnapQrisService($config); try { $response = $qrisService->generateQris($requestBody, $accessToken); } catch (Exception $e) { // Handle exception } ``` ```kotlin // --- 1. Configure the NICEPay client --- val config: NICEPay = NICEPay.Builder() .isProduction(false) .clientSecret("YOUR_CLIENT_SECRET") // Replace with your actual client secret .partnerId("TNICEQR081") .externalID("09041220240418") .timestamp("2022-04-18T09:00:40+07:00") .privateKey("YOUR_PRIVATE_KEY") // Replace with your actual private key .build() // --- 2. Set the Access Token --- val accessToken = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJUTklDRVFSMDgxIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJOSUNFUEFZIiwiZXhwIjoiMjAyNC0wNC0xOFQwMjozMToyOVoifQ==.5F1rppWeObC_EqJyW64W87F3M1_TLS5DzfzFhjxPZSs=" // --- 3. Build the Qris request body --- val cartDataJson = "{\"count\":1,\"item\":[{\"img_url\":\"https://d3nevzfk7ii3be.cloudfront.net/igi/vOrGHXlovukA566A.medium\",\"goods_name\":\"Nokia 3360\",\"goods_detail\":\"Old Nokia 3360\",\"goods_amt\":\"100\",\"goods_quantity\":\"1\"}]}" val qris = SnapQris.Builder() .merchantId("TNICEQR081") .storeId("NicepayStoreID1") .amount("100.00", "IDR") .partnerReferenceNo("ordNo2022120215134035") .validityPeriod("2024-04-18T10:31:33+07:00") .additionalInfo(mapOf( "goodsNm" to "Test SNAP Transaction Nicepay", "billingNm" to "John Doe", "billingPhone" to "082213561712", "billingEmail" to "email@merchant.com", "billingCity" to "Jakarta", "billingAddr" to "Jalan Bukit Berbunga 22", "billingState" to "DKI Jakarta", "billingPostCd" to "12345", "billingCountry" to "Indonesia", "callBackUrl" to "https://ptsv2.com/t/jhon/post", "dbProcessUrl" to "https://ptsv2.com/t/jhon/post", "userIP" to "127.0.0.1", "cartData" to cartDataJson, "mitraCd" to "QSHP", "msId" to "", "msFee" to "", "msFeeType" to "", "mbFee" to "", "mbFeeType" to "" )) .build() // --- 4. Make the API call --- val response = snapQrisService.qrMpmGenerate(qris, accessToken, config) ``` CodeIgniter ```php setIsProduction(false) // dev ->setIsCloudServer(isCloudServer: false) ->setPrivateKey('YOUR_PRIVATE_KEY') // Replace with your actual private key ->setClientSecret('YOUR_CLIENT_SECRET') // Replace with your actual client secret ->setPartnerId('TNICEQR081') ->setExternalID('09041220240418') ->setTimestamp('2022-04-18T09:00:40+07:00') ->build(); // --- 2. Build the Qris request body --- $cartDataJson = '{"count":1,"item":[{"img_url":"https://d3nevzfk7ii3be.cloudfront.net/igi/vOrGHXlovukA566A.medium","goods_name":"Nokia 3360","goods_detail":"Old Nokia 3360","goods_amt":"100","goods_quantity":"1"}]}'; $qrisBuilder = Qris::builder(); $requestBody = $qrisBuilder ->setPartnerReferenceNo('ordNo2022120215134035') ->setAmount('100.00', 'IDR') ->setMerchantId('TNICEQR081') ->setStoreId('NicepayStoreID1') ->setValidityPeriod('2024-04-18T10:31:33+07:00') ->setAdditionalInfo( "Test SNAP Transaction Nicepay", "John Doe", "082213561712", "email@merchant.com", "Jakarta", "Jalan Bukit Berbunga 22", "DKI Jakarta", "12345", "Indonesia", "https://ptsv2.com/t/jhon/post", "https://ptsv2.com/t/jhon/post", "127.0.0.1", $cartDataJson, "QSHP" ) ->build(); // --- 3. Set the Access Token and make the API call --- $accessToken = 'eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJUTklDRVFSMDgxIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJOSUNFUEFZIiwiZXhwIjoiMjAyNC0wNC0xOFQwMjozMToyOVoifQ==.5F1rppWeObC_EqJyW64W87F3M1_TLS5DzfzFhjxPZSs='; $snapQrisService = new SnapQrisService(); try { $response = $snapQrisService->generateQris($requestBody, $accessToken, $config); } catch (Exception $e) { // Handle exception } ``` ::: ### Response Parameter :::CodeblockTabs Sample Response ```json { "responseCode": "2004700", "responseMessage": "Successful", "referenceNo": "TNICEQR08108202404181012168473", "partnerReferenceNo": "ordNo2022120215134035", "qrContent": "00020101021226610016ID.CO.SHOPEE.WWW01189360091800202508660208202508660303UMI5204123453033605406100.005802ID5913NicepayStore16015KAB. ACEH BARAT61052365962360520082024041810121600660708T00000026304C6F6", "qrUrl": "https://mapi.gw.uat.airpay.co.id/v3/merchant-host/qr/download?qr=pS03QyB4ZmuQMPdhSIl1jIr2WmPx3ErgJ3VJbaVfWC", "additionalInfo": { "goodsNm": "Test SNAP Transaction Nicepay", "billingNm": "John Doe", "mitraCd": "QSHP", "validityPeriod": "2024-04-18T10:31:33+07:00" } } ``` ::: [title] Notification - API Payout (Disbursement) SNAP [path] NICEPAY API/API SNAP/Payout API (Disbursement) - SNAP/ # Tentang Notification - API Payout (Disbursement) SNAP *** API ini digunakan untuk mengirimkan notifikasi dari hasil transaksi yang dilakukan pada proses Payout atau Disbursement. # Panduan Validasi X-SIGNATURE *** Berikut adalah cara untuk melakukan validasi X-SIGNATURE pada Request Header Notify: `SHA256withRSA (Public_Key, stringToSign) stringToSign = client_ID + “|” + X-TIMESTAMP` :::hint{type="warning"} Informasi khusus API Notifikasi SNAP terkait kredensial `Public_Key` akan diberikan oleh tim NICEPAY kepada Merchant melalui email, karena kredensial `Public_Key` yang akan digunakan di API Notifikasi SNAP berbeda dengan API Transaksi SNAP (Registration, Inquiry & Payment). Silakan menghubungi Tim Integrasi melalui email ([integration@nicepay.co.id](mailto\:integration@nicepay.co.id)) untuk informasi atau bantuan lebih lanjut. ::: Berikut adalah contoh hasil X-SIGNATURE dari cara validasi di atas: `mYyscWBs00bm0TJQ/xY7Uu1Goh8qXJyYSlo88rFrhQ+mlyQkMtq NKMlZDpS+` # Merchant Notification - API Payout (Disbursement) SNAP *** | **API Endpoint** | `[merchant-domain]/api/v1.0/transfer/notify` | | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **HTTP Method** | `POST` | | **Content-type** | `application/json` | | **Description** | Transaction Result Notification (when success)

If your use firewall, add allow policy for IP =
IP Public environtment Production:
`103.20.51.34`
`103.20.51.33`
`18.98.96.50`

IP Public environtment Dev:
`103.20.51.39`
`103.20.51.40`
`18.98.96.54` | ## Request Notification Header Parameter | **Parameter** | **Tipe** | **Kebutuhan** | **Deskripsi** | | -------------- | -------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `Content-Type` | String | Mandatory | `Application / JSON` | | `X-TIMESTAMP` | String | 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-CLIENT-KEY` | String | Mandatory | Unique Partner ID, Partner ID = Client ID | | `X-SIGNATURE` | String | Mandatory | Signature will be generated by Merchant.
[Panduan X-Signature - Symmetric](docId\:UZex33ReLyENKOgbJJnYp) | ## Request Notification Body Parameter | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | ----------------------------- | -------- | ---------- | ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `originalPartnerReferenc eNo` | String | 40 | Mandatory | Original transaction identifier on consumer
system | | `originalReferenceNo` | String | 40 | Mandatory | Original transaction identifier on service
provider system | | `latestTransactionStatus` | String | 2 | Mandatory | Category code for the status of the
transaction.
[Payout Transaction Status](docId\:XxlWrB0Q8XVkSMaO7ti9a) Example :
`00`- Success
`03`- Pending
`09`- Failed | | `transactionStatusDesc` | Object | 50 | Optional | Description status transaction | | `beneficiaryBankCode` | String | 4 | Mandatory | Beneficiary [Bank Code - API SNAP](docId:9WOQy5-1hlf_uCwshSDHO) | | `beneficiaryAccountNo` | String | 25 | Mandatory | Beneficiary Account Number | | `beneficiaryName` | String | 100 | Mandatory | Beneficiary Name | | `amount` | Object | Variable | Mandatory | Amount of Transaction | | `value` | String | 12 | Mandatory | Value | | `currency` | String | 3 | Mandatory | Currency | | `transactionDateTime` | String | 25 | Optional | Transaction Date Using ISO-8601 Format
`YYYY-MM-DDTHH:MM:SS` | ## Response Notification Header Parameter | **Parameter** | **Tipe** | **Kebutuhan** | **Deskripsi** | | -------------- | -------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `Content-Type` | String | Mandatory | `Application / JSON` | | `X-TIMESTAMP` | String | 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`.
| ## Response Notification Body Parameter | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | ----------------- | -------- | ---------- | ------------- | ---------------------------------------------------------------------------- | | `responseCode` | String | 7 | Mandatory | [General Response Code and Message - API SNAP](docId\:lKqJXSl5CMKdXYXxHYYSs) | | `responseMessage` | String | 150 | Mandatory | Response Message | ## Sample Post For Notification :::CodeblockTabs Sample Request Notification ```json //HEADER SECTION Content-type: application/json X-TIMESTAMP: 2023-11-23T07:44:11+07:00 X-SIGNATURE: 85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5 X-CLIENT-KEY: 82150823919040624621823174737537 { "originalPartnerReferenceNo": "2020102900000000000001", "originalReferenceNo": "TNICEPO07105202210141451109841", "latestTransactionStatus": "00", "transactionStatusDesc": "success", "beneficiaryBankCode": "BBBA", "beneficiaryAccountNo": "888801000003301", "beneficiaryName": "Yories Yolanda", "amount": { "value": "12345678.00", "currency": "IDR" }, "transactionDateTime": "2019-07-03T12:08:56-07:00" } ``` Sample Response Notification ```none //HEADER SECTION Content-type: application/json X-TIMESTAMP: 2023-11-23T07:44:16+07:00 { "responseCode": "2000000", "responseMessage": "Success" } ``` ::: [title] Payment - API Checkout [path] NICEPAY API/API Checkout/ # Menampilkan Payment Page dari PaymentURL *** Ketika berhasil mendaftarkan *request* pada [Registration - API Checkout](docId:1y_mEI3eZUS-XW2YPhGyp), akan mendapatkan *response *berupa `paymentURL`. Untuk menampilkan *payment page *di sisi Front-end, diperlukan untuk melakukan *mapping* `paymentURL` tersebut terlebih dahulu dengan tambahan pada URL-nya, yaitu `?tXid=` dan dilengkapi dengan `txid` didapat pada *response* [Registration - API Checkout](docId:1y_mEI3eZUS-XW2YPhGyp). Perhatikan contoh berikut ini. ```none paymentURL: https://www.nicepay.co.id/nicepay/redirect/v2/payment txid : IONPAYTEST00202203211640309389 NICEPAY Payment Page: https://www.nicepay.co.id/nicepay/redirect/v2/payment?tXid=IONPAYTEST00202203211640309389 ``` Ketika *Payment Page* tersebut sudah sesuai, maka ajukan sudah bisa dibayarkan oleh . hanya perlu menampilkan tautan atau *embedded link* tersebut pada *website* miliki. :::hint{type="warning"} Untuk ShopeePay dan OVO, kami sarankan agar membuka melalui perangkat ponsel dimiliki. ::: ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/qRcpEzhxJymcn-WztW6Nz_id-new-secure-payment-page-payloan-3.png "Halaman Pembayaran Berhasil") # Parameter Format Payment Page | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | --------------------------------------------------------- | -------- | ---------- | --------------------- | ------------------------------------------------------- | | `paymentURL`
Required | ANS | 14 | URL | https\://nicepay.co.id/nicepay/redirect/v2/payment | | `tXid`
Required | AN | 30 | Transaction ID
| IONPAYTEST00202203211640309389 | # After Payment Handling *** Setelah sudah berhasil dilakukan oleh , mengenai tersebut, berhasil maupun gagal, akan terkirim secara otomatis ke melalui `callbackURL` dan `dbProcessURL` masukkan pada saat *request* melalui [Registration - API Checkout](docId:1y_mEI3eZUS-XW2YPhGyp). :::hint{type="info"} kunjungi [Notification - API Checkout](docId:0BfdvETd5MPDBAkFzIVBE) untuk mendapatkan lebih detail mengenai `dbProcessURL`. ::: ## Response Parameters (CallbackUrl) | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | -------------------------------------------------------------------------------------------------------- | -------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------- | | `resultCd` | N | 4 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | 0000 | | `resultMsg` | AN | 255 | Result Message: [Error Code](docId\:yEh1VA9k2y6sL1kQF2aWD) | SUCCESS | | `tXid` | AN | 30 | Transaction ID | IONPAYTEST01202212141112221428

When success | | `referenceNo` | ANS | 40 | Order Number | (empty)

When success | | `payMethod`
E-Wallet, Payloan | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | 01

When success | | `amt` | N | 12 | Transaction Amount | 10000

When success | | `currency`
E-Wallet, Payloan | A | 3 | Currency | IDR

When success | | `payNo`
CVS | N | 20 | Number | | | `goodsNm`
E-Wallet, Payloan | AN | 100 | Goods Name | Testing Transaction

When success | | `billingNm`
E-Wallet, Payloan | A | 100 | Billing Name | John Doe

When success | | `transDt` | N | 8 | Transaction Date (`YYYYMMDD`) | 20221212

When success | | `transTm` | N | 6 | Transaction Time (`HH24MISS`) | 121212

When success | | `description ` | AN | 100 | Transaction Description | Testing Transaction

When success | | `authNo`
Only CC (Additional) | N | 10 | Approval Number | 080623

When success | | `issuBankCd`
Only CC | A | 4 | [Issuing Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | OTHR

When success | | `acquBankCd`
Only CC | A | 4 | [Acquiring Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | BMRI

When success
| | `cardNo`
Only CC | ANS | 20 | Card Number with Masking | 453211\*\*\*\*\*1111

When success | | `timestamp` | N | 14 | Request Timestamp | 20221212121212

When Success | | `merchantToken`
CC | AN | 255 | Token | 2035d2295d9578fffb40137186f0203474142ae3e57992d4847826c5fcaffce6

When Success | | `cardExpYymm`
CC | N | 4 | Card Expiration (`YYMM`) | 2712

When Success | | `instmntMon`
CC | N | 2 | Installment Month
`1`: 1 Month/Full , jika `instmntType`*:* *null/1*
`3`: 3 Months
`6`: 6 Months
`12`: 12 Months | 1

When Success | | `instmntType`
CC | N | 2 | [Installment Type Code](docId:7CIX-U_4z295XgtNVEsbO) | 1

When Success | | `ccTransType`
CC | AN | 2 | Transaction Type:
`1`: Normal
`2`: Recurring
`3`: Pre-Auth
`4`: Capture | 1

When Success | | `recurringToken`
Only CC (Additional) | AN | 255 | Recurring Token | | | `vat`
CC | N | 12 | Value Added Tax () | | | `fee`
CC | N | 12 | Service Fee | | | `notaxAmt`
CC | N | 12 | Tax Fee Amount | | | `mitraCd`
Direct Debit, E-Wallet, Payloan | A | 4 | [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8) | | | `bankVacctNo`
VA | N | 20 | VA Number | | :::hint{type="info"} Response akan dikirimkan melalui `callBackurl` dengan Content-type: `application/json` dan metode: `POST Parameter`. ::: ## Sample JSON for CallbackUrl *** :::CodeblockTabs URL payment ```json https://nicepay.co.id/nicepay/redirect/v2/payment?tXid=IONPAYTEST00202203211640309389 ``` Response CallBack ```json { "resultCd":"0000", "resultMsg":"SUCCESS", "tXid":"IONPAYTEST01202212141112221428", "referenceNo":"", "payMethod":"01", "amt":"10000", "transDt":"20221212", "transTm":"121212", "description":"Testing Credit Card Transaction", "authNo":"080623", "issuBankCd":"OTHR" "acquBankCd":"BMRI", "cardNo":"453211*****1111", "goodsNm":"Test Transaction Nicepay" "billingNm":"John Doe", "currency":"IDR", "timeStamp":"20221212121212", "merchantToken":"2035d2295d9578fffb40137186f0203474142ae3e57992d4847826c5fcaffce6", "cardExpYymm":"2712", "instmntMon":"1", "instmntType":"1", "ccTransType":"1" } ``` ::: CallBack Handling API Checkout ------------------------------------ *** ::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/eMkBILN_IdNLFXTXs64K9_nicepay-api-checkout-api-callback-handling-flowdrawio-2.png" size="50" width="370" height="361" caption="Alur CallBack Handling" position="center" darkWidth="370" darkHeight="361" showCaption="true"} :::hint{type="info"} - `tXid` tidak akan sama dengan *request hold*. Proses *Capture* akan memastikan bahwa nilai amount di-*capture* tidak melebihi dana dimiliki. - Saat *Callback *diterima `callbackUrl` , kami sangat menganjurkan untuk melakukan verifikasi Status menggunakan [Status Inquiry - API Checkout](docId\:K9vBS87ev9_w5oJAU0et3). - `CallBack Handling` dapat sangat membantu untuk meminimalisir terjadinya *Fraud*, kami sangat merekomendasikan untuk melakukan verifikasi `CallBack Handling`. ::: [title] Request Access Token - API NICEPAY Inquiry Virtual Account SNAP [path] NICEPAY API/API SNAP/Advance API - SNAP/API NICEPAY Inquiry Virtual Account SNAP/ # Tentang Request Access Token - API NICEPAY Inquiry Virtual Account SNAP *** Bagian ini berisi tentang terkait dengan standar digunakan pada dengan fitur (NIVA) agar dapat mengajukan token untuk melakukan &#xNAN;*.* # Request Access Token - API NICEPAY Inquiry Virtual Account SNAP *** :::hint{type="warning"} Sebelum melakukan proses integrasi, Merchant perlu mengirimkan base URL (Merchant Domain) via email kepada Tim Integrasi NICEPAY ([integration@nicepay.co.id](mailto\:integration@nicepay.co.id)) agar Merchant dapat mengakses API NIVA. Setelah menerima URL Base, NICEPAY akan memberikan Public Key kepada Merchant, sehingga Merchant dapat langsung memulai proses integrasi. ::: ## Get Access Token akan mengajukan *generate *`access_token` kepada melalui . `access_token` diberikan akan mengikuti format dari dan memiliki waktu kedaluwarsa 15 menit. | **API Endpoint** | `https://[merchant-domain]/api/v.1.0/access-token/b2b` | | ---------------- | ------------------------------------------------------ | | **Method** | `POST` | | **Description** | Untuk melakukan *request access token* NIVA | | **Content-type** | `application/json` | ## Request Access Token Header Parameter | **Parameter** | **Tipe** | **Kebutuhan** | **Deskripsi** | **Contoh** | | -------------- | -------- | ------------- | ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `Content-Type` | String | Mandatory | String Media Type of Resource | `application/json` | | `X-TIMESTAMP` | String | Mandatory | Timezone | `YYYY-MM-DDTHH:MM:SS`
(2024-01-22T15:00:01+07:00) | | `X-CLIENT KEY` | String | Mandatory | ID | IONPAYTEST | | `X-SIGNATURE` | String | Mandatory | Signature | Generated by /
created using asymmetric
signature SHA256withRSA algorithm
(`Private_Key`, `stringToSign`)
`stringToSign `= `client ID` + “`\|`” + `X-TIMESTAMP` | ## Request Access Token Body Parameter | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | ---------------- | -------- | ---------- | ------------- | --------------- | | `grantType` | String | 8 | Mandatory | Name | | `additionalInfo` | String | 17 | Mandatory | Goods/Item Name | ## Request Access Token Response Parameter | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | ----------------- | -------- | ---------- | ------------- | ------------------------ | | `responseCode` | String | 5 | Mandatory | Response Code | | `responseMessage` | String | 100 | Mandatory | Response Message | | `accessToken` | String | 150 | Mandatory | Access Token | | `tokenType` | String | 8 | Mandatory | Type Token | | `expiresIn` | String | 17 | Mandatory | Session Expiry in Second | | `additionalInfo` | String | 17 | Mandatory | Additional Information | ## Sample Parameter :::CodeblockTabs JSON Request ```json { "grantType": "client_credentials", "additionalInfo": {} } ``` JSON Response ```json { "responseCode": "2007300", "responseMessage": "Successful", "accessToken": "Xy8duZzAvv9bwDXxRxcb89tsuvk4MF4kx4lGfE4aCRVxR7XdERhbe1", "tokenType": "Bearer", "expiresIn": "900", "additionalInfo": {} } ``` ::: [title] API NICEPAY Inquiry Virtual Account SNAP [path] NICEPAY API/API SNAP/Advance API - SNAP/ # Tentang API NICEPAY Inquiry Virtual Account SNAP *** Bagian ini berisi tentang terkait dengan standar digunakan pada dengan fitur (NIVA). Pada fitur ini, data berada di sisi . Sehingga, pada setiap dari , melakukan inquiry data , konfirmasi , dan melakukan *request* ke . # Daftar API NICEPAY Inquiry Virtual Account SNAP *** ::::LinkArray :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-ec8v99xD-0EBakZVO8G9i-20240805-110110.jpg"} [Payment - API NICEPAY Inquiry Virtual Account SNAP](docId\:gL2i62YaR7lm1j6w4wDbs) digunakan untuk mengajukan . ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-DTb5CgBNGeldodYfuYrWi-20240805-110136.jpg"} [Inquiry - API NICEPAY Inquiry Virtual Account SNAP](docId\:vI_LyF6ua8mD2Z0jOpB4g) digunakan untuk mengajukan pemeriksaan . ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-4eZAw0WnDrphLbAVRbkjD-20240805-110147.jpg"} [Reversal - API NICEPAY Inquiry Virtual Account SNAP](docId\:VAhAizo3z_8QjvGWcRkkQ) digunakan untuk mengirimkan notifikasi dari kepada agar melakukan pengembalian dana akibat suatu kondisi . ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ho7Cq0xJG60lzOZLT7xI3-9hlH9ZvVuQrT16n0Lf9i1-20250610-065609.jpg"} [Request Access Token - API NICEPAY Inquiry Virtual Account SNAP](docId\:tbDHyMKVQK7C20nUkjB0N) digunakan untuk mengajukan *request access token*. ::: :::: # Alur Proses *** ![](https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-fLfdJLc8X7dtFDUBrijUZ-20240827-022735.jpg "Alur Proses API NIVA SNAP") Deskripsi Langkah: 1. melakukan *checkout* pesanan kepada . 2. melakukan validasi dan *generate* VA. 3. mengirimkan dan menampilkan VA kepada . 4. mengajukan token kepada . 5. melakukan validasi dan *generate* token. 6. mengirimkan response kepada . 7. menerima token. 8. memasukkan VA kepada . 9. melakukan inquiry. 10. mengajukan inquiry kepada . 11. mengajukan inquiry kepada . 12. memeriksa . 13. mengirimkan kepada . 14. mengirimkan kepada . 15. mengajukan kepada . 16. mengirimkan kepada . 17. melakukan . 18. mengajukan kepada . 19. mengajukan kepada . 20. melakukan persetujuan . 21. memperbaharui , kemudian: - Proses antara , dan : - mengirimkan kepada . - NICEPAY mengirimkan kepada . - menampilkan *response* kepada . 22. menampilkan *response* kepada . [title] Pre-Auth & Capture - Registration API Credit Card [path] NICEPAY API/API Non-SNAP/Payment API/API Credit Card/Registration - API Credit Card/ # Tentang Pre-Auth & Capture - Registration API Credit Card *** **Pre-Auth & Capture **merupakan fitur lainnya dari di mana dapat menahan (*hold*) atau melakukan Pre-Auth terlebih dahulu dari dana sudah dibayarkan oleh . Kemudian, perlu melakukan validasi atas jumlah dana tersebut atau disebut dengan Capture agar dana tersebut masuk ke dalam rekening . Jika melakukan Capture setelah masa kedaluwarsa Pre-Auth berakhir maka tersebut akan dianggap *Void* dan dana tersebut akan dikembalikan kepada . Maka, kami sarankan untuk segera melakukan Capture sebelum masa kedaluwarsa Pre-Auth tersebut habis. :::hint{type="success"} Pelajari mengenai fitur dengan Pre-Auth & Capture di [Pre-Authorization & Capture pada Kartu Kredit](docId\:O3GEuXQpBRQBTckPUzF6B). ::: # Pre-Auth & Capture - Registration API Credit Card *** | **API Endpoint** | `/nicepay/direct/v2/registration` | | ------------------ | ------------------------------------------------------------ | | **Request Method** | **POST****** | | **Description** | Pre-Auth & Capture | | **Merchant Token** | SHA256(`timeStamp`+`iMid`+`referenceNo`+`amt`+`merchantKey`) | | **Request Format** | `application/json` | ## Request Parameter for Pre-Auth & Capture - Registration API Credit Card *** Langkah pertama perlu lakukan untuk mengaktifkan fitur Pre-Auth & Capture adalah melakukan registrasi terlebih dahulu pada Registrasi ini. Proses ini dilakukan agar mendapatkan `tXid` dapat dipakai untuk melakukan Pre-Auth nantinya. | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ----------------------------------------------------------------------------------- | ------------------ | ---------- | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------- | | `timeStamp`
Required | N | 14 | Request Timestamp (`YYYYMMDDHH24MISS`) | 20221202141217 | | `iMid`
Required | AN | 10 | ID
| IONPAYTEST | | `payMethod`
Required | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok)
| 01 | | `currency`
Required | A | 3 | Currency
| IDR | | `amt`
Required | N | 12 | Amount
(number not in float format) | 10000 (Jumlah total amount goods dari `cartData`) | | `referenceNo`
Required | ANS | 40 | 's Reference Number
| ordNo20221202141217 | | `goodsNm `
Required | AN | 100 | Goods Name
| Testing Transaction | | `billingNm `
Required | A | 100 | Buyer Name
| John Doe | | `billingPhone `
Required | N | 15 | Buyer Phone Number
| 2112345678 | | `billingEmail `
Required | ANS | 40 | Buyer E-mail
| buyer\@merchant.com | | `billingAddr `
Required | AN | 100 | Buyer Address
| Jln. Raya Kasablanka Kav.88 | | `billingCity `
Required | A | 50 | Buyer City
| South Jakarta | | `billingState `
Required | A | 50 | Billing State
| DKI Jakarta | | `billingPostCd `
Required | N | 10 | Billing Post Number
| 14350 | | `billingCountry `
Required | A | 10 | Billing Country
| | | `cartData`
Optional | `JSONstring`
| 4000 | Cart Data
| \{} | | `instmntType`
Required | N | 2 | [Installment Type Code](docId:7CIX-U_4z295XgtNVEsbO) | 1 (Untuk PreAuth & Recurring default 1) | | `instmntMon`
Required | N | 2 | Installment Month
`1`: 1 Month/Full , *jika *`instmntType`*: null/1* | 1 (Untuk PreAuth & Recurring default 1) | | `recurrOpt`
Required | N | 2 | `0`: Automatic Cancel
`1`: Do not cancel
`2`: Do not make token | 2 | | `dbProcessUrl`
Required | ANS | 255 | Notification URL
| https\://merchant.com/dbProcessUrl
| | `userIP`
Required for CC, E-Wallet, Payloan, QRIS | AN | 15 | User IP | 127.0.0.1 | | `merchantToken`
Required | AN | 255 | Token
| c91e6531f6c84869439bc5ebe5389bd71e7752c054fc9dbfe193d087a1b797ae | | `description` | AN | 100 | Transaction Description | Test Transaction | | `userSessionID` | AN | 100 | User Session ID | userSessionID | | `userAgent` | ANS | 100 | User Agent | Mozilla | | `userLanguage` | A | 2 | User Language | en-US | ### Cart Data for Pre-Auth & Capture - Registration API Credit Card `cartData` pada *request * di Registrasi berguna untuk meliputi barang atau *item* apa saja akan dibayarkan oleh berserta rincian dan harga per *item.* | **Parameter** | **Deskripsi** | **Contoh** | | ------------- | ---------------------------------------------------------------------------------------------------- | ---------- | | `Count` | Total jumlah dari keseluruhan cart data | 2 | | `Item` | Terbagi menjadi 5 macam , yaitu `img_url`, `goods_id`, `goods_name`, `goods_detail`, dan `goods_amt` | - | *** Penjelasan detil pada **Item.** | **Parameter** | **Deskripsi** | **Contoh** | | -------------- | -------------------------------------- | --------------------------------------------- | | `img_url` | URL Gambar Barang (Ukuran 50px x 50px) | htttps\://www\.merchant.com/image\_goods1.jpg | | `goods_id` | ID Barang | NICEPRDID1 | | `goods_name` | Nama Barang | Nama Item-1 | | `goods_detail` | Deskripsi Detail Barang | Detail Item-1 | | `goods_amt` | Harga Barang | 1000 | ### Sample JSON Cart Data :::CodeblockTabs cartData Credit Card Registration ```json { "count": "2", "item": [ { "img_url": "http://www.merchant.com/image_goods1.jpg", "goods_id": "NICEPRDID1", "goods_name": "Item 1 Name", "goods_detail": "Item 1 Detail", "goods_amt": "1000" }, { "img_url": "http://www.merchant.com/image_goods2.jpg", "goods_id": "NICEPRDID1", "goods_name": "Item 2 Name", "goods_detail": "Item 2 Detail", "goods_amt": "1000" } ] } ``` ::: ## Response Parameter for Pre-Auth & Capture - Registration API Credit Card *** Berikut ini adalah *response* dari hasil *request* registrasi tipe Pre-Auth & Capture sebelumnya sudah dilakukan pada . Hasil diperlukan untuk dapat melanjutkan ke berikutnya dari hasil *response* ini adalah `tXid`. Untuk melanjutkan ke langkah berikutnya, silakan mengunjungi [Pre-Auth & Capture - Payment API Credit Card](docId\:zFDKm9bwMDI5FRoKfInDK). | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | -------------- | -------- | ---------- | ----------------------------------------------------------- | ------------------------------ | | `resultCd` | N | 4 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | 0000 | | `resultMsg ` | AN | 255 | Result Message: [Error Code](docId\:yEh1VA9k2y6sL1kQF2aWD) | SUCCESS | | `tXid` | AN | 30 | Transaction ID | PACTEST00101202206241007570327 | | `referenceNo` | ANS | 40 | Reference Number | ordNo20221215101254 | | `payMethod` | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | 01 | | `amt` | N | 12 | Amount | 10000 | | `transDt` | N | 8 | Transaction Date (`YYYYMMDD`) | 20221212 | | `transTm` | N | 6 | Transction Time (`HH24MISS`) | 121212 | | `description` | AN | 100 | Transaction Description | Testing Transaction | | `bankCd` | A | 4 | [Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | null | | `vacctNo` | N | 20 | Virtual Account | null | | `mitraCd` | A | 4 | [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8) | null | | `payNo` | N | 12 | CVS Number | null | | `currency ` | A | 3 | Currency | IDR | | `goodsNm` | AN | 100 | Goods Name | Goods For Testing Transaction | | `billingNm` | A | 100 | Buyer Name | John Doe | | `vacctValidDt` | N | 8 | VA Expiry Date (`YYYYMMDD`) | null | | `vacctValidTm` | N | 6 | VA Expiry Time (`HH24MISS`) | null | | `payValidDt ` | N | 8 | Expiry Date (`YYYYMMDD`) | null | | `payValidTm` | N | 6 | Expiry Time (`HH24MISS`) | null | | `requestURL` | ANS | 360 | Request URL | null | | `paymentExpDt` | N | 6 | QR Expiry Date (`YYYYMMDD`) | null | | `paymentExpTm` | N | 6 | QR Expiry Time (`HH24MISS`) | null | | `qrContent` | ANS | 360 | QR String in Plain Text | null | | `qrUrl` | ANS | 360 | URL for QR Image, Valid for 5 minutes | null | :::hint{type="info"} memeriksa [NICEPAY Code](docId\:kYd45uYYIjwzVs3dt8_rk) untuk mengetahui kode umum beserta kode *response* dalam ataupun lainnya di . ::: ## Sample Parameter for Pre-Auth & Capture - Registration API Credit Card *** ### Request Parameter :::CodeblockTabs cURL ```curl curl --location 'https://dev.nicepay.co.id/nicepay/direct/v2/registration' \ --header 'Content-Type: application/json' \ --data-raw '{ "timeStamp": "20221214111261", "iMid": "PACTEST001", "payMethod": "01", "currency": "IDR", "amt": "5000", "merchantToken": "b40cb019e938d0118b77cb6f564a7facf12472e5bbb598dde0cd43b2df46b2aa", "referenceNo": "ordNo20221214111261", "goodsNm": "Goods For Testing Pre-Auth", "billingNm": "John Doe", "billingPhone": "081288998899", "billingEmail": "john.doe@example.com", "billingAddr": "Jln. Raya Kasablanka Kav.88", "billingCity": "South Jakarta", "billingState": "DKI Jakarta", "billingCountry": "Indonesia", "billingPostCd": "12800", "dbProcessUrl": "http://ptsv2.com/t/merchant/post", "userIP": "127.0.0.1", "instmntType": "1", "instmntMon": "1", "cartData": "{\"count\":\"1\",\"item\":[{\"goods_id\":\"NICEPRDID1\",\"img_url\":\"http://www.merchant.com/image_goods1.jpg\",\"goods_name\":\"Goods For Testing Pre-Auth\",\"goods_detail\":\"Goods For Testing Pre-Auth Details\",\"goods_amt\":\"5000\",\"goods_quantity\":\"1\"}]}", "recurrOpt": "", "userLanguage": "en", "userAgent": "Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0" }' ``` Node.js ```nodejs const nicepayClient = require("nodejs-nicepay"); let secondVersion = new nicepayClient.SecondApiVersion({ isProduction: false, isCloudServer: false, merchantKey: "YOUR_MERCHANT_KEY", }); const parameter = { timeStamp: "20221214111261", iMid: "PACTEST001", payMethod: "01", currency: "IDR", amt: "5000", merchantToken: "b40cb019e938d0118b77cb6f564a7facf12472e5bbb598dde0cd43b2df46b2aa", referenceNo: "ordNo20221214111261", goodsNm: "Goods For Testing Pre-Auth", billingNm: "John Doe", billingPhone: "081288998899", billingEmail: "john.doe@example.com", billingAddr: "Jln. Raya Kasablanka Kav.88", billingCity: "South Jakarta", billingState: "DKI Jakarta", billingCountry: "Indonesia", billingPostCd: "12800", dbProcessUrl: "http://ptsv2.com/t/merchant/post", cartData: "{\"count\":\"1\",\"item\":[{\"goods_id\":\"NICEPRDID1\",\"img_url\":\"http://www.merchant.com/image_goods1.jpg\",\"goods_name\":\"Goods For Testing Pre-Auth\",\"goods_detail\":\"Goods For Testing Pre-Auth Details\",\"goods_amt\":\"5000\",\"goods_quantity\":\"1\"}]}", userIP: "127.0.0.1", instmntType: "1", instmntMon: "1", recurrOpt: "", userLanguage: "en", userAgent: "Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0", }; let endPoint = "/direct/v2/registration"; secondVersion.requestAPI(parameter, endPoint); ``` ```java String reffNo = "ordNo20221202141217"; Card requestData = Card.builder() .timeStamp("20221202141217") .iMid("IONPAYTEST") .payMethod("01") .currency("IDR") .amt("5000") .referenceNo(reffNo) .goodsNm("Testing Transaction") .billingNm("John Doe") .billingPhone("081288998899") .billingEmail("john.doe@example.com") .billingAddr("Jln. Raya Kasablanka Kav.88") .billingCity("South Jakarta") .billingState("DKI Jakarta") .billingPostCd("12800") .billingCountry("Indonesia") .description("Testing Registration Credit Card") .deliveryNm("") .deliveryPhone("") .deliveryAddr("") .deliveryCity("") .deliveryState("") .deliveryPostCd("") .deliveryCountry("") .dbProcessUrl("http://ptsv2.com/t/merchant/post") .userIP("127.0.0.1") .userAgent("Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0") .instmntType("1") .instmntMon("1") .recurrOpt("1") .cartData("{\"count\":\"1\",\"item\":[{\"goods_id\":\"NICEPRDID1\",\"img_url\":\"http://www.merchant.com/image_goods1.jpg\",\"goods_name\":\"Goods For Testing Pre-Auth\",\"goods_detail\":\"Goods For Testing Pre-Auth Details\",\"goods_amt\":\"5000\",\"goods_quantity\":\"1\"}]}") .merchantToken("20221202141217", "IONPAYTEST", reffNo, "5000", merchantKey) .build(); NICEPayResponseV2 cardRegistResponse = V2CardService.callV2CardRegistration(requestData, config); ``` ```python amt = 5000 itemCartData = { "goods_id": "NICEPRDID1", "goods_detail": "Goods For Testing Pre-Auth details", "goods_name": "Goods For Testing Pre-Auth", "goods_amt": amt, "goods_url": "https://merchant.com/cellphones/iphone5s_64g", } bodyCartData = ( builderCartData.BuildCartData() .setCount("1") .setItem(itemCartData) .build() ) bodyCreditCard = ( builderCreditCard.BuildCreditCard() .setPayMethod(ConstantsGeneral.getPayMethodCreditCard()) .setRecurrOpt("1") .setInstmntMon("1") .setInstmntType("1") .setAmt(str(amt)) .build() ) environment = ( builderEnvironment.BuildEnvironment() .isCloud(False) .isProduction(False) .build() ) ``` C# ```csharp string merchantKey = config.MerKey; string clientId = config.ClientId; string timestamp = "20221214111261"; string refNo = "ordNo20221214111261"; string amount = "5000"; bool isProduction = false; bool isCloudServer = false; // 1️⃣ Generate merchant token (keep original logic) var merchantTokenBuilder = new MerchantTokenBuilder() .SetTimeStamp(timestamp) .SetIMid("PACTEST001") .SetRefNo(refNo) .SetAmount(amount) .SetMerchantKey(merchantKey); string merchantToken = merchantTokenBuilder.BuildMerchantToken(); // 2️⃣ Build Cart Data var cartItem = new Dictionary { { "goods_id", "NICEPRDID1"}, { "img_url", "http://www.merchant.com/image_goods1.jpg" }, { "goods_name", "Goods For Testing Pre-Auth" }, { "goods_detail", "Goods For Testing Pre-Auth Details" }, { "goods_amt", "5000" } }; var cartDataBuilder = new BuilderCartData() .SetCount("1") .SetItem(cartItem); var cartData = cartDataBuilder.Build(); // 3️⃣ Build Credit Card Request Body var bodyBuilder = new NicepayRequestBuilder() .SetCommonFields( iMid: "PACTEST001", timeStamp: timestamp, payMethod: "01", currency: "IDR", amt: amount, referenceNo: refNo, goodsNm: "Goods For Testing Pre-Auth", merchantToken: merchantToken ) .setCreditCard( instmntType: "1", instmntMon: "1", recurrOpt: "" ) .SetBillingInfo( billingNm: "John Doe", billingPhone: "081288998899", billingEmail: "john.doe@example.com", billingAddr: "Jln. Raya Kasablanka Kav.88", billingCity: "South Jakarta", billingState: "DKI Jakarta", billingPostCd: "12800", billingCountry: "Indonesia" ) .SetDbProcessUrl("http://ptsv2.com/t/merchant/post") .SetCartData(cartData) .SetUserIP("127.0.0.1") .SetUserLanguage("en") .SetUserAgent("Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0"); ApiEndpoints apiEndpoints = new ApiEndpoints(); // 4️⃣ Build payload and send Dictionary payload = bodyBuilder.Build(); string jsonPayload = Newtonsoft.Json.JsonConvert.SerializeObject(payload, Newtonsoft.Json.Formatting.Indented); var registrationService = new NicepayRegistrationService(apiEndpoints, isProduction, isCloudServer); var result = await registrationService.SendPostAsync(apiEndpoints.RegistV2, payload); ``` Vanilla JS ```javascript const registrationData = { timeStamp: "20221214111261", iMid: "PACTEST001", payMethod: "01", currency: "IDR", amt: "5000", merchantToken: "b40cb019e938d0118b77cb6f564a7facf12472e5bbb598dde0cd43b2df46b2aa", referenceNo: "ordNo20221214111261", goodsNm: "Goods For Testing Pre-Auth", billingNm: "John Doe", billingPhone: "081288998899", billingEmail: "john.doe@example.com", billingAddr: "Jln. Raya Kasablanka Kav.88", billingCity: "South Jakarta", billingState: "DKI Jakarta", billingCountry: "Indonesia", billingPostCd: "12800", dbProcessUrl: "http://ptsv2.com/t/merchant/post", cartData: "{\"count\":\"1\",\"item\":[{\"goods_id\":\"NICEPRDID1\",\"img_url\":\"http://www.merchant.com/image_goods1.jpg\",\"goods_name\":\"Goods For Testing Pre-Auth\",\"goods_detail\":\"Goods For Testing Pre-Auth Details\",\"goods_amt\":\"5000\",\"goods_quantity\":\"1\"}]}", userIP: "127.0.0.1", instmntType: "1", instmntMon: "1", recurrOpt: "", userLanguage: "en", userAgent: "Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0", }; const paymentData = { cardNo: "4811111111111114", expMonth: "12", expYear: "2025", cvv: "123", }; (async () => { try { const response = await Nicepay.registerTransaction(registrationData, paymentData); console.log("Transaction Response:", response); } catch (error) { console.error("Registration Failed:", error); } })(); ``` Laravel ```php $useProd = false; $useCloud = false; $registration_endpoint = "/nicepay/direct/v2/registration"; $url = HttpUtil::getNicepayDomain($useProd, $useCloud) . $registration_endpoint; $timestamp = "20221213101276"; $reference_no = "ordNo20221213101276"; $amt = "5000"; $merchant_token = "ed9c8640b6260c8fa7070aa4e38df87896f9777899af354ee6d3d61f64626c0c"; $body = [ "timeStamp" => $timestamp, "iMid" => "RECURRTEST", "payMethod" => "01", "currency" => "IDR", "amt" => $amt, "merchantToken" => $merchant_token, "referenceNo" => $reference_no, "goodsNm" => "Goods For Testing", "billingNm" => "John Doe", "billingPhone" => "081288998899", "billingEmail" => "john.doe@example.com", "billingAddr" => "Jln. Raya Kasablanka Kav.88", "billingCity" => "South Jakarta", "billingState" => "DKI Jakarta", "billingPostCd" => "12800", "billingCountry" => "Indonesia", "cartData" => "{\"count\":\"1\",\"item\":[{\"goods_id\":\"NICEPRDID1\",\"img_url\":\"http://www.merchant.com/image_goods1.jpg\",\"goods_name\":\"Goods For Testing Pre-Auth\",\"goods_detail\":\"Goods For Testing Pre-Auth Details\",\"goods_amt\":\"5000\",\"goods_quantity\":\"1\"}]}", "dbProcessUrl" => "http://ptsv2.com/t/merchant/post", "userIP" => "127.0.0.1", "instmntType" => "1", "instmntMon" => "1", "recurrOpt" => "1", "userLanguage" => "en", "userAgent" => "Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0" ]; $response = HttpUtil::postJsonRequest($url, $body); ``` PHP Native ```php $config = NICEPay::builder() ->setIsProduction(false) ->build(); $timestamp = "20221202141217"; $reffNo = "ordNo20221202141217"; $amount = "5000"; $parameter = Card::builder() ->setTimeStamp($timestamp) ->setIMid("IONPAYTEST") ->setPayMethod("01") ->setCurrency("IDR") ->setAmt($amount) ->setReferenceNo($reffNo) ->setMerchantToken($timestamp, "IONPAYTEST", $reffNo, $amount, $this->merchantKey) ->setDescription("Testing Registration Credit Card") ->setGoodsNm("Testing Transaction") ->setBillingNm("John Doe") ->setBillingPhone("081288998899") ->setBillingEmail("john.doe@example.com") ->setBillingAddr("Jln. Raya Kasablanka Kav.88") ->setBillingCity("South Jakarta") ->setBillingState("DKI Jakarta") ->setBillingPostCd("12800") ->setBillingCountry("Indonesia") ->setDbProcessUrl("http://ptsv2.com/t/merchant/post") ->setCartData("{\"count\":\"1\",\"item\":[{\"goods_id\":\"NICEPRDID1\",\"img_url\":\"http://www.merchant.com/image_goods1.jpg\",\"goods_name\":\"Goods For Testing Pre-Auth\",\"goods_detail\":\"Goods For Testing Pre-Auth Details\",\"goods_amt\":\"5000\",\"goods_quantity\":\"1\"}]}") ->setUserIP("127.0.0.1") ->setInstmntType("1") ->setInstmntMon("1") ->setRecurrOpt("1") ->setUserLanguage("en") ->setUserAgent("Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0") ->build(); $cardService = new V2CardService($config); $response = $cardService->registration($parameter); ``` ```kotlin var config: NICEPay? = NICEPay.Builder() .isProduction(false) .clientSecret(TestingConstants.CLIENT_SECRET) .partnerId(TestingConstants.PARTNER_ID) .externalID(TestingConstants.EXTERNAL_ID) .timestamp(TestingConstants.TIMESTAMP) .privateKey(TestingConstants.PRIVATE_KEY) .build() val request: DirectV2Card = DirectV2Card.Builder() .timeStamp("20221202141217") .iMid("IONPAYTEST") .payMethod("01") .currency("IDR") .amt("5000") .referenceNo("ordNo20221202141217") .goodsNm("Testing Transaction") .billingNm("John Doe") .billingPhone("081288998899") .billingEmail("john.doe@example.com") .billingAddr("Jln. Raya Kasablanka Kav.88") .billingCity("South Jakarta") .billingState("DKI Jakarta") .billingPostCd("12800") .billingCountry("Indonesia") .dbProcessUrl("http://ptsv2.com/t/merchant/post") .userIP("127.0.0.1") .userAgent("Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0") .userLanguage("en") .instmntType("1") .instmntMon("1") .recurrOpt("1") .cartData("{\"count\":\"1\",\"item\":[{\"goods_id\":\"NICEPRDID1\",\"img_url\":\"http://www.merchant.com/image_goods1.jpg\",\"goods_name\":\"Goods For Testing Pre-Auth\",\"goods_detail\":\"Goods For Testing Pre-Auth Details\",\"goods_amt\":\"5000\",\"goods_quantity\":\"1\"}]}") .merchantKey(DEFAULT_MERCHANT_KEY) .build() val response: NICEPayResponseV2 = v2CardService.registration(request, config)!! ``` CodeIgniter ```php $timestamp = "20221202141217"; $configBuilder = NICEPay::builder(); $config = $configBuilder ->setIsProduction(false) ->setIsCloudServer(isCloudServer: true) ->build(); $reffNo = "ordNo20221202141217"; $amount = "5000"; $CardBuilder = Card::builder(); $parameter = $CardBuilder ->setTimeStamp($timestamp) ->setIMid("IONPAYTEST") ->setPayMethod("01") ->setCurrency("IDR") ->setAmt($amount) ->setReferenceNo($reffNo) ->setMerchantToken($timestamp, "IONPAYTEST", $reffNo, $amount, $this->merchantKey) ->setDescription("Testing Registration Credit Card") ->setgoodsNm("Testing Transaction") ->setBillingNm("John Doe") ->setBillingPhone("081288998899") ->setBillingEmail("john.doe@example.com") ->setBillingAddr("Jln. Raya Kasablanka Kav.88") ->setBillingCity("South Jakarta") ->setBillingState("DKI Jakarta") ->setBillingPostCd("12800") ->setBillingCountry("Indonesia") ->setDbProcessUrl("http://ptsv2.com/t/merchant/post") ->setCartData("{\"count\":\"1\",\"item\":[{\"goods_id\":\"NICEPRDID1\",\"img_url\":\"http://www.merchant.com/image_goods1.jpg\",\"goods_name\":\"Goods For Testing Pre-Auth\",\"goods_detail\":\"Goods For Testing Pre-Auth Details\",\"goods_amt\":\"5000\",\"goods_quantity\":\"1\"}]}") ->setUserIP("127.0.0.1") ->setInstmntType("1") ->setInstmntMon("1") ->setRecurrOpt("1") ->setUserLanguage("en") ->setUserAgent("Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0") ->build(); $cardService = new V2CardService($config); $response = $cardService->registration($parameter); ``` ::: ### Response Parameter :::CodeblockTabs Sample Response ```json { "resultCd": "0000", "resultMsg": "SUCCESS", "tXid": "PACTEST00101202510081159303818", "referenceNo": "ordNo20221214111261", "payMethod": "01", "amt": "5000", "transDt": "20251008", "transTm": "115930", "description": null, "bankCd": null, "vacctNo": null, "mitraCd": null, "payNo": null, "currency": null, "goodsNm": null, "billingNm": null, "vacctValidDt": null, "vacctValidTm": null, "payValidDt": null, "payValidTm": null, "requestURL": null, "paymentExpDt": null, "paymentExpTm": null, "qrContent": null, "qrUrl": null } ``` ::: [title] Recurring - Registration API Credit Card [path] NICEPAY API/API Non-SNAP/Payment API/API Credit Card/Registration - API Credit Card/ # Tentang Recurring - Registration API Credit Card *** Pembayaran tipe Recurring adalah pilihan tipe menggunakan melakukan suatu tagihan secara berkala dengan nominal sama seperti ditagihkan pada awal . digunakan pada tahap pendaftaran sama dengan untuk mendaftarkan tipe Full & Installment, namun terdapat perbedaan pada *request* dikirimkan. :::hint{type="success"} Pelajari mengenai fitur dengan Recurring di [Fitur Kartu Kredit](docId\:cgLxG10p9zmVtuX_-b7ga). ::: :::hint{type="info"} mengunjungi [Kartu Kredit](docId:1pHQ_XU3Dpep4hzX41lqg) untuk mempelajari umum seputar . ::: # Recurring - Registration API Credit Card *** | **API URL** | `/nicepay/direct/v2/registration` | | ------------------ | ------------------------------------------------------------ | | **Request Method** | **POST****** | | **Description** | Recurring | | **Merchant Token** | SHA256(`timeStamp`+`iMid`+`referenceNo`+`amt`+`merchantKey`) | | **Request Format** | `application/json` | ## Request Parameter for Recurring - Registration API Credit Card *** Berikut ini adalah daftar untuk melakukan *Recurring* untuk . | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ----------------------------------------------------------------------------------- | ------------------ | ---------- | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------- | | `timeStamp`
Required | N | 14 | Request Timestamp (`YYYYMMDDHH24MISS`) | 20221202141217 | | `iMid`
Required | AN | 10 | ID
| IONPAYTEST | | `payMethod`
Required | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok)
| 01 (Credit Card) | | `currency`
Required | A | 3 | Currency
| IDR | | `amt`
Required | N | 12 | Amount
(number not in float format) | 10000 (Jumlah total amount goods dari cartData) | | `referenceNo`
Required | ANS | 40 | 's Reference Number
| ordNo20221202141217 | | `goodsNm `
Required | AN | 100 | Goods Name
| Testing Transaction | | `billingNm `
Required | A | 100 | Buyer Name
| John Doe | | `billingPhone `
Required | N | 15 | Buyer Phone No.
| 2112345678 | | `billingEmail `
Required | ANS | 40 | Buyer E-mail
| buyer\@merchant.com | | `billingAddr `
Required | AN | 100 | Buyer Address
| Jln. Raya Kasablanka Kav.88 | | `billingCity `
Required | A | 50 | Buyer City
| South Jakarta | | `billingState `
Required | A | 50 | Billing State
| DKI Jakarta | | `billingPostCd `
Required | N | 10 | Billing Post Number
| 14350 | | `billingCountry `
Required | A | 10 | Billing Country
| | | `cartData`
Optional | `JSONstring`
| 4000 | Cart Data
| \{} | | `instmntType`
Required | N | 2 | [Installment Type Code](docId:7CIX-U_4z295XgtNVEsbO) | 1 (Untuk PreAuth & Recurring default 1) | | `instmntMon`
Required | N | 2 | Installment Month
`1`: 1 Month/Full , *jika* `instmntType`*:* `null`*/1*
| 1 (Untuk PreAuth & Recurring default 1) | | `recurrOpt`
Required | N | 2 | `0`: Automatic Cancel
`1`: Do not cancel
`2`: Do not make token | 2 | | `dbProcessUrl`
Required | ANS | 255 | Notification URL | https\://merchant.com/dbProcessUrl
| | `userIP`
Required for CC, E-Wallet, Payloan, QRIS | AN | 15 | User IP | 127.0.0.1 | | `merchantToken`
Required | AN | 255 | Token
| c91e6531f6c84869439bc5ebe5389bd71e7752c054fc9dbfe193d087a1b797ae
| | `description` | AN | 100 | Transaction Description | Test Transaction
| | `userSessionID` | AN | 100 | User Session ID | userSessionID | | `userAgent` | ANS | 100 | User Agent | Mozilla | | `userLanguage` | A | 2 | User Language | en-US
| ### ### Cart Data for Recurring - Registration API Credit Card `cartData` pada *request * di Registrasi berguna untuk meliputi barang atau *item* apa saja akan dibayarkan oleh berserta rincian dan harga per *item.* | **Parameter** | **Deskripsi** | **Contoh** | | ------------- | ---------------------------------------------------------------------------------------------------- | ---------- | | `Count` | Total jumlah dari keseluruhan cart data | 2 | | `Item` | Terbagi menjadi 5 macam , yaitu `img_url`, `goods_id`, `goods_name`, `goods_detail`, dan `goods_amt` | - | *** Penjelasan detil pada **Item.** | **Parameter** | **Deskripsi** | **Contoh** | | -------------- | -------------------------------------- | --------------------------------------------- | | `img_url` | URL Gambar Barang (Ukuran 50px x 50px) | htttps\://www\.merchant.com/image\_goods1.jpg | | `goods_id` | ID Barang | NICEPRDID1 | | `goods_name` | Nama Barang | Nama Item-1 | | `goods_detail` | Deskripsi Detail Barang | Detail Item-1 | | `goods_amt` | Harga Barang | 1000 | ### Sample JSON Cart Data :::CodeblockTabs cartData Credit Card Registration ```json { "count": "2", "item": [ { "img_url": "http://www.merchant.com/image_goods1.jpg", "goods_id": "NICEPRDID1", "goods_name": "Item 1 Name", "goods_detail": "Item 1 Detail", "goods_amt": "1000" }, { "img_url": "http://www.merchant.com/image_goods2.jpg", "goods_id": "NICEPRDID1", "goods_name": "Item 2 Name", "goods_detail": "Item 2 Detail", "goods_amt": "1000" } ] } ``` ::: ## Response Parameter for Recurring - Registration API Credit Card *** Berikut adalah *response * dari hasil *request * untuk *Recurring *pada : | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | -------------- | -------- | ---------- | ----------------------------------------------------------- | ------------------------------ | | `resultCd` | N | 4 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | 0000 | | `resultMsg ` | AN | 255 | Result Message: [Error Code](docId\:yEh1VA9k2y6sL1kQF2aWD) | SUCCESS | | `tXid` | AN | 30 | Transaction ID | IONPAYTEST01202212151029182023 | | `referenceNo` | ANS | 40 | Reference Number | ordNo20221215101254 | | `payMethod` | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | 01 | | `amt` | N | 12 | Amount | 10000 | | `transDt` | N | 8 | Transaction Date (`YYYYMMDD`) | 20221212 | | `transTm` | N | 6 | Transaction Time (`HH24MISS`) | 121212 | | `description` | AN | 100 | Transaction Description | Testing Transaction | | `bankCd` | A | 4 | [Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | null | | `vacctNo` | N | 20 | | null | | `mitraCd` | A | 4 | [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8) | null | | `payNo` | N | 12 | CVS Number | null | | `currency ` | A | 3 | Currency | IDR | | `goodsNm` | AN | 100 | Goods Name | Goods For Testing Transaction | | `billingNm` | A | 100 | Buyer Name | John Doe | | `vacctValidDt` | N | 8 | VA Expiry Date (`YYYYMMDD`) | null | | `vacctValidTm` | N | 6 | VA Expiry Time (`HH24MISS`) | null | | `payValidDt ` | N | 8 | Expiry Date (`YYYYMMDD`) | null | | `payValidTm` | N | 6 | Expiry Time (`HH24MISS`) | null | | `requestURL` | ANS | 360 | Request URL | null | | `paymentExpDt` | N | 6 | QR Expiry Date (`YYYYMMDD`) | null | | `paymentExpTm` | N | 6 | QR Expiry Time (`HH24MISS`) | null | | `qrContent` | ANS | 360 | QR String in Plain Text | null | | `qrUrl` | ANS | 360 | URL for QR Image, Valid for 5 minutes | null | ## Sample Parameter for Recurring - Registration API Credit Card *** ### Request Parameter :::CodeblockTabs cURL ```curl curl --location 'https://dev.nicepay.co.id/nicepay/direct/v2/registration' \ --header 'Content-Type: application/json' \ --data-raw '{ "timeStamp": "20221213101276", "iMid": "RECURRTEST", "payMethod": "01", "currency": "IDR", "amt": "5000", "merchantToken": "ed9c8640b6260c8fa7070aa4e38df87896f9777899af354ee6d3d61f64626c0c", "referenceNo": "ordNo20221213101276", "goodsNm" : "Goods For Testing", "billingNm" : "John Doe", "billingPhone" : "081288998899", "billingEmail" : "john.doe@example.com", "billingAddr" : "Jln. Raya Kasablanka Kav.88", "billingCity" : "South Jakarta", "billingState" : "DKI Jakarta", "billingCountry" : "Indonesia", "billingPostCd" : "12800", "cartData": "{\"count\":\"1\",\"item\":[{\"goods_id\":\"NICEPRDID1\",\"img_url\":\"http://www.merchant.com/image_goods1.jpg\",\"goods_name\":\"Goods For Testing\",\"goods_detail\":\"Goods For Testing Details\",\"goods_amt\":\"5000\",\"goods_quantity\":\"1\"}]}", "dbProcessUrl": "http://ptsv2.com/t/merchant/post", "userIP":"127.0.0.1", "instmntType":"1", "instmntMon":"1", "recurrOpt":"1", "userLanguage": "en", "userAgent":"Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0" }' ``` Node.js ```nodejs const nicepayClient = require("nodejs-nicepay"); let secondVersion = new nicepayClient.SecondApiVersion({ isProduction: false, isCloudServer: false, merchantKey: "YOUR_MERCHANT_KEY" }); const parameter = { timeStamp: "20221213101276", iMid: "RECURRTEST", payMethod: "01", currency: "IDR", amt: "5000", referenceNo: "ordNo20221213101276", goodsNm: "Goods For Testing", billingNm: "John Doe", billingPhone: "081288998899", billingEmail: "john.doe@example.com", billingAddr: "Jln. Raya Kasablanka Kav.88", billingCity: "South Jakarta", billingState: "DKI Jakarta", billingPostCd: "12800", billingCountry: "Indonesia", cartData: "{\"count\":\"1\",\"item\":[{\"goods_id\":\"NICEPRDID1\",\"img_url\":\"http://www.merchant.com/image_goods1.jpg\",\"goods_name\":\"Goods For Testing\",\"goods_detail\":\"Goods For Testing Details\",\"goods_amt\":\"5000\",\"goods_quantity\":\"1\"}]}", dbProcessUrl: "http://ptsv2.com/t/merchant/post", userIP: "127.0.0.1", instmntType: "1", instmntMon: "1", recurrOpt: "1", userLanguage: "en", userAgent: "Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0", }; let endPoint = "/direct/v2/registration"; secondVersion.requestAPI(parameter, endPoint); ``` ```java String reffNo = "ordNo20221202141217"; Card requestData = Card.builder() .timeStamp("20221202141217") .iMid("IONPAYTEST") .payMethod("01") .currency("IDR") .amt("5000") .referenceNo(reffNo) .goodsNm("Testing Transaction") .billingNm("John Doe") .billingPhone("081288998899") .billingEmail("john.doe@example.com") .billingAddr("Jln. Raya Kasablanka Kav.88") .billingCity("South Jakarta") .billingState("DKI Jakarta") .billingPostCd("12800") .billingCountry("Indonesia") .description("Testing Registration Credit Card") .deliveryNm("") .deliveryPhone("") .deliveryAddr("") .deliveryCity("") .deliveryState("") .deliveryPostCd("") .deliveryCountry("") .dbProcessUrl("http://ptsv2.com/t/merchant/post") .userIP("127.0.0.1") .userAgent("Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0") .instmntType("1") .instmntMon("1") .recurrOpt("1") .cartData("{\"count\":\"1\",\"item\":[{\"goods_id\":\"NICEPRDID1\",\"img_url\":\"http://www.merchant.com/image_goods1.jpg\",\"goods_name\":\"Goods For Testing\",\"goods_detail\":\"Goods For Testing Details\",\"goods_amt\":\"5000\",\"goods_quantity\":\"1\"}]}") .merchantToken("20221202141217", "IONPAYTEST", reffNo, "5000", merchantKey) .build(); NICEPayResponseV2 cardRegistResponse = V2CardService.callV2CardRegistration(requestData, config); ``` ```python amt = 1000 itemCartData = { "goods_id": "NICEPRDID1", "goods_detail": "BB12345678", "goods_name": "Market", "goods_amt": amt, "goods_url": "https://merchant.com/cellphones/iphone5s_64g", } bodyCartData = ( builderCartData.BuildCartData() .setCount("1") .setItem(itemCartData) .build() ) bodyCreditCard = ( builderCreditCard.BuildCreditCard() .setPayMethod(ConstantsGeneral.getPayMethodCreditCard()) .setRecurrOpt("1") .setInstmntMon("1") .setInstmntType("1") .setAmt(str(amt)) .build() ) environment = ( builderEnvironment.BuildEnvironment() .isCloud(False) .isProduction(False) .build() ) ``` C# ```csharp string merchantKey = config.MerKey; string clientId = config.ClientId; string timestamp = "20221213101276"; string refNo = "ordNo20221213101276"; string amount = "5000"; bool isProduction = false; bool isCloudServer = false; // 1️⃣ Generate merchant token var merchantTokenBuilder = new MerchantTokenBuilder() .SetTimeStamp(timestamp) .SetIMid(clientId) .SetRefNo(refNo) .SetAmount(amount) .SetMerchantKey(merchantKey); string merchantToken = merchantTokenBuilder.BuildMerchantToken(); // 2️⃣ Build Cart Data var cartItem = new Dictionary { {"goods_id", "IONPAYTESTPRD1"}, { "img_url", "http://www.merchant.com/image_goods1.jpg" }, { "goods_name", "Goods For Testing" }, { "goods_detail", "Goods For Testing Details" }, { "goods_amt", "5000" } }; var cartDataBuilder = new BuilderCartData() .SetCount("1") .SetItem(cartItem); var cartData = cartDataBuilder.Build(); // 3️⃣ Build Credit Card Request Body var bodyBuilder = new NicepayRequestBuilder() .SetCommonFields( iMid: "RECURRTEST", timeStamp: timestamp, payMethod: "01", currency: "IDR", amt: amount, referenceNo: refNo, goodsNm: "Goods For Testing", merchantToken: merchantToken ) .setCreditCard( instmntType: "1", instmntMon: "1", recurrOpt: "" ) .SetBillingInfo( billingNm: "John Doe", billingPhone: "081288998899", billingEmail: "john.doe@example.com", billingAddr: "Jln. Raya Kasablanka Kav.88", billingCity: "South Jakarta", billingState: "DKI Jakarta", billingPostCd: "12800", billingCountry: "Indonesia" ) .SetDbProcessUrl("http://ptsv2.com/t/merchant/post") .SetCartData(cartData) .SetUserIP("127.0.0.1") .SetUserLanguage("en") .SetUserAgent("Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0"); ApiEndpoints apiEndpoints = new ApiEndpoints(); // 4️⃣ Build payload and send Dictionary payload = bodyBuilder.Build(); string jsonPayload = Newtonsoft.Json.JsonConvert.SerializeObject(payload, Newtonsoft.Json.Formatting.Indented); var registrationService = new NicepayRegistrationService(apiEndpoints, isProduction, isCloudServer); var result = await registrationService.SendPostAsync(apiEndpoints.RegistV2, payload); ``` Vanilla JS ```javascript const registrationData = { timeStamp: "20221202141217", payMethod: "01", currency: "IDR", amt: "5000", referenceNo: "ordNo20221202141217", goodsNm: "Testing Transaction", billingNm: "John Doe", billingPhone: "081288998899", billingEmail: "john.doe@example.com", billingAddr: "Jln. Raya Kasablanka Kav.88", billingCity: "South Jakarta", billingState: "DKI Jakarta", billingPostCd: "12800", billingCountry: "Indonesia", description: "Testing Registration Credit Card", deliveryNm: "", deliveryPhone: "", deliveryAddr: "", deliveryCity: "", deliveryState: "", deliveryPostCd: "", deliveryCountry: "", dbProcessUrl: "http://ptsv2.com/t/merchant/post", merchantToken: "c91e6531f6c84869439bc5ebe5389bd71e7752c054fc9dbfe193d087a1b797ae", userIP: "127.0.0.1", cartData: "{\"count\":\"1\",\"item\":[{\"goods_id\":\"NICEPRDID1\",\"img_url\":\"http://www.merchant.com/image_goods1.jpg\",\"goods_name\":\"Goods For Testing\",\"goods_detail\":\"Goods For Testing Details\",\"goods_amt\":\"5000\",\"goods_quantity\":\"1\"}]}", userAgent: "Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0", instmntMon: "1", instmntType: "1", recurrOpt:"1" }; // Example payment data object if needed (adjust per your code) const paymentData = { cardNo: "4811111111111114", expMonth: "12", expYear: "2025", cvv: "123", }; (async () => { try { const response = await Nicepay.registerTransaction(registrationData, paymentData); console.log("Transaction Response:", response); } catch (error) { console.error("Registration Failed:", error); } })(); ``` Laravel ```php $useProd = false; $useCloud = false; $registration_endpoint = "/nicepay/direct/v2/registration"; $url = HttpUtil::getNicepayDomain($useProd, $useCloud) . $registration_endpoint; $timestamp = "20221213101276"; $reference_no = "ordNo20221213101276"; $amt = "5000"; $merchant_token = "ed9c8640b6260c8fa7070aa4e38df87896f9777899af354ee6d3d61f64626c0c"; $body = [ "timeStamp" => $timestamp, "iMid" => "RECURRTEST", "payMethod" => "01", "currency" => "IDR", "amt" => $amt, "merchantToken" => $merchant_token, "referenceNo" => $reference_no, "goodsNm" => "Goods For Testing", "billingNm" => "John Doe", "billingPhone" => "081288998899", "billingEmail" => "john.doe@example.com", "billingAddr" => "Jln. Raya Kasablanka Kav.88", "billingCity" => "South Jakarta", "billingState" => "DKI Jakarta", "billingCountry" => "Indonesia", "billingPostCd" => "12800", "cartData" => "{\"count\":\"1\",\"item\":[{\"goods_id\":\"NICEPRDID1\",\"img_url\":\"http://www.merchant.com/image_goods1.jpg\",\"goods_name\":\"Goods For Testing\",\"goods_detail\":\"Goods For Testing Details\",\"goods_amt\":\"5000\",\"goods_quantity\":\"1\"}]}", "dbProcessUrl" => "http://ptsv2.com/t/merchant/post", "userIP" => "127.0.0.1", "instmntType" => "1", "instmntMon" => "1", "recurrOpt" => "1", "userLanguage" => "en", "userAgent" => "Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0" ]; $response = HttpUtil::postJsonRequest($url, $body); ``` PHP Native ```php $config = NICEPay::builder() ->setIsProduction(false) ->build(); $timestamp = "20221202141217"; $reffNo = "ordNo20221202141217"; $amount = "5000"; $parameter = Card::builder() ->setTimeStamp($timestamp) ->setIMid("IONPAYTEST") ->setPayMethod("01") ->setCurrency("IDR") ->setAmt($amount) ->setReferenceNo($reffNo) ->setMerchantToken($timestamp, "IONPAYTEST", $reffNo, $amount, $this->merchantKey) ->setDescription("Testing Registration Credit Card") ->setGoodsNm("Testing Transaction") ->setBillingNm("John Doe") ->setBillingPhone("081288998899") ->setBillingEmail("john.doe@example.com") ->setBillingAddr("Jln. Raya Kasablanka Kav.88") ->setBillingCity("South Jakarta") ->setBillingState("DKI Jakarta") ->setBillingCountry("Indonesia") ->setBillingPostCd("12800") ->setDbProcessUrl("http://ptsv2.com/t/merchant/post") ->setCartData("{\"count\":\"1\",\"item\":[{\"goods_id\":\"NICEPRDID1\",\"img_url\":\"http://www.merchant.com/image_goods1.jpg\",\"goods_name\":\"Goods For Testing\",\"goods_detail\":\"Goods For Testing Details\",\"goods_amt\":\"5000\",\"goods_quantity\":\"1\"}]}") ->setUserIP("127.0.0.1") ->setInstmntType("1") ->setInstmntMon("1") ->setRecurrOpt("1") ->setUserLanguage("en") ->setUserAgent("Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0") ->build(); $cardService = new V2CardService($config); ``` ```kotlin var config: NICEPay? = NICEPay.Builder() .isProduction(false) .clientSecret(TestingConstants.CLIENT_SECRET) .partnerId(TestingConstants.PARTNER_ID) .externalID(TestingConstants.EXTERNAL_ID) .timestamp(TestingConstants.TIMESTAMP) .privateKey(TestingConstants.PRIVATE_KEY) .build() val request: DirectV2Card = DirectV2Card.Builder() .timeStamp("20221202141217") .iMid("IONPAYTEST") .payMethod("01") .currency("IDR") .amt("5000") .referenceNo("ordNo20221202141217") .goodsNm("Testing Transaction") .billingNm("John Doe") .billingPhone("081288998899") .billingEmail("john.doe@example.com") .billingAddr("Jln. Raya Kasablanka Kav.88") .billingCity("South Jakarta") .billingState("DKI Jakarta") .billingPostCd("12800") .billingCountry("Indonesia") .dbProcessUrl("http://ptsv2.com/t/merchant/post") .userIP("127.0.0.1") .userAgent("Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0") .userLanguage("en") .instmntType("1") .instmntMon("1") .recurrOpt("1") .cartData("{\"count\":\"1\",\"item\":[{\"goods_id\":\"NICEPRDID1\",\"img_url\":\"http://www.merchant.com/image_goods1.jpg\",\"goods_name\":\"Goods For Testing\",\"goods_detail\":\"Goods For Testing Details\",\"goods_amt\":\"5000\",\"goods_quantity\":\"1\"}]}") .merchantKey(DEFAULT_MERCHANT_KEY) .build() val response: NICEPayResponseV2 = v2CardService.registration(request, config)!! ``` CodeIgniter ```php $timestamp = "20221202141217"; $configBuilder = NICEPay::builder(); $config = $configBuilder ->setIsProduction(false) ->setIsCloudServer(isCloudServer: true) ->build(); $reffNo = "ordNo20221202141217"; $amount = "5000"; $CardBuilder = Card::builder(); $parameter = $CardBuilder ->setTimeStamp($timestamp) ->setIMid("IONPAYTEST") ->setPayMethod("01") ->setCurrency("IDR") ->setAmt($amount) ->setReferenceNo($reffNo) ->setMerchantToken($timestamp, "IONPAYTEST", $reffNo, $amount, $this->merchantKey) ->setDescription("Testing Registration Credit Card") ->setgoodsNm("Testing Transaction") ->setBillingNm("John Doe") ->setBillingPhone("081288998899") ->setBillingEmail("john.doe@example.com") ->setBillingAddr("Jln. Raya Kasablanka Kav.88") ->setBillingCity("South Jakarta") ->setBillingState("DKI Jakarta") ->setBillingPostCd("12800") ->setBillingCountry("Indonesia") ->setDbProcessUrl("http://ptsv2.com/t/merchant/post") ->setCartData("{\"count\":\"1\",\"item\":[{\"goods_id\":\"NICEPRDID1\",\"img_url\":\"http://www.merchant.com/image_goods1.jpg\",\"goods_name\":\"Goods For Testing\",\"goods_detail\":\"Goods For Testing Details\",\"goods_amt\":\"5000\",\"goods_quantity\":\"1\"}]}") ->setUserIP("127.0.0.1") ->setInstmntType("1") ->setInstmntMon("1") ->setRecurrOpt("1") ->setUserLanguage("en") ->setUserAgent("Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0") ->build(); $cardService = new V2CardService($config); $response = $cardService->registration($parameter); ``` ::: ### Response Parameter :::CodeblockTabs Sample Response ```json { "resultCd": "0000", "resultMsg": "SUCCESS", "tXid": "RECURRTEST01202510081035159576", "referenceNo": "ordNo20221213101276", "payMethod": "01", "amt": "5000", "transDt": "20251008", "transTm": "103515", "description": null, "bankCd": null, "vacctNo": null, "mitraCd": null, "payNo": null, "currency": null, "goodsNm": null, "billingNm": null, "vacctValidDt": null, "vacctValidTm": null, "payValidDt": null, "payValidTm": null, "requestURL": null, "paymentExpDt": null, "paymentExpTm": null, "qrContent": null, "qrUrl": null } ``` ::: [title] Reject Payout [path] NICEPAY API/API Playground/SNAP API Testing/Payout (Disbursement)/ { "id": "LviK1ym2QO7tajLQUsgtf", "type": "api-oas-v2", "data": { "method": "POST", "url": "https://dev.nicepay.co.id/nicepay/api/v1.0/transfer/reject", "servers": [ { "url": "https://dev.nicepay.co.id/nicepay/api/v1.0/transfer/reject" }, { "url": "https://staging.nicepay.co.id/nicepay/api/v1.0/transfer/reject" }, { "url": "https://www.nicepay.co.id/nicepay/api/v1.0/transfer/reject" } ], "name": "Reject Payout", "description": "", "contentType": "application/json", "request": { "pathParameters": [], "headerParameters": [ { "kind": "required", "name": "X-TIMESTAMP", "type": "string", "example": "2022-08-28T10:11:40+07:00" }, { "kind": "required", "name": "X-SIGNATURE", "type": "string", "default": "xRGlWgHZc5zQW/ELtJOEM7p6y1f+IuLj4GoaFbPaMcX+mFlAxxnMPlrRVo5lTnFOCu4oFRPJseXL7d5qk2nCxg==" }, { "kind": "required", "name": "X-PARTNER-ID", "type": "string", "example": "IONPAYTEST" }, { "kind": "required", "name": "X-EXTERNAL-ID", "type": "string", "example": "20232123595911" }, { "kind": "required", "name": "CHANNEL-ID", "type": "string", "example": "IONPAYTEST" } ], "queryParameters": [], "bodyDataParameters": [ { "kind": "optional", "name": "body", "type": "object", "example": "{\"originalReferenceNo\":\"IONPAYTEST07202308291735328345\",\"merchantId\":\"IONPAYTEST\",\"originalPartnerReferenceNo\":\"ref-998294194\"}", "description": "", "customType": "reject_payout_body", "schema": [ { "name": "merchantId", "kind": "required", "type": "string", "description": "Merchant identifier that is unique pereach merchant", "example": "" }, { "name": "originalReferenceNo", "kind": "required", "type": "string", "description": "Original transaction identifier on service provider system", "example": "" }, { "name": "originalPartnerReferenceNo", "kind": "required", "type": "string", "description": "Original transaction identifier on consumer system", "example": "" } ], "modelRef": "#/components/schemas/reject_payout_body", "complexItems": [ { "name": "object", "schema": [ { "name": "merchantId", "kind": "required", "type": "string", "description": "Merchant identifier that is unique pereach merchant", "example": "" }, { "name": "originalReferenceNo", "kind": "required", "type": "string", "description": "Original transaction identifier on service provider system", "example": "" }, { "name": "originalPartnerReferenceNo", "kind": "required", "type": "string", "description": "Original transaction identifier on consumer system", "example": "" } ], "modelRef": "#/components/schemas/Reject-Payout", "customType": "Reject-Payout" }, { "name": "object", "schema": [] } ], "complexType": "allOf", "isExpanded": true } ], "formDataParameters": [], "oAuthParameters": [ { "id": "Authorization", "name": "Authorization", "kind": "optional", "type": "http", "scheme": "bearer" } ] }, "responses": [ { "statusCode": "200", "description": "Successful", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Successful", "code": "{\n \"responseCode\": \"2000000\",\n \"responseMessage\": \"Successful\",\n \"originalPartnerReferenceNo\": \"ref-998294194\",\n \"originalReferenceNo\": \"IONPAYTEST07202308291735328345\",\n \"beneficiaryAccountNo\": \"903327200\",\n \"beneficiaryName\": \"Test\",\n \"beneficiaryBankCode\": \"BBBA\",\n \"amount\": {\n \"value\": \"10000.00\",\n \"currency\": \"IDR\"\n }\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "SuccessfulRejectPayout", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "2000000" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Successful" }, { "name": "originalPartnerReferenceNo", "kind": "optional", "type": "string", "description": "Original Partner ReferenceNo", "example": "ref-998294194" }, { "name": "originalReferenceNo", "kind": "optional", "type": "string", "description": "Original ReferenceNo", "example": "IONPAYTEST07202308291735328345" }, { "name": "beneficiaryAccountNo", "kind": "optional", "type": "string", "description": "Beneficiary AccountNo", "example": "903327200" }, { "name": "beneficiaryName", "kind": "optional", "type": "string", "description": "Beneficiary Name", "example": "Test" }, { "name": "beneficiaryBankCode", "kind": "optional", "type": "string", "description": "Beneficiary BankCode", "example": "BBBA" }, { "name": "amount", "kind": "optional", "type": "object", "modelRef": "#/components/schemas/amount", "customType": "amount", "schema": [ { "name": "currency", "kind": "optional", "type": "string", "description": "Currency", "example": "IDR" }, { "name": "value", "kind": "optional", "type": "string", "description": "Value", "example": "10000.00" } ] } ], "modelRef": "#/components/schemas/SuccessfulRejectPayout", "isExpanded": true } ] }, { "statusCode": "202", "description": "Request In Progress", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Request In Progress", "code": "{\n \"responseCode\": \"202XX00\",\n \"responseMessage\": \"Request In Progress\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "RequestInProgress", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "202XX00" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Request In Progress" } ], "modelRef": "#/components/schemas/RequestInProgress", "isExpanded": true } ] }, { "statusCode": "409", "description": "Duplicate partnerReferenceNo", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Duplicate partnerReferenceNo", "code": "{\n \"responseCode\": \"409XX01\",\n \"responseMessage\": \"Duplicate partnerReferenceNo\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "DuplicatePartnerReferenceNo", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "409XX01" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Duplicate partnerReferenceNo" } ], "modelRef": "#/components/schemas/DuplicatePartnerReferenceNo", "isExpanded": true } ] }, { "statusCode": "500", "description": "General Error", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "General Error", "code": "{\n \"responseCode\": \"500XX00\",\n \"responseMessage\": \"General Error\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "GeneralError", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "500XX00" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "General Error" } ], "modelRef": "#/components/schemas/GeneralError", "isExpanded": true } ] }, { "statusCode": "504", "description": "Request Timeout", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Request Timeout", "code": "{\n \"responseCode\": \"504XX00\",\n \"responseMessage\": \"Request Timeout\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "RequestTimeout", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "504XX00" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Request Timeout" } ], "modelRef": "#/components/schemas/RequestTimeout", "isExpanded": true } ] } ] }, "children": [ { "text": "" } ] } [title] Inquiry - Account Binding API E-Wallet (Direct Debit) SNAP [path] NICEPAY API/API SNAP/Payment API - SNAP/API E-Wallet (Direct Debit) SNAP/Account Binding - API E-Wallet (Direct Debit) SNAP/ # Tentang Inquiry - Account Binding API E-Wallet (Direct Debit) SNAP *** ini digunakan untuk melakukan pemeriksaan akun pengguna milik telah berhasil terhubung atau tidak pada sesuai standar . Inquiry - Account Binding API E-Wallet (Direct Debit) SNAP ========================================================== *** | **Service Code** | `08` | | ---------------- | ------------------------------------------------- | | **API Endpoint** | `/nicepay/api/v1.0/registration-account-inquiry` | | **Method** | `POST` | ## Request Header Parameter for Inquiry - Account Binding API E-Wallet (Direct Debit) SNAP *** | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | --------------- | -------- | ---------- | ------------- | --------------------------------------------------------------------------------------------------------------- | | `Content-Type` | String | Variable | Mandatory | Content type, value always `application/json` | | `Authorization` | String | Variable | Mandatory | Bearer “`accessToken`” | | `X-TIMESTAMP` | String | Variable | Mandatory | Transaction date time, in format `YYYY-MMDDTHH:mm:ss+07:00`. Time must be in GMT+7 (Jakarta time) | | `X-SIGNATURE` | String | Variable | Mandatory | Signature will be generated automatically by . | | `X-PARTNER-ID` | String | 10 | Mandatory | Unique ID, Partner ID = Client ID | | `X-EXTERNAL-ID` | String | 40 | Mandatory | Unique messaging Reference ID generated by . Numeric String. Reference number that should be unique in every . | | `CHANNEL-ID` | String | 5 | Mandatory | Device identification on which s is currently being accessed by End User () | ## Request Body Parameter for Inquiry - Account Binding API E-Wallet (Direct Debit) SNAP *** | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | -------------------- | ----------- | ---------- | ------------- | -------------------------------------------- | | `partnerReferenceNo` | String | 40 | Mandatory | Original identifier on provider | | `additionalInfo` | JSON Object | Variable | Mandatory | Additional | | `refreshToken` | String | 40 | Mandatory | `refreshToken` From | | `mitraCd` | String | 40 | Mandatory | Code Example :
AstraPay : `ASTR` | ## Response Header Parameter for Inquiry - Account Binding API E-Wallet (Direct Debit) SNAP *** | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | -------------- | -------- | ---------- | ------------- | ------------------------------------------------------------------------------------------------ | | `Content-Type` | String | Variable | Mandatory | Content type, value always `application/json` | | `X-TIMESTAMP` | String | Variable | Mandatory | Transaction date time, in format `YYYY-MMDDTHH:mm:ss+07:00`. Time must be in GMT+7(Jakarta time) | ## Response Body Parameter for Inquiry - Account Binding API E-Wallet (Direct Debit) SNAP *** | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | -------------------- | ----------- | ---------- | ------------- | ----------------------------------------------------------------------------- | | `responseCode` | String | 7 | Mandatory | Refer to response code list | | `responseMessage` | String | 150 | Mandatory | Debug message to provide more | | `referenceNo` | String | 40 | Mandatory | Transaction ID | | `partnerReferenceNo` | String | 40 | Mandatory | identifier | | `additionalInfo` | JSON Object | Variable | Mandatory | Additional | | `mitraCd` | String | 4 | Mandatory | Code
Example :
AstraPay : `ASTR`
AlloBank : `ALLO` | | `accountToken` | String | 40 | Mandatory | Account Token Information | | `accessTokenInfo` | JSON Object | Variable | Mandatory | Account Token Information | | `accessToken` | String | 150 | Mandatory | Access Token | | `expiresIn` | String | 25 | Mandatory | Date time of token expiration | | `refreshToken` | String | 150 | Mandatory | Refresh token | | `reExpiresIn` | String | 25 | Mandatory | Date time of refresh token expiration | | `authCode` | String | 30 | Mandatory | Authentication Code for Merchant | ## Sample Parameter for Inquiry - Account Binding API E-Wallet (Direct Debit) SNAP *** ### Request Parameter :::CodeblockTabs cURL ```curl curl -X POST \ 'https://dev.nicepay.co.id/nicepay/api/v1.0/registration-account-inquiry' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8=' \ -H 'X-TIMESTAMP: 2024-01-31T10:11:40+07:00' \ -H 'X-SIGNATURE: ufBw7R8RhW79IOiV/Hlv607M60qzAYBv8uZmbSrYb6/Thlo/FhQVP4xRyelUehoSS9o+QS6vWTKb/ygtucC+tQ==' \ -H 'X-PARTNER-ID: IONPAYTEST' \ -H 'X-EXTERNAL-ID: tXid202410142300021707638093' \ -H 'CHANNEL-ID: IONPAYTEST01' \ -d '{"partnerReferenceNo":"2020102900000000000001","additionalInfo":{"referenceNo":"IONPAYTEST05202208121451526358","mitraCd":"ASTR"}}' ``` Node.js ```nodejs const config = { isProduction: false, privateKey: cons.privateKey, clientSecret: cons.clientSecret, clientId: "IONPAYTEST", isCloudServer: false, }; const ACCESS_TOKEN = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8="; const parameter = { body: { // Inquiry Body Fields partnerReferenceNo: "2020102900000000000001", additionalInfo: { referenceNo: "IONPAYTEST05202208121451526358", mitraCd: "ASTR" } }, headers: { X_EXTERNAL_ID: "tXid202410142300021707638093", CHANNEL_ID: "IONPAYTEST01", }, }; let snap = new Snap(config); let endPoint = `/api/v1.0/registration-account-inquiry`; let response = snap .requestSnapTransaction(parameter, endPoint, ACCESS_TOKEN, "POST"); ``` ::: ### Response Parameter :::CodeblockTabs Sample Response ```json { "responseCode": "2000800", "responseMessage": "Successful", "referenceNo": "IONPAYTEST05202208121451526358", "partnerReferenceNo": "2020102900000000000001", "additionalInfo": { "mitraCd": "ASTR", "accountToken": "1Fhas7281han862=", "accessTokenInfo": { "accessToken": "ublicpBa869cad0990e4e17a57ecf7c5469a4b2", "expiresIn": "2021-07-04T12:08:56+05:30", "refreshToken": "201208134b203fe6c11548bcabd8da5bb087a83b", "reExpiresIn": "2051-07-04T12:08:56+05:30", " authCode": "nlleyvaQcB2SOkVjtF7ceCuC16BiqCc6DRrjaKOnnfRdToW8Tr" } } } ``` ::: [title] Notification - API Virtual Account SNAP [path] NICEPAY API/API SNAP/Payment API - SNAP/API Virtual Account SNAP/ # Tentang Notification - API Virtual Account SNAP *** dengan standar ini digunakan untuk mengirimkan pada . # Panduan Validasi X-SIGNATURE *** Berikut adalah cara untuk melakukan validasi X-SIGNATURE pada Request Header Notify: `SHA256withRSA (Public_Key, stringToSign) stringToSign = client_ID + “|” + X-TIMESTAMP` :::hint{type="warning"} Informasi khusus Notifikasi terkait kredensial `Public_Key` akan diberikan oleh Tim kepada melalui email, karena kredensial `Public_Key` akan digunakan di Notifikasi berbeda dengan Transaksi (Registration, Inquiry & ). menghubungi Tim Integrasi melalui email ([integration@nicepay.co.id](mailto\:integration@nicepay.co.id)) untuk atau bantuan lebih lanjut. ::: Berikut adalah contoh hasil X-SIGNATURE dari cara validasi di atas: `mYyscWBs00bm0TJQ/xY7Uu1Goh8qXJyYSlo88rFrhQ+mlyQkMtq NKMlZDpS+` # Merchant Notification - API Virtual Account SNAP *** | **Service Code** | `25` | | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **API Endpoint** | `[merchant-domain]/api/v1.0/transfer-va/payment` | | **HTTP Method** | `POST` | | **Content-type** | `application/json` | | **Description** | Transaction Result Notification (when success)

If your use firewall, add allow policy for IP =
IP Public environtment Production:
`103.20.51.34`
`103.20.51.33`
`18.98.96.50`

IP Public environtment Dev:
`103.20.51.39`
`103.20.51.40`
`18.98.96.54` | ## Request Notification Header Parameter | **Parameter** | **Tipe** | **Kebutuhan** | **Deskripsi** | | -------------- | -------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `Content-Type` | String | Mandatory | `Application / JSON` | | `X-TIMESTAMP` | String | 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-CLIENT-KEY` | String | Mandatory | Unique ID, ID = Client ID | | `X-SIGNATURE` | String | Mandatory | Signature will be generated by .
[Panduan X-Signature - Symmetric](docId\:UZex33ReLyENKOgbJJnYp) | ## Request Notification Body Parameter | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | ----------------------- | -------- | ---------- | ------------- | --------------------------------------------------- | | `partnerServiceId` | String | 20 | Mandatory | Service ID / Prefix | | `customerNo` | String | 40 | Mandatory | Number | | `virtualAccountNo` | String | 16 | Mandatory | Number | | `virtualAccountName` | String | 100 | Mandatory | Name | | `trxId` | String | 40 | Mandatory | Transaction ID
(Reference Number from ) | | `paymentRequestId` | String | 128 | Mandatory | Unique Identifier from | | `hashedSourceAccountNo` | String | 32 | Optional | Source account number in hash or unhash depend on | | `sourceBankCode` | String | 11 | Optional | Source account code | | `paidAmount` | Object | Variable | Mandatory | Amount of paid | | `value` | String | 12 | Mandatory | Value | | `currency` | String | 3 | Mandatory | Currency | | `trxDateTime` | String | 25 | Mandatory | Transaction Date Time | | `additionalInfo` | Object | Variable | Mandatory | Additional | | `bankCd` | String | 4 | Mandatory | [Bank Code - API SNAP](docId:9WOQy5-1hlf_uCwshSDHO) | | `goodsNm` | String | 200 | Mandatory | Goods Name | | `vacctValidDt` | String | 8 | Mandatory | Valid Date | | `vacctValidTm` | String | 6 | Mandatory | Valid Time | ## Response Notification Header Parameter | **Parameter** | **Tipe** | **Kebutuhan** | **Deskripsi** | | -------------- | -------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `Content-Type` | String | Mandatory | `Application / JSON` | | `X-TIMESTAMP` | String | 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`. | ## Response Notification Body Parameter | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | ----------------------- | -------- | ---------- | ------------- | ---------------------------------------------------------------------------- | | `responseCode` | String | 7 | Mandatory | [General Response Code and Message - API SNAP](docId\:lKqJXSl5CMKdXYXxHYYSs) | | `responseMessage` | String | 150 | Mandatory | Response Message | | `virtualAccountData` | Object | Variable | Mandatory | Data | | `partnerServiceId` | String | 20 | Mandatory | Service ID / Prefix | | `customerNo` | String | 40 | Mandatory | Number | | `virtualAccountNo` | String | 16 | Optional | Number | | `virtualAccountName` | Object | 100 | Mandatory | Name | | `trxId` | Object | 40 | Mandatory | Reference Number | | `paymentRequestId` | String | 128 | Mandatory | Unique Identifier from | | `hashedSourceAccountNo` | String | 32 | Optional | Source account number in hash or unhash depend on | | `sourceBankCode` | String | 11 | Optional | Optional
Source account code | | `paidAmount` | Object | Variable | Mandatory | Amount of paid | | `value` | Object | 12 | Mandatory | Value | | `currency` | String | 3 | Mandatory | Currency | | `trxDateTime` | String | 25 | Mandatory | Transaction Date Time | | `additionalInfo` | Object | Variable | Mandatory | Additional | | `bankCd` | String | 4 | Mandatory | [Bank Code - API SNAP](docId:9WOQy5-1hlf_uCwshSDHO) | | `goodsNm` | String | 200 | Mandatory | Goods Name | | `vacctValidDt` | String | 8 | Mandatory | Valid Date | | `vacctValidTm` | String | 6 | Mandatory | Valid Time | # Sample Parameter for Notification API Virtual Account SNAP *** ## Request Parameter :::CodeblockTabs cURL ```curl curl --location 'https://www.merchantbaseurl.com/api/v1.0/transfer-va/payment' \ --header 'Content-Type: application/json' \ --header 'X-TIMESTAMP: 2023-11-23T07:44:11+07:00' \ --header 'X-SIGNATURE: 85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5' \ --header 'X-CLIENT-KEY: 82150823919040624621823174737537' \ --data '{ "partnerServiceId": "70151021", "customerNo": "10000001", "virtualAccountNo": "7015102110000001", "virtualAccountName": "John Test", "trxId": "abcdefgh1234", "paymentRequestId": "008", "hashedSourceAccountNo": "abcdefghijklmnopqrstuvwxyz123456", "sourceBankCode": "008", "paidAmount": { "value": "10000.00", "currency": "IDR" }, "trxDateTime": "20201231T235959Z", "additionalInfo": { "bankCd": "BMRI", "goodsNm": "Test", "vacctValidDt": "20221110", "vacctValidTm": "161037" } }' ``` ::: ## Response Parameter :::CodeblockTabs Sample Response ```json //HEADER SECTION Content-type: application/json X-TIMESTAMP: 2023-11-23T07:44:16+07:00 { "responseCode": "2002500", "responseMessage": "Success", "virtualAccountData": { "partnerServiceId": "70151021", "customerNo": "10000001", "virtualAccountNo": "7015102110000001", "virtualAccountName": "John Test", "trxId": "abcdefgh1234", "paymentRequestId": "2020102900000000000001", "hashedSourceAccountNo": "abcdefghijklmnopqrstuvwxyz123456", "sourceBankCode": "008", "paidAmount": { "value": "10000.00", "currency": "IDR" }, "trxDateTime": "20201231T235959Z", "additionalInfo": { "bankCd": "BMRI", "goodsNm": "Test", "vacctValidDt": "20221110", "vacctValidTm": "161037" } } } ``` ::: [title] Non-SNAP Library [path] NICEPAY API/NICEPAY Library/ NICEPAY menyediakan SDK Non-SNAP untuk memudahkan dan mempercepat proses integrasi dengan Merchant. SDK NICEPAY Non-SNAP ini dapat diunduh melalui tautan [GitHub](https://github.com/nicepay-dev/plugs-libs) atau di-*hit* secara langsung jika bahasa pemrograman pada SDK yang digunakan tidak tersedia. Hingga saat ini, NICEPAY telah menyediakan SDK untuk: ::::LinkArray{contentSource="CUSTOM"} :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/6PQ07zypWV4rp9r-4PG0v_10s2v9vt6xrbppkv4y3zj9g.jpeg"} [Android Kotlin Library](https://github.com/nicepay-dev/plugs-libs/tree/master/Android%20Kotlin) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/TalCM3HRtYeubcx1gDkJi_3.png"} [C# Library](https://github.com/nicepay-dev/plugs-libs/tree/master/C%23) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/kdpgVnZ79GyQ3FzbjfK5j_1.png"} [CodeIgniter Library](https://github.com/nicepay-dev/Codeigniter-nicepay-snap) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/eC2IjIB2vUxGtOBNgFyjH_4.png"} [Java Library](https://github.com/nicepay-dev/java-nicepay) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/Yvnb3B1PkGjafUMsWfBS2_5.png"} [Laravel Library](https://github.com/nicepay-dev/plugs-libs/tree/master/Laravel%20SNAP) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/SBwtZ2S0BDO4k0k1VmIKH_6.png"} [PHP Native Library](https://github.com/nicepay-dev/plugs-libs/tree/master/NativePHP) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/7KPo00xw11eUqLvRMgxHj_7.png"} [Python Library](https://github.com/nicepay-dev/python-nicepay) ::: :::: [title] Cancel - API Virtual Account SNAP [path] NICEPAY API/API SNAP/Payment API - SNAP/API Virtual Account SNAP/ # Tentang Cancel - API Virtual Account SNAP *** API dengan standar SNAP ini digunakan untuk melakukan pengajuan pembatalan proses transaksi pada metode pembayaran Virtual Account. # Merchant Cancel - API Virtual Account SNAP *** :::hint{type="warning"} Silakan mengajukan akses token terlebih dahulu untuk melakukan autentikasi melalui bagian [Request Access Token API - SNAP](docId\:GcGqBIYXG1Etcd0Ji9cHX). ::: | **Service Code** | `31` | | ---------------- | ---------------------------------------------------- | | **API Endpoint** | `/api/v1.0/transfer-va/delete-va` | | **HTTP Method** | **DELETE** | | **Description** | Untuk mengajukan pembatalan proses transaksi VA | | **Content-Type** | `application/json` | ## Request Header Parameter for Cancel - API Virtual Account SNAP | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | **Contoh** | | --------------- | -------- | ---------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | | `Content-Type` | String | | Mandatory | `Application / JSON` | | | `Authorization` | String | | Mandatory | Bearer “`access_token`” | | | `X-TIMESTAMP` | String | | 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 | | Mandatory | Signature will be generated by Merchant.
[Panduan X-Signature - Symmetric](docId\:UZex33ReLyENKOgbJJnYp) | | | `X-PARTNER-ID` | String | 20 | Mandatory | `X-PARTNER-ID` = `CLIENT_ID` | | | `X-EXTERNAL-ID` | String | 40 | Mandatory | Unique Reference Number
(`41807553358950093184`) | | | `CHANNEL-ID` | String | 20 | Mandatory | Unique Channel Merchant Credential ID Number
Client ID + "01" = Channel ID
`"IONPAYTEST" + "01" = "IONPAYTEST01"` | IONPAYTEST01 | ## Request Body Parameter for Cancel - API Virtual Account SNAP | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | ------------------- | ------------ | ---------- | ------------- | ----------------------------------------------------------------------------------------------------------------------- | | `partnerServiceId` | String | 20 | Mandatory | Partner Service ID / Prefix | | `customerNo` | String | 40 | Mandatory | Customer Number
(Mandatory for Fix type) | | `virtualAccountNo` | String | 25 | Mandatory | Virtual Account Number | | `trxId` | String
| 40 | Mandatory | Transaction ID
(Reference Number from Merchant) | | `additionalInfo` | Object | | Optional | `"additionalInfo": { `
` "totalAmount": { `
` ... `
` }, `
` ... `
` }` | | `totalAmount` | Object | | Optional | `"totalAmount": { `
` ... `
` }` | | `value` | String | 12 | Mandatory | Transaction Amount | | `currency` | String | 3 | Mandatory | Currency | | `tXidVA` | String | 40 | Mandatory | Transaction ID | | `cancelMessage` | String | 255 | Mandatory | Cancel Message | ## Response Parameter for Cancel - API Virtual Account SNAP | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | -------------------- | ------------ | ---------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------- | | `responseCode` | String | | Mandatory | [General Response Code and Message - API SNAP](docId\:lKqJXSl5CMKdXYXxHYYSs) | | `responseMessage` | String | | Mandatory | [General Response Code and Message - API SNAP](docId\:lKqJXSl5CMKdXYXxHYYSs) | | `virtualAccountData` | Object | | Mandatory | `"virtualAccountData": { `
` ... `
` }` | | `partnerServiceId` | String | 20 | Mandatory | Partner Service ID / Prefix | | `customerNo` | String | 40 | Mandatory | Customer Number
(Mandatory for Fix type) | | `virtualAccountNo` | String | 40 | Mandatory | Virtual Account Number | | `trxId` | String
| 40 | Mandatory | Transaction ID
(Reference Number from Merchant) | | `additionalInfo` | Object | | Mandatory | `"additionalInfo": { `
` ..., `
`"totalAmount": { `
` ... `
` }`
`}` | | `tXidVA` | String | 40 | Mandatory | Transaction ID | | `cancelMessage` | String | 200 | Mandatory | Cancel Message | | `cancelVATime` | String | 8 | Mandatory | Cancel Virtual Account Time | | `totalAmount` | Object | | Mandatory | `"totalAmount": { `
` ... `
` }` | | `value` | String | 12 | Mandatory | Transaction Amount | | `currency` | String | 3 | Mandatory | Currency | # Sample Parameter for Cancel - API Virtual Account SNAP *** ## Request Parameter :::CodeblockTabs cURL ```curl curl -X DELETE "https://www.nicepay.co.id/nicepay/api/v1.0/transfer-va/delete-va" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8=" \ -H "X-TIMESTAMP: 2024-12-31T10:11:40+07:00" \ -H "X-SIGNATURE: ufBw7R8RhW79IOiV/Hlv607M60qzAYBv8uZmbSrYb6/Thlo/FhQVP4xRyelUehoSS9o+QS6vWTKb/ygtucC+tQ==" \ -H "X-PARTNER-ID: NORMALTEST" \ -H "X-EXTERNAL-ID: tXid202402111402271707638095" \ -H "CHANNEL-ID: NORMALTEST" \ -d '{ "partnerServiceId": "99123040", "customerNo": "00007307", "virtualAccountNo": "9912304000007307", "trxId": "2024123000000000000001", "additionalInfo": { "totalAmount": { "value": "10000.00", "currency": "IDR" }, "tXidVA": "NORMALTEST02202401181001033629", "cancelMessage": "Cancel Virtual Account" } }' ``` Node.js ```nodejs const config = { isProduction: false, privateKey: cons.privateKey, clientSecret: cons.clientSecret, clientId: cons.clientId, isCloudServer: false, }; let parameterDelete = { body: { partnerServiceId: "99123040", customerNo: "00007307", virtualAccountNo: "9912304000007307", trxId: "2024123000000000000001", additionalInfo: { totalAmount: { value: "10000.00", currency: "IDR", }, tXidVA: "NORMALTEST02202401181001033629", cancelMessage: "Cancel Virtual Account", }, }, headers: { X_EXTERNAL_ID: "tXid202402111402271707638095", CHANNEL_ID: cons.clientId, }, }; let endPoint = `/api/v1.0/transfer-va/delete-va`; let snap = new Snap(config); let response = snap.requestSnapTransaction(parameterDelete, endPoint, accessToken, "DELETE"); ``` ```java config = NICEPay.builder() .isProduction(false) .clientSecret(CLIENT_SECRET) .partnerId(I_MID) .externalID("tXid202402111402271707638095") .timestamp("2024-12-31T10:11:40+07:00") .privateKey(PRIVATE_KEY) .build(); var accessToken = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8="; Cancel requestData = Cancel.builder() .partnerServiceId("99123040") .customerNo("00007307") .virtualAccountNo("9912304000007307") .totalAmount("10000.00", "IDR") .trxId("2024123000000000000001") .tXidVA("NORMALTEST02202401181001033629") .cancelMessage("Cancel Virtual Account") .build(); NICEPayResponse result = SnapCancelService.callServiceVACancel(requestData, accessToken, config); ``` ```python bodyCreateToken = ( builderAccessToken.BuildAccessToken() .setGrantType("client_credentials") .setAdditionalInfo("") .build() ) totalAmount = { "value": "10000.00", "currency": "IDR" } additionalInfo = { "tXidVA": "NORMALTEST02202401181001033629", "totalAmount": totalAmount, "cancelMessage": "Cancel Virtual Account" } bodyCancelVA = ( builderVirtualAccount.BuildCancelVA() .setPartnerServiceId("99123040") .setCustomerNo("00007307") .setVirtualAccountNo("9912304000007307") .setTrxId("2024123000000000000001") .setAdditionalInfo(additionalInfo) .build() ) environment = ( builderEnvironment.BuildEnvironment() .isCloud(False) .isProduction(False) .build() ) result = SnapService.serviceTransaction( bodyCreateToken.jsonAccessToken(), bodyCancelVA.jsonVACancel(), ConstantsEndpoints.cancelVA(), environment, "DELETE" ) ``` C# ```csharp TestingConstant config = new TestingConstant(); string clientId = config.ClientId; string privateKey = config.PrivateKey; string timestamp = "2024-12-31T10:11:40+07:00"; string clientSecret = config.ClientSecret; string channelId = "NORMALTEST"; bool isProduction = false; bool isCloudServer = false; string signature = SignatureGeneratorUtils.GenerateSignature(privateKey, clientId, timestamp); // Get access token var tokenRequester = new AccessTokenRequester(); string accessTokenResponse = await tokenRequester.GetAccessTokenAsync(clientId, signature, timestamp, isProduction, isCloudServer); dynamic accessTokenObject = JObject.Parse(accessTokenResponse); string accessToken = accessTokenObject.accessToken; // Setup Nicepay API service ApiEndpoints apiEndpoints = new ApiEndpoints(); APIService vaService = new APIService(apiEndpoints, clientSecret, clientId, channelId, isProduction, isCloudServer); string VA_NO = "9912304000007307"; string trxID = "2024123000000000000001"; string Amount = "10000.00"; string currency = "IDR"; string txidVa = "NORMALTEST02202401181001033629"; string cancelMessage = "Cancel Virtual Account"; var bodyBuilder = new CancelBuilder() .SetCancelVASnap( partnerServiceId: "99123040", virtualAccountNo: VA_NO, trxId: trxID, amountValue: Amount, currency: currency, tXidVA: txidVa, customerNo: "00007307", cancelMessage: cancelMessage ) .Build(); string jsonPayload = Newtonsoft.Json.JsonConvert.SerializeObject(bodyBuilder); Console.WriteLine("Delete VA Request: " + jsonPayload); // Process Delete VA (POST request) string externalId = "tXid202402111402271707638095"; string deleteResponse = await vaService.SendDeleteRequest(apiEndpoints.DeleteVA, accessToken, timestamp, bodyBuilder, externalId); ``` Laravel ```php $url = HttpUtil::getNicepayDomain($this->useProd, $this->useCloud) . "nicepay/" . $this->delete_va_endpoint; $helper = new Helpers(); $http_method = "DELETE"; $date = Carbon::now(); $x_time_stamp = $date->toIso8601String(); $time_stamp = $date->format("YmdHis"); $partner_id = $this->client_id; $client_secret = $this->client_secret; $access_token = $this->access_token; $external_id = "tXid202402111402271707638095"; $totalAmount = [ "value" => "10000.00", "currency" => "IDR" ]; $additionalInfo = [ "totalAmount" => $totalAmount, "tXidVA" => "NORMALTEST02202401181001033629", "cancelMessage" => "Cancel Virtual Account" ]; $body = [ "partnerServiceId" => "99123040", "customerNo" => "00007307", "virtualAccountNo" => "9912304000007307", "trxId" => "2024123000000000000001", "additionalInfo" => $additionalInfo, ]; $string_to_sign = $helper->generateStringToSign( $http_method, $this->delete_va_endpoint, $access_token, $body, $x_time_stamp ); $signature = $helper->hmacSHA512Encoded( $string_to_sign, $client_secret, OPENSSL_ALGO_SHA512 ); $header = $helper->generateHeader( $access_token, $x_time_stamp, $signature, $partner_id, $external_id, $partner_id . "02" ); try { $response = HttpUtil::deleteJsonRequestWithHeader($url, $body, $header); } catch (\Exception $e) { echo "Error deleting VA: " . $e->getMessage(); } ``` PHP Native ```php $config = NICEPay::builder() ->setIsProduction(false) ->setClientSecret(TestConst::$CLIENT_SECRET_NT) ->setPartnerId($this->iMid) ->setExternalID("ExtIdCancel" . $this->timestamp) ->setTimestamp($this->timestamp) ->setPrivateKey(TestConst::$KEY_OLD_FORMAT) ->build(); $accessToken = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8="; $vacctNo = "9912304000007307"; $reffNo = "2024123000000000000001"; $txId = "NORMALTEST02202401181001033629"; $amount = "10000.00"; $requestData = Cancel::builder() ->setPartnerServiceId("99123040") ->setCustomerNo("00007307") ->setVirtualAccountNo($vacctNo) ->setTotalAmount($amount, "IDR") ->setTrxId($reffNo) ->settxIdVA($txId) ->setCancelMessage("Cancel Virtual Account") ->build(); try { $snapVAService = new SnapVAService($config); $response = $snapVAService->cancel($requestData, $accessToken); } catch (Exception $e) { echo "Error cancelling VA: " . $e->getMessage(); } ``` ```kotlin val config: NICEPay = NICEPay.Builder() .isProduction(false) .clientSecret(TestingConstants.NORMALTEST_CLIENT_SECRET) .partnerId(I_MID_NORMALTEST) .externalID("tXid202402111402271707638095") .timestamp("2024-12-31T10:11:40+07:00") .privateKey(TestingConstants.PRIVATE_KEY) .build() val accessToken = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8=" val reqDeleteVA: SnapCancel = SnapCancel.Builder() .partnerServiceId("99123040") .customerNo("00007307") .virtualAccountNo("9912304000007307") .cancelMessage("Cancel Virtual Account") .totalAmount("10000.00", "IDR") .trxId("2024123000000000000001") .tXidVA("NORMALTEST02202401181001033629") .build() val snapVirtualAccountService: SnapVirtualAccountService = SnapVirtualAccountServiceImpl() val response: NICEPayResponse? = snapVirtualAccountService.deleteVA(reqDeleteVA, accessToken, config) ``` CodeIgniter ```php $timestamp = Helper::getFormattedDate(); $config = NICEPay::builder() ->setIsProduction(false) ->setIsCloudServer(true) ->setPrivateKey($this->oldKeyFormat) ->setClientSecret($this->clientSecret) ->setPartnerId($this->iMidTest) ->setExternalID("tXid202402111402271707638095") ->setTimestamp("2024-12-31T10:11:40+07:00") ->build(); $deleteVirtualAccountBuilder = DeleteVirtualAccount::builder(); $parameter = $deleteVirtualAccountBuilder ->setPartnerServiceId("99123040") ->setCustomerNo("00007307") ->setVirtualAccountNo("9912304000007307") ->setTrxId("2024123000000000000001") ->setTotalAmount("10000.00", "IDR") ->setTxIdVA("NORMALTEST02202401181001033629") ->setCancelMessage("Cancel Virtual Account") ->build(); $accessToken = self::getAccessToken($config); $snapVAService = new SnapVAService(); try { $response = $snapVAService->deleteVA($parameter, $accessToken, $config); } catch (\Exception $e) { echo "Error deleting VA: " . $e->getMessage(); } ``` ::: ## Response Parameter :::CodeblockTabs Sample Response ```json { "responseCode": "2003100", "responseMessage": "Success", "virtualAccountData": { "partnerServiceId": "99123040", "customerNo": "00007307", "virtualAccountNo": "9912304000007307", "trxId": "2024123000000000000001", "additionalInfo": { "tXidVA": "NORMALTEST02202401181001033629", "cancelMessage": "Cancel Virtual Account", "cancelVATime": "2024-12-31T10:11:40+07:00", "totalAmount": { "value": "10000.00", "currency": "IDR" } } } } ``` ::: [title] Status Virtual Account [path] NICEPAY API/API Playground/SNAP API Testing/Virtual Account/ { "id": "2_kCJxSlFTcASUdS-IG08", "type": "api-oas-v2", "data": { "method": "POST", "url": "https://dev.nicepay.co.id/nicepay/api/v1.0/transfer-va/status", "servers": [ { "url": "https://dev.nicepay.co.id/nicepay/api/v1.0/transfer-va/status" }, { "url": "https://staging.nicepay.co.id/nicepay/api/v1.0/transfer-va/status" }, { "url": "https://www.nicepay.co.id/nicepay/v1.0/transfer-va/status" } ], "name": "Status Virtual Account", "description": "", "contentType": "application/json", "request": { "pathParameters": [], "headerParameters": [ { "kind": "required", "name": "X-TIMESTAMP", "type": "string", "example": "2024-03-05T14:15:40+07:00" }, { "kind": "required", "name": "X-SIGNATURE", "type": "string", "default": "50qKbU/O5o3Ro2Njl71aGUJ0wc1S06LBkDJfijG/bUuKJl6t5tuSp7MtVt2pVZXUHm696ZOQBviaPuFGJBJpiA==" }, { "kind": "required", "name": "X-PARTNER-ID", "type": "string", "example": "TNICEVA023" }, { "kind": "required", "name": "X-EXTERNAL-ID", "type": "string", "example": "20240304173021" }, { "kind": "required", "name": "CHANNEL-ID", "type": "string", "example": "TNICEVA023" } ], "queryParameters": [], "bodyDataParameters": [ { "kind": "optional", "name": "body", "type": "object", "example": "{\"partnerServiceId\":\"\",\"customerNo\":\"\",\"virtualAccountNo\":\"70014000091511466666\",\"inquiryRequestId\":\"\",\"additionalInfo\":{\"totalAmount\":{\"value\":\"10000.00\",\"currency\":\"IDR\"},\"trxId\":\"2023123100000000000001\",\"tXidVA\":\"IONPAYTEST02202304271511466666\"}}", "description": "", "customType": "status_body_1", "schema": [ { "name": "partnerServiceId", "kind": "required", "type": "string", "description": "Partner Service ID / Prefix", "example": "" }, { "name": "customerNo", "kind": "optional", "type": "string", "description": "Customer Number", "example": "" }, { "name": "virtualAccountNo", "kind": "required", "type": "string", "description": "Virtual Account Number", "example": "9912391111111111" }, { "name": "inquiryRequestId", "kind": "required", "type": "string", "description": "Unique identifier for inquiry", "example": "" }, { "name": "additionalInfo", "kind": "optional", "type": "object", "modelRef": "#/components/schemas/additionalInfoStatus", "customType": "additionalInfoStatus", "schema": [ { "name": "totalAmount", "kind": "optional", "type": "object", "modelRef": "#/components/schemas/additionalInfoStatus_totalAmount", "customType": "additionalInfoStatus_totalAmount", "schema": [ { "name": "value", "kind": "optional", "type": "string", "example": "10000.00" }, { "name": "currency", "kind": "optional", "type": "string", "example": "IDR" } ] }, { "name": "trxId", "kind": "optional", "type": "string", "example": "" }, { "name": "tXidVA", "kind": "optional", "type": "string", "example": "" } ] } ], "modelRef": "#/components/schemas/status_body_1", "complexItems": [ { "name": "object", "schema": [ { "name": "partnerServiceId", "kind": "required", "type": "string", "description": "Partner Service ID / Prefix", "example": "" }, { "name": "customerNo", "kind": "optional", "type": "string", "description": "Customer Number", "example": "" }, { "name": "virtualAccountNo", "kind": "required", "type": "string", "description": "Virtual Account Number", "example": "9912391111111111" }, { "name": "inquiryRequestId", "kind": "required", "type": "string", "description": "Unique identifier for inquiry", "example": "" }, { "name": "additionalInfo", "kind": "optional", "type": "object", "modelRef": "#/components/schemas/additionalInfoStatus", "customType": "additionalInfoStatus", "schema": [ { "name": "totalAmount", "kind": "optional", "type": "object", "modelRef": "#/components/schemas/additionalInfoStatus_totalAmount", "customType": "additionalInfoStatus_totalAmount", "schema": [ { "name": "value", "kind": "optional", "type": "string", "example": "10000.00" }, { "name": "currency", "kind": "optional", "type": "string", "example": "IDR" } ] }, { "name": "trxId", "kind": "optional", "type": "string", "example": "" }, { "name": "tXidVA", "kind": "optional", "type": "string", "example": "" } ] } ], "modelRef": "#/components/schemas/StatusVirtualAccount", "customType": "StatusVirtualAccount" }, { "name": "object", "schema": [] } ], "complexType": "allOf", "isExpanded": true } ], "formDataParameters": [], "oAuthParameters": [ { "id": "Authorization", "name": "Authorization", "kind": "optional", "type": "http", "scheme": "bearer" } ] }, "responses": [ { "statusCode": "200", "description": "Successful", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Successful", "code": "{\n \"responseCode\": \"2002700\",\n \"responseMessage\": \"Successful\",\n \"virtualAccountData\": {\n \"partnerServiceId\": \"\",\n \"customerNo\": \"\",\n \"virtualAccountNo\": \"70014000091511466666\",\n \"inquiryRequestId\": \"\",\n \"totalAmount\": {\n \"value\": \"10000.00\",\n \"currency\": \"IDR\"\n },\n \"additionalInfo\": {\n \"virtualAccountName\": \"Jhon Doe\",\n \"trxId\": \"2023123100000000000001\",\n \"transactionStatusDesc\": \"Success\",\n \"latestTransactionStatus\": \"00\",\n \"bankCd\": \"BMRI\",\n \"tXidVA\": \"IONPAYTEST02202304271511466666\",\n \"goodsNm\": \"John Doe\",\n \"vacctValidDt\": \"20230429\",\n \"vacctValidTm\": \"151146\"\n }\n }\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "Success", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "2002600" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Successful" }, { "name": "virtualAccountData", "kind": "optional", "type": "object", "modelRef": "#/components/schemas/Success_virtualAccountData", "customType": "Success_virtualAccountData", "schema": [ { "name": "partnerServiceId", "kind": "optional", "type": "string", "description": "partnerServiceId", "example": "" }, { "name": "customerNo", "kind": "optional", "type": "string", "description": "customerNo", "example": "" }, { "name": "virtualAccountNo", "kind": "optional", "type": "string", "description": "virtualAccountNo", "example": "7001400002007725" }, { "name": "inquiryRequestId", "kind": "optional", "type": "string", "description": "inquiryRequestId", "example": "" }, { "name": "totalAmount", "kind": "optional", "type": "object", "modelRef": "#/components/schemas/totalAmount", "customType": "totalAmount", "schema": [ { "name": "value", "kind": "optional", "type": "string", "example": "10000.00" }, { "name": "currency", "kind": "optional", "type": "string", "example": "IDR" } ] }, { "name": "additionalInfo", "kind": "optional", "type": "object", "modelRef": "#/components/schemas/Success_virtualAccountData_additionalInfo", "customType": "Success_virtualAccountData_additionalInfo", "schema": [ { "name": "bankCd", "kind": "optional", "type": "string", "description": "bankCd", "example": "BMRI" }, { "name": "tXidVA", "kind": "optional", "type": "string", "description": "tXidVA", "example": "TNICEVA02302202403061508052242" }, { "name": "goodsNm", "kind": "optional", "type": "string", "description": "goodsNm", "example": "John Doe" }, { "name": "vacctValidDt", "kind": "optional", "type": "string", "description": "vacctValidDt", "example": "20240307" }, { "name": "vacctValidTm", "kind": "optional", "type": "string", "description": "vacctValidTm", "example": "150805" }, { "name": "virtualAccountName", "kind": "optional", "type": "string", "description": "virtualAccountName", "example": "John Doe" }, { "name": "trxId", "kind": "optional", "type": "string", "description": "trxId", "example": "2023123100000000000001" }, { "name": "transactionStatusDesc", "kind": "optional", "type": "string", "description": "transactionStatusDesc", "example": "Pending" }, { "name": "latestTransactionStatus", "kind": "optional", "type": "string", "description": "latestTransactionStatus", "example": "03" } ] } ] } ], "modelRef": "#/components/schemas/Success", "isExpanded": true } ] }, { "statusCode": "202", "description": "Request In Progress", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Request In Progress", "code": "{\n \"responseCode\": \"202XX00\",\n \"responseMessage\": \"Request In Progress\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "RequestInProgress", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "202XX00" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Request In Progress" } ], "modelRef": "#/components/schemas/RequestInProgress", "isExpanded": true } ] }, { "statusCode": "409", "description": "Duplicate partnerReferenceNo", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Duplicate partnerReferenceNo", "code": "{\n \"responseCode\": \"409XX01\",\n \"responseMessage\": \"Duplicate partnerReferenceNo\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "DuplicatepartnerReferenceNo", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "409XX01" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Duplicate partnerReferenceNo" } ], "modelRef": "#/components/schemas/DuplicatepartnerReferenceNo", "isExpanded": true } ] }, { "statusCode": "500", "description": "General Error", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "General Error", "code": "{\n \"responseCode\": \"500XX00\",\n \"responseMessage\": \"General Error\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "GeneralError", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "500XX00" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "General Error" } ], "modelRef": "#/components/schemas/GeneralError", "isExpanded": true } ] }, { "statusCode": "504", "description": "Request Timeout", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Request Timeout", "code": "{\n \"responseCode\": \"504XX00\",\n \"responseMessage\": \"Request Timeout\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "RequestTimeout", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "504XX00" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Request Timeout" } ], "modelRef": "#/components/schemas/RequestTimeout", "isExpanded": true } ] } ] }, "children": [ { "text": "" } ] } [title] SNAP API Testing [path] NICEPAY API/API Playground/ # Swagger untuk SNAP API Testing *** API Testing dilakukan untuk melakukan uji coba beberapa metode pembayaran yang menggunakan API SNAP sebelum dipasang pada sistem. Beberapa API SNAP yang tersedia dalam format uji coba Swagger antara lain: | **Nama API** | **File Swagger** | **Informasi API** | | ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- | | Access Token | [Request Access Token](docId\:TKaHKgtCS-UQyX9_lmLkb) | [Request Access Token API - SNAP](docId\:GcGqBIYXG1Etcd0Ji9cHX) | | API Virtual Account SNAP | 1. [Create Virtual Account](docId\:o62RTCfvTglo7lcWKy1Tp) 2. [Status Virtual Account](docId\:oafPKl1if3ARQ3KN4_Qpi) 3. [Cancel Virtual Account](docId\:JL1BIGAbDoChTqY0iLT74) | [API Virtual Account SNAP](docId:2XCcJFVmwY9jDmD6w09oN) | | API QRIS | 1) [Create QRIS](docId\:p8SZuTtxHLtI_zxQbdHb1) 2) [Status QRIS](docId\:p0kjr7RWt-WiAONMxq5GP) 3) [Refund QRIS](docId:3bAJmH1l7VSCAJFvYbA_Y) | [API QRIS SNAP](docId:2fWhBt1oPDQeRmQJBODlU) | | API E-Wallet | Segera | [API E-Wallet (Direct Debit) SNAP](docId:24TJozvWeUtfoWWb2WN94) | | API Payout | 1. [Registration Payout](docId\:KDV8xDb7tj8XKIRgwDnLU) 2. [Approve Payout](docId:4boxqO_HRro5LpImO-C-F) 3. [Reject Payout](docId:-IO7Abd9Ks4AxJRqKbX-I) 4. [Inquiry Payout](docId\:OA-rD33XZzwJiXkb9EcFQ) 5. [Cancel Payout](docId\:IeLnFuFFShMgOrUvap2ue) 6. [Balance Inquiry Payout](docId\:q6E8HYoqFm0vvaRwE38Mq) | [Payout API (Disbursement) - SNAP](docId\:pImeP_3g-q6QNBFmwvkOr) | # Panduan Uji Coba API SNAP *** Berikut adalah langkah untuk melakukan Uji Coba API SNAP. 1. *Generate *Access Token yang akan digunakan pada bagian Authorization. 2. Isi formulir Header Parameter dan Body Parameter yang tersedia. 3. Tekan tombol `Try It` untuk mengirimkan request parameter dan mendapatkan response parameter. 4. Response parameter dapat terlihat di bagian kanan bawah pada layar. # Panduan X-Signature *** ## Asymmetric X-Signature Asymmetric digunakan untuk mengajukan Access Token Header. Berikut adalah contoh langkah untuk generate X-Signature Access Token: `SHA256withRSA (Private_Key, stringToSign) stringToSign = client_ID + “|” + X-TIMESTAMP` ## Symmetric X-Signature Symmetric digunakan sebagai header untuk mengajukan request parameter untuk setiap API yang dikirimkan menuju sistem NICEPAY. Berikut adalah contoh langkah untuk *generate *X-Signature Transaksi: `HMAC_SHA512 (clientSecret, stringToSign) stringToSign = HTTPMethod +":"+ EndpointUrl +":"+ AccessToken +":"+ Lowercase(HexEncode(SHA256(minify(RequestBody))))+ ":" + X-TimeStamp` 1. Susun `EncodeRequestBody` menggunakan payload, `HexEncode` dan `SHA256`. `HexEncode(SHA256(minify(RequestBody)))` 2. Susun payload signature concat pada kolom menggunakan pemisah ":" `HTTPMethod:EndpointUrl:accessToken:EncodeRequestBody:TimeStamp` :::CodeblockTabs 1\. Sample URL ```none POST:/api/v1.0/transfer-va/create-va:eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJQREpCIiwiZXhwIjoiMjAyNS0wNy0xMVQwMzoyODoxNVoifQ==.04XPQtQmHCnUyft4pgRCH_WTaRp8pt6aX8IugxX_7Hk=:0140cbc57524ee33d23ec6b520a6e3ffa966320fcbac5608716548648e65c4c5:2025-07-11T10:13:15+07:00; ``` 2\. Sample Generate ```none Sample Generate hmac SHA512 for payload String payload = "{\"partnerServiceId\":\"\",\"customerNo\":\"\",\"virtualAccountNo\":\"\",\"virtualAccountName\":\"NodeJS Test\",\"trxId\":\"order1752203594788\",\"totalAmount\":{\"value\":\"10000.00\",\"currency\":\"IDR\"},\"additionalInfo\":{\"bankCd\":\"BMRI\",\"goodsNm\":\"Test\",\"dbProcessUrl\":\"https://nicepay.co.id/\",\"vacctValidDt\":\"\",\"vacctValidTm\":\"\"}}"; String requestBody = ""; String hexEncode = ""; requestBody = payload.replaceAll("[\n\r\t]", "") hexEncode = java.security.MessageDigest.getInstance("SHA256").digest(requestBody.getBytes("UTF-8")).encodeHex() hexEncode = '0140cbc57524ee33d23ec6b520a6e3ffa966320fcbac5608716548648e65c4c5' String stringToSign = "POST" + ":" + "/api/v1.0/transfer-va/create-va" + ":" + "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJQREpCIiwiZXhwIjoiMjAyNS0wNy0xMVQwMzoyODoxNVoifQ==.04XPQtQmHCnUyft4pgRCH_WTaRp8pt6aX8IugxX_7Hk=" + ":" + "0140cbc57524ee33d23ec6b520a6e3ffa966320fcbac5608716548648e65c4c5" + ":" + "2025-07-11T10:13:15+07:00" ``` 3\. Sample Create Hash ```none Sample Create Hash SecretKeySpec secretKey = new SecretKeySpec(clientSecret.getBytes(),"HmacSHA512"); Mac hmac = Mac.getInstance("HmacSHA512") hmac.init(secretKey) ``` 4\. Sample signature base64 ```none Base64 encoder = Base64.getEncoder() String hmacAsBase64 = encoder.encodeToString(hmac.doFinal(stringToSign.getBytes("UTF-8"))) ``` 5\. Sample Result ```none The result are X-SIGNATURE : 3NP5zxeymUhesQwVoU7domG6bWRQKnp0ePsJ2Uc9bq1J7Yr5t+mKIYhCYGeoUGoS3CqIoFOvfXdutboAS7uGng== ``` ::: [title] Full Payment & Installment - Registration API Credit Card [path] NICEPAY API/API Non-SNAP/Payment API/API Credit Card/Registration - API Credit Card/ # Tentang Full Payment & Installment - Registration API Credit Card *** Pembayaran tipe *Full Payment & Installment *adalah pilihan tipe menggunakan melakukan suatu tagihan secara penuh atau secara cicilan (3, 6, atau 12 bulan). # Full Payment & Installment - Registration API Credit Card *** **Registrasi API **dalam merupakan langkah awal dalam melakukan [Payment API](docId\:OK8pnFvDrqo-4Qq3umLQz) dengan . | **API Endpoint** | `/nicepay/direct/v2/registration` | | ------------------ | ------------------------------------------------------------ | | **Request Method** | **POST****** | | **Description** | Performs Transaction Regist to | | **Merchant Token** | SHA256(`timeStamp`+`iMid`+`referenceNo`+`amt`+`merchantKey`) | | **Request Format** | `application/json` | ## Request Parameter for Full Payment & Installment - Registration API Credit Card *** Berikut adalah daftar diperlukan untuk melakukan *request* Registrasi pada . | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ----------------------------------------------------------------------------------- | ------------------ | ---------- | -------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- | | `timeStamp`
Required | N | 14 | Request Timestamp (`YYYYMMDDHH24MISS`) | 20221202141217 | | `iMid`
Required | AN | 10 | ID
| IONPAYTEST | | `payMethod`
Required | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok)
| 01 | | `currency`
Required | A | 3 | Currency
| IDR | | `amt`
Required | N | 12 | Amount
(number not in float format) | 10000 (Jumlah total amount goods dari cartData) | | `referenceNo`
Required | ANS | 40 | Reference Number
| ordNo20221202141217 | | `goodsNm `
Required | AN | 100 | Goods Name
| Testing Transaction | | `billingNm `
Required | A | 100 | Buyer Name
| John Doe | | `billingPhone `
Required | N | 15 | Buyer Phone Number
| 2112345678 | | `billingEmail `
Required | ANS | 40 | Buyer E-mail
| buyer\@merchant.com | | `billingAddr `
Required | AN | 100 | Buyer Address
| Jln. Raya Kasablanka Kav.88 | | `billingCity `
Required | A | 50 | Buyer City
| South Jakarta | | `billingState `
Required | A | 50 | Billing State
| DKI Jakarta | | `billingPostCd `
Required | N | 10 | Billing Post Number
| 14350 | | `billingCountry `
Required | A | 10 | Billing Country
| | | `cartData`
Optional | `JSONstring`
| 4000 | Cart Data
| \{} | | `instmntType`
Required | N | 2 | [Installment Type Code](docId:7CIX-U_4z295XgtNVEsbO) | 1 | | `instmntMon`
Required | N | 2 | Installment Month
`1`: 1 Month/Full , *jika* `instmntType`*:* *null/1*
`3`: 3 Months
`6`: 6 Months
`12`: 12 Months | 1 | | `recurrOpt`
Required | N | 2 | `0`: Automatic Cancel
`1`: Do not cancel
`2`: Do not make token | 2 | | `dbProcessUrl`
Required | ANS | 255 | Notification URL
| https\://merchant.com/dbProcessUrl
| | `userIP`
Required for CC, E-Wallet, Payloan, QRIS | AN | 15 | User IP | 127.0.0.1 | | `merchantToken`
Required | AN | 255 | Token
| c91e6531f6c84869439bc5ebe5389bd71e7752c054fc9dbfe193d087a1b797ae | | `description` | AN | 100 | Transaction Description | Test Transaction | | `userSessionID` | AN | 100 | User Session ID | userSessionID | | `userAgent` | ANS | 100 | User Agent | Mozilla | | `userLanguage` | A | 2 | User Language | en-US | :::hint{type="warning"} **Catatan untuk Credit Card Full Payment & Credit Card Installment** - Untuk jenis **Credit Card - Full Payment**, pada `instmntType` bisa diisi dengan *1 atau kosong (*Null)** dan pada `instmntMon` bisa diisi dengan *1 atau kosong (*Null*)*. - Untuk jenis **Credit Card - Installment**, pada `instmntType` bisa diisi dengan *2* dan pada `instmntMon` bisa diisi dengan *3 (3 bulan), 6 (6 bulan) atau 12 (12 bulan)*. ::: ### Cart Data for Full Payment & Installment - Registration API Credit Card `cartData` pada *request * di Registrasi berguna untuk meliputi barang atau *item* apa saja akan dibayarkan oleh berserta rincian dan harga per *item.* | **Parameter** | **Deskripsi** | **Contoh** | | ------------- | ---------------------------------------------------------------------------------------------------- | ---------- | | `Count` | Total jumlah dari keseluruhan cart data | 2 | | `Item` | Terbagi menjadi 5 macam , yaitu `img_url`, `goods_id`, `goods_name`, `goods_detail`, dan `goods_amt` | - | *** Penjelasan detil pada **Item.** | **Parameter** | **Deskripsi** | **Contoh** | | -------------- | -------------------------------------- | --------------------------------------------- | | `img_url` | URL Gambar Barang (Ukuran 50px x 50px) | htttps\://www\.merchant.com/image\_goods1.jpg | | `goods_id` | ID Barang | NICEPRDID1 | | `goods_name` | Nama Barang | Nama Item-1 | | `goods_detail` | Deskripsi Detail Barang | Detail Item-1 | | `goods_amt` | Harga Barang | 1000 | ### Sample JSON Cart Data :::CodeblockTabs cartData Credit Card Registration ```json { "count": "2", "item": [ { "img_url": "http://www.merchant.com/image_goods1.jpg", "goods_id": "NICEPRDID1", "goods_name": "Item 1 Name", "goods_detail": "Item 1 Detail", "goods_amt": "1000" }, { "img_url": "http://www.merchant.com/image_goods2.jpg", "goods_id": "NICEPRDID1", "goods_name": "Item 2 Name", "goods_detail": "Item 2 Detail", "goods_amt": "1000" } ] } ``` ::: ## Response Parameter for Full Payment & Installment - Registration API Credit Card *** Berikut adalah *response* dari hasil *request* pada Registrasi . | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | -------------- | -------- | ---------- | ----------------------------------------------------------- | ------------------------------ | | `resultCd` | N | 4 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | 0000 | | `resultMsg ` | AN | 255 | Result Message: [Error Code](docId\:yEh1VA9k2y6sL1kQF2aWD) | SUCCESS | | `tXid` | AN | 30 | Transaction ID | IONPAYTEST01202212151029182023 | | `referenceNo` | ANS | 40 | Reference Number | ordNo20221215101254 | | `payMethod` | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | 01 | | `amt` | N | 12 | Amount | 10000 | | `transDt` | N | 8 | Transaction Date (`YYYYMMDD`) | 20221212 | | `transTm` | N | 6 | Transaction Time (`HH24MISS`) | 121212 | | `description` | AN | 100 | Transaction Description | Testing Transaction | | `bankCd` | A | 4 | [Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | null | | `vacctNo` | N | 20 | | null | | `mitraCd` | A | 4 | [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8) | null | | `payNo` | N | 12 | CVS Number | null | | `currency ` | A | 3 | Currency | IDR | | `goodsNm` | AN | 100 | Goods Name | Goods For Testing Transaction | | `billingNm` | A | 100 | Buyer Name | John Doe | | `vacctValidDt` | N | 8 | VA Expiry Date (`YYYYMMDD`) | null | | `vacctValidTm` | N | 6 | VA Expiry Time (`HH24MISS`) | null | | `payValidDt ` | N | 8 | Expiry Date (`YYYYMMDD`) | null | | `payValidTm` | N | 6 | Expiry Time (`HH24MISS`) | null | | `requestURL` | ANS | 360 | Request URL | null | | `paymentExpDt` | N | 6 | QR Expiry Date (`YYYYMMDD`) | null | | `paymentExpTm` | N | 6 | QR Expiry Time (`HH24MISS`) | null | | `qrContent` | ANS | 360 | QR String in Plain Text | null | | `qrUrl` | ANS | 360 | URL for QR Image, Valid for 5 minutes | null | :::hint{type="info"} memeriksa [NICEPAY Code](docId\:kYd45uYYIjwzVs3dt8_rk) untuk mengetahui kode umum beserta kode *response* dalam ataupun lainnya di . ::: ## Sample Parameter for Full Payment & Installment - Registration API Credit Card *** ### Request Parameter :::CodeblockTabs cURL ```curl curl --location 'https://dev.nicepay.co.id/nicepay/direct/v2/registration' \ --header 'Content-Type: application/json' \ --data-raw '{ "timeStamp": "20221202141217", "iMid": "IONPAYTEST", "payMethod": "01", "currency": "IDR", "amt": "5000", "merchantToken": "c91e6531f6c84869439bc5ebe5389bd71e7752c054fc9dbfe193d087a1b797ae", "referenceNo": "ordNo20221202141217", "description": "Testing Registration Credit Card", "goodsNm" : "Testing Transaction", "billingNm" : "John Doe", "billingPhone" : "081288998899", "billingEmail" : "john.doe@example.com", "billingAddr" : "Jln. Raya Kasablanka Kav.88", "billingCity" : "South Jakarta", "billingState" : "DKI Jakarta", "billingCountry" : "Indonesia", "billingPostCd" : "12800", "dbProcessUrl": "http://ptsv2.com/t/merchant/post", "cartData" : "{\"count\":\"1\",\"item\":[{\"goods_id\":\"NICEPRDID1\",\"img_url\":\"http://www.merchant.com/image_goods1.jpg\",\"goods_name\":\"Testing Transaction\",\"goods_detail\":\"Testing Transaction Details\",\"goods_amt\":\"5000\"}]}", "userIP":"127.0.0.1", "instmntType":"1", "instmntMon":"1", "recurrOpt":"", "userLanguage": "en", "userAgent":"Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0" }' ``` Node.js ```nodejs const nicepayClient = require("nodejs-nicepay"); let secondVersion = new nicepayClient.SecondApiVersion({ isProduction: false, isCloudServer: false, merchantKey: "YOUR_MERCHANT_KEY", }); const parameter = { payMethod: "01", currency: "IDR", amt: "5000", referenceNo: "ordNo20221202141217", goodsNm: "Testing Transaction", billingNm: "John Doe", billingPhone: "081288998899", billingEmail: "john.doe@example.com", billingAddr: "Jln. Raya Kasablanka Kav.88", billingCity: "South Jakarta", billingState: "DKI Jakarta", billingPostCd: "12800", billingCountry: "Indonesia", description: "Testing Registration Credit Card", dbProcessUrl: "http://ptsv2.com/t/merchant/post", userIP: "127.0.0.1", cartData: "{\"count\":\"1\",\"item\":[{\"goods_id\":\"NICEPRDID1\",\"img_url\":\"http://www.merchant.com/image_goods1.jpg\",\"goods_name\":\"Testing Transaction\",\"goods_detail\":\"Testing Transaction Details\",\"goods_amt\":\"5000\"}]}", sellers: "", bankCd: "", userAgent: "Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0", mitraCd: "", instmntMon: "1", instmntType: "1", shopId: "", }; let endPoint = "/direct/v2/registration"; secondVersion.requestAPI(parameter, endPoint); ``` ```java String reffNo = "ordNo20221202141217"; Card requestData = Card.builder() .timeStamp("20221202141217") .iMid("IONPAYTEST") .payMethod("01") .currency("IDR") .amt("5000") .referenceNo(reffNo) .goodsNm("Testing Transaction") .billingNm("John Doe") .billingPhone("081288998899") .billingEmail("john.doe@example.com") .billingAddr("Jln. Raya Kasablanka Kav.88") .billingCity("South Jakarta") .billingState("DKI Jakarta") .billingPostCd("12800") .billingCountry("Indonesia") .dbProcessUrl("http://ptsv2.com/t/merchant/post") .userIP("127.0.0.1") .userAgent("Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0") .userLanguage("en") .instmntType("1") .instmntMon("1") .recurrOpt("") .cartData("{\"count\":\"1\",\"item\":[{\"goods_id\":\"NICEPRDID1\",\"img_url\":\"http://www.merchant.com/image_goods1.jpg\",\"goods_name\":\"Testing Transaction\",\"goods_detail\":\"Testing Transaction Details\",\"goods_amt\":\"5000\"}]}") .merchantToken("20221202141217", "IONPAYTEST", reffNo, "5000", merchantKey) .build(); NICEPayResponseV2 cardRegistResponse = V2CardService.callV2CardRegistration(requestData, config); ``` ```python $useProd = false; $useCloud = false; $registration_endpoint = "/nicepay/direct/v2/registration"; $url = HttpUtil::getNicepayDomain($useProd, $useCloud) . $registration_endpoint; $timestamp = "20221202141217"; $reference_no = "ordNo20221202141217"; $amt = "5000"; $merchant_token = "c91e6531f6c84869439bc5ebe5389bd71e7752c054fc9dbfe193d087a1b797ae"; $body = [ "timeStamp" => $timestamp, "iMid" => "IONPAYTEST", "payMethod" => "01", "currency" => "IDR", "amt" => $amt, "merchantToken" => $merchant_token, "referenceNo" => $reference_no, "description" => "Testing Registration Credit Card", "goodsNm" => "Testing Transaction", "billingNm" => "John Doe", "billingPhone" => "081288998899", "billingEmail" => "john.doe@example.com", "billingAddr" => "Jln. Raya Kasablanka Kav.88", "billingCity" => "South Jakarta", "billingState" => "DKI Jakarta", "billingCountry" => "Indonesia", "billingPostCd" => "12800", "dbProcessUrl" => "http://ptsv2.com/t/merchant/post", "cartData" => "{\"count\":\"1\",\"item\":[{\"goods_id\":\"NICEPRDID1\",\"img_url\":\"http://www.merchant.com/image_goods1.jpg\",\"goods_name\":\"Testing Transaction\",\"goods_detail\":\"Testing Transaction Details\",\"goods_amt\":\"5000\"}]}", "userIP" => "127.0.0.1", "instmntType" => "1", "instmntMon" => "1", "recurrOpt" => "", "userLanguage" => "en", "userAgent" => "Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0" ]; $response = HttpUtil::postJsonRequest($url, $body); ``` C# ```csharp string merchantKey = config.MerKey; string clientId = config.ClientId; string timestamp = DateTimeOffset.Now.ToString("yyyyMMddHHmmss"); string refNo = $"ordNo{timestamp}"; string amount = "5000"; bool isProduction = false; bool isCloudServer = false; var cartItem = new Dictionary { { "goods_id", "NICEPRDID1"}, { "img_url", "http://www.merchant.com/image_goods1.jpg" }, { "goods_name", "Testing Transaction" }, { "goods_detail", "Testing Transaction Details" }, { "goods_amt", "5000" } }; var cartDataBuilder = new BuilderCartData() .SetCount("1") .SetItem(cartItem); var cartData = cartDataBuilder.Build(); // Generate merchant token var merchantTokenBuilder = new MerchantTokenBuilder() .SetTimeStamp(timestamp) .SetIMid(clientId) .SetRefNo(refNo) .SetAmount(amount) .SetMerchantKey(merchantKey); string merchantToken = merchantTokenBuilder.BuildMerchantToken(); // Build Credit Card Request Body var bodyBuilder = new NicepayRequestBuilder() .SetCommonFields( iMid: clientId, timeStamp: timestamp, payMethod: "01", // Credit Card currency: "IDR", amt: amount, referenceNo: refNo, goodsNm: "Testing Transaction", merchantToken: merchantToken ) .setCreditCard( instmntType: "1", instmntMon: "1", recurrOpt: "" ) .SetBillingInfo( billingNm: "John Doe", billingPhone: "081288998899", billingEmail: "john.doe@example.com", billingAddr: "Jln. Raya Kasablanka Kav.88", billingCity: "South Jakarta", billingState: "DKI Jakarta", billingPostCd: "12800", billingCountry: "Indonesia" ) .SetDbProcessUrl("http://ptsv2.com/t/merchant/post") .SetCartData(cartData) .SetUserIP("127.0.0.1") .SetUserLanguage("en") .SetUserAgent("Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0"); ApiEndpoints apiEndpoints = new ApiEndpoints(); // Build payload and send Dictionary payload = bodyBuilder.Build(); string jsonPayload = Newtonsoft.Json.JsonConvert.SerializeObject(payload, Newtonsoft.Json.Formatting.Indented); var registrationService = new NicepayRegistrationService(apiEndpoints, isProduction, isCloudServer); var result = await registrationService.SendPostAsync(apiEndpoints.RegistV2, payload); ``` Vanilla JS ```javascript const registrationData = { timeStamp: "20221202141217", payMethod: "01", currency: "IDR", amt: "5000", referenceNo: "ordNo20221202141217", goodsNm: "Testing Transaction", billingNm: "John Doe", billingPhone: "081288998899", billingEmail: "john.doe@example.com", billingAddr: "Jln. Raya Kasablanka Kav.88", billingCity: "South Jakarta", billingState: "DKI Jakarta", billingPostCd: "12800", billingCountry: "Indonesia", description: "Testing Registration Credit Card", deliveryNm: "", deliveryPhone: "", deliveryAddr: "", deliveryCity: "", deliveryState: "", deliveryPostCd: "", deliveryCountry: "", dbProcessUrl: "http://ptsv2.com/t/merchant/post", merchantToken: "c91e6531f6c84869439bc5ebe5389bd71e7752c054fc9dbfe193d087a1b797ae", userIP: "127.0.0.1", cartData: "{\"count\":\"1\",\"item\":[{\"goods_id\":\"NICEPRDID1\",\"img_url\":\"http://www.merchant.com/image_goods1.jpg\",\"goods_name\":\"Testing Transaction\",\"goods_detail\":\"Testing Transaction Details\",\"goods_amt\":\"5000\"}]}", userAgent: "Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0", instmntMon: "1", instmntType: "1", }; const response = await Nicepay.registerTransaction(registrationData); ``` Laravel ```php $useProd = false; $useCloud = false; $registration_endpoint = "/nicepay/direct/v2/registration"; $url = HttpUtil::getNicepayDomain($useProd, $useCloud) . $registration_endpoint; $timestamp = "20221202141217"; $reference_no = "ordNo20221202141217"; $amt = "5000"; $merchant_token = "c91e6531f6c84869439bc5ebe5389bd71e7752c054fc9dbfe193d087a1b797ae"; $body = [ "timeStamp" => $timestamp, "iMid" => "IONPAYTEST", "payMethod" => "01", "currency" => "IDR", "amt" => $amt, "merchantToken" => $merchant_token, "referenceNo" => $reference_no, "description" => "Testing Registration Credit Card", "goodsNm" => "Testing Transaction", "billingNm" => "John Doe", "billingPhone" => "081288998899", "billingEmail" => "john.doe@example.com", "billingAddr" => "Jln. Raya Kasablanka Kav.88", "billingCity" => "South Jakarta", "billingState" => "DKI Jakarta", "billingCountry" => "Indonesia", "billingPostCd" => "12800", "dbProcessUrl" => "http://ptsv2.com/t/merchant/post", "cartData" => "{\"count\":\"1\",\"item\":[{\"goods_id\":\"NICEPRDID1\",\"img_url\":\"http://www.merchant.com/image_goods1.jpg\",\"goods_name\":\"Testing Transaction\",\"goods_detail\":\"Testing Transaction Details\",\"goods_amt\":\"5000\"}]}", "userIP" => "127.0.0.1", "instmntType" => "1", "instmntMon" => "1", "recurrOpt" => "", "userLanguage" => "en", "userAgent" => "Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0" ]; $response = HttpUtil::postJsonRequest($url, $body); ``` PHP Native ```php $config = NICEPay::builder() ->setIsProduction(false) ->build(); $timestamp = "20221202141217"; $reffNo = "ordNo20221202141217"; $amount = "5000"; $parameter = Card::builder() ->timeStamp($timestamp) ->iMid("IONPAYTEST") ->payMethod("01") ->currency("IDR") ->amt($amount) ->referenceNo($reffNo) ->merchantToken($timestamp, "IONPAYTEST", $reffNo, $amount, $this->merchantKey) ->description("Testing Registration Credit Card") ->goodsNm("Testing Transaction") ->billingNm("John Doe") ->billingPhone("081288998899") ->billingEmail("john.doe@example.com") ->billingAddr("Jln. Raya Kasablanka Kav.88") ->billingCity("South Jakarta") ->billingState("DKI Jakarta") ->billingCountry("Indonesia") ->billingPostCd("12800") ->dbProcessUrl("http://ptsv2.com/t/merchant/post") ->cartData("{\"count\":\"1\",\"item\":[{\"goods_id\":\"NICEPRDID1\",\"img_url\":\"http://www.merchant.com/image_goods1.jpg\",\"goods_name\":\"Testing Transaction\",\"goods_detail\":\"Testing Transaction Details\",\"goods_amt\":\"5000\"}]}") ->userIP("127.0.0.1") ->instmntType("1") ->instmntMon("1") ->recurrOpt("") ->userLanguage("en") ->userAgent("Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0") ->build(); $cardService = new V2CardService($config); ``` ```kotlin var config: NICEPay? = NICEPay.Builder() .isProduction(false) .clientSecret(TestingConstants.CLIENT_SECRET) .partnerId(TestingConstants.PARTNER_ID) .externalID(TestingConstants.EXTERNAL_ID) .timestamp(TestingConstants.TIMESTAMP) .privateKey(TestingConstants.PRIVATE_KEY) .build() val request: DirectV2Card = DirectV2Card.Builder() .timeStamp("20221202141217") .iMid("IONPAYTEST") .payMethod("01") .currency("IDR") .amt("5000") .merchantToken("c91e6531f6c84869439bc5ebe5389bd71e7752c054fc9dbfe193d087a1b797ae") .referenceNo("ordNo20221202141217") .description("Testing Registration Credit Card") .goodsNm("Testing Transaction") .billingNm("John Doe") .billingPhone("081288998899") .billingEmail("john.doe@example.com") .billingAddr("Jln. Raya Kasablanka Kav.88") .billingCity("South Jakarta") .billingState("DKI Jakarta") .billingCountry("Indonesia") .billingPostCd("12800") .dbProcessUrl("http://ptsv2.com/t/merchant/post") .userIP("127.0.0.1") .instmntType("1") .instmntMon("1") .recurrOpt("") .cartData("{\"count\":\"1\",\"item\":[{\"goods_id\":\"NICEPRDID1\",\"img_url\":\"http://www.merchant.com/image_goods1.jpg\",\"goods_name\":\"Testing Transaction\",\"goods_detail\":\"Testing Transaction Details\",\"goods_amt\":\"5000\"}]}") .userLanguage("en") .userAgent("Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0") .build() val response : NICEPayResponseV2 = v2CardService.registration(request, config)!! ``` CodeIgniter ```php $timestamp = "20221213101276"; $configBuilder = NICEPay::builder(); $config = $configBuilder ->setIsProduction(false) ->setIsCloudServer(true) ->build(); $reffNo = "ordNo20221213101276"; $amount = "5000"; $CardBuilder = Card::builder(); $parameter = $CardBuilder ->setTimeStamp($timestamp) ->setIMid("RECURRTEST") ->setPayMethod("01") ->setCurrency("IDR") ->setAmt($amount) ->setReferenceNo($reffNo) ->setMerchantToken($timestamp, "RECURRTEST", $reffNo, $amount, $this->merchantKey) // ✅ unchanged logic ->setGoodsNm("Goods For Testing") ->setBillingNm("John Doe") ->setBillingPhone("081288998899") ->setBillingEmail("john.doe@example.com") ->setBillingAddr("Jln. Raya Kasablanka Kav.88") ->setBillingCity("South Jakarta") ->setBillingState("DKI Jakarta") ->setBillingCountry("Indonesia") ->setBillingPostCd("12800") ->setCartData("{\"count\":\"1\",\"item\":[{\"goods_id\":\"NICEPRDID1\",\"img_url\":\"http://www.merchant.com/image_goods1.jpg\",\"goods_name\":\"Testing Transaction\",\"goods_detail\":\"Testing Transaction Details\",\"goods_amt\":\"5000\"}]}") ->setDbProcessUrl("http://ptsv2.com/t/merchant/post") ->setUserIP("127.0.0.1") ->setInstmntType("1") ->setInstmntMon("1") ->setRecurrOpt("") ->setUserLanguage("en") ->setUserAgent("Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0") ->build(); $cardService = new V2CardService($config); $response = $cardService->registration($parameter); ``` ::: ### Response Parameter :::CodeblockTabs Sample Response ```json { "resultCd": "0000", "resultMsg": "SUCCESS", "tXid": "IONPAYTEST01202510080949037182", "referenceNo": "ordNo20221202141217", "payMethod": "01", "amt": "5000", "transDt": "20251008", "transTm": "094903", "description": "Testing Registration Credit Card", "bankCd": null, "vacctNo": null, "mitraCd": null, "payNo": null, "currency": null, "goodsNm": null, "billingNm": null, "vacctValidDt": null, "vacctValidTm": null, "payValidDt": null, "payValidTm": null, "requestURL": null, "paymentExpDt": null, "paymentExpTm": null, "qrContent": null, "qrUrl": null } ``` ::: Setelah menyelesaikan ini, silakan melanjutkan ke [Payment - API Credit Card](docId\:FcJslW1q-2oJhb0HWqJsj). [title] General Response Code and Message - API SNAP [path] NICEPAY API/API SNAP/NICEPAY Code - API SNAP/ **General Response Code and Message** berisi kode *response *yang digunakan untuk memeriksa koneksi sistem API SNAP apakah suatu transaksi berjalan dengan lancar atau mengalami suatu kendala. | **No** | **Response Code** | **HTTP Code** | **Response Message** | | ------ | ----------------- | ------------- | --------------------------------------- | | 1 | `200XX00` | `200` | Successful | | 2 | `401XX00` | `401` | Unauthorized \[`reason`] | | 3 | `401XX01` | `401` | Access Token Invalid | | 4 | `400XX01` | `400` | Invalid Field Format \{`field name`} | | 5 | `400XX02` | `400` | Invalid Mandatory Field \{`field name`} | | 6 | `403XX01` | `403` | Feature Not Allowed | | 7 | `403XX02` | `403` | Exceeds Transaction Amount Limit | | 8 | `403XX05` | `403` | Do Not Honor | | 9 | `403XX14` | `403` | Insufficient Funds | | 10 | `403XX15` | `403` | Transaction Not Permitted \[`reason`] | | 11 | `403XX18` | `403` | Account Inactive | | 12 | `403XX21` | `403` | Set Limit Not Allowed | | 13 | `403XX23` | `403` | Account Limit Exceed | | 14 | `404XX11` | `404` | Invalid Account | | 15 | `404XX13` | `404` | Paid Bill | | 16 | `404XX19` | `404` | Invalid Virtual Account | | 17 | `409XX00` | `409` | Conflict | | 18 | `409XX01` | `409` | Duplicate `partnerReferenceNo` | | 19 | `500XX00` | `500` | General Error | | 20 | `504XX00` | `504` | Request Timeout | [title] API SNAP [path] NICEPAY API/ # Tentang API SNAP *** ::embed[]{url="https://youtu.be/LyL212wVlro"} SNAP adalah Standar Nasional Open API Pembayaran yang ditetapkan oleh Bank Indonesia dan disusun bersama dengan perwakilan industri sistem pembayaran dengan mencakup: 1. Standar Teknis dan Keamanan, Standar Data, serta Spesifikasi Teknis SNAP yang dipublikasikan dalam laman. 2. [Pedoman Tata Kelola](https://www.bi.go.id/id/layanan/Standar/SNAP/Documents/SNAP_Pedoman_Tata_Kelola.pdf) dalam penyelenggaraan keterhubungan. SNAP BI telah ditetapkan oleh Bank Indonesia melalui “Surat Keputusan Gubernur Bank Indonesia No.23/10/KEP.GBI/2021 tanggal 16 Agustus 2021 tentang Penetapan Standar *Open Application Programming Interface* (API) Pembayaran" yang wajib diterapkan secara bertahap dalam setiap *Open *API Pembayaran. NICEPAY telah memiliki beberapa API dengan standar Bank Indonesia tersebut untuk memberikan keamanan dan kenyamanan dalam bertransaksi antar Pelanggan dan Merchant dalam menggunakan metode pembayaran yang disiapkan oleh Mitra NICEPAY. # Informasi Terkait API SNAP *** Berikut adalah daftar informasi terkait API SNAP. ::::LinkArray{contentSource="CUSTOM"} :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/VrAcRrptVxyAhRH9cuOYg_header-api-snap-implementasi-snap.jpg"} [Implementasi SNAP](docId:9NC4zMt_CIYOOoQ3RweUm) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-4P7OFdkS9INWZi7UXxdNM-20240805-042845.jpg"} [SNAP Library](docId\:ZszbQT0mHb_7Su1xSMfKl) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-jJMVp_k7itHcTArld92FI-20240805-043103.jpg"} [SNAP API Testing](docId\:UZex33ReLyENKOgbJJnYp) ::: :::: # Daftar API SNAP *** Berikut adalah daftar API NICEPAY yang sudah memiliki standar SNAP. ::::LinkArray{contentSource="CUSTOM"} :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-1A_Tt2Wat12bLRRGHw5ZR-20240805-043121.jpg"} [Request Access Token API - SNAP](docId\:GcGqBIYXG1Etcd0Ji9cHX) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-vuHo424YiVXDDvAZMEjK0-20240805-043135.jpg"} [Payment API - SNAP](docId:-M_V-II4nkTcxd6jiHTfg) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-cfhZaD3r-18GEKF7nWCLT-20240805-043154.jpg"} [Payout API (Disbursement) - SNAP](docId\:pImeP_3g-q6QNBFmwvkOr) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-Crt8beoKaL_vzKOpWl3aq-20240805-043254.jpg"} [Advance API - SNAP](docId\:iytnF1uTXSDGwvjRVS62b) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-9OwxKSH8BAax1d4DZyJiW-20240805-043316.jpg"} [NICEPAY Code - API SNAP](docId\:R1lBLY8cilScdLGjWoFgc) ::: :::: # NICEPAY API URL *** Berikut NICEPAY API URL yang harus di-*request* melalui protokol HTTPS agar dapat terhubung dengan NICEPAY. | **Environment** | **Protocol** | **Base URL** | | --------------- | ------------ | -------------------------------- | | Development | https | `https://dev.nicepay.co.id/` | | Staging | https | `https://staging.nicepay.co.id/` | | Production | https | `https://www.nicepay.co.id/` | # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem Kunjungi bagian [API Non-SNAP](docId\:kXzqsXIH06f-mIhtUQ7GN) untuk mengetahui informasi terkait API NICEPAY versi Non-SNAP. ::: :::VerticalSplitItem ::: :::: [title] Cancel - API Checkout [path] NICEPAY API/API Checkout/ # Tentang API Checkout Cancel *** ini digunakan untuk membatalkan akan berjalan. Khusus untuk VA, hanya dapat dibatalkan sebelum melakukan . Setelah dibatalkan, harus kembali melakukan pendaftaran dari awal melalui [Registration - API Checkout](docId:1y_mEI3eZUS-XW2YPhGyp). # API Checkout Cancel *** | **API URL** | `/nicepay/direct/v2/cancel` | | ------------------- | ---------------------------------------------------------- | | **Request Method** | `POST` | | **Header** | `Content-Type: application/json`**** | | **Merchant Token** | SHA256 (`timestamp`+ `iMid`+ `tXid`+ `amt`+ `merchantKey`) | ## Request Parameters *** | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | --------------------------------------------------------------- | -------- | ---------- | ------------------------------------------------------ | ---------------------------------------------------------------- | | `timeStamp`
Required | N | 14 | Request Timestamp | 20221219111294 | | `tXid`
Required | AN | 30 | Transaction ID
| NORMALTEST00202212191104443483 | | `iMid`
Required | AN | 10 | ID
| NORMALTEST | | `payMethod`
Required | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | 02 | | `cancelType`
Required | N | 2 | [Cancel Type Code](docId\:Mq9xE7wdOPR8OkZ3v-pVc)
| 1 | | `merchantToken`
Required | AN | 255 | Token
| 63d44f80942cc915f6d736995797470ac2918a9f88b6fb762608541145e65bd8 | | `amt`
Required | N | 12 | Amount
| 10000 | | `cancelMsg`
Required | AN | 255 | Cancel Message | Request Cancel | | `preauthToken` | AN | 100 | Pre-Auth Token | d4ef98b26f917a697691807cf… | | `referenceNo`
Optional For CC | ANS | 40 | Cancel Number | CancelNo20160525000-52104 | | `cancelServerIp` | AN | 15 | Server IP | 127.0.0.1 | | `cancelUserId` | AN | 30 | User ID | Admin | | `cancelUserIp` | AN | 15 | User IP | 127.0.0.1 | | `cancelUserInfo` | AN | 100 | User Information | Test Cancel | | `cancelRetryCnt` | N | 2 | Retry Count | 5 | | `worker` | AN | 10 | Worker | Worker | ## Response Parameters *** | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | --------------------------------------------------------------------- | -------- | ---------- | ----------------------------------------------------------- | ------------------------------------------------------ | | `resultCd` | N | 4 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | 0000 | | `resultMsg` | AN | 255 | Result Message: [Error Code](docId\:yEh1VA9k2y6sL1kQF2aWD) | SUCCESS | | `tXid` | AN | 30 | Transaction ID | NORMALTEST00202212191104443483

When Success | | `referenceNo` | ANS | 40 | Order Number | ORDER20221012080918

When Success | | `transDt` | N | 8 | Transaction Date | 20221219

When Success | | `transTm` | N | 6 | Transaction Time | 110444

When Success | | `amt` | N | 12 | Amount | 10000

When Success | | `description` | AN | 255 | Description | | | `canceltXid` | AN | 30 | Cancel Transaction ID | | | `cancelTrxSn` | AN | 32 | Cancel Transaction Number | | | `cancelReferenceNo`
Optional For CC | AN | 40 | Cancel Number | | ## Sample Parameter for Cancel - API Checkout *** ### Request Parameter :::CodeblockTabs cURL ```curl curl --location 'https://dev.nicepay.co.id/nicepay/direct/v2/cancel' \ --header 'Content-Type: application/json' \ --data '{ "timeStamp" : "20251111011147", "iMid" : "IONPAYTEST", "tXid" : "IONPAYTEST02202511110137007677", "payMethod" : "02", "merchantToken" : "0eeb02a32bffdc6309a672b3ef7ea35f8fb2b20c1fda11e4cbdb76313d9f2085", "amt" : "10000", "cancelType" : "1", "cancelMsg" : "Cancel Testing Transaction", "cancelUserId" : "", "cancelUserIp" : "127.0.0.1", "cancelServerIp" : "127.0.0.1", "cancelUserInfo" : "", "cancelRetryCnt" : "", "worker" : "" }' ``` Node.js ```nodejs const SecondApiVersion = require("../lib/secondApiVersion.js"); const cons = require("./sharedConfig.js"); const config = { isProduction: false, isCloudServer: false, merchantKey: cons.merchantKey, }; let parameterCancel = { "timeStamp": "20251111011147", "iMid": "IONPAYTEST", "tXid": "IONPAYTEST02202511110137007677", "payMethod": "02", "amt": "10000", "cancelType": "1", "cancelMsg": "Cancel Testing Transaction", "cancelUserId": "", "cancelUserIp": "127.0.0.1", "cancelServerIp": "127.0.0.1", "cancelUserInfo": "", "cancelRetryCnt": "", "worker": "" }; let secondVersion = new SecondApiVersion(config); response = secondVersion .requestAPI(parameterCancel, "/direct/v2/cancel"); ``` ```java config = NICEPay.builder() .isProduction(false) .build(); String timestamp = "20251111011147"; String txId = "IONPAYTEST02202511110137007677"; String iMid = "IONPAYTEST"; String amount = "10000"; Cancel requestCancel = Cancel.builder() .timeStamp(timestamp) .tXid(txId) .iMid(iMid) .merchantToken(timestamp, iMid, txId, amount, YOUR_MERCHANT_KEY) .payMethod("02") .cancelType("1") .amt(amount) .cancelMsg("Cancel Testing Transaction") .cancelUserId("") .cancelUserIp("127.0.0.1") .cancelServerIp("127.0.0.1") .cancelUserInfo("") .cancelRetryCnt("") .worker("") .build(); NICEPayResponseV2 response = V2CancelService.callV2CancelTransaction(requestCancel, config); ``` ```python bodyCancel = ( builderCancel.BuildCancel() .setPayMethod("02") .setTxid("IONPAYTEST02202511110137007677") .setCancelUserId("") .setCancelType("1") .setCancelMsg("Cancel Testing Transaction") .setAmt("10000") .setCancelUserIp("127.0.0.1") .setCancelServerIp("127.0.0.1") .setCancelUserInfo("") .setCancelRetryCnt("") .setWorker("") .build() ) environment = (builderEnvironment.BuildEnvironment() .isCloud(False) .isProduction(False) .build()) response = ServiceNicepay.serviceCancel(DataGenerator.getCancelBody(bodyCancel.jsonCancel()), environment) ``` C# ```csharp TestingConstantService config = new TestingConstantService(); // Sample Constants string merchantKey = config.MerKey; string clientId = "IONPAYTEST"; string timestamp = "20251111011147"; string amount = "10000"; string txid = "IONPAYTEST02202511110137007677"; bool isProduction = false; bool isCloudServer = false; var builder = new MerchantTokenBuilder() .SetTimeStamp(timestamp) .SetIMid(clientId) .SetTXid(txid) .SetAmount(amount) .SetMerchantKey(merchantKey); // Act: Menghasilkan merchantToken string merchantToken = builder.BuildCancelMerchantToken(); var Bodybuilder = new NicepayRequestBuilder() .SetCancel( iMid : clientId, timeStamp : timestamp, tXid : txid, amt : amount, merchantToken : merchantToken, payMethod : "02", cancelType : "1", cancelMsg : "Cancel Testing Transaction", cancelUserId : "", cancelRetryCnt : "", ); ApiEndpoints apiEndpoints = new ApiEndpoints(); Dictionary payload = Bodybuilder.Build(); string jsonPayload = Newtonsoft.Json.JsonConvert.SerializeObject(payload); var registrationService = new NicepayRegistrationService(apiEndpoints,isProduction, isCloudServer); var result = await registrationService.SendPostAsync(apiEndpoints.CancelV2,payload); ``` Laravel ```php $url = HttpUtil::getNicepayDomain($this->useProd, $this->useCloud) . $this->cancel_endpoint; //request body parameter $timestamp = "20251111011147"; $txid = "IONPAYTEST02202511110137007677"; $amt = $this->amt; $merchant_token = $this->generateMerchantToken($timestamp, $this->imid, $txid, $this->amt, $this->merchant_key); $body = [ "timeStamp" => $timestamp, "tXid" => $txid, "iMid" => $this->imid, "payMethod" => $this->pay_method, "merchantToken" => $merchant_token, "amt" => $amt, "cancelMsg" => "Cancel Testing Transaction", "cancelType" => "1", "cancelServerIp" => "127.0.0.1", "cancelUserId" => "", "cancelUserIp" => "127.0.0.1", "cancelUserInfo" => "", "cancelRetryCnt" => "", "worker" => "" ]; try { $response = HttpUtil::postJsonRequest($url, $body); } catch (Throwable $th) { return HttpUtil::generateErrorResponse($th); } ``` PHP Native ```php $timestampv2 = "20251111011147"; $amount = "10000"; $iMid = "IONPAYTEST"; $merchantKey = TestConst::$MERCHANT_KEY; $configV2 = Nicepay::builder() ->setIsProduction(false) ->build(); $config = $configV2; $timestamp = $timestampv2; $txId = "IONPAYTEST02202511110137007677"; $requestBody = Cancel::builder() ->setTimeStamp($timestamp) ->setIMid($this->iMid) ->setTXid($txId) ->setMerchantToken($timestamp, $this->iMid, $txId, $this->amount, $this->merchantKey) ->setPayMethod("02") ->setCancelType("1") ->setAmt($this->amount) ->setCancelMsg("Cancel Testing Transaction") ->setCancelUserId("") ->setCancelUserIp("127.0.0.1") ->setCancelServerIp("127.0.0.1") ->setCancelUserInfo("") ->setCancelRetryCnt("") ->setWorker("") ->build(); try { $v2VaService = new V2VAService($config); $response = $v2VaService->cancel($requestBody); } ``` ```kotlin private val v2VirtualAccountService: DirectV2Service = DirectV2VirtualAccountServiceImpl() private val timeStamp: String = "20251111011147" private val txId: String = "IONPAYTEST02202511110137007677" private val iMid: String = "IONPAYTEST" private val amount: String = "10000" private var config: NICEPay? = NICEPay.Builder() .isProduction(false) .build() val request: DirectV2Cancel = DirectV2Cancel.Builder() .timeStamp(timeStamp) .tXid(txId) .iMid(iMid) .merchantKey(TestingConstants.DEFAULT_MERCHANT_KEY) .amt(amount) .payMethod("02") .cancelType("1") .cancelMsg("Cancel Testing Transaction") .cancelUserId("") .cancelUserIp("127.0.0.1") .cancelServerIp("127.0.0.1") .cancelUserInfo("") .cancelRetryCnt("") .worker("") .build() val response: NICEPayResponseV2 = v2VirtualAccountService.cancel(request, config)!! ``` CodeIgniter ```php $config = Nicepay::builder() ->setIsProduction(false) ->setIsCloudServer(false) ->build(); $timestamp = "20251111011147"; $txId = "IONPAYTEST02202511110137007677"; $amount = "10000"; $requestBody = Cancel::builder() ->setTimeStamp($timestamp) ->setIMid($this->iMid) ->setTXid($txId) ->setMerchantToken($timestamp, $this->iMid, $txId, $amount, $this->merchantKey) ->setPayMethod("02") ->setCancelType("1") ->setAmt($this->amount) ->setCancelMsg("Cancel Testing Transaction") ->setCancelUserId("") ->setCancelUserIp("127.0.0.1") ->setCancelServerIp("127.0.0.1") ->setCancelUserInfo("") ->setCancelRetryCnt("") ->setWorker("") ->build(); try { $v2VaService = new V2VAService($config); $response = $v2VaService->cancel($requestBody); } ``` ::: ### Response Parameter :::CodeblockTabs Sample Response ```json { "tXid": "IONPAYTEST02202511110137007677", "referenceNo": "ordNo20251111011183", "resultCd": "0000", "resultMsg": "SUCCESS", "transDt": "20251111", "transTm": "013700", "description": "TESTING TRANSACTION", "amt": "10000" } ``` ::: [title] E-Wallet - API Checkout [path] NICEPAY API/API Checkout/Payment - API Checkout/ # Tentang E-Wallet - API Checkout *** ini digunakan oleh untuk melakukan pengajuan kepada untuk menggunakan . # Alur Proses *** ## General ![Alur E-Wallet Umum](https://app.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/dgFfOnPXN5zcE4TO2R6yT_nicepay-archbee-payment-e-wallet-join.png "Alur E-Wallet Umum") Deskripsi alur setelah melakukan pesanan: 1. mengajukan *checkout *kepada . 2. mengirimkan pengajuan *checkout *menggunakan Registration kepada . 3. mengirimkan *response * regist kepada . 4. mengirimkan kepada . 5. mengajukan kepada . 6. melakukan *generate *pesanan. 7. menyimpan . 8. Pada saat : - Jika menggunakan OVO, maka akan mengimkan kepada aplikasi terkait untuk melakukan . - Jika menggunakan lain (selain OVO dan AstraPay), maka akan mengalihkan menuju . Kemudian, harus melakukan *login *dengan akun terkait sebelum melakukan . 9. mengirimkan kepada . 10. menerima . 11. mengirimkan kepada . 12. menerima . 13. mengirimkan kepada . 14. menerima . 15. mengajukan pemeriksaan kepada . 16. mengirimkan *response *dari pemeriksaan kepada . 17. menerima akhir. 18. mengirimkan konfirmasi pesanan kepada . ## AstraPay ![Alur E-Wallet AstraPay](https://app.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/kGt23r_YFA-1l9FANPAav_nicepay-archbee-payment-e-wallet-astrapay.png "Alur E-Wallet AstraPay") Deskripsi alur saat melakukan : 1. Jika belum memiliki akun AstraPay: - *request checkout *kepada . - mengirimkan Registration ([nicepay/api/linkEnable.do](#)) kepada . - mengirimkan *account link request *kepada AstraPay. - AstraPay menerima *request * dikirim oleh . - AstraPay mengirimkan *response *pengalihan URL menuju kepada . - mengirimkan *response *pengalihan URL kepada . - menampilkan pendaftaran kepada . - melakukan pendaftaran akun. - mengirimkan pendaftaran akun kepada AstraPay. - AstraPay melakukan validasi akun. - AstraPay mengirimkan kepada . - mengirimkan kepada . - mengirimkan bahwa akun sudah didaftarkan kepada . 2. *request checkout *kepada . 3. mengajukan ([nicepay/api/linkInitiate.do](#)) kepada . 4. mengajukan kepada AstraPay. 5. AstraPay melakukan *generate *. 6. AstraPay mengirimkan *response *redirect URL kepada . 7. mengirimkan *response *redirect URL kepada . 8. mengalihkan kepada AstraPay. 9. melakukan verifikasi . 10. melakukan kepada AstraPay. 11. AstraPay melakukan verifikasi . 12. AstraPay mengirimkan *callback *kepada . - mengirimkan *response *kepada . - menampilkan *response callback *kepada . 13. AstraPay mengirimkan kepada . - menerima . - mengirimkan kepada . - menerima . 14. *request* pemeriksaan kepada . 15. mengirimkan *response *kepada . 16. menerima akhir. 17. memperbarui kepada . ## Perbedaan Alur Proses Checkout (*Redirect*) Proses *checkout *memiliki dua perbedaan alur, yaitu *asynchronous* dan *synchronous*. Pada alur *asynchronous*, perlu memasukkan kredensial untuk masuk ke dalam aplikasi sebelum melakukan . Sementara untuk *synchronous*, tidak perlu memasukkan kredensial aplikasi terlebih dahulu dan dapat langsung melakukan melalui dikirimkan pada aplikasi . Perbedaan alur tersebut dapat dilihat pada dua alur di bawah ini. ### Alur Proses Asynchronous ![Alur Proses Asynchronouse pada E-Wallet](https://app.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/Ro3IEekft89HgP9w5IyB-_nicepay-archbee-payment-e-wallet.png "Alur Proses Asynchronouse pada E-Wallet") Deskripsi alur setelah melakukan *checkout *pesanan: 1. *requests checkout* kepada . 2. mengirimkan *request checkout* menggunakan Registration kepada . 3. mengirimkan *response * Registration kepada . 4. *request * kepada . 5. mengajukan kepada dan menyimpan . 6. melakukan *generate *pesanan. 7. menyimpan . 8. Jika menggunakan lain (selain OVO dan AstraPay), maka akan mengalihkan menuju . 9. melakukan *login *dengan akun terkait sebelum melakukan . 10. mengirimkan kepada . 11. menerima . 12. mengirimkan kepada . 13. menerima . 14. mengirimkan kepada . 15. menerima . 16. *request* pemeriksaan kepada . 17. mengirimkan *response *dari *request* pemeriksaan kepada . 18. menerima terakhir. 19. mengirimkan konfirmasi pesanan kepada . ### Alur Proses Synchronous ![Alur Proses Synchronouse pada e-Wallet](https://app.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/n7SzPqy6DiTnzKxGH89bM_nicepay-archbee-payment-ewallet-ovo.png "Alur Proses Synchronouse pada e-Wallet") Deskripsi alur setelah melakukan *checkout *pesanan: 1. *request checkout* kepada . 2. mengirimkan *request checkout* menggunakan Registration kepada . 3. mengirimkan *response * regist kepada . 4. mengirimkan kepada . 5. mengajukan kepada . 6. melakukan *generate *pesanan. 7. menyimpan . 8. (OVO) akan mengimkan kepada aplikasi terkait untuk melakukan . 9. mengirimkan kepada . 10. menerima . 11. mengirimkan kepada . 12. menerima . 13. mengirimkan kepada . 14. menerima . 15. *request* pemeriksaan kepada . 16. mengirimkan *response *dari *request* pemeriksaan kepada . 17. menerima akhir. 18. mengirimkan konfirmasi pesanan kepada . # NICEPAY Secure Payment Page *** ![Secure Payment Page](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/ohh_r6otn4iPQSs_4RfL1_image-id-nicepay-secure-payment-page-main-dashboard.jpg "Secure Payment Page") Gambar di atas adalah contoh *Checkout *dengan metode menggunakan Secure Page. ![E-Wallet - Secure Payment Page](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/pnNEHqJccO1szcPrcVeX-_image-id-e-wallet-secure-payment-page.jpg "E-Wallet - Secure Payment Page") Setelah pengajuan registrasi telah selesai, dapat melanjutkan sampai dengan penyelesaian dengan mengikuti [Panduan Bayar E-Wallet](docId:-v30F8TW2bUenjkPfjaX5). ![Success - Secure Payment Page](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/IW-LY2xKXixI9Vqvy1O3-_image-id-e-wallet-success-secure-payment-page.jpg "Success - Secure Payment Page") :::hint{type="warning"} Catatan untuk ShopeePay dan OVO, silakan berikan pesan peringatan kepada untuk membuka melalui perangkat ponsel demi memberikan pengalaman lebih baik kepada . ::: # API Checkout Transaction Payment *** | **API URL** | `/nicepay/redirect/v2/payment` | | ------------------- | ------------------------------------------- | | **Request Method** | `Redirect-GET` | | **Header** | `Content-Type: application/Form-UrlEncoded` | ## Request Parameter for E-Wallet - API Checkout (CallbackUrl) *** | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | --------------------------------------------------------- | -------- | ---------- | --------------------- | ----------------------------------------------------------- | | `paymentURL`
Required | ANS | 14 | URL
| https\://dev.nicepay.co.id/nicepay/redirect/v2/payment | | `tXid`
Required | AN | 30 | Transaction ID
| TNICEEW05100202212201020014087 | :::hint{type="warning"} Catatan untuk ShopeePay dan OVO, silakan berikan pesan peringatan kepada untuk membuka melalui perangkat ponsel demi memberikan pengalaman lebih baik kepada . ::: ## Response Parameter for E-Wallet - API Checkout (CallbackUrl) *** | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ------------------------------------------------------------------------------------------------------------------------------------- | -------- | ---------- | ----------------------------------------------------------- | ---------------------------------------------------------------------------------- | | `resultCd` | N | 4 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | 0000 | | `resultMsg` | AN | 255 | Result Message: [Error Code](docId\:yEh1VA9k2y6sL1kQF2aWD) | SUCCESS | | `tXid` | AN | 30 | Transaction ID | IONPAYTEST00202212201351474222

When Success | | `referenceNo` | ANS | 40 | Order Number | ordNo20221220131215

When Success | | `payMethod`
E-Wallet, Payloan | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | 05

When Success | | `amt` | N | 12 | Transaction Amount | 5000

When Success | | `transDt`
| N | 8 | Transaction Date (`YYYYMMDD`) | 20221220

When Success | | `transTm`
| N | 6 | Transaction Time (`HH24MISS`) | 135201

When Success | | `mitraCd`
Direct Debit, E-Wallet, Payloan | A | 4 | [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8) | DANA

When Success | | `callBackUrl` | ANS | 255 | Result URL | https\://webhook.site/7bef799f-ebe2-4328-a7b3-6d53deedca27

When Success | :::hint{type="info"} Catatan: Response akan dikirimkan melalui `callbackUrl` dengan Content-type: `application/json` dan metode: `POST Parameter`. ::: Sample Parameter for E-Wallet - API Checkout (CallbackUrl) ---------------------------------------------------------- *** :::hint{type="success"} Pada saat *Checkout*, *response* dari *request* melalui *hit* adalah Callback URL. ::: ### Request Parameter :::CodeblockTabs cURL ```curl curl -X GET "https://www.merchant.com/callbackUrl?resultCd=0000&resultMsg=SUCCESS&tXid=IONPAYTEST00202212201351474222&referenceNo=ordNo20221220131215&payMethod=05&amt=5000&transDt=20221220&transTm=135201&mitraCd=DANA&callBackUrl=https%3A%2F%2Fwebhook.site%2F7bef799f-ebe2-4328-a7b3-6d53deedca27" ``` ::: ### Callback Parameter :::CodeblockTabs Response Callback ```curl resultCd=0000 resultMsg=SUCCESS tXid=IONPAYTEST00202212201351474222 referenceNo=ordNo20221220131215 payMethod=05 amt=5000 transDt=20221220 transTm=135201 mitraCd=DANA callBackUrl=https://webhook.site/7bef799f-ebe2-4328-a7b3-6d53deedca27 ``` ::: ## Callback Handling API Checkout Transaction Payment *** :::hint{type="success"} Saat Callback diterima `callbackUrl` , kami merekomendasikan untuk melakukan verifikasi Status dengan menggunakan [Status Inquiry - API Checkout](docId\:K9vBS87ev9_w5oJAU0et3). ::: :::hint{type="warning"} `Callback Handling` sangat penting untuk membantu meminimalisir tindakan *Fraud*. Kami sangat merekomendasikan untuk melakukan verifikasi menggunakan `Callback parameter`. ::: ::Image[]{src="https://app.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/WKbTcgF46-td5RYqdl0m4_nicepay-api-checkout-api-callback-handling-flow-1.png" size="50" width="370" height="361" position="center" caption="Alur Callback Handling" alt="Alur Callback Handling" darkWidth="370" darkHeight="361" showCaption="true"} :::CodeblockTabs URL Callback ```json https://www.merchant.com/callbackUrl?resultCd=0000&resultMsg=SUCCESS&tXid=IONPAYTEST00202212201351474222&referenceNo=ordNo20221220131215&payMethod=05&amt=5000&transDt=20221220&transTm=135201&mitraCd=DANA&callBackUrl=https%3A%2F%2Fwebhook.site%2F7bef799f-ebe2-4328-a7b3-6d53deedca27 ``` Response Callback ```json resultCd=0000 resultMsg=SUCCESS tXid=IONPAYTEST00202212201351474222 referenceNo=ordNo20221220131215 payMethod=05 amt=5000 transDt=20221220 transTm=135201 mitraCd=DANA callBackUrl=https://webhook.site/7bef799f-ebe2-4328-a7b3-6d53deedca27 ``` ::: [title] Inquiry - API NICEPAY Inquiry Convenience Store SNAP [path] NICEPAY API/API SNAP/Advance API - SNAP/API NICEPAY Inquiry Convenience Store SNAP/ # Tentang Inquiry - API NICEPAY Inquiry Convenience Store SNAP *** Bagian ini berisi tentang terkait dengan standar digunakan pada dengan fitur Inquiry (NICO) agar dapat memeriksa &#xNAN;*.* # Inquiry - API NICEPAY Inquiry Convenience Store SNAP *** :::hint{type="warning"} mengajukan akses token terlebih dahulu untuk melakukan autentikasi melalui [Request Access Token - API NICEPAY Inquiry Convenience Store SNAP](docId\:Bo7josDlhHB-_TMdE6TGS). ::: | **API Endpoint** | `https://[merchant-domain]/api/v.1.0/cvs/inquiry` | | ---------------- | ------------------------------------------------- | | **Method** | `POST` | | **Description** | Untuk melakukan pemeriksaan NICO | | **Content-type** | `application/json` | :::hint{type="info"} Pada saat melakukan , akan mengirimkan Public Key kepada . Kemudian, wajib memberi terkait *endpoint * Inquiry CVS dan mengirimkan Client ID & Client Secret sesuai dengan spesifikasi kepada tim . Hal tersebut perlu dilakukan agar dapat mengajukan akses token dan melakukan *inquiry* data berada di sisi . Sehingga, dapat dijalankan dengan lancar oleh . ::: ## Request Inquiry Transaction Header Parameter | **Parameter** | **Tipe** | **Kebutuhan** | **Deskripsi** | **Contoh** | | --------------- | -------- | ------------- | ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `Content-Type` | String | Mandatory | String Media Type of Resource | `application/json` | | `Authorization` | String | Mandatory | Access Token Transaction | Bearer "accessToken" | | `X-TIMESTAMP` | String | Mandatory | Timezone | `YYYY-MM-DDTHH:MM:SS`
(2024-01-22T15:00:01+07:00) | | `X-PARTNER-ID` | String | Mandatory | ID | IONPAYTEST | | `X-SIGNATURE` | String | Mandatory | Signature | Generated by /
created using asymmetric
signature SHA256withRSA algorithm
(`Private_Key`, `stringToSign`)
`stringToSign `= `client ID` + “`\|`” + `X-TIMESTAMP` | | `X-EXTERNAL-ID` | String | Mandatory | Reference Number that should be unique in every | 11245542345212 | | `CHANNEL-ID` | String | Mandatory | Device identification on which s | IONPAYTEST | ## Request Inquiry Transaction Body Parameter | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | ------------------ | -------- | ---------- | ------------- | ------------------------------------------- | | `partnerServiceId` | String | 4 | Mandatory | Prefix | | `customerNo` | String | 8 | Mandatory | Number | | `payNo` | String | 12 | Mandatory | payNo Number | | `inquiryRequestId` | String | 40 | Mandatory | Unique Identifier from | | `mitraCd` | String | 4 | Mandatory | [Mitra Code](docId\:Tm257gq3DxgZf98uZ0l33) | ## Response Inquiry Transaction Body Parameter | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | ---------------------- | -------- | ---------- | ------------- | ------------------------------------------- | | `responseCode` | String | 5 | Mandatory | Response Code | | `responseMessage` | String | 100 | Mandatory | Response Message | | `payNoData` | Object | | Mandatory | payNo Data | | `partnerServiceId` | String | 4 | Mandatory | Prefix | | `customerNo` | String | 8 | Mandatory | Number | | `payNo` | String | 12 | Mandatory | payNo Number | | `payNoName` | String | 100 | Mandatory | payNo Name | | `goodsName` | String | 200 | Mandatory | Goods Name | | `payNoPhone` | Number | 15 | Mandatory | payNo Phone | | `payNoEmail` | String | 100 | Mandatory | payNo Email | | `inquiryRequestId` | String | 40 | Mandatory | Unique Identifier from | | `totalAmount` | Object | | Mandatory | Total Amount | | `value` | Number | 12 | Mandatory | Value | | `currency` | String | 3 | Mandatory | Currency | | `partnerReferenceNo` | String | 40 | Mandatory | Reference Number | | `mitraCd` | String | 4 | Mandatory | [Mitra Code](docId\:Tm257gq3DxgZf98uZ0l33) | | `payNoExpiredDateTime` | String | 25 | Mandatory | payNo Expired Date Time | ## Sample Parameter :::CodeblockTabs JSON Request ```json { "partnerServiceId": "7015", "customerNo": "89101110", "payNo": "701589101110", "inquiryRequestId": "41807553358950093184", "mitraCd": "ALMA" } ``` JSON Response ```json { "responseCode": "2000000", "responseMessage": "Successful", "payNoData": { "partnerServiceId": "7015", "customerNo": "89101110", "payNo": "701589101110", "payNoName": "John Test", "goodsName": "Pembelian John Test", "payNoPhone": "087771122333", "payNoEmail": "jhon@test.com", "inquiryRequestId": "41807553358950093184", "totalAmount": { "value": "10000.00", "currency": "IDR" }, "partnerReferenceNo": "abcdefgh1234", "mitraCd": "ALMA", "payNoExpiredDateTime": "2024-07-03T12:08:56+07:00" } } ``` ::: [title] Account Binding - API E-Wallet (Direct Debit) SNAP [path] NICEPAY API/API SNAP/Payment API - SNAP/API E-Wallet (Direct Debit) SNAP/ # Tentang Account Binding - API E-Wallet (Direct Debit) SNAP *** Account Binding digunakan untuk menghubungkan akun pengguna milik dengan akan dilakukan. Hal ini dilakukan untuk mempermudah melakukan pemeriksaan akun serta mempercepat . :::hint{type="info"} Account Binding hanya digunakan untuk AlloBank dan AstraPay. ::: # Alur Proses *** ## Account Binding - API E-Wallet (Direct Debit) SNAP :::hint{type="info"} Alur terlampir meliputi [Access Token B2B & B2B2C - Account Binding API E-Wallet (Direct Debit) SNAP](docId\:qZvrZPmasvcazBAKT97SS) dan [Registration - Account Binding API E-Wallet (Direct Debit) SNAP](docId:8Z5vJg0Veilgx7j5W9uLv). ::: ![Alur Proses Account Binding - API E-Wallet (Direct Debit) SNAP](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/MFKEByd1QILwQPNAFPIfV_diagram-account-binding-api-e-wallet-direct-debit-snap-process-flow.jpg "Alur Proses Account Binding - API E-Wallet (Direct Debit) SNAP") Deskripsi Alur: 1. mengajukan penghubungan akun kepada . 2. mengajukan akses token B2B kepada . 3. melakukan validasi. 4. melakukan *generate *akses token B2B. 5. mengirimkan *response *akses token B2B kepada . 6. menerima akses token B2B 7. melakukan *generate signature*. 8. mengajukan penghubungan akun kepada . 9. Pada saat pengajuan akses token B2B, jika: - Parameter tidak valid, maka: - mengirimkan *response *bahwa pengajuan gagal kepada . - menerima *response *yang dikirimkan . - Parameter valid, maka: - mengajukan penghubungan akun kepada . - menerima pengajuan penghubungan akun. - mengirimkan OTP kepada . - menerima OTP yang dikirimkan oleh . - melakukan *submit *OTP kepada . - menerima OTP yang di-*submit *oleh - mengirimkan *response *penghubungan akun kepada . - menerima *response *penghubungan akun dikirimkan oleh . - mengirimkan *response* penghubungan akun kepada . - menerima *response* penghubungan akun. - melakukan redirect pada tampilan penghubungan akun . 10. memasukkan autentikasi pengguna dan mengirimkan kepada . 11. melakukan penghubungan akun. 12. mengirimkan *response *kode autentikasi kepada . 13. menerima kode autentikasi. 14. mengirimkan *response *kode autentikasi kepada . 15. menerima kode autentikasi. 16. mengajukan akses token B2B2C kepada . 17. Pada saat pengajuan akses token B2B2C, jika: - Parameter tidak valid, maka: - mengirimkan *response *bahwa pengajuan gagal kepada . - menerima *response * dikirimkan . - Parameter valid, maka: - mengajukan akses token B2B2C kepada . - menerima pengajuan akses token B2B2C. - mengirimkan *response *penghubungan akun berhasil kepada . - menerima penghubungan akun berhasil. - melakukan *redirect *penghubungan akun berhasil kepada . - menerima penghubungan akun berhasil. - menampilkan penghubungan akun berhasil kepada . ## Unbinding - Account Binding API E-Wallet (Direct Debit) SNAP ![Alur Proses Unbinding - API E-Wallet (Direct Debit) SNAP](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/S202XieSyJQcJRkvl_6dX_diagram-unbinding-api-e-wallet-direct-debit-snap-process-flow.jpg "Alur Proses Unbinding - API E-Wallet (Direct Debit) SNAP") Deskripsi alur: 1. mengajukan penghentian sambungan akun kepada . 2. mengajukan penghentian sambungan akun kepada . 3. Pada saat pengajuan penghentian sambungan akun: - Jika tidak valid, maka: - mengirimkan *response *bahwa pengajuan gagal kepada . - menerima *response * dikirimkan . - Jika valid, maka: - mengajukan penghentian sambungan akun kepada . - mem pengajuan penghentian sambungan akun. - mengirimkan *response *penghentian sambungan akun kepada . - menerima *response *penghentian sambungan akun dikirimkan . - mengirimkan *response *penghentian sambungan akun kepada . - menerima penghentian sambungan akun. - menampilkan *refund *kepada . # Daftar API Account Binding - E-Wallet (Direct Debit) SNAP *** ::::LinkArray{contentSource="CUSTOM"} :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-BKVPoV3GsiQriuVNpm3hV-20250910-074424.jpg"} [Access Token B2B & B2B2C - Account Binding API E-Wallet (Direct Debit) SNAP](docId\:qZvrZPmasvcazBAKT97SS) digunakan untuk mendapatkan akses token pada *account binding *dan *balance inquiry*. ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-0G73dB8_o7uhp1iI9LVWo-20250910-074452.jpg"} [Registration - Account Binding API E-Wallet (Direct Debit) SNAP](docId:8Z5vJg0Veilgx7j5W9uLv) digunakan untuk mendaftarkan akun dengan akan dilakukan. ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-mY-Ls3U7sS5AXIRmXL015-20250910-074509.jpg"} [Inquiry - Account Binding API E-Wallet (Direct Debit) SNAP](docId\:ZO2FWBTRms7PLDowWkK55) digunakan untuk memeriksa *account binding.* ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-Tebrdfe_d0sFzBjfHcYm4-20250910-074520.jpg"} [Unbinding - Account Binding API E-Wallet (Direct Debit) SNAP](docId\:PJeGWlxmT5DF0_EV57ZAD) digunakan untuk melakukan pemutusan akun Pengguna. ::: :::: [title] Bank Code - API SNAP [path] NICEPAY API/API SNAP/NICEPAY Code - API SNAP/ *Value *(Nilai) berikut dapat dapat digunakan untuk mengisi `bankCd` pada . *Value Bank Code* juga muncul pada *response* sebagai `bankCd`, `acqBankCd`, dan `issuerBankCode`. # Bank Code *** ## Virtual Account ::File{src="https://api.archbee.com/api/presign/ZHvSjR5ZrsoxwKbJa3xmo/STAh1Whf2xOe5QcuZ1Z7m_bank-code-virtual-account.csv" label="Bank Code - Virtual Account.csv"} | **Nilai** | **Deskripsi** | | --------- | ----------------------- | | `BMRI` | Mandiri | | `IBBK` | International Maybank | | `BBBA` | Permata | | `BBBB` | Permata Syariah | | `CENA` | Central Asia (BCA) | | `BNIN` | Negara 46 (BNI) | | `HNBN` | KEB Hana | | `BRIN` | Rakyat (BRI) | | `BNIA` | PT CIMB Niaga, Tbk. | | `BDIN` | PT Danamon , Tbk. | | `PDJB` | BJB | | `YUDB` | Neo Commerce (BNC) | | `BDKI` | Jakarta | | `BSYI` | Syariah | ## Payout ::File{src="https://archbee-doc-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/WgOrNC_kjE1LHfEuIK_oT_bank-code-payout.csv" label="Bank Code - Payout.csv"} | **Value** | **Description** | | --------- | --------------------------------------- | | `ABAL` | BPD BALI | | `ABNA` | ROYAL BANK SCOTLAND | | `AGSS` | BANK AGRIS | | `AGTB` | BRI AGRONIAGA | | `AKTB` | BARCLAYS INDO | | `ANTD` | BANK ANTARDAERAH | | `ANZB` | BANK ANZ INDO | | `ARFA` | PANIN SYARIAH | | `ARTG` | BANK ARTHA GRAHA | | `ATOS` | BANK JAGO | | `AWAN` | BANK QNB INDO | | `BBAI` | BANK BUMI ARTA | | `BBBA` | PT BANK PERMATA, TBK | | `BBIJ` | BANK UOB INDO | | `BBUK` | BANK BUKOPIN | | `BCIA` | BANK CAPITAL INDO | | `BDIN` | BANK DANAMON | | `BDIP` | SAHABAT SAMPOERNA | | `BDKI` | BANK JAKARTA | | `BDPC` | BANK DANPAC | | `BDSY` | DANAMON SYARIAH | | `BHTL` | BANK HARMONI INTL | | `BICN` | COMMONWEALTH | | `BIDX` | BANK INDEX SELINDO | | `BJTM` | BANK JATIM | | `BKCH` | BANK OF CHINA | | `BKKB` | BANGKOK BANK | | `BMDM` | BANK MESTIKA DHARMA | | `BMRI` | MANDIRI | | `BMSE` | MULTI ARTA SENTOSA | | `BNIA` | CIMB NIAGA | | `BNIN` | BNI | | `BNPA` | BNP PARIBAS INDO | | `BOFA` | BANK OF AMERICA | | `BOTK` | MUFG BANK, LTD | | `BPIA` | RESONA PERDANIA | | `BPKO` | BANK PIKKO | | `BRIN` | BRI | | `BSYI` | BANK SYARIAH INDONESIA | | `BSSP` | BPD SUMSELBABEL | | `BTAN` | BTN | | `BUMI` | BANK MNC INTL | | `BUST` | KROM BANK INDONESIA | | `BUTG` | BANK MEGA SYARIAH | | `BVIC` | VICTORIA INTL | | `BWKI` | CHINA CONSTRUCTION | | `CENA` | BCA | | `CICT` | BANK MUTIARA | | `CITI` | CITIBANK | | `CNBA` | BANK CENTRATAMA | | `CTCB` | BANK CTBC INDO | | `DBSB` | DBS INDO | | `DEUT` | DEUTSCHE AG | | `EKON` | BANK HSBC INDO | | `EKST` | BANK PUNDI INDONESIA(KPO) | | `FAMA` | SUPERBANK | | `GNES` | BANK GANESHA | | `HNBN` | BANK KEB HANA | | `HRDA` | BANK HARDA INTL | | `HVBK` | WOORI SAUDARA INDO | | `IBBK` | MAYBANK INDO | | `ICBK` | BANK ICBC INDO | | `INDO` | BANK INDONESIA(KPO) | | `INPB` | BANK INA PERDANA | | `JSAB` | BANK JASA JAKARTA | | `KSEB` | BANK SEABANK INDONESIA | | `LFIB` | NOBU NATIONAL BANK | | `LMAN` | BANK DINAR INDO | | `LOMA` | BANK AMAR INDO | | `MASD` | BANK MASPION INDO | | `MAYA` | BANK MAYAPADA | | `MAYO` | BANK MAYORA | | `MBBE` | MAYBANK SYARIAH | | `MEEK` | BANK METRO EXPRESS | | `MEGA` | BANK MEGA TBK. | | `MGAB` | BANK MITRANIAGA | | `MHCC` | BANK MIZUHO INDO | | `MUAB` | BANK MUAMALAT | | `NISP` | OCBC NISP | | `NUPA` | BANK NUSANTARA | | `PDAC` | BANK ACEH | | `PDBK` | BPD BENGKULU | | `PDIJ` | BPD PAPUA | | `PDJB` | BANK JABAR | | `PDJG` | BPD JAWA TENGAH | | `PDJM` | BPD JAMBI | | `PDJT` | BANK JATIM SYARIAH | | `PDKB` | BPD KALBAR | | `PDKG` | BPD KALTENG | | `PDKS` | BPD KALSEL | | `PDKT` | BPD KALTIM | | `PDLP` | BPD LAMPUNG | | `PDML` | BPD MALUKU | | `PDNB` | BPD NTB | | `PDNT` | BPD NTT | | `PDRI` | BPD RIAU KEPRI | | `PDSB` | BPD SUMBAR | | `PDSU` | BPD SUMUT | | `PDWG` | BPD SULAWESITENGAH | | `PDWR` | BPD SULAWESITENGGARA | | `PDWS` | BANK SULSELBAR | | `PDWU` | BPD SULAWESIUTARA | | `PDYK` | BPD YOGYA SYARIAH | | `PINB` | PANIN | | `PMAS` | BANK PRIMA MASTER | | `PUBA` | BANK BTPN SYARIAH | | `RABO` | RABO BANK | | `RIPA` | BANK OKE INDO | | `ROYB` | BANK ROYAL INDO | | `SBID` | BANK SBI INDO | | `SBJK` | BANK SINARMAS | | `SCBL` | STANDARD CHARTERED | | `SDOB` | BUKOPIN SYARIAH | | `SIHB` | BANK SINAR HARAPAN | | `SUNI` | SUMITOMO MITSUI(KPO) | | `SWAG` | VICTORIA SYARIAH | | `SWBA` | BANK OF INDIA INDO | | `SYAC` | BPD ACEH SYARIAH | | `SYBK` | MAYBANK INDO UUS | | `SYBT` | BTN SYARIAH | | `SYCA` | BCA SYARIAH | | `SYDK` | BANK JAKARTA SYARIAH | | `SYJB` | BANK JABAR SYARIAH | | `SYKB` | BPD KALBAR SYARIAH | | `SYKS` | BPD KALSEL SYARIAH | | `SYKT` | BPD KALTIM SYARIAH | | `SYNA` | CIMB NIAGA SYARIAH | | `SYNI` | BNI SYARIAH | | `SYON` | OCBC NISP SYARIAH | | `SYSB` | BPD SUMBAR SYARIAH | | `SYSS` | BPD SUMSEL SYARIAH | | `SYSU` | BPD SUMUT SYARIAH | | `SYYK` | BPD YOGYA | | `TAPE` | BTPN | | `YUDB` | BANK YUDHA BAKTI | | `IDMC` | INDOMARET* | | `APID` | AIRPAY INTERNATIONAL | | `DANA` | ESPAY DEBIT INDONESIA KOE | | `CHAS` | JPMORGAN CHASE | | `NANO` | BANK NANO SYARIAH | | `SYAT` | BANK JAGO TBK UUS | | `ALSY` | BANK ALADIN SYARIAH TBK | | `SHBK` | BANK SHINHAN INDONESIA | | `SYJM` | BPD JAMBI UUS | *berlaku hanya untuk Cashout ## Advance API - Inquiry Detail ::File{src="https://archbee-doc-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/WkCre36tqG-Ovp8VqcoG__bank-code-advance-api-inquiry-detail.csv" label="Bank Code - Advance API - Inquiry Detail.csv" uploadAsPublic="true"} | **Value** | **Deskripsi** | | --------- | ------------------------------------ | | `BMRI` | Bank Mandiri | | `IBBK` | Bank International Indonesia Maybank | | `BBBA` | Bank Permata | | `BBBB` | Bank Permata Syariah | | `CENA` | Bank Central Asia (BCA) | | `BNIN` | Bank Negara Indonesia 46 (BNI) | | `HNBN` | Bank KEB Hana Indonesia | | `BRIN` | Bank Rakyat Indonesia (BRI) | | `BNIA` | Bank PT Bank CIMB Niaga, Tbk. | | `BDIN` | Bank PT Bank Danamon Indonesia, Tbk. | | `OTHR` | Bank Lain, *Unknown* | # Acquiring Bank Code *** ::File{src="https://archbee-doc-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/JcakQ9K8BAC4-ZpylG_7Y_bank-code-acquiring-bank-code.csv" label="Bank Code - Acquiring Bank Code.csv" uploadAsPublic="false"} | **Value** | **Deskripsi** | | --------- | ------------------------------ | | `BMRI` | Bank Mandiri | | `BNIN` | Bank Negara Indonesia 46 (BNI) | | `CENA` | Bank Central Asia (BCA) | | `BRIN` | Bank Rakyat Indonesia (BRI) | | `BNIA` | Bank PT Bank CIMB Niaga, Tbk. | # Issuing Bank Code *** ::File{src="https://archbee-doc-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/qSx0bykTCV9fscWi2B4Hm_bank-code-issuing-bank-code.csv" label="Bank Code - Issuing Bank Code.csv"} | **Value** | **Description** | | --------- | ------------------------- | | `ABAL` | BPD BALI | | `ABNA` | ROYAL BANK SCOTLAND | | `AGSS` | BANK AGRIS | | `AGTB` | BRI AGRONIAGA | | `AKTB` | BARCLAYS INDO | | `ANTD` | BANK ANTARDAERAH | | `ANZB` | BANK ANZ INDO | | `ARFA` | PANIN SYARIAH | | `ARTG` | BANK ARTHA GRAHA | | `ATOS` | BANK ARTOS INDO | | `AWAN` | BANK QNB INDO | | `BBAI` | BANK BUMI ARTA | | `BBBA` | PT BANK PERMATA, TBK | | `BBIJ` | BANK UOB INDO | | `BBUK` | BANK BUKOPIN | | `BCIA` | BANK CAPITAL INDO | | `BDIN` | BANK DANAMON | | `BDIP` | SAHABAT SAMPOERNA | | `BDKI` | BANK JAKARTA | | `BDPC` | BANK DANPAC | | `BDSY` | DANAMON SYARIAH | | `BHTL` | BANK HARMONI INTL | | `BICN` | COMMONWEALTH | | `BIDX` | BANK INDEX SELINDO | | `BJTM` | BANK JATIM | | `BKCH` | BANK OF CHINA | | `BKKB` | BANGKOK BANK | | `BMDM` | BANK MESTIKA DHARMA | | `BMRI` | MANDIRI | | `BMSE` | MULTI ARTA SENTOSA | | `BNIA` | CIMB NIAGA | | `BNIN` | BNI | | `BNPA` | BNP PARIBAS INDO | | `BOFA` | BANK OF AMERICA | | `BOTK` | MUFG BANK, LTD | | `BPIA` | RESONA PERDANIA | | `BPKO` | BANK PIKKO | | `BRIN` | BRI | | `BSYI` | BANK SYARIAH INDONESIA | | `BSSP` | BPD SUMSELBABEL | | `BTAN` | BTN | | `BUMI` | BANK MNC INTL | | `BUST` | BANK BISNIS INTL | | `BUTG` | BANK MEGA SYARIAH | | `BVIC` | VICTORIA INTL | | `BWKI` | CHINA CONSTRUCTION | | `CENA` | BCA | | `CICT` | BANK MUTIARA | | `CITI` | CITIBANK | | `CNBA` | BANK CENTRATAMA | | `CTCB` | BANK CTBC INDO | | `DBSB` | DBS INDO | | `DEUT` | DEUTSCHE AG | | `EKON` | BANK HSBC INDO | | `EKST` | BANK PUNDI INDONESIA(KPO) | | `FAMA` | BANK FAMA | | `GNES` | BANK GANESHA | | `HNBN` | BANK KEB HANA | | `HRDA` | BANK HARDA INTL | | `HVBK` | WOORI SAUDARA INDO | | `IBBK` | MAYBANK INDO | | `ICBK` | BANK ICBC INDO | | `INDO` | BANK INDONESIA(KPO) | | `INPB` | BANK INA PERDANA | | `JSAB` | BANK JASA JAKARTA | | `KSEB` | BANK KESEJAHTERAAN | | `LFIB` | NOBU NATIONAL BANK | | `LMAN` | BANK DINAR INDO | | `LOMA` | BANK AMAR INDO | | `MASD` | BANK MASPION INDO | | `MAYA` | BANK MAYAPADA | | `MAYO` | BANK MAYORA | | `MBBE` | MAYBANK SYARIAH | | `MEEK` | BANK METRO EXPRESS | | `MEGA` | BANK MEGA TBK. | | `MGAB` | BANK MITRANIAGA | | `MHCC` | BANK MIZUHO INDO | | `MUAB` | BANK MUAMALAT | | `NISP` | OCBC NISP | | `NUPA` | BANK NUSANTARA | | `PDAC` | BANK ACEH | | `PDBK` | BPD BENGKULU | | `PDIJ` | BPD PAPUA | | `PDJB` | BANK JABAR | | `PDJG` | BPD JAWA TENGAH | | `PDJM` | BPD JAMBI | | `PDJT` | BANK JATIM SYARIAH | | `PDKB` | BPD KALBAR | | `PDKG` | BPD KALTENG | | `PDKS` | BPD KALSEL | | `PDKT` | BPD KALTIM | | `PDLP` | BPD LAMPUNG | | `PDML` | BPD MALUKU | | `PDNB` | BPD NTB | | `PDNT` | BPD NTT | | `PDRI` | BPD RIAU KEPRI | | `PDSB` | BPD SUMBAR | | `PDSU` | BPD SUMUT | | `PDWG` | BPD SULAWESITENGAH | | `PDWR` | BPD SULAWESITENGGARA | | `PDWS` | BANK SULSELBAR | | `PDWU` | BPD SULAWESIUTARA | | `PDYK` | BPD YOGYA SYARIAH | | `PINB` | PANIN | | `PMAS` | BANK PRIMA MASTER | | `PUBA` | BANK BTPN SYARIAH | | `RABO` | RABO BANK | | `RIPA` | BANK OKE INDO | | `ROYB` | BANK ROYAL INDO | | `SBID` | BANK SBI INDO | | `SBJK` | BANK SINARMAS | | `SCBL` | STANDARD CHARTERED | | `SDOB` | BUKOPIN SYARIAH | | `SIHB` | BANK SINAR HARAPAN | | `SUNI` | SUMITOMO MITSUI(KPO) | | `SWAG` | VICTORIA SYARIAH | | `SWBA` | BANK OF INDIA INDO | | `SYAC` | BPD ACEH SYARIAH | | `SYBK` | MAYBANK INDO UUS | | `SYBT` | BTN SYARIAH | | `SYCA` | BCA SYARIAH | | `SYDK` | BANK JAKARTA SYARIAH | | `SYJB` | BANK JABAR SYARIAH | | `SYKB` | BPD KALBAR SYARIAH | | `SYKS` | BPD KALSEL SYARIAH | | `SYKT` | BPD KALTIM SYARIAH | | `SYNA` | CIMB NIAGA SYARIAH | | `SYNI` | BNI SYARIAH | | `SYON` | OCBC NISP SYARIAH | | `SYSB` | BPD SUMBAR SYARIAH | | `SYSS` | BPD SUMSEL SYARIAH | | `SYSU` | BPD SUMUT SYARIAH | | `SYYK` | BPD YOGYA | | `TAPE` | BTPN | | `YUDB` | BANK YUDHA BAKTI | [title] Check Status Transaction - API Virtual Account SNAP [path] NICEPAY API/API SNAP/Payment API - SNAP/API Virtual Account SNAP/ # Tentang Check Status Transaction - API Virtual Account SNAP *** API dengan standar SNAP ini digunakan oleh Merchant untuk mengajukan pemeriksaan status inquiry kepada NICEPAY. # Check Status Transaction - API Virtual Account SNAP *** :::hint{type="warning"} Silakan mengajukan akses token terlebih dahulu untuk melakukan autentikasi melalui bagian [Request Access Token API - SNAP](docId\:GcGqBIYXG1Etcd0Ji9cHX). ::: | **Service Code** | `26` | | ---------------- | --------------------------------------------------------------- | | **API Endpoint** | `/api/v1.0/transfer-va/status` | | **Method** | `HTTP` `POST` | | **Description** | Untuk mengajukan pemeriksaan status inquiry kepada NICEPAY | | **Content-Type** | `application/json` | ## Request Check Status Header Parameter | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | **Contoh** | | --------------- | -------- | ---------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | | `Content-Type` | String | | Mandatory | `Application / JSON` | | | `Authorization` | String | | Mandatory | Bearer “`access_token`” | | | `X-TIMESTAMP` | String | | 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 | | Mandatory | Signature will be generated by Merchant.
[Panduan X-Signature - Symmetric](docId\:UZex33ReLyENKOgbJJnYp) | | | `X-PARTNER-ID` | String | 20 | Mandatory | `X-PARTNER-ID` = `CLIENT_ID` | | | `X-EXTERNAL-ID` | String | 40 | Mandatory | Unique Reference Number.
(`41807553358950093184`) | | | `CHANNEL-ID` | String | 20 | Mandatory | Unique Channel Merchant Credential ID Number.
Client ID + "01" = Channel ID
`"IONPAYTEST" + "01" = "IONPAYTEST01"` | IONPAYTEST01 | ## Request Check Status Body Parameter :::hint{type="info"} Untuk parameter `partnerServiceId` dan `virtualAccountNo` dapat dikirim dengan nilai kosong. ::: | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | ------------------ | -------- | ---------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------- | | `partnerServiceId` | String | 20 | Mandatory | Partner Service ID / Prefix | | `customerNo` | String | 40 | Mandatory | Customer Number | | `virtualAccountNo` | String | 25 | Mandatory | Virtual Account Number | | `inquiryRequestId` | String | 128 | Mandatory | The same value as `X-EXTERNAL-ID` | | `additionalInfo` | Object | | Mandatory | `"additionalInfo": { `
` "totalAmount": { `
` ... `
` }, `
` ... `
` } ` | | `totalAmount` | Object | | Mandatory | `"totalAmount": { `
` ... `
` }` | | `value` | String | 12 | Mandatory | Transaction Amount | | `currency` | String | 3 | Mandatory | Currency | | `trxId` | String | 40 | Mandatory | Reference Number from Merchant | | `tXidVA` | String | 30 | Mandatory | Transaction ID (Generated by NICEPAY) | ## Response Check Status Parameter | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | ------------------------- | -------- | ---------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `responseCode` | String | | Mandatory | [General Response Code and Message - API SNAP](docId\:lKqJXSl5CMKdXYXxHYYSs) | | `responseMessage` | String | | Mandatory | Response Message | | `virtualAccountData` | Object | | Mandatory | | | `partnerServiceId` | String | 20 | Mandatory | Partner Service ID / Prefix | | `customerNo` | String | 40 | Mandatory | Customer Number | | `virtualAccountNo` | String | 25 | Mandatory | Virtual Account Number | | `inquiryRequestId` | String | 128 | Mandatory | The same value as `X-EXTERNAL-ID` | | `totalAmount` | Object | | Mandatory | `"totalAmount": { `
` .... `
` }` | | `value` | String | 12 | Mandatory | Transaction Amount | | `currency` | String | 3 | Mandatory | Currency | | `additionalInfo` | Object | | Mandatory | `"additionalInfo": { `
` ... `
` }` | | `bankCd` | String | 4 | Mandatory | [Bank Code - API SNAP](docId:9WOQy5-1hlf_uCwshSDHO) | | `tXidVA` | String | 30 | Mandatory | Transaction ID (Generated by NICEPAY) | | `goodsNm` | String | 200 | Mandatory | Goods Name | | `vacctValidDt` | String | 8 | Mandatory | Virtual Account Valid Date | | `vacctValidTm` | String | 6 | Mandatory | Virtual Account Valid Time | | `virtualAccountName` | String | 100 | Mandatory | Virtual Account Name | | `trxId` | String | 40 | Mandatory | Reference Number from Merchant | | `transactionStatusDesc` | String | | Mandatory | [Transaction Status - API SNAP](docId\:XxlWrB0Q8XVkSMaO7ti9a) Description :
`Success `
` Pending `
` Refunded `
` Canceled `
` Failed` | | `latestTransactionStatus` | String | | Mandatory | [Latest Transaction Status ](docId\:XxlWrB0Q8XVkSMaO7ti9a):
`00` - Success
`03` - Pending
`04` - Refunded
`05` - Canceled
`06` - Failed | | `hashedSourceAccountNo` | String | 32 | Optional | Source account number in hash or unhash depend on Bank | | `sourceBankCode` | String | 11 | Optional | Source account Bank code | # Sample Parameter for Check Status Transaction API Virtual Account SNAP *** ## Request Parameter :::CodeblockTabs cURL ```curl curl --location 'https://dev.nicepay.co.id/nicepay/api/v1.0/transfer-va/status' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8=' \ --header 'X-TIMESTAMP: 2024-12-31T10:11:40+07:00' \ --header 'X-SIGNATURE: ufBw7R8RhW79IOiV/Hlv607M60qzAYBv8uZmbSrYb6/Thlo/FhQVP4xRyelUehoSS9o+QS6vWTKb/ygtucC+tQ==' \ --header 'X-PARTNER-ID: NORMALTEST' \ --header 'X-EXTERNAL-ID: tXid202402111402271707638094' \ --header 'CHANNEL-ID: NORMALTEST' \ --data '{ "partnerServiceId": "99123040", "customerNo": "00007307", "virtualAccountNo": "9912304000007307", "inquiryRequestId": "tXid202402111402271707638094", "additionalInfo": { "totalAmount": { "value": "10000.00", "currency": "IDR" }, "trxId": "2024123000000000000001", "tXidVA": "NORMALTEST02202401181001033629" } }' ``` Node.js ```nodejs let config = { isProduction: false, privateKey: cons.privateKey, clientSecret: cons.clientSecret, clientId: cons.clientId, isCloudServer: false, }; let paramCheckStatus = { body: { partnerServiceId: "99123040", customerNo: "00007307", virtualAccountNo: "9912304000007307", inquiryRequestId: "tXid202402111402271707638094", additionalInfo: { totalAmount: { value: "10000.00", currency: "IDR", }, trxId: "2024123000000000000001", tXidVA: "NORMALTEST02202401181001033629", }, }, headers: { X_EXTERNAL_ID: "tXid202402111402271707638094", CHANNEL_ID: cons.clientId, }, }; let snap = new Snap(config); let endPoint = `/api/v1.0/transfer-va/status`; let response = snap.requestSnapTransaction(paramCheckStatus, endPoint, accessToken, "POST"); ``` ```java config = NICEPay.builder() .isProduction(false) .isCloudServer(false) .clientSecret(CLIENT_SECRET) .partnerId(PARTNER_ID) .externalID("tXid202402111402271707638094") .timestamp("2024-12-31T10:11:40+07:00") .privateKey(PRIVATE_KEY_CLOUD) .build(); var accessToken = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8="; InquiryStatus requestData = InquiryStatus.builder() .partnerServiceId("99123040") .customerNo("00007307") .virtualAccountNo("9912304000007307") .inquiryRequestId("tXid202402111402271707638094") .totalAmount("10000.00", "IDR") .trxId("2024123000000000000001") .tXidVA("NORMALTEST02202401181001033629") .build(); NICEPayResponse result = SnapInquiryStatusService.callServiceVACheckStatus(requestData, accessToken, config); ``` ```python bodyCreateToken = ( builderAccessToken.BuildAccessToken() .setGrantType("client_credentials") .setAdditionalInfo("") .build() ) totalAmount = { "value": "10000.00", "currency": "IDR" } additionalInfo = { "tXidVA": "NORMALTEST02202401181001033629", "totalAmount": totalAmount, "trxId": "2024123000000000000001", } bodyInquiryVA = ( builderVirtualAccount.BuildInquiryVA() .setPartnerServiceId("99123040") .setCustomerNo("00007307") .setVirtualAccountNo("9912304000007307") .setInquiryRequestId("tXid202402111402271707638094") .setAdditionalInfo(additionalInfo) .build() ) environment = (builderEnvironment.BuildEnvironment() .isCloud(False) .isProduction(False) .build()) result = SnapService.serviceTransaction( bodyCreateToken.jsonAccessToken(), bodyInquiryVA.jsonVAInquiry(), ConstantsEndpoints.inquiryVA(), environment ) ``` C# ```csharp string clientId = "NORMALTEST"; string privateKey = "_PRIVATE_KEY"; // replace with actual private key string timestamp = "2024-12-31T10:11:40+07:00"; string clientSecret = "_CLIENT_SECRET"; // replace with actual client secret string channelId = "NORMALTEST"; bool isProduction = false; bool isCloudServer = true; string signature = SignatureGeneratorUtils.GenerateSignature(privateKey, clientId, timestamp); var tokenRequester = new AccessTokenRequester(); string accessTokenResponse = await tokenRequester.GetAccessTokenAsync(clientId, signature, timestamp, isProduction, isCloudServer); dynamic accessTokenObject = JObject.Parse(accessTokenResponse); string accessToken = accessTokenObject.accessToken; ApiEndpoints apiEndpoints = new ApiEndpoints(); APIService vaService = new APIService(apiEndpoints, clientSecret, clientId, channelId, isProduction, isCloudServer); SnapVaServices requestBodyGenerator = new SnapVaServices(clientId); // Values from your provided data string VA_NO = "9912304000007307"; string trxID = "2024123000000000000001"; string Amount = "10000.00"; string txidVa = "NORMALTEST02202401181001033629"; string inquiryRequestBody = requestBodyGenerator.GenerateInquiryRequest( customerNo: "00007307", virtualAccountNo: VA_NO, inquiryRequestId: "tXid202402111402271707638094", value: Amount, currency: "IDR", trxId: trxID, tXidVA: txidVa ); string externalId = "tXid202402111402271707638094"; string inquiryResponse = await vaService.SendPostRequest(apiEndpoints.InquiryVA, accessToken, timestamp, inquiryRequestBody, externalId); ``` Laravel ```php protected $useProd = false; protected $useCloud = false; protected $inquiry_va_endpoint = "/api/v1.0/transfer-va/status"; // Credential protected $client_id = "CLIENT_KEY_MERCHANT"; protected $key = "_PRIVATE_KEY_MERCHANT"; protected $client_secret = "_CLIENT_SECRET_MERCHANT"; protected $access_token = "_ACCESS_TOKEN_MERCHANT"; $url = HttpUtil::getNicepayDomain($this->useProd, $this->useCloud) . "/nicepay" . $this->inquiry_va_endpoint; $helper = new Helpers(); $http_method = "POST"; // Use the timestamp from previous data $x_time_stamp = "2024-12-31T10:11:40+07:00"; $time_stamp = "20241231101140"; $partner_id = $this->client_id; $client_secret = $this->client_secret; $access_token = $helper->generateAccessToken($this->client_id, $this->key); $external_id = "tXid202402111402271707638094"; $totalAmount = [ "value" => "10000.00", "currency" => "IDR" ]; $additionalInfo = [ "totalAmount" => $totalAmount, "trxId" => "2024123000000000000001", "tXidVA" => "NORMALTEST02202401181001033629" ]; $body = [ "partnerServiceId" => "99123040", "customerNo" => "00007307", "virtualAccountNo" => "9912304000007307", "virtualAccountName" => "TEST VA Status", "inquiryRequestId" => "tXid202402111402271707638094", "trxId" => "2024123000000000000001", "totalAmount" => $totalAmount, "additionalInfo" => $additionalInfo ]; $string_to_sign = $helper->generateStringToSign( $http_method, $this->inquiry_va_endpoint, $access_token, $body, $x_time_stamp ); $signature = $helper->hmacSHA512Encoded( $string_to_sign, $client_secret, OPENSSL_ALGO_SHA512 ); $header = $helper->generateHeader( $access_token, $x_time_stamp, $signature, $partner_id, $external_id, $partner_id . "01" ); try { $response = HttpUtil::postJsonRequestWithHeader($url, $body, $header); } catch (\Exception $e) { echo "Error: " . $e->getMessage(); } ``` PHP Native ```php $config = NICEPay::builder() ->setIsProduction(false) ->setPrivateKey($this->oldKeyFormat) ->setClientSecret($this->clientSecret) ->setPartnerId($this->iMidTest) ->setExternalID("tXid202402111402271707638094") ->setTimestamp("2024-12-31T10:11:40+07:00") ->build(); $parameter = InquiryStatus::builder() ->setPartnerServiceId("99123040") ->setCustomerNo("00007307") ->setVirtualAccountNo("9912304000007307") ->setInquiryRequestId("tXid202402111402271707638094") ->setTrxId("2024123000000000000001") ->setTxIdVA("NORMALTEST02202401181001033629") ->setTotalAmount("10000.00", "IDR") ->build(); $accessToken = self::getAccessToken($config); $snapVAService = new SnapVAService($config); try { $response = $snapVAService->inquiryStatus($parameter, $accessToken); } catch (\Exception $e) { echo "Error: " . $e->getMessage(); } ``` ```kotlin val config: NICEPay = NICEPay.Builder() .isProduction(false) .clientSecret(TestingConstants.NORMALTEST_CLIENT_SECRET) .partnerId(I_MID_NORMALTEST) .externalID("tXid202402111402271707638094") .timestamp("2024-12-31T10:11:40+07:00") .privateKey(TestingConstants.PRIVATE_KEY) .build() val accessToken = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8=" val reqInquiryVA: SnapCheckStatus = SnapCheckStatus.Builder() .partnerServiceId("99123040") .customerNo("00007307") .virtualAccountNo("9912304000007307") .inquiryRequestId("tXid202402111402271707638094") .totalAmount("10000.00", "IDR") .trxId("2024123000000000000001") .tXidVA("NORMALTEST02202401181001033629") .build() val snapVirtualAccountService: SnapVirtualAccountService = SnapVirtualAccountServiceImpl() val response: NICEPayResponse? = snapVirtualAccountService.checkStatus(reqInquiryVA, accessToken, config) ``` CodeIgniter ```php $this->clientSecret = $testConst::IMID_TEST_CLIENT_SECRET; $this->oldKeyFormat = $testConst::IMID_TEST_PRIVATE_KEY; $this->iMidTest = $testConst::IMID_TEST; $this->merchantKey = $testConst::IMID_COMMON_MERCHANT_KEY; $this->v2Config = NICEPay::builder() ->setIsProduction(false) ->build(); $config = NICEPay::builder() ->setIsCloudServer(true) ->setPrivateKey($this->oldKeyFormat) ->setClientSecret($this->clientSecret) ->setPartnerId($this->iMidTest) ->setExternalID("tXid202402111402271707638094") ->setTimestamp("2024-12-31T10:11:40+07:00") ->build(); $inquiryStatusBuilder = InquiryStatus::builder(); $parameter = $inquiryStatusBuilder ->setPartnerServiceId("99123040") ->setCustomerNo("00007307") ->setVirtualAccountNo("9912304000007307") ->setInquiryRequestId("tXid202402111402271707638094") ->setTrxId("2024123000000000000001") ->setTxIdVA("NORMALTEST02202401181001033629") ->setTotalAmount("10000.00", "IDR") ->build(); $accessToken = self::getAccessToken($config); $snapVAService = new SnapVAService(); try { $response = $snapVAService->inquiryStatus($parameter, $accessToken, $config); } catch (\Exception $e) { echo "Error: " . $e->getMessage(); } ``` ::: ## Response Parameter :::CodeblockTabs Sample Response ```json { "responseCode": "2002600", "responseMessage": "Successful", "virtualAccountData": { "partnerServiceId": "86230927", "customerNo": "87654321", "virtualAccountNo": "8623092787654321", "inquiryRequestId": "11032020240313", "totalAmount": { "value": "10000.00", "currency": "IDR" } }, "additionalInfo": { "virtualAccountName": "John Test", "trxId": "2020102900000000000001", "transactionStatusDesc": "success", "latestTransactionStatus": "00", "bankCd": "CENA", "tXidVA": "OPENFIX0010220221107161035699", "goodsNm": "Test", "vacctValidDt": "20221110", "vacctValidTm": "161037", "hashedSourceAccountNo": "abcdefghijklmnopqrstuvwxyz123456", "sourceBankCode": "008" } } ``` ::: [title] Registration - API Payout (Disbursement) SNAP [path] NICEPAY API/API SNAP/Payout API (Disbursement) - SNAP/ # Tentang Registration - API Payout (Disbursement) SNAP *** API ini digunakan untuk mendaftarkan proses Payout atau Disbursement sebelum melakukan proses transaksi. # Registration - API Payout (Disbursement) SNAP *** :::hint{type="warning"} Silakan mengajukan akses token terlebih dahulu untuk melakukan autentikasi melalui bagian [Request Access Token API - SNAP](docId:92feymrQs_iebHXrfgXUq). ::: | **API Endpoint** | ****`/nicepay/api/v1.0/transfer/registration` | | ---------------- | -------------------------------------------------------------------------- | | **HTTP Method** | **POST** | | **Description** | Create Transaction Payout or Disbursement | | **Content-type** | `application/json` | ## Request Registration Disbursement Header Parameter | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | **Contoh** | | --------------- | -------- | ---------- | ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | | `Content-Type` | String | 127 | Mandatory | Content type, value always `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 | Signature will be generated by Merchant.
[Panduan X-Signature - Symmetric](docId\:UZex33ReLyENKOgbJJnYp) | | | `X-PARTNER-ID` | String | 20 | Mandatory | Unique Partner ID, Partner ID = Client ID | | | `X-EXTERNAL-ID` | String | 40 | Mandatory | Unique messaging Reference ID generated by Merchant. Numeric String. Reference number that should be unique in every transaction. | | | `CHANNEL-ID` | String | 20 | Mandatory | Unique Channel Merchant Credential ID Number.
Client ID + "01" = Channel ID
`"IONPAYTEST" + "01" = "IONPAYTEST01"` | IONPAYTEST01 | ## Request Registration Disbursement Body Parameter | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | ------------------------------ | ------------------------- | ---------- | ------------- | ----------------------------------------------------------------------------------------- | | `merchantId` | String | 10 | Mandatory | Merchant identifier that is unique per each Merchant | | `msId` | String | 20 | Optional | Merchant Seller ID | | `beneficiaryAccountNo` | String | 25 | Mandatory | Beneficiary Account Number | | `beneficiaryName` | String | 100 | Mandatory | Beneficiary Name | | `beneficiaryPhone` | String | 20 | Mandatory | Beneficiary Phone | | `beneficiaryCustomerResidence` | String | 2 | Mandatory | Beneficiary Customer Residence:
`1`: Indonesia
`2`: Non Indonesia | | `beneficiaryCustomerType` | String | 2 | Mandatory | Beneficiary Customer Type:
`1`: Personal
`2`: Company
`3`: Government | | `beneficiaryPostalCode` | String
| 6 | Optional | Beneficiary Postal Code | | `payoutMethod` | String | 4 | Mandatory | Payout Method:
`0`: Over Booking
`1`: Online Trans
`2`: SKN
`3`: RTGS | | `beneficiaryBankCode` | String | 4 | Mandatory | Beneficiary [Bank Code - API SNAP](docId:9WOQy5-1hlf_uCwshSDHO) | | `amount` | Array of
JSON Object | Variable | Mandatory | Amount Information
`"amount": {...}` | | `value` | String | 12 | Mandatory | Transaction Amount, including thecents | | `currency` | String | 3 | Mandatory | Currency Code based on ISO | | `partnerReferenceNo` | String | 40 | Mandatory | Transaction ID from Merchant | | `reservedDt` | String | 8 | Optional | The date when will be automatic reserved. `YYYYMMDD`: `20251231` | | `reservedTm` | String | 6 | Optional | The date when will be automatic reserved. `HH24MISS`: `235959` | | `description` | String | 40 | Optional | Description Transaction | ## Response Registration Disbursement Parameter | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | ---------------------- | ------------------------- | ---------- | ------------- | ----------------------------------------------------------------------------------------------------------------------------------- | | `responseCode` | String | 7 | Mandatory | Refer to [General Response Code and Message - API SNAP](docId\:lKqJXSl5CMKdXYXxHYYSs) List | | `responseMessage` | String | 150 | Mandatory | Refer to [General Response Code and Message - API SNAP](docId\:lKqJXSl5CMKdXYXxHYYSs) List | | `partnerReferenceNo` | String | 40 | Mandatory | Merchant Transaction Identifier | | `originalReferenceNo` | String | 40 | Mandatory | Original Transaction Identifier on Service
Provider System | | `beneficiaryaccountNo` | String | 25 | Mandatory | Beneficiary Account Number | | `beneficiaryName` | String | 100 | Mandatory | Beneficiary Name | | `payoutMethod` | String | 4 | Mandatory | Payout Method:
`0`: Over Booking
`1`: Online Trans
`2`: SKN
`3`: RTGS | | `beneficiaryBankCode` | String | 4 | Mandatory | Beneficiary [Bank Code - API SNAP](docId:9WOQy5-1hlf_uCwshSDHO) | | `amount` | Array of JSON
Object | Variable | Mandatory | Amount Information
`"amount": {...}` | | `value` | String | 12 | Mandatory | Transaction Amount, If it’s IDR then value
includes 2 decimal digits.
e.g. IDR 10.000,- will be placed with
10000.00 | | `currency` | String | 3 | Mandatory | Currency Code based on ISO | ## Sample Parameter :::CodeblockTabs Request Body ```json //HEADER SECTION Content-Type: application/json Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8= X-TIMESTAMP: 2024-12-31T10:11:40+07:00 X-SIGNATURE: ufBw7R8RhW79IOiV/Hlv607M60qzAYBv8uZmbSrYb6/Thlo/FhQVP4xRyelUehoSS9o+QS6vWTKb/ygtucC+tQ== X-PARTNER-ID :IONPAYTEST X-EXTERNAL-ID: tXid202402111402271707638103 CHANNEL-ID: IONPAYTEST { "merchantId": "IONPAYTEST", "msId": "", "beneficiaryAccountNo": "5345000060", "beneficiaryName": "IONPAY NETWORKS", "beneficiaryPhone": "08123456789", "beneficiaryCustomerResidence": "1", "beneficiaryCustomerType": "1", "beneficiaryPostalCode": "123456", "payoutMethod": "0", "beneficiaryBankCode": "CENA", "amount": { "value": "12345678.00", "currency": "IDR" }, "partnerReferenceNo": "order1676975014155", "description": "This is test Request", "reservedDt": "20230222", "reservedTm": "172334" } ``` Sample Response ```json { "responseCode": "2000000", "responseMessage": "Successful", "partnerReferenceNo": "order1676975014155", "originalReferenceNo": "IONPAYTEST07202302211723331619", "beneficiaryaccountNo": "5345000060", "beneficiaryName": "NICEPAY", "payoutMethod": "1", "beneficiaryBankCode": "CENA", "amount": { "value": "12345678.00", "currency": "IDR" } } ``` ::: [title] QRIS [path] NICEPAY API/API Playground/SNAP API Testing/ [title] Cancel Virtual Account [path] NICEPAY API/API Playground/SNAP API Testing/Virtual Account/ { "id": "RWw3lkIX8gL6jhRt77a4j", "type": "api-oas-v2", "data": { "method": "DELETE", "url": "https://dev.nicepay.co.id/nicepay/api/v1.0/transfer-va/delete-va", "servers": [ { "url": "https://dev.nicepay.co.id/nicepay/api/v1.0/transfer-va/delete-va" }, { "url": "https://staging.nicepay.co.id/nicepay/api/v1.0/transfer-va/delete-va" }, { "url": "https://www.nicepay.co.id/nicepay/v1.0/transfer-va/delete-va" } ], "name": "Cancel Virtual Account", "description": "", "contentType": "application/json", "request": { "pathParameters": [], "headerParameters": [ { "kind": "required", "name": "X-TIMESTAMP", "type": "string", "example": "2024-03-05T14:15:40+07:00" }, { "kind": "required", "name": "X-SIGNATURE", "type": "string", "default": "4inuZtSe4h9YmRbqRyHTyUbQ/dce0beKF2CL1L4ojs2n84nzrusKVVJ9n2KDRRQQwS5bsu43IdshTZF2tHOkBw==" }, { "kind": "required", "name": "X-PARTNER-ID", "type": "string", "example": "TNICEVA023" }, { "kind": "required", "name": "X-EXTERNAL-ID", "type": "string", "example": "20240304181404" }, { "kind": "required", "name": "CHANNEL-ID", "type": "string", "example": "TNICEVA023" } ], "queryParameters": [], "bodyDataParameters": [ { "kind": "required", "name": "body", "type": "object", "example": "{\"partnerServiceId\":\"\",\"customerNo\":\"\",\"virtualAccountNo\":\"7001400002007131\",\"trxId\":\"2023123100000000000001\",\"totalAmount\":{\"value\":\"10000.00\",\"currency\":\"IDR\"},\"additionalInfo\":{\"tXidVA\":\"TNICEVA02302202312290922516148\",\"cancelMessage\":\"Cancel Virtual Account\"}}", "description": "", "customType": "deleteva_body", "schema": [ { "name": "partnerServiceId", "kind": "required", "type": "string", "description": "Partner Service ID / Prefix", "example": "" }, { "name": "customerNo", "kind": "required", "type": "string", "description": "Customer Number", "example": "" }, { "name": "virtualAccountNo", "kind": "required", "type": "string", "description": "Virtual Account Number", "example": "9912391111111111" }, { "name": "trxId", "kind": "required", "type": "string", "description": "Reference Number from Merchant", "example": "2020102900000000000001" }, { "name": "additionalInfo", "kind": "optional", "type": "object", "modelRef": "#/components/schemas/additionalInfoCancel", "customType": "additionalInfoCancel", "schema": [ { "name": "totalAmount", "kind": "optional", "type": "object", "modelRef": "#/components/schemas/additionalInfoStatus_totalAmount", "customType": "additionalInfoStatus_totalAmount", "schema": [ { "name": "value", "kind": "optional", "type": "string", "example": "10000.00" }, { "name": "currency", "kind": "optional", "type": "string", "example": "IDR" } ] }, { "name": "tXidVA", "kind": "optional", "type": "string", "example": "" }, { "name": "cancelMessage", "kind": "optional", "type": "string", "example": "" } ] } ], "modelRef": "#/components/schemas/deleteva_body", "complexItems": [ { "name": "object", "schema": [ { "name": "partnerServiceId", "kind": "required", "type": "string", "description": "Partner Service ID / Prefix", "example": "" }, { "name": "customerNo", "kind": "required", "type": "string", "description": "Customer Number", "example": "" }, { "name": "virtualAccountNo", "kind": "required", "type": "string", "description": "Virtual Account Number", "example": "9912391111111111" }, { "name": "trxId", "kind": "required", "type": "string", "description": "Reference Number from Merchant", "example": "2020102900000000000001" }, { "name": "additionalInfo", "kind": "optional", "type": "object", "modelRef": "#/components/schemas/additionalInfoCancel", "customType": "additionalInfoCancel", "schema": [ { "name": "totalAmount", "kind": "optional", "type": "object", "modelRef": "#/components/schemas/additionalInfoStatus_totalAmount", "customType": "additionalInfoStatus_totalAmount", "schema": [ { "name": "value", "kind": "optional", "type": "string", "example": "10000.00" }, { "name": "currency", "kind": "optional", "type": "string", "example": "IDR" } ] }, { "name": "tXidVA", "kind": "optional", "type": "string", "example": "" }, { "name": "cancelMessage", "kind": "optional", "type": "string", "example": "" } ] } ], "modelRef": "#/components/schemas/CancelVirtualAccount", "customType": "CancelVirtualAccount" }, { "name": "object", "schema": [] } ], "complexType": "allOf", "isExpanded": true } ], "formDataParameters": [], "oAuthParameters": [ { "id": "Authorization", "name": "Authorization", "kind": "optional", "type": "http", "scheme": "bearer" } ] }, "responses": [ { "statusCode": "200", "description": "Successful", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Successful", "code": "{\n \"responseCode\": \"2003100\",\n \"responseMessage\": \"Successful\",\n \"virtualAccountData\": {\n \"partnerServiceId\": \"\",\n \"customerNo\": \"\",\n \"virtualAccountNo\": \"7001400002007131\",\n \"trxId\": \"2023123100000000000001\",\n \"totalAmount\": {\n \"value\": \"10000.00\",\n \"currency\": \"IDR\"\n },\n \"additionalInfo\": {\n \"totalAmount\": {\n \"value\": \"10000.00\",\n \"currency\": \"IDR\"\n },\n \"tXidVA\": \"TNICEVA02302202312290922516148\",\n \"cancelMessage\": \"Cancel Virtual Account\",\n \"cancelVATime\": \"2023-12-29T09:22:51+07:00\"\n }\n }\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "SuccessCancel", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "2003100" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Successful" }, { "name": "virtualAccountData", "kind": "optional", "type": "object", "modelRef": "#/components/schemas/SuccessCancel_virtualAccountData", "customType": "SuccessCancel_virtualAccountData", "schema": [ { "name": "partnerServiceId", "kind": "optional", "type": "string", "description": "partnerServiceId", "example": "" }, { "name": "customerNo", "kind": "optional", "type": "string", "description": "customerNo", "example": "" }, { "name": "virtualAccountNo", "kind": "optional", "type": "string", "description": "virtualAccountNo", "example": "7001400002007725" }, { "name": "trxId", "kind": "optional", "type": "string", "description": "trxId", "example": "2023123100000000000001" }, { "name": "additionalInfo", "kind": "optional", "type": "object", "modelRef": "#/components/schemas/SuccessCancel_virtualAccountData_additionalInfo", "customType": "SuccessCancel_virtualAccountData_additionalInfo", "schema": [ { "name": "tXidVA", "kind": "optional", "type": "string", "description": "tXidVA", "example": "TNICEVA02302202403061508052242" }, { "name": "cancelMessage", "kind": "optional", "type": "string", "description": "tXidVA", "example": "cancel va" }, { "name": "cancelVATime", "kind": "optional", "type": "string", "description": "cancelVATime", "example": "2024-03-06T15:08:05+07:00" }, { "name": "totalAmount", "kind": "optional", "type": "object", "modelRef": "#/components/schemas/totalAmount", "customType": "totalAmount", "schema": [ { "name": "value", "kind": "optional", "type": "string", "example": "10000.00" }, { "name": "currency", "kind": "optional", "type": "string", "example": "IDR" } ] } ] } ] } ], "modelRef": "#/components/schemas/SuccessCancel", "isExpanded": true } ] }, { "statusCode": "202", "description": "Request In Progress", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Request In Progress", "code": "{\n \"responseCode\": \"202XX00\",\n \"responseMessage\": \"Request In Progress\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "RequestInProgress", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "202XX00" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Request In Progress" } ], "modelRef": "#/components/schemas/RequestInProgress", "isExpanded": true } ] }, { "statusCode": "409", "description": "Duplicate partnerReferenceNo", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Duplicate partnerReferenceNo", "code": "{\n \"responseCode\": \"409XX01\",\n \"responseMessage\": \"Duplicate partnerReferenceNo\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "DuplicatepartnerReferenceNo", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "409XX01" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Duplicate partnerReferenceNo" } ], "modelRef": "#/components/schemas/DuplicatepartnerReferenceNo", "isExpanded": true } ] }, { "statusCode": "500", "description": "General Error", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "General Error", "code": "{\n \"responseCode\": \"500XX00\",\n \"responseMessage\": \"General Error\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "GeneralError", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "500XX00" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "General Error" } ], "modelRef": "#/components/schemas/GeneralError", "isExpanded": true } ] }, { "statusCode": "504", "description": "Request Timeout", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Request Timeout", "code": "{\n \"responseCode\": \"504XX00\",\n \"responseMessage\": \"Request Timeout\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "RequestTimeout", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "504XX00" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Request Timeout" } ], "modelRef": "#/components/schemas/RequestTimeout", "isExpanded": true } ] } ] }, "children": [ { "text": "" } ] } [title] Create Virtual Account [path] NICEPAY API/API Playground/SNAP API Testing/Virtual Account/ { "id": "kCoZOzT4ptpROLK9MJZg_", "type": "api-oas-v2", "data": { "method": "POST", "url": "https://dev.nicepay.co.id/nicepay/api/v1.0/transfer-va/create-va", "servers": [ { "url": "https://dev.nicepay.co.id/nicepay/api/v1.0/transfer-va/create-va" }, { "url": "https://staging.nicepay.co.id/nicepay/api/v1.0/transfer-va/create-va" }, { "url": "https://www.nicepay.co.id/nicepay/v1.0/transfer-va/create-va" } ], "name": "Create Virtual Account", "description": "", "contentType": "application/json", "request": { "pathParameters": [], "headerParameters": [ { "kind": "required", "name": "X-TIMESTAMP", "type": "string", "example": "2022-08-04T23:59:59+07:00" }, { "kind": "required", "name": "X-SIGNATURE", "type": "string", "default": "RtZh3JLTde3laYpjI2zpLW854Dg7aPMXKH4PTnqVsgxUIOV0BVeBRQkG0CCpSSaJGKp16122ReEM9w2no4u4sg==" }, { "kind": "required", "name": "X-PARTNER-ID", "type": "string", "example": "IONPAYTEST" }, { "kind": "required", "name": "X-EXTERNAL-ID", "type": "string", "example": "20230804230101" }, { "kind": "required", "name": "CHANNEL-ID", "type": "string", "example": "IONPAYTEST" } ], "queryParameters": [], "bodyDataParameters": [ { "kind": "optional", "name": "body", "type": "object", "example": "{\"partnerServiceId\":\"\",\"customerNo\":\"\",\"virtualAccountNo\":\"\",\"virtualAccountName\":\"Jhon Doe\",\"trxId\":\"2023123100000000000001\",\"totalAmount\":{\"value\":\"10000.00\",\"currency\":\"IDR\"},\"additionalInfo\":{\"bankCd\":\"BMRI\",\"goodsNm\":\"John Doe\",\"dbProcessUrl\":\"https://dev.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp\",\"vacctValidDt\":\"\",\"vacctValidTm\":\"\",\"msId\":\"\",\"msFee\":\"\",\"msFeeType\":\"\",\"mbFee\":\"\",\"mbFeeType\":\"\"}}", "description": "", "customType": "createva_body", "schema": [ { "name": "partnerServiceId", "kind": "required", "type": "string", "example": "" }, { "name": "customerNo", "kind": "optional", "type": "string", "example": "" }, { "name": "virtualAccountNo", "kind": "required", "type": "string", "example": "" }, { "name": "virtualAccountName", "kind": "required", "type": "string", "example": "" }, { "name": "trxId", "kind": "required", "type": "string", "example": "" }, { "name": "totalAmount", "kind": "optional", "type": "object", "modelRef": "#/components/schemas/totalAmount", "customType": "totalAmount", "schema": [ { "name": "value", "kind": "optional", "type": "string", "example": "10000.00" }, { "name": "currency", "kind": "optional", "type": "string", "example": "IDR" } ] }, { "name": "additionalInfo", "kind": "optional", "type": "object", "modelRef": "#/components/schemas/additionalInfo", "customType": "additionalInfo", "schema": [ { "name": "bankCd", "kind": "optional", "type": "string", "example": "" }, { "name": "goodsNm", "kind": "optional", "type": "string", "example": "" }, { "name": "dbProcessUrl", "kind": "optional", "type": "string", "example": "" }, { "name": "vacctValidDt", "kind": "optional", "type": "string", "example": "" }, { "name": "vacctValidTm", "kind": "optional", "type": "string", "example": "" }, { "name": "msId", "kind": "optional", "type": "string", "example": "" }, { "name": "msFee", "kind": "optional", "type": "string", "example": "" }, { "name": "msFeeType", "kind": "optional", "type": "string", "example": "" }, { "name": "mbFee", "kind": "optional", "type": "string", "example": "" }, { "name": "mbFeeType", "kind": "optional", "type": "string", "example": "" } ] } ], "modelRef": "#/components/schemas/createva_body", "complexItems": [ { "name": "object", "schema": [ { "name": "partnerServiceId", "kind": "required", "type": "string", "example": "" }, { "name": "customerNo", "kind": "optional", "type": "string", "example": "" }, { "name": "virtualAccountNo", "kind": "required", "type": "string", "example": "" }, { "name": "virtualAccountName", "kind": "required", "type": "string", "example": "" }, { "name": "trxId", "kind": "required", "type": "string", "example": "" }, { "name": "totalAmount", "kind": "optional", "type": "object", "modelRef": "#/components/schemas/totalAmount", "customType": "totalAmount", "schema": [ { "name": "value", "kind": "optional", "type": "string", "example": "10000.00" }, { "name": "currency", "kind": "optional", "type": "string", "example": "IDR" } ] }, { "name": "additionalInfo", "kind": "optional", "type": "object", "modelRef": "#/components/schemas/additionalInfo", "customType": "additionalInfo", "schema": [ { "name": "bankCd", "kind": "optional", "type": "string", "example": "" }, { "name": "goodsNm", "kind": "optional", "type": "string", "example": "" }, { "name": "dbProcessUrl", "kind": "optional", "type": "string", "example": "" }, { "name": "vacctValidDt", "kind": "optional", "type": "string", "example": "" }, { "name": "vacctValidTm", "kind": "optional", "type": "string", "example": "" }, { "name": "msId", "kind": "optional", "type": "string", "example": "" }, { "name": "msFee", "kind": "optional", "type": "string", "example": "" }, { "name": "msFeeType", "kind": "optional", "type": "string", "example": "" }, { "name": "mbFee", "kind": "optional", "type": "string", "example": "" }, { "name": "mbFeeType", "kind": "optional", "type": "string", "example": "" } ] } ], "modelRef": "#/components/schemas/Create-VA", "customType": "Create-VA" }, { "name": "object", "schema": [] } ], "complexType": "allOf", "isExpanded": true } ], "formDataParameters": [], "oAuthParameters": [ { "id": "Authorization", "name": "Authorization", "kind": "optional", "type": "http", "scheme": "bearer" } ] }, "responses": [ { "statusCode": "200", "description": "Successful", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Successful", "code": "{\n \"responseCode\": \"2002700\",\n \"responseMessage\": \"Successful\",\n \"virtualAccountData\": {\n \"partnerServiceId\": \"\",\n \"customerNo\": \"\",\n \"virtualAccountNo\": \"70014000091511466666\",\n \"virtualAccountName\": \"Jhon Doe\",\n \"trxId\": \"2023123100000000000001\",\n \"totalAmount\": {\n \"value\": \"10000.00\",\n \"currency\": \"IDR\"\n },\n \"additionalInfo\": {\n \"bankCd\": \"BMRI\",\n \"tXidVA\": \"IONPAYTEST02202304271511466666\",\n \"goodsNm\": \"John Doe\",\n \"vacctValidDt\": \"20230429\",\n \"vacctValidTm\": \"151146\",\n \"msId\": \"\",\n \"msFee\": \"\",\n \"msFeeType\": \"\",\n \"mbFee\": \"\",\n \"mbFeeType\": \"\"\n }\n }\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "SuccessRegist", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "2002700" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Successful" }, { "name": "virtualAccountData", "kind": "optional", "type": "object", "modelRef": "#/components/schemas/SuccessRegist_virtualAccountData", "customType": "SuccessRegist_virtualAccountData", "schema": [ { "name": "partnerServiceId", "kind": "optional", "type": "string", "description": "partnerServiceId", "example": "" }, { "name": "customerNo", "kind": "optional", "type": "string", "description": "customerNo", "example": "" }, { "name": "virtualAccountNo", "kind": "optional", "type": "string", "description": "virtualAccountNo", "example": "7001400002007725" }, { "name": "trxId", "kind": "optional", "type": "string", "description": "trxId", "example": "2023123100000000000001" }, { "name": "totalAmount", "kind": "optional", "type": "object", "modelRef": "#/components/schemas/totalAmount", "customType": "totalAmount", "schema": [ { "name": "value", "kind": "optional", "type": "string", "example": "10000.00" }, { "name": "currency", "kind": "optional", "type": "string", "example": "IDR" } ] }, { "name": "additionalInfo", "kind": "optional", "type": "object", "modelRef": "#/components/schemas/SuccessRegist_virtualAccountData_additionalInfo", "customType": "SuccessRegist_virtualAccountData_additionalInfo", "schema": [ { "name": "bankCd", "kind": "optional", "type": "string", "description": "bankCd", "example": "BMRI" }, { "name": "tXidVA", "kind": "optional", "type": "string", "description": "tXidVA", "example": "TNICEVA02302202403061508052242" }, { "name": "goodsNm", "kind": "optional", "type": "string", "description": "goodsNm", "example": "Jhon Doe" }, { "name": "vacctValidDt", "kind": "optional", "type": "string", "description": "vacctValidDt", "example": "20240307" }, { "name": "vacctValidTm", "kind": "optional", "type": "string", "description": "vacctValidTm", "example": "150805" }, { "name": "msId", "kind": "optional", "type": "string", "description": "msId", "example": "" }, { "name": "msFee", "kind": "optional", "type": "string", "description": "msFee", "example": "" }, { "name": "msFeeType", "kind": "optional", "type": "string", "description": "msFeeType", "example": "" }, { "name": "mbFee", "kind": "optional", "type": "string", "description": "mbFee", "example": "" }, { "name": "mbFeeType", "kind": "optional", "type": "string", "description": "mbFeeType", "example": "" } ] } ] } ], "modelRef": "#/components/schemas/SuccessRegist", "isExpanded": true } ] }, { "statusCode": "202", "description": "Request In Progress", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Request In Progress", "code": "{\n \"responseCode\": \"202XX00\",\n \"responseMessage\": \"Request In Progress\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "RequestInProgress", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "202XX00" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Request In Progress" } ], "modelRef": "#/components/schemas/RequestInProgress", "isExpanded": true } ] }, { "statusCode": "409", "description": "Duplicate partnerReferenceNo", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Duplicate partnerReferenceNo", "code": "{\n \"responseCode\": \"409XX01\",\n \"responseMessage\": \"Duplicate partnerReferenceNo\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "DuplicatepartnerReferenceNo", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "409XX01" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Duplicate partnerReferenceNo" } ], "modelRef": "#/components/schemas/DuplicatepartnerReferenceNo", "isExpanded": true } ] }, { "statusCode": "500", "description": "General Error", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "General Error", "code": "{\n \"responseCode\": \"500XX00\",\n \"responseMessage\": \"General Error\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "GeneralError", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "500XX00" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "General Error" } ], "modelRef": "#/components/schemas/GeneralError", "isExpanded": true } ] }, { "statusCode": "504", "description": "Request Timeout", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Request Timeout", "code": "{\n \"responseCode\": \"504XX00\",\n \"responseMessage\": \"Request Timeout\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "RequestTimeout", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "504XX00" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Request Timeout" } ], "modelRef": "#/components/schemas/RequestTimeout", "isExpanded": true } ] } ] }, "children": [ { "text": "" } ] } [title] Transaction Status - API SNAP [path] NICEPAY API/API SNAP/NICEPAY Code - API SNAP/ **Transaction Status** digunakan untuk memeriksa status transaksi yang berjalan sesuai dengan metode pembayaran yang dipilih pada suatu transaksi dalam sistem NICEPAY khususnya API SNAP. Setiap metode transaksi memiliki status yang berbeda. Berikut adalah rincian kode status untuk setiap metode transaksi. # Payment *** ## Virtual Account | **Status Code** | **Response Message** | **Description** | | --------------- | -------------------- | ----------------------------------------------- | | `00` | Success | Transaksi sudah berhasil terbayar | | `03` | Pending | Transaksi yang belum terbayar | | `04` | Refunded | Transaksi yang sudah di-*refund* | | `05` | Canceled | Transaksi yang *invalid* atau sudah kedaluwarsa | | `06` | Failed | Transaksi yang gagal | ## E-Wallet | **Status Code** | **Response Message** | **Description** | | --------------- | -------------------- | ------------------------------------------------------------ | | `00` | Success | Transaksi sudah berhasil terbayar | | `01` | Initiated | Transaksi yang sedang dalam proses inisasi untuk dibayarkan | | `03` | Pending | Transaksi yang belum terbayar | | `04` | Refund | Transaksi yang sudah di-*refund* | | `05` | Canceled | Transaksi yang *invalid* atau sudah kedaluwarsa | | `06` | Failed | Transaksi yang gagal | ## QRIS | **Status Code** | **Response Message** | **Description** | | --------------- | -------------------- | ----------------------------------------------- | | `00` | Success | Transaksi sudah berhasil terbayar | | `03` | Pending | Transaksi yang belum terbayar | | `04` | Refund | Transaksi sudah di-*refund* | | `05` | Canceled | Transaksi yang *invalid* atau sudah kedaluwarsa | | `06` | Failed | Transaksi yang gagal | # Payout (Disbursement) *** | **Status Code** | **Response Message** | **Description** | | --------------- | -------------------- | ----------------------------------------------------------------------------- | | `00` | Success | Transaksi yang sudah di approved dan masuk dalam proses transfer disbursement | | `03` | Pending | Menunggu proses approval atau reject | | `04` | Canceled | Transaksi disbursement terjadwal yang dibatalkan | | `05` | Rejected | Transaksi yang di reject | | `08` | Pending (Suspect) | Transaksi yang statusnya masih belum pasti | | `09` | Failed | Transaksi disbursement yang gagal | [title] API QRIS SNAP [path] NICEPAY API/API SNAP/Payment API - SNAP/ # Tentang API QRIS SNAP *** Bagian ini berisi informasi terkait API QRIS dengan standar SNAP. # Daftar API QRIS SNAP *** ::::LinkArray :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-YRIUmWQzkVPyxVtS5nQYL-20240806-032310.jpg"} [Registration - API QRIS SNAP](docId\:n42BapM1t1eOiXNS-RA_d) digunakan untuk mengajukan pendaftaran pembayaran. ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-rqeJGrRRp2FImTC538cQT-20240806-032327.jpg"} [Notification - API QRIS SNAP](docId\:YjUncBpvXHbdxdoT3Na5o) digunakan untuk mengirimkan notifikasi transaksi pembayaran. ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-Hjn4VNColF1G3Hm98Fayq-20240806-032340.jpg"} [Check Status Transaction - API QRIS SNAP](docId:3aXWe6p6cyHX_ZuN-bvgQ) digunakan untuk memeriksa status transaksi. ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-PIfM0JXyVyyONRWNrlKuB-20240806-032356.jpg"} [Refund Transaction - API QRIS SNAP](docId\:U1UpkNC78XEyuHGD4CxPD) untuk melakukan pengembalian dana transaksi. ::: :::: # Alur Proses *** ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/pk_YXvGOxasJsdcgxe_Dm_nicepay-archbee-payment-qris-snap-1.png "Alur Proses API QRIS SNAP") Deskripsi langkah: 1. Merchant mengirimkan data *checkout *kepada Pelanggan. 2. Merchant mengajukan *access token* kepada NICEPAY. 3. NICEPAY melakukan *generate access token*. 4. NICEPAY mengirimkan *response access token* kepada Merchant 5. Merchant menerima akses token. 6. Merchant mengirimkan API untuk membuat QR kepada NICEPAY. 7. NICEPAY mengirimkan pengajuan pembuatan pemesanan pembayaran kepada Mitra QRIS. 8. Mitra QRIS melakukan *generate QR Code*. 9. Mitra QRIS mengirimkan *response *QR kepada NICEPAY. 10. NICEPAY mengirimkan *response *QR kepada Merchant. 11. Merchant menampilkan QR kepada Pelanggan. 12. Pelanggan memindai QR dan melakukan inisiasi pembayaran kepada Mitra QRIS. 13. Mitra QRIS menampilkan *response *pembayaran kepada Pelanggan. 14. Mitra QRIS mengirimkan *push notification* kepada NICEPAY. 15. NICEPAY melakukan validasi notifikasi. 16. NICEPAY mengajukan pemeriksaan status pembayaran kepada Mitra QRIS. 17. Mitra QRIS mengirimkan *response* status pembayaran kepada NICEPAY. 18. NICEPAY memperbaharui status. 19. NICEPAY mengirimkan *push notification* kepada Merchant. 20. Merchant mengajukan pemeriksaan status menggunakan API kepada NICEPAY. 21. NICEPAY mengirimkan *response *pemeriksaan status kepada Merchant. 22. Merchant menerima status terakhir. 23. Merchant mengirimkan konfirmasi perubahan status kepada Pelanggan. # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem Kunjungi halaman [API Virtual Account SNAP](docId:2XCcJFVmwY9jDmD6w09oN) untuk mengetahui informasi terkait standar API SNAP pada metode pembayaran Virtual Account. ::: :::VerticalSplitItem Kunjungi halaman [API E-Wallet (Direct Debit) SNAP](docId:24TJozvWeUtfoWWb2WN94) untuk mengetahui informasi terkait standar API SNAP pada metode pembayaran E-Wallet. ::: :::: [title] Reversal - API NICEPAY Inquiry Virtual Account SNAP [path] NICEPAY API/API SNAP/Advance API - SNAP/API NICEPAY Inquiry Virtual Account SNAP/ # Tentang Reversal - API NICEPAY Inquiry Virtual Account SNAP *** Bagian ini berisi tentang informasi terkait API dengan standar SNAP yang digunakan pada metode pembayaran Virtual Account dengan fitur NICEPAY Inquiry Virtual Account (NIVA) untuk mengirimkan notifikasi dari Bank kepada NICEPAY. Kemudian, NICEPAY akan mengirimkan notifikasi kepada Merchant terkait pengembalian dana/pembatalan terhadap pembayaran yang telah berhasil terbayar. Hal ini sangat jarang terjadi dan disebabkan kondisi tertentu pada Bank, sehingga pembayaran yang telah berhasil menjadi batal atau dilakukan pengembalian dana kembali kepada Pelanggan. Ketika mendapatkan notifikasi reversal, Merchant disarankan untuk membatalkan transaksi, menghubungi Pelanggan atau tindakan lain sesuai prosedur pada sisi Merchant. # Reversal - API NICEPAY Inquiry Virtual Account SNAP *** :::hint{type="warning"} Silakan mengajukan akses token terlebih dahulu untuk melakukan autentikasi melalui bagian [Request Access Token - API NICEPAY Inquiry Virtual Account SNAP](docId\:tbDHyMKVQK7C20nUkjB0N). ::: | **API Endpoint** | `[merchant-domain]/api/v1.0/transfer-va/reversal` | | ---------------- | ----------------------------------------------------- | | **Method** | `HTTP` `POST` | | **Description** | Untuk mengirimkan notifikasi reversal kepada Merchant | | **Content-type** | `application/json` | :::hint{type="info"} Pada saat melakukan proses integrasi, NICEPAY akan mengirimkan Public Key kepada Merchant. Kemudian, Merchant wajib memberi informasi terkait *endpoint *API Inquiry VA dan mengirimkan Client ID & Client Secret sesuai dengan spesifikasi NICEPAY kepada tim NICEPAY. Hal tersebut perlu dilakukan agar NICEPAY dapat mengajukan akses token dan melakukan *inquiry* data Pelanggan yang berada di sisi Merchant. Sehingga, proses pembayaran dapat dijalankan dengan lancar oleh Pelanggan Anda. ::: ## Request Reversal Header Parameter | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | **Contoh** | | --------------- | -------- | ---------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | | `Content-Type` | String | | Mandatory | `Application / JSON` | | | `Authorization` | String | | Mandatory | Bearer “`access_token`” | | | `X-TIMESTAMP` | String | | 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 | | Mandatory | Signature will be generated by Merchant.
[Panduan X-Signature - Symmetric](docId\:UZex33ReLyENKOgbJJnYp) | | | `X-PARTNER-ID` | String | 20 | Mandatory | `X-PARTNER-ID` = `CLIENT_ID` | | | `X-EXTERNAL-ID` | String | 40 | Mandatory | Unique Reference Number
(`41807553358950093184`) | | | `CHANNEL-ID` | String | | Mandatory | Unique Channel Merchant Credential ID Number.
Client ID + "01" = Channel ID
`"IONPAYTEST" + "01" = "IONPAYTEST01"` | IONPAYTEST01 | ## Request Reversal Body Parameter | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | -------------------- | -------- | ---------- | ------------- | ------------------------------------------------------------------------------- | | `partnerServiceId` | String | 20 | Mandatory | Partner Service ID / Prefix | | `customerNo` | String | 40 | Mandatory | Customer Number | | `virtualAccountNo` | String | 16 | Mandatory | Virtual Account Number. (If you have concern for VA number please call our PIC) | | `virtualAccountName` | String | 100 | Optional | Virtual Account Name | | `trxId` | String | 40 | Mandatory | Merchant Order Number | | `paymentRequestId` | String | 128 | Mandatory | Unique Identifier
from Nicepay | | `trxDateTime` | String | 25 | Optional | Transaction Date
Time | | `paidAmount` | Object | | Mandatory | | | `value` | String | 12 | Mandatory | Value | | `currency` | String | 3 | Mandatory | Currency | | `additionalInfo` | Object | | Mandatory | Additional Info
`"additionalInfo": { `
` ... `
` }` | | `bankCd` | String | 4 | Mandatory | [Bank Code - API SNAP](docId:9WOQy5-1hlf_uCwshSDHO) | ## Response Reversal Parameter | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | -------------------- | -------- | ---------- | ------------- | ------------------------------------------------------------------------------- | | `responseCode` | String | | Mandatory | [General Response Code and Message - API SNAP](docId\:lKqJXSl5CMKdXYXxHYYSs) | | `responseMessage` | String | | Mandatory | Response Message | | `virtualAccountData` | Object | | Mandatory | `"virtualAccountData": { `
`...}` | | `partnerServiceId` | String | 20 | Mandatory | Partner Service ID / Prefix | | `customerNo` | String | 40 | Mandatory | Customer Number | | `virtualAccountNo` | String | 16 | Mandatory | Virtual Account Number. (If you have concern for VA number please call our PIC) | | `virtualAccountName` | String | 100 | Mandatory | Virtual Account Name | | `trxId` | String | 40 | Mandatory | Reference Number from Merchant | | `paymentRequestId` | String | 128 | Mandatory | Unique Identifier from Nicepay | | `trxDateTime` | String | 25 | Optional | Transaction Date Time | | `paidAmount` | Object | | Mandatory | | | `value` | String | 12 | Mandatory | Value | | `currency` | String | 3 | Mandatory | Currency | | `additionalInfo` | Object | | Mandatory | `"additionalInfo": { `
` ... `
` }` | | `goodsNm` | String | 200 | Mandatory | Goods Name | ## Sample Parameter :::CodeblockTabs Sample Request ```json //HEADER SECTION Content-Type: application/json Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8= X-TIMESTAMP: 2024-12-31T10:11:40+07:00 X-SIGNATURE: ufBw7R8RhW79IOiV/Hlv607M60qzAYBv8uZmbSrYb6/Thlo/FhQVP4xRyelUehoSS9o+QS6vWTKb/ygtucC+tQ== X-PARTNER-ID : FIXOPEN001 X-EXTERNAL-ID: tXid202402111402271707638115 CHANNEL-ID: FIXOPEN001 { "partnerServiceId": "70151021", "customerNo": "10000001", "virtualAccountNo": "7015102110000001", "virtualAccountName": "John Test", "trxId": "abcdefgh1234", "paymentRequestId": "FIXOPEN0010000000006", "paidAmount": { "value": "10000.00", "currency": "IDR" }, "trxDateTime": "2024-02-01T15:40:06+07:00", "additionalInfo": { "bankCd": "BMRI" } } ``` Sample Response ```json { "responseCode": "2000000", "responseMessage": "Successful", "virtualAccountData": { "partnerServiceId": "70151021", "customerNo": "10000001", "virtualAccountNo": "7015102110000001", "virtualAccountName": "John Test", "paymentRequestId": "FIXOPEN0010000000006", "paidAmount": { "value": "100000.00", "currency": "IDR" }, "trxDateTime": "2024-02-01T15:40:06+07:00", "trxId": "abcdefgh1234" }, "additionalInfo": { "goodsNm": "Test" } } ``` ::: [title] Request Access Token API - SNAP [path] NICEPAY API/API SNAP/ # Tentang Request Access Token API - SNAP *** Bagian ini berisi tentang rincian terkait akses token dengan standar digunakan untuk melakukan , pemeriksaan , dan pengembalian dana. # Request Access Token API - SNAP *** ## Get Access Token | **Service Code** | [API SNAP Service Code](docId\:GcGqBIYXG1Etcd0Ji9cHX) | | ---------------- | -------------------------------------------------------------------------------------------- | | **API Endpoint** | [`/nicepay/v1.0/access-token/b2b`](https://dev.nicepay.co.id/nicepay/v1.0/access-token/b2b) | | **HTTP Method** | **POST** | | **Description** | Request Token for Authentication | | **Content-type** | `application/json` | ### API SNAP Service Code | **Service Code** | **API Reference** | | ---------------- | ----------------------------------------------------------------------------------------------------------------- | | `73` | [E-Wallet - Access Token](docId\:GcGqBIYXG1Etcd0Ji9cHX)
[QRIS - Access Token](docId\:GcGqBIYXG1Etcd0Ji9cHX) | | `11` | [Balance Inquiry - API Payout (Disbursement) SNAP](docId\:uqFOgB81BaLhYd0KgRAdc) | | `54` | [Registration - API E-Wallet (Direct Debit) SNAP](docId:66iE5aVXXL4uqw6hqFPVV) | | `55` | [Check Status Transaction - API E-Wallet (Direct Debit) SNAP](docId\:vB63D8suaKPYP-4bIOWx9) | | `58` | [Refund Transaction - API E-Wallet (Direct Debit) SNAP](docId:8-hlezmJtlz45LRJnXcEc) | | `47` | [Registration - API QRIS SNAP](docId\:n42BapM1t1eOiXNS-RA_d) | | `51` | [Check Status Transaction - API QRIS SNAP](docId:3aXWe6p6cyHX_ZuN-bvgQ) | | `78` | [Refund Transaction - API QRIS SNAP](docId\:U1UpkNC78XEyuHGD4CxPD) | ## Get Header ### Request Access Token Header | **Nama Parameter Header** | **Tipe** | **Atribut** | **Konten** | | ------------------------- | -------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `Content-Type` | String | Mandatory | `Application/json` | | `X-TIMESTAMP` | String | Mandatory | `YYYY-MM-DDTHH:MM:SS`
(2022-03-21T10:11:40+07:00) | | `X-CLIENT KEY` | String | Mandatory | Provided (`X-CLIENT `
`KEY` = `CLIENT_ID`) | | `X-SIGNATURE` | String | Mandatory | Generated by /
created using asymmetric
signature SHA256withRSA algorithm
(`Private_Key`, `stringToSign`)
`stringToSign `= `client ID` + “`\|`” + `X-TIMESTAMP` | ### Request Access Token Body | **Parameter** | **Tipe** | **Kebutuhan** | **Deskripsi** | | ---------------- | -------- | ------------- | --------------------------- | | `grantType` | String | Mandatory | Only “`client_credentials`” | | `additionalInfo` | Object | Optional | | ### Response Parameter | **Parameter BI** | **Parameter NICEPAY** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | ----------------- | --------------------- | -------- | ---------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------ | | `responseCode` | `responseCd` | String | | Optional | [General Response Code and Message - API SNAP](docId\:lKqJXSl5CMKdXYXxHYYSs)

Error code to specify error returned. | | `responseMessage` | `responseMsg` | String | | Optional | Response Message

Debug message to provide more | | `accessToken` | | String | 2048 | Mandatory | Sebuah *string* mewakili autorisasi dikeluarkan untuk Klien digunakan untuk mengakses *protected resources* | | `tokenType` | | String | | Mandatory | Token Type Value: “Bearer” | | `expiresIn` | | String | | Mandatory | Session expiry in seconds: `900`
(15 minutes) | ### Sample Parameter :::CodeblockTabs Sample Request ```json //HEADER SECTION Content-Type: application/json X-SIGNATURE: aFHq5SNdWO5Pq2vwZk4ztd9Cu3OvblG6NezGwLX3GC2mRJorDHPeZpR3V+RXrPC8ojcyCwQy01FSipmA8YdQvz1hOth7aekXzhigYCRNS34EHYEoFGD1YMHVFRvxn2Fu8HAd6wTvPNy2X2rbUS3hWrJsfa5cHu8wKVb7zPCuxNc= X-CLIENT-KEY : NORMALTEST X-TIMESTAMP: 2024-12-31T10:11:40+07:00 { "grantType": "client_credentials" "additionalInfo": { } } ``` Sample Response ```json { "responseCode": "2007300", "responseMessage": "Successful", "accessToken": "Xy8duZzAvv9bwDXxRxcb89tsuvk4MF4kx4lGfE4aCRVxR7XdERhbe1", "tokenType": "Bearer", "expiresIn": "900" } ``` ::: [title] Cancel Payout [path] NICEPAY API/API Playground/SNAP API Testing/Payout (Disbursement)/ { "id": "OpTKgcLtuCgh4u3vAcwmz", "type": "api-oas-v2", "data": { "method": "POST", "url": "https://dev.nicepay.co.id/nicepay/api/v1.0/transfer/cancel", "servers": [ { "url": "https://dev.nicepay.co.id/nicepay/api/v1.0/transfer/cancel" }, { "url": "https://staging.nicepay.co.id/nicepay/api/v1.0/transfer/cancel" }, { "url": "https://www.nicepay.co.id/nicepay/api/v1.0/transfer/cancel" } ], "name": "Cancel Payout", "description": "", "contentType": "application/json", "request": { "pathParameters": [], "headerParameters": [ { "kind": "required", "name": "X-TIMESTAMP", "type": "string", "example": "2022-08-28T10:11:40+07:00" }, { "kind": "required", "name": "X-SIGNATURE", "type": "string", "default": "EZWlWxuFbDZmRwsKa+PHO4aIfDOYpzHOFjfrS6NawXcs97ueHg/oKamThqCWoaxSZYkT8JuOJ6Jfoup21wLrLw==" }, { "kind": "required", "name": "X-PARTNER-ID", "type": "string", "example": "IONPAYTEST" }, { "kind": "required", "name": "X-EXTERNAL-ID", "type": "string", "example": "2023082823595903" }, { "kind": "required", "name": "CHANNEL-ID", "type": "string", "example": "IONPAYTEST" } ], "queryParameters": [], "bodyDataParameters": [ { "kind": "optional", "name": "body", "type": "object", "example": "{\"beneficiaryAccountNo\":\"903327200\",\"originalReferenceNo\":\"IONPAYTEST07202308301826504375\",\"merchantId\":\"IONPAYTEST\",\"originalPartnerReferenceNo\":\"ref-998294194\"}", "description": "", "customType": "cancel_payout_body", "schema": [ { "name": "merchantId", "kind": "required", "type": "string", "description": "Merchant identifier that is unique pereach merchant", "example": "" }, { "name": "originalReferenceNo", "kind": "required", "type": "string", "description": "Original transaction identifier on service provider system", "example": "" }, { "name": "originalPartnerReferenceNo", "kind": "required", "type": "string", "description": "Original transaction identifier on consumer system", "example": "" } ], "modelRef": "#/components/schemas/cancel_payout_body", "complexItems": [ { "name": "object", "schema": [ { "name": "merchantId", "kind": "required", "type": "string", "description": "Merchant identifier that is unique pereach merchant", "example": "" }, { "name": "originalReferenceNo", "kind": "required", "type": "string", "description": "Original transaction identifier on service provider system", "example": "" }, { "name": "originalPartnerReferenceNo", "kind": "required", "type": "string", "description": "Original transaction identifier on consumer system", "example": "" } ], "modelRef": "#/components/schemas/Cancel-Payout", "customType": "Cancel-Payout" }, { "name": "object", "schema": [] } ], "complexType": "allOf", "isExpanded": true } ], "formDataParameters": [], "oAuthParameters": [ { "id": "Authorization", "name": "Authorization", "kind": "optional", "type": "http", "scheme": "bearer" } ] }, "responses": [ { "statusCode": "200", "description": "Successful", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Successful", "code": "{\n \"responseCode\": \"2000000\",\n \"responseMessage\": \"Successful\",\n \"originalPartnerReferenceNo\": \"ref-998294194\",\n \"originalReferenceNo\": \"IONPAYTEST07202308301826504375\",\n \"beneficiaryAccountNo\": \"903327200\",\n \"beneficiaryName\": \"Test\",\n \"beneficiaryBankCode\": \"BBBA\",\n \"amount\": {\n \"value\": \"10000.00\",\n \"currency\": \"IDR\"\n }\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "SuccessfulCancelPayout", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "2000000" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Successful" }, { "name": "originalPartnerReferenceNo", "kind": "optional", "type": "string", "description": "Original Partner ReferenceNo", "example": "ref-998294194" }, { "name": "originalReferenceNo", "kind": "optional", "type": "string", "description": "Original ReferenceNo", "example": "IONPAYTEST07202308301826504375" }, { "name": "beneficiaryAccountNo", "kind": "optional", "type": "string", "description": "Beneficiary AccountNo", "example": "903327200" }, { "name": "beneficiaryName", "kind": "optional", "type": "string", "description": "Beneficiary Name", "example": "Test" }, { "name": "beneficiaryBankCode", "kind": "optional", "type": "string", "description": "Beneficiary BankCode", "example": "BBBA" }, { "name": "amount", "kind": "optional", "type": "object", "modelRef": "#/components/schemas/amount", "customType": "amount", "schema": [ { "name": "currency", "kind": "optional", "type": "string", "description": "Currency", "example": "IDR" }, { "name": "value", "kind": "optional", "type": "string", "description": "Value", "example": "10000.00" } ] } ], "modelRef": "#/components/schemas/SuccessfulCancelPayout", "isExpanded": true } ] }, { "statusCode": "202", "description": "Request In Progress", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Request In Progress", "code": "{\n \"responseCode\": \"202XX00\",\n \"responseMessage\": \"Request In Progress\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "RequestInProgress", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "202XX00" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Request In Progress" } ], "modelRef": "#/components/schemas/RequestInProgress", "isExpanded": true } ] }, { "statusCode": "409", "description": "Duplicate partnerReferenceNo", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Duplicate partnerReferenceNo", "code": "{\n \"responseCode\": \"409XX01\",\n \"responseMessage\": \"Duplicate partnerReferenceNo\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "DuplicatePartnerReferenceNo", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "409XX01" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Duplicate partnerReferenceNo" } ], "modelRef": "#/components/schemas/DuplicatePartnerReferenceNo", "isExpanded": true } ] }, { "statusCode": "500", "description": "General Error", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "General Error", "code": "{\n \"responseCode\": \"500XX00\",\n \"responseMessage\": \"General Error\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "GeneralError", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "500XX00" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "General Error" } ], "modelRef": "#/components/schemas/GeneralError", "isExpanded": true } ] }, { "statusCode": "504", "description": "Request Timeout", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Request Timeout", "code": "{\n \"responseCode\": \"504XX00\",\n \"responseMessage\": \"Request Timeout\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "RequestTimeout", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "504XX00" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Request Timeout" } ], "modelRef": "#/components/schemas/RequestTimeout", "isExpanded": true } ] } ] }, "children": [ { "text": "" } ] } [title] Mulai Segera [path] / ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/bt0OEKsOkBxS3VEZFBtNU_microsoftteams-image-23.png "Mulai Segera") # Selamat Datang di NICEPAY! ***Kami berkomitmen untuk fokus terhadap solusi pembayaran online serta memprioritaskan keamanan dan kenyamanan pelanggan Anda*** NICEPAY adalah penyedia jasa pembayaran *online *yang menyediakan solusi pembayaran *all-in-one*, yakni dengan mengintegrasikan berbagai metode pembayaran digital menjadi sebuah ekosistem pembayaran yang dapat digunakan oleh Merchant untuk pelanggannya. Dengan demikian, NICEPAY mampu membuat proses transaksi pembayaran menjadi lebih mudah dan aman demi memenuhi segala kebutuhan bisnis Anda. ::::LinkArray :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/-h76S9Zi6NEWxQhSePBP1_nicepay-product.jpg"} Penasaran dengan produk yang dimiliki oleh NICEPAY? Temukan rincian informasi [Produk NICEPAY](docId\:geGcTDX-FpQOROu1YHRR6) lebih lanjut. ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/nRA8dGQql_W-TYSFPhZJt_regist-as-a-merchant.jpg"} Tertarik untuk bekerja sama dengan NICEPAY? Segera [Daftar Sebagai Merchant](docId\:S2CT_wXC_zW5ypUcweI8k) dan dapatkan kemudahan dalam melakukan transaksi. ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/z5y3ubWcayF8TRLUKTkvB_api.jpg"} Ingin mencoba proses integrasi dengan API NICEPAY? Silakan ikuti tutorial [Hands On API](docId\:cx5Ql5EpfoykUFF_3r5pI) berikut. ::: :::: [title] Virtual Account [path] NICEPAY API/API Playground/SNAP API Testing/ [title] Payment API - SNAP [path] NICEPAY API/API SNAP/ # Tentang Payment API - SNAP *** Bagian ini berisi tentang informasi terkait API metode pembayaran dengan standar SNAP yang digunakan untuk melakukan transaksi pembayaran. # Daftar Payment API - SNAP *** ::::LinkArray :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-92yJx_zuD_ltzA9FJ_RKz-20240806-031524.jpg"} [API Virtual Account SNAP](docId:2XCcJFVmwY9jDmD6w09oN) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-LrntCQ4yz4wzA6llrxVWY-20240806-031543.jpg"} [API QRIS SNAP](docId:2fWhBt1oPDQeRmQJBODlU) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-d7s7XYX2BqdymRv4-dpta-20240806-031602.jpg"} [API E-Wallet (Direct Debit) SNAP](docId:24TJozvWeUtfoWWb2WN94) ::: :::: # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem Kunjungi halaman [Request Access Token API - SNAP](docId\:GcGqBIYXG1Etcd0Ji9cHX) untuk mengetahui rincian API SNAP untuk mendapatkan akses token. ::: :::VerticalSplitItem Kunjungi halaman [Payout API (Disbursement) - SNAP](docId\:pImeP_3g-q6QNBFmwvkOr) untuk mengetahui rincian API SNAP pada Payout. ::: :::: ::::VerticalSplit{layout="middle"} :::VerticalSplitItem Kunjungi halaman [Advance API - SNAP](docId\:iytnF1uTXSDGwvjRVS62b) untuk mengetahui rincian API SNAP yang lebih terdepan. ::: :::VerticalSplitItem ::: :::: [title] Payment - API NICEPAY Inquiry Convenience Store SNAP [path] NICEPAY API/API SNAP/Advance API - SNAP/API NICEPAY Inquiry Convenience Store SNAP/ # Tentang Payment - API NICEPAY Inquiry Convenience Store SNAP *** Bagian ini berisi tentang terkait dengan standar digunakan pada dengan fitur Inquiry (NICO) memberikan kebebasan untuk menyimpan data dan membuat nomor sendiri di nya selama masih mengikuti ketentuan pembuatan nomor CVS dari . # Payment - API NICEPAY Inquiry Convenience Store SNAP :::hint{type="warning"} mengajukan akses token terlebih dahulu untuk melakukan autentikasi melalui [Request Access Token - API NICEPAY Inquiry Convenience Store SNAP](docId\:Bo7josDlhHB-_TMdE6TGS). ::: | **API Endpoint** | `https://[merchant-domain]/api/v.1.0/cvs/payment` | | ---------------- | ------------------------------------------------- | | **Method** | `POST` | | **Description** | Untuk melakukan NICO | | **Content-type** | `application/json` | :::hint{type="info"} Pada saat melakukan , akan mengirimkan Public Key kepada . Kemudian, wajib memberi terkait *endpoint * Inquiry CVS dan mengirimkan Client ID & Client Secret sesuai dengan spesifikasi kepada tim . Hal tersebut perlu dilakukan agar dapat mengajukan akses token dan melakukan *inquiry* data berada di sisi . Sehingga, dapat dijalankan dengan lancar oleh . ::: ## Request Payment Transaction Header Parameter | **Parameter** | **Tipe** | **Kebutuhan** | **Deskripsi** | **Contoh** | | --------------- | -------- | ------------- | ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `Content-Type` | String | Mandatory | String Media Type of Resource | `application/json` | | `Authorization` | String | Mandatory | Access Token Transaction | Bearer "accessToken" | | `X-TIMESTAMP` | String | Mandatory | Timezone | `YYYY-MM-DDTHH:MM:SS`
(2024-01-22T15:00:01+07:00) | | `X-PARTNER-ID` | String | Mandatory | ID | IONPAYTEST | | `X-SIGNATURE` | String | Mandatory | Signature | Generated by /
created using asymmetric
signature SHA256withRSA algorithm
(`Private_Key`, `stringToSign`)
`stringToSign `= `client ID` + “`\|`” + `X-TIMESTAMP` | | `X-EXTERNAL-ID` | String | Mandatory | Reference Number that should be unique in every | 11245542345212 | | `CHANNEL-ID` | String | Mandatory | Device identification on which s | IONPAYTEST | ## Request Payment Transaction Body Parameter | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | --------------------- | -------- | ---------- | ------------- | ------------------------------------------- | | `partnerServiceId` | String | 4 | Mandatory | Prefix | | `customerNo` | String | 8 | Mandatory | Number | | `payNo` | String | 12 | Mandatory | payNo Number | | `payNoName` | String | 100 | Mandatory | payNo Name | | `goodsName` | String | 200 | Mandatory | Goods Name | | `payNoPhone` | String | 15 | Mandatory | payNo Phone | | `payNoEmail` | String | 100 | Mandatory | payNo Email | | `partnerReferenceNo` | String | 40 | Mandatory | Reference Number | | `paymentRequestId` | String | 30 | Mandatory | TXID (Transaction ID Generated by } | | `paidAmount` | String | | Mandatory | Paid Amount | | `value` | String | 12 | Mandatory | Transaction Amount | | `currency` | String | 3 | Mandatory | Currency | | `transactionDateTime` | String | 25 | Mandatory | Transaction Date Time | | `mitraCd` | String | 4 | Mandatory | [Mitra Code](docId\:Tm257gq3DxgZf98uZ0l33) | ## Response Payment Transaction Body Parameter | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | --------------------- | -------- | ---------- | ------------- | ------------------------------------------- | | `responseCode` | String | 5 | Mandatory | Response Code | | `responseMessage` | String | 100 | Mandatory | Response Message | | `payNoData` | Object | | Mandatory | payNo Data | | `partnerServiceId` | String | 4 | Mandatory | Prefix | | `customerNo` | String | 8 | Mandatory | Number | | `payNo` | String | 12 | Mandatory | payNo Number | | `payNoName` | String | 100 | Mandatory | payNo Name | | `goodsName` | String | 200 | Mandatory | Goods Name | | `payNoPhone` | Number | 15 | Mandatory | payNo Phone | | `payNoEmail` | String | 100 | Mandatory | payNo Email | | `partnerReferenceNo` | String | 40 | Mandatory | Reference Number | | `paymentRequestId` | String | 30 | Mandatory | TXID (Transaction ID Generated by } | | `paidAmount` | Object | | Mandatory | Paid Amount | | `value` | String | 12 | Mandatory | Transaction Amount | | `currency` | String | 3 | Mandatory | Currency | | `transactionDateTime` | String | 25 | Mandatory | Transaction Date Time | | `mitraCd` | String | 4 | Mandatory | [Mitra Code](docId\:Tm257gq3DxgZf98uZ0l33) | ## Sample Parameter :::CodeblockTabs JSON Request ```json { "partnerServiceId": "7015", "customerNo": "89101110", "payNo": "701589101110", "payNoName": "John Test", "goodsName": "Pembelian John Test", "payNoPhone": "087771122333", "payNoEmail": "jhon@test.com", "partnerReferenceNo": "abcdefgh1234", "paymentRequestId": "IONPAYTEST03202212021529034686", "paidAmount": { "value": "10000.00", "currency": "IDR" }, "transactionDateTime": "2014-07-03T12:08:56+07:00", "mitraCd": "ALMA" } ``` JSON Response ```json { "responseCode": "2000000", "responseMessage": "Successful", "payNoData": { "partnerServiceId": "7015", "customerNo": "89101110", "payNo": "701589101110", "payNoName": "John Test", "payNoPhone": "087771122333", "payNoEmail": "jhon@test.com", "partnerReferenceNo": "abcdefgh1234", "paymentRequestId": "IONPAYTEST03202212021529034686", "paidAmount": { "value": "100000.00", "currency": "IDR" }, "transactionDateTime": "2019-07-03T12:08:56+07:00", "mitraCd": "ALMA" } } ``` ::: [title] Payment Method Code - API SNAP [path] NICEPAY API/API SNAP/NICEPAY Code - API SNAP/ Kode metode pembayaran ini digunakan sebagai sarana transaksi dalam sistem NICEPAY. Saat ini, NICEPAY telah memiliki 8 metode pembayaran yang tersedia, yaitu Kartu Kredit (CC), Virtual Account, Convenience Store, Direct Debit, E-Wallet, Payloan, GPN, dan QRIS. Berikut ini adalah *value* yang dapat digunakan untuk mengisi parameter `paymentMehod` pada API NICEPAY. # General *** | **Value** | **Deskripsi** | **Kanal Pembayaran** | | --------- | ------------------------------------------------------------------------------------------------------------- | ----------------------------------------- | | `00` | Seluruh metode pembayaran yang aktif, Pelanggan dapat memilih metode pembayaran di halaman pembayaran NICEPAY | Seluruh kanal pembayaran yang aktif | | `01` | Credit Card | *Acquiring*: Mandiri, BNI, BCA, CIMB, BRI | | `02` | Virtual Account | | | `03` | CVS (Convenience Store) / Retail | Alfamart, Indomaret | | `04` | Direct Debit | Jenius, BCA KlikPay | | `05` | E-Wallet | OVO, DANA, LinkAja, ShopeePay, AstraPay | | `06` | Payloan | Akulaku, Kredivo, Indodana | | `08` | QRIS | ShopeePay | | `09` | GPN Card | Artajasa | [title] Inquiry Payout [path] NICEPAY API/API Playground/SNAP API Testing/Payout (Disbursement)/ { "id": "5Ft6epiT1Huw6a4yT4TeU", "type": "api-oas-v2", "data": { "method": "POST", "url": "https://dev.nicepay.co.id/nicepay/api/v1.0/transfer/inquiry", "servers": [ { "url": "https://dev.nicepay.co.id/nicepay/api/v1.0/transfer/inquiry" }, { "url": "https://staging.nicepay.co.id/nicepay/api/v1.0/transfer/inquiry" }, { "url": "https://www.nicepay.co.id/nicepay/api/v1.0/transfer/inquiry" } ], "name": "Inquiry Payout", "description": "", "contentType": "application/json", "request": { "pathParameters": [], "headerParameters": [ { "kind": "required", "name": "X-TIMESTAMP", "type": "string", "example": "2022-08-04T23:59:59+07:00" }, { "kind": "required", "name": "X-SIGNATURE", "type": "string", "default": "sR4reWIkmnsLnxSwOLhufO4FoniFn3vvFUV09sF7t5oMyznWePqruGneOTahZLHX8Er8WIRYcuROGg37DnNRkw==" }, { "kind": "required", "name": "X-PARTNER-ID", "type": "string", "example": "IONPAYTEST" }, { "kind": "required", "name": "X-EXTERNAL-ID", "type": "string", "example": "2023082823595902" }, { "kind": "required", "name": "CHANNEL-ID", "type": "string", "example": "IONPAYTEST" } ], "queryParameters": [], "bodyDataParameters": [ { "kind": "optional", "name": "body", "type": "object", "example": "{\"beneficiaryAccountNo\":\"903327200\",\"originalReferenceNo\":\"IONPAYTEST07202308301826504375\",\"merchantId\":\"IONPAYTEST\",\"originalPartnerReferenceNo\":\"ref-998294194\"}", "description": "", "customType": "inquiry_payout_body", "schema": [ { "name": "merchantId", "kind": "required", "type": "string", "description": "Merchant identifier that is unique pereach merchant", "example": "" }, { "name": "originalReferenceNo", "kind": "required", "type": "string", "description": "Original transaction identifier on service provider system", "example": "" }, { "name": "originalPartnerReferenceNo", "kind": "required", "type": "string", "description": "Original transaction identifier on consumer system", "example": "" }, { "name": "beneficiaryAccountNo", "kind": "required", "type": "string", "description": "Beneficiary Account Number", "example": "" } ], "modelRef": "#/components/schemas/inquiry_payout_body", "complexItems": [ { "name": "object", "schema": [ { "name": "merchantId", "kind": "required", "type": "string", "description": "Merchant identifier that is unique pereach merchant", "example": "" }, { "name": "originalReferenceNo", "kind": "required", "type": "string", "description": "Original transaction identifier on service provider system", "example": "" }, { "name": "originalPartnerReferenceNo", "kind": "required", "type": "string", "description": "Original transaction identifier on consumer system", "example": "" }, { "name": "beneficiaryAccountNo", "kind": "required", "type": "string", "description": "Beneficiary Account Number", "example": "" } ], "modelRef": "#/components/schemas/Inquiry-Payout", "customType": "Inquiry-Payout" }, { "name": "object", "schema": [] } ], "complexType": "allOf", "isExpanded": true } ], "formDataParameters": [], "oAuthParameters": [ { "id": "Authorization", "name": "Authorization", "kind": "optional", "type": "http", "scheme": "bearer" } ] }, "responses": [ { "statusCode": "200", "description": "Successful", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Successful", "code": "{\n \"responseCode\": \"2000000\",\n \"responseMessage\": \"Successful\",\n \"originalPartnerReferenceNo\": \"ref-998294194\",\n \"originalReferenceNo\": \"IONPAYTEST07202308301826504375\",\n \"beneficiaryAccountNo\": \"903327200\",\n \"beneficiaryName\": \"Test\",\n \"beneficiaryBankCode\": \"BBBA\",\n \"beneficiaryCustomerResidence\": \"1\",\n \"beneficiaryCustomerType\": \"1\",\n \"amount\": {\n \"value\": \"10000.00\",\n \"currency\": \"IDR\"\n },\n \"latestTransactionStatus\": \"03\",\n \"transactionStatusDesc\": \"Pending\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "SuccessfulInquiryPayout", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "2000000" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Successful" }, { "name": "originalPartnerReferenceNo", "kind": "optional", "type": "string", "description": "Original Partner ReferenceNo", "example": "ref-998294194" }, { "name": "originalReferenceNo", "kind": "optional", "type": "string", "description": "Original ReferenceNo", "example": "IONPAYTEST07202308301826504375" }, { "name": "beneficiaryAccountNo", "kind": "optional", "type": "string", "description": "Beneficiary AccountNo", "example": "903327200" }, { "name": "beneficiaryName", "kind": "optional", "type": "string", "description": "Beneficiary Name", "example": "Test" }, { "name": "beneficiaryBankCode", "kind": "optional", "type": "string", "description": "Beneficiary BankCode", "example": "BBBA" }, { "name": "beneficiaryCustomerResidence", "kind": "optional", "type": "string", "description": "Beneficiary Customer Residence", "example": "1" }, { "name": "beneficiaryCustomerType", "kind": "optional", "type": "string", "description": "Beneficiary Customer Type", "example": "1" }, { "name": "amount", "kind": "optional", "type": "object", "modelRef": "#/components/schemas/amount", "customType": "amount", "schema": [ { "name": "currency", "kind": "optional", "type": "string", "description": "Currency", "example": "IDR" }, { "name": "value", "kind": "optional", "type": "string", "description": "Value", "example": "10000.00" } ] }, { "name": "latestTransactionStatus", "kind": "optional", "type": "string", "description": "Latest Transaction Status", "example": "03" }, { "name": "transactionStatusDesc", "kind": "optional", "type": "string", "description": "Transaction Status Desc", "example": "Pending" } ], "modelRef": "#/components/schemas/SuccessfulInquiryPayout", "isExpanded": true } ] }, { "statusCode": "202", "description": "Request In Progress", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Request In Progress", "code": "{\n \"responseCode\": \"202XX00\",\n \"responseMessage\": \"Request In Progress\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "RequestInProgress", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "202XX00" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Request In Progress" } ], "modelRef": "#/components/schemas/RequestInProgress", "isExpanded": true } ] }, { "statusCode": "409", "description": "Duplicate partnerReferenceNo", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Duplicate partnerReferenceNo", "code": "{\n \"responseCode\": \"409XX01\",\n \"responseMessage\": \"Duplicate partnerReferenceNo\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "DuplicatePartnerReferenceNo", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "409XX01" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Duplicate partnerReferenceNo" } ], "modelRef": "#/components/schemas/DuplicatePartnerReferenceNo", "isExpanded": true } ] }, { "statusCode": "500", "description": "General Error", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "General Error", "code": "{\n \"responseCode\": \"500XX00\",\n \"responseMessage\": \"General Error\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "GeneralError", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "500XX00" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "General Error" } ], "modelRef": "#/components/schemas/GeneralError", "isExpanded": true } ] }, { "statusCode": "504", "description": "Request Timeout", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Request Timeout", "code": "{\n \"responseCode\": \"504XX00\",\n \"responseMessage\": \"Request Timeout\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "RequestTimeout", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "504XX00" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Request Timeout" } ], "modelRef": "#/components/schemas/RequestTimeout", "isExpanded": true } ] } ] }, "children": [ { "text": "" } ] } [title] NICEPAY Code - API SNAP [path] NICEPAY API/API SNAP/ **NICEPAY Code** adalah kumpulan daftar parameter yang digunakan dalam sistem atau metode pembayaran tertentu pada sistem NICEPAY khusus API SNAP. ::::LinkArray :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v--SOEUBZwwMEkMQqGXxCJD-20240805-072046.jpg"} [General Response Code and Message - API SNAP](docId\:lKqJXSl5CMKdXYXxHYYSs) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-OKpS8QxhOWifD0LRVWnvM-20240805-072106.jpg"} [Transaction Status - API SNAP](docId\:XxlWrB0Q8XVkSMaO7ti9a) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-BoBy6-UXYXrsGIkyPQXFz-20240805-072128.jpg"} [Payout Beneficiary Merchant Category - API SNAP](docId\:ssuh0x_z-mldNvFs0wL5H) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-110zgyjduf9ZPDBFdURgB-20240805-072152.jpg"} [Bank Code - API SNAP](docId:9WOQy5-1hlf_uCwshSDHO) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-o5TEjI6Ak3rqQWgCdSM-q-20240805-072207.jpg"} [Mitra Code - API SNAP](docId\:mebNfCDEq1GFUs9oE_MOF) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-qgxdNY9eNrDU03w35P3Fr-20240805-072223.jpg"} [Installment Type Code - API SNAP](docId\:kfL_CouKaNqNU1qyZnBCF) ::: :::: [title] Request Access Token [path] NICEPAY API/API Playground/SNAP API Testing/ [title] SNAP Library [path] NICEPAY API/NICEPAY Library/ menyediakan SDK untuk memudahkan dan mempercepat dengan . Library dapat diunduh melalui tautan terlampir. Hingga saat ini, telah menyediakan Library untuk: ::::LinkArray{contentSource="CUSTOM"} :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/7KPo00xw11eUqLvRMgxHj_7.png"} [Python SNAP Library](https://github.com/nicepay-dev/python-nicepay) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/Fp2zqtHadTeEeSRsX2dR__8.png"} [NodeJS SNAP Library](https://github.com/nicepay-dev/nodejs-nicepay) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/vNFHerdiZmpUSbBdcu8pD_kotlin.jpg"} [Kotlin SNAP Library](https://github.com/nicepay-dev/kotlin-nicepay) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/Cg-kF12HyuGTIrlmHOEUN_golang-img.png"} [Golang SNAP Library](https://github.com/nicepay-dev/golang-nicepay) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/PMLBh6SJl6NIaJh9QpWYG_6.png"} [PHP SNAP Library](https://github.com/nicepay-dev/nativephp-nicepay) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/ZWXeiP7hOdEcIrsnLTy0F_4.png"} [Java SNAP Library](https://github.com/nicepay-dev/java-nicepay) ::: :::: :::hint{type="info"} kunjungi [NICEHub](docId\:LhDLrrC4HO1GT8pM-YRhZ) untuk mendapatkan mengenai plugin *third party *lainnya. ::: [title] Notification - API QRIS SNAP [path] NICEPAY API/API SNAP/Payment API - SNAP/API QRIS SNAP/ # Tentang Notification - API QRIS SNAP *** API dengan standar SNAP ini digunakan untuk mengirimkan notifikasi transaksi pembayaran pada metode pembayaran QRIS. # Panduan Validasi X-SIGNATURE *** Berikut adalah cara untuk melakukan validasi X-SIGNATURE pada Request Header Notify: `SHA256withRSA (Public_Key, stringToSign) stringToSign = client_ID + “|” + X-TIMESTAMP` :::hint{type="warning"} Informasi khusus API Notifikasi SNAP terkait kredensial `Public_Key` akan diberikan oleh tim NICEPAY kepada Merchant melalui email, karena kredensial `Public_Key` yang akan digunakan di API Notifikasi SNAP berbeda dengan API Transaksi SNAP (Registration, Inquiry & Payment). Silakan menghubungi Tim Integrasi melalui email ([integration@nicepay.co.id](mailto\:integration@nicepay.co.id)) untuk informasi atau bantuan lebih lanjut. ::: Berikut adalah contoh hasil X-SIGNATURE dari cara validasi di atas: `mYyscWBs00bm0TJQ/xY7Uu1Goh8qXJyYSlo88rFrhQ+mlyQkMtq NKMlZDpS+` # Merchant Notification - API QRIS SNAP *** | **Service Code** | `52` | | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **API Endpoint** | `[merchant-domain]/api/v1.0/qr/qr-mpm-notify` | | **HTTP Method** | `POST` | | **Content-type** | `application/json` | | **Description** | Transaction Result Notification (when success)

If your use firewall, add allow policy for IP =
IP Public environtment Production:
`103.20.51.34`
`103.20.51.33`
`18.98.96.50`

IP Public environtment Dev:
`103.20.51.39`
`103.20.51.40`
`18.98.96.54` | ## Request Header Parameter for Notification - API QRIS SNAP *** | **Parameter** | **Tipe** | **Kebutuhan** | **Deskripsi** | | -------------- | -------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `Content-Type` | String | Mandatory | `Application / JSON` | | `X-TIMESTAMP` | String | 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-CLIENT-KEY` | String | Mandatory | Unique Partner ID, Partner ID = Client ID | | `X-SIGNATURE` | String | Mandatory | Signature will be generated by Merchant.
[Panduan X-Signature - Symmetric](docId\:UZex33ReLyENKOgbJJnYp) | ## Request Body Parameter for Notification - API QRIS SNAP *** | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | ---------------------------- | -------- | ---------- | ------------- | ----------------------------------------------------------------------------------------------------------------- | | `originalReferenceNo` | String | 40 | Mandatory | Original transaction identifier on service
provider system | | `originalPartnerReferenceNo` | String | 40 | Mandatory | Original transaction identifier on consumer
system | | `amount` | Object | Variable | Mandatory | Amount of transaction | | `value` | String | 12 | Mandatory | Value | | `currency` | String | 3 | Mandatory | Currency | | `latestTransactionStatus` | String | 2 | Mandatory | Category code for the status of the
transaction.
Example :
`00`- Success
`05`- Cancelled | | `transactionStatusDesc` | String | 50 | Optional | Description status transaction | | `externalStoreId` | String | 32 | Mandatory | Unique identifier of shop id in client system | | `additionalInfo` | Object | Variable | Mandatory | Additional information | | `transactionDateTime` | String | 25 | Optional | Transaction Date Using ISO-8601 Format
`YYYY-MM-DDTHH:MM:SS` | | `paymentTrxSn` | Object | 32 | Mandatory | Payment Transaction Number from Acquiring
side | | `userId` | String | 128 | Optional | QRIS User ID | ## Response Header Parameter for Notification - API QRIS SNAP *** | **Parameter** | **Tipe** | **Kebutuhan** | **Deskripsi** | | -------------- | -------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `Content-Type` | String | Mandatory | `Application / JSON` | | `X-TIMESTAMP` | String | 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`. | ## Response Body Parameter for Notification - API QRIS SNAP *** | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | ----------------- | -------- | ---------- | ------------- | ---------------------------------------------------------------------------- | | `responseCode` | String | 7 | Mandatory | [General Response Code and Message - API SNAP](docId\:lKqJXSl5CMKdXYXxHYYSs) | | `responseMessage` | String | 150 | Mandatory | Response Message | ## Sample Parameter for Notification - API QRIS SNAP *** ### Request Parameter :::CodeblockTabs cURL ```curl curl -X POST \ '[merchant-domain]/api/v1.0/qr/qr-mpm-notify' \ -H 'Content-Type: application/json' \ -H 'X-TIMESTAMP: 2023-11-23T07:44:11+07:00' \ -H 'X-SIGNATURE: 85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5' \ -H 'X-CLIENT-KEY: 82150823919040624621823174737537' \ -d '{ "originalReferenceNo": "TNICEQR08108202210141451109841", "originalPartnerReferenceNo": "2020102900000000000001", "latestTransactionStatus": "00", "transactionStatusDesc": "success", "amount": { "value": "12345678.00", "currency": "IDR" }, "externalStoreId": "124928924949487", "additionalInfo": { "transactionDateTime": "2019-07-03T12:08:56-07:00", "paymentTrxSn": "07202210051341224326", "userId": "13naUASIQBIH341bdjashf1204gkjbcas" } }' ``` ::: ### Response Parameter :::CodeblockTabs Sample Response ```json { "responseCode": "2005200", "responseMessage": "Success" } ``` ::: [title] NICEPAY Library [path] NICEPAY API/ NICEPAY menyediakan SDK untuk memudahkan dan mempercepat proses integrasi dengan Merchant. NICEPAY Library terbagi menjadi 2 kategori, yaitu Library khusus SNAP dan Non-SNAP. ::::LinkArray{contentSource="CUSTOM"} :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-TlMBbmTvL24RPAVyCk271-20240823-083254.jpg"} [SNAP Library](docId\:ZszbQT0mHb_7Su1xSMfKl) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-ux-ldhlvB9HVD-uvs0zye-20240823-083304.jpg"} [Non-SNAP Library](docId:3KdE7GyJljSDNo9z9Zs04) ::: :::: *** ::::hint{type="info"} :::Iframe{iframeHeight="0" code="Silakan kunjungi NICEHub untuk mendapatkan informasi mengenai plugin integrasi third-party lainnya."NICEPAY"} ::: :::: [title] Check Status Transaction - API QRIS SNAP [path] NICEPAY API/API SNAP/Payment API - SNAP/API QRIS SNAP/ # Tentang Check Status Transaction - API QRIS SNAP *** API dengan standar SNAP ini digunakan untuk memeriksa status transaksi pembayaran pada metode pembayaran QRIS. # Check Status Transaction - API QRIS SNAP *** :::hint{type="warning"} Silakan mengajukan akses token terlebih dahulu sebelum melakukan pemeriksaan status transaksi (Check Status Transaction API) melalui bagian [Request Access Token API - SNAP](docId\:GcGqBIYXG1Etcd0Ji9cHX). ::: | **Service Code** | `47` | | ---------------- | ----------------------------------- | | **API Endpoint** | `/nicepay/api/v1.0/qr/qr-mpm-query` | | **HTTP Method** | **POST** | | **Description** | Check Status Transaction API | | **Content-type** | `application/json` | ## Request Header Parameter for Check Status Transaction - API QRIS SNAP *** | **Nama Parameter Header** | **Tipe** | **Kebutuhan** | **Deskripsi** | **Contoh** | | ------------------------- | ----------------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | | `Content-Type` | String (127) | Mandatory | Type of the content | `Application/Json` | | `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`. | | | `Authorization` | String (Variable) | Mandatory | "Bearer" + \{`access_token`} | | | `X-SIGNATURE` | String (Variable) | Mandatory | Signature will be generated by Merchant.
[Panduan X-Signature - Symmetric](docId\:UZex33ReLyENKOgbJJnYp) | | | `X-PARTNER-ID` | String(20) | Mandatory | NICEPAY Client ID (`MID`) | IONPAYTEST | | `X-EXTERNAL-ID` | String (40) | Mandatory | Unique messaging Reference ID generated by Merchant. Numeric String. Reference number that should be unique in every transaction in One Day. | | | `CHANNEL-ID` | String (20) | Mandatory | Unique Channel Merchant Credential ID Number.
Client ID + "01" = Channel ID
`"IONPAYTEST" + "01" = "IONPAYTEST01"` | IONPAYTEST01 | ## Request Body Parameter for Check Status Transaction - API QRIS SNAP *** | **Nama Parameter BI** | **Tipe Parameter** | **Kebutuhan** | **Parameter NICEPAY** | **Deskripsi ** | **Contoh** | | ---------------------------- | ------------------ | ------------- | --------------------- | ----------------------------------------------------------------------------- | --------------------------------- | | `originalReferenceNo` | String
(40) | Mandatory | `tXid` | NICEPAY Transaction ID or Identifier | IONPAYTEST08202106091121206416 | | `originalPartnerReferenceNo` | String
(40) | Mandatory | `referenceNo` | Unique Transaction ID from Merchant | ncpy20221017161458 | | `merchantId` | String
(10) | Mandatory | `iMid` | NICEPAY Merchant ID | IONPAYTEST | | `externalStoreId` | String
(32) | Mandatory | `storeCd` | Merchant ID from Acquirer Pay Side | NICEPAY | | `serviceCode` | String
(2) | Mandatory | - | Transaction Type Indicator (service code of the original transaction request) | 47 | | `additionalInfo` | Object | Mandatory | - | | `"additionalInfo": { `
` }` | ## Response Parameter for Check Status Transaction - API QRIS SNAP *** | **Nama Parameter BI** | **Tipe Parameter** | **Kebutuhan** | **Parameter NICEPAY** | **Deskripsi** | **Contoh** | | ---------------------------- | ------------------ | ------------- | --------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- | | `responseCode` | String (7) | Mandatory | `responseCd` | Error Code to Specify the Error Returned
[General Response Code and Message - API SNAP](docId\:lKqJXSl5CMKdXYXxHYYSs) | 2005100 | | `responseMessage` | String (150) | Mandatory | `responseMsg` | Debug Message to Provide More Information | Successful | | `originalReferenceNo` | String (40) | Mandatory | `tXid` | NICEPAY Transaction ID or Identifier | IONPAYTEST08202106091121206416 | | `originalPartnerReferenceNo` | String (40) | Mandatory | `referenceNo` | Unique Transaction ID from Merchant | ncpy20221017161458 | | `serviceCode` | String (2) | Mandatory | - | Transaction Type Indicator (Service Code of the Original Transaction Request) | 47 | | `latestTransactionStatus` | String (2) | Mandatory | `status` | [Status of the Transaction](docId\:XxlWrB0Q8XVkSMaO7ti9a) | 00 | | `paidTime` | String (25) | Mandatory | `transDt`, `transTm` | Transaction Date Using ISO-8601 Format
`YYYY-MM-DDTHH:MM:SS` | 2022-07-20T07:15:00+07:00 | | `amount` | Object | Mandatory | `"amount": { `
` ... `
` }` | - | | | - `value` | String (12) | Mandatory | `amt` | Transaction Amount

Note: Amount Format, Currently Only Supported IDR (Indonesian Currency Rupiah) then Value Includes 2 Decimal Digits which are Separated by a Dot (.) | 10000.00 | | - `currency` | String (3) | Mandatory | `Currency` | Default Value: IDR | IDR | | `additionalInfo` | Object | Mandatory | `"additionalInfo": { `
` ... `
` }` | | | | - `merchantId` | String (10) | Mandatory | `iMid` | NICEPAY Merchant ID | IONPAYTEST | | - `paymentTrxSn` | String (32) | Mandatory | `paymentTrxSn` | Payment Transaction Number from Acquirer Side | 07202210051341224326 | | - `cancelTrxSn` | String (32) | Conditional | `cancelTrxSn` | Cancel Transaction Number from Acquirer Side if Payment has been Cancelled | 07202210051341224326 | | - `cancelAmt` | String (12) | Conditional | | Transaction Amount

Note: Amount Format, Currently Only Supported IDR (Indonesian Currency Rupiah) then Value includes 2 Decimal Digits which are Separated by a Dot (.) | 10000.00 | | - `requestTime` | String (25) | Mandatory | `reqDt`,
`reqTm` | Transaction Date Using ISO-8601 Format
`YYYY-MM-DDTHH:MM:SS` | 2022-07-20T07:15:00+07:00 | | - `goodsNm` | String (200) | Mandatory | | Goods Name | Merchant Goods 1 | | - `billingNm` | String (100) | Mandatory | | Buyer Name | Buyer Name | | - `userId` | String (128) | Mandatory | `userId` | QRIS User ID | 213naUASIQBIH341bdjashf1204gkjbcasc | | - `externalStoreId` | String (32) | Mandatory | `storeCd` | Merchant ID from Acquirer Pay Side | NICEPAY | ## Sample Parameter for Check Status Transaction - API QRIS SNAP *** ### Request Parameter :::CodeblockTabs cURL ```curl curl -X POST \ 'https://dev.nicepay.co.id/nicepay/api/v1.0/qr/qr-mpm-query' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJUTklDRVFSMDgxIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJOSUNFUEFZIiwiZXhwIjoiMjAyNC0wNC0xOFQwNTowMzo1NloifQ==.IN_MYPmwhWgxRYWnTBZ7RDgG6-UqjZSLfUx9Ayn37Ek=' \ -H 'X-TIMESTAMP: 2024-04-18T09:00:40+07:00' \ -H 'X-SIGNATURE: xVVJtqCctS7cfXP4fe8AqTqitg0OSTthfXe4rfTIreUU9CnVTHKh7elbTIDMueHA2Y0PLYNc7+goqsQWYf1WHA==' \ -H 'X-PARTNER-ID: TNICEQR081' \ -H 'X-EXTERNAL-ID: 11044820240418' \ -H 'CHANNEL-ID: TNICEQR08101' \ -d '{"originalReferenceNo":"TNICEQR08108202404181012168473","originalPartnerReferenceNo":"ordNo2022120215134035","merchantId":"TNICEQR081","externalStoreId":"NicepayStoreID1","serviceCode":"47","additionalInfo":{}}' ``` Node.js ```nodejs // This configuration should be initialized with your actual credentials const config = {   isProduction: false,   privateKey: "YOUR_PRIVATE_KEY", // Replace with your actual private key   clientSecret: "YOUR_CLIENT_SECRET", // Replace with your actual client secret   clientId: "TNICEQR081",   isCloudServer: false, }; const accessToken = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJUTklDRVFSMDgxIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJOSUNFUEFZIiwiZXhwIjoiMjAyNC0wNC0xOFQwNTowMzo1NloifQ==.IN_MYPmwhWgxRYWnTBZ7RDgG6-UqjZSLfUx9Ayn37Ek="; let paramQuery = {   body: {     originalReferenceNo:"TNICEQR08108202404181012168473",     originalPartnerReferenceNo:"ordNo2022120215134035",     merchantId:"TNICEQR081",     externalStoreId:"NicepayStoreID1",     serviceCode:"47",     additionalInfo:{}   },   headers: { X_EXTERNAL_ID: "11044820240418",     CHANNEL_ID: "TNICEQR08101",   }, }; let snap = new Snap(config); let endPoint = `/api/v1.0/qr/qr-mpm-query`; let response = snap   .requestSnapTransaction(paramQuery, endPoint, accessToken, "POST"); ``` ```java NICEPay config = NICEPay.builder() .isProduction(false) .isCloudServer(false) .clientSecret(CLIENT_SECRET) .partnerId("TNICEQR081") .externalID("11044820240418") .timestamp("2024-04-18T09:00:40+07:00") .privateKey(PRIVATE_KEY) .build(); String accessToken = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJUTklDRVFSMDgxIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJOSUNFUEFZIiwiZXhwIjoiMjAyNC0wNC0xOFQwNTowMzo1NloifQ==.IN_MYPmwhWgxRYWnTBZ7RDgG6-UqjZSLfUx9Ayn37Ek="; InquiryStatus requestData = InquiryStatus.builder() .merchantId("TNICEQR081") .originalPartnerReferenceNo("ordNo2022120215134035") .originalReferenceNo("TNICEQR08108202404181012168473") .externalStoreId("NicepayStoreID1") .serviceCode("47") .build(); NICEPayResponse result = SnapInquiryStatusService.callServiceQrisCheckStatus(requestData, accessToken, config); ``` ```python bodyCreateToken = ( builderAccessToken.BuildAccessToken() .setGrantType("client_credentials") .setAdditionalInfo("") .build() ) additionalInfo = { } bodyQrisInquiry = ( builderQris.BuildQrisInquiry() .setMerchantId("TNICEQR081") .setExternalStoreId("NicepayStoreID1") .setOriginalReferenceNo("TNICEQR08108202404181012168473") .setOriginalPartnerReferenceNo("ordNo2022120215134035") .setServiceCode("47") .setAdditionalInfo(additionalInfo) .build() ) environment = (builderEnvironment.BuildEnvironment() .isCloud(False) .isProduction(False) .build()) # The service call to execute the transaction result = SnapService.serviceTransaction(bodyCreateToken.jsonAccessToken(), bodyQrisInquiry.jsonQrisInquiry(), ConstantsEndpoints.inquiryQris(), environment) ``` C# ```csharp string clientId = "TNICEQR081"; string privateKey = "YOUR_PRIVATE_KEY"; // Replace with your actual private key string clientSecret = "YOUR_CLIENT_SECRET"; // Replace with your actual client secret string channelId = "TNICEQR08101"; bool isProduction = false;// set true for Production bool isCloudServer = false; // Values from the cURL command string timestamp = "2024-04-18T09:00:40+07:00"; string externalId = "11044820240418"; string accessToken = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJUTklDRVFSMDgxIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJOSUNFUEFZIiwiZXhwIjoiMjAyNC0wNC0xOFQwNTowMzo1NloifQ==.IN_MYPmwhWgxRYWnTBZ7RDgG6-UqjZSLfUx9Ayn37Ek="; ApiEndpoints apiEndpoints = new ApiEndpoints(); APIService qrisService = new APIService(apiEndpoints, clientSecret, clientId, channelId, isProduction, isCloudServer); SnapQrisServices snapQrisServices = new SnapQrisServices(clientId); var inquiryBody = new { originalReferenceNo = "TNICEQR08108202404181012168473", originalPartnerReferenceNo = "ordNo2022120215134035", merchantId = "TNICEQR081", externalStoreId = "NicepayStoreID1", serviceCode = "47", additionalInfo = new {} }; string requestBodyJson = Newtonsoft.Json.JsonConvert.SerializeObject(inquiryBody); string endpoint = apiEndpoints.StatusQris; string inquiryResponse = await qrisService.SendPostRequest(endpoint, accessToken, timestamp, requestBodyJson, externalId); Console.WriteLine("Inquiry Qris Response: " + inquiryResponse); ``` Laravel ```php protected $useProd = false; protected $useCloud = false; protected $inquiry_qris_endpoint = "/api/v1.0/qr/qr-mpm-query"; // Credential protected $client_id = "TNICEQR081"; PROTECTED $key = "_PRIVATE_KEY_MERCHANT"; PROTECTED $client_secret = "_CLIENT_SECRET_MERCHANT"; PROTECTED $access_token = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJUTklDRVFSMDgxIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJOSUNFUEFZIiwiZXhwIjoiMjAyNC0wNC0xOFQwNTowMzo1NloifQ==.IN_MYPmwhWgxRYWnTBZ7RDgG6-UqjZSLfUx9Ayn37Ek="; // Authorization Bearer PROTECTED $store_id = "NicepayStoreID1"; $url = HttpUtil::getNicepayDomain($this->useProd, $this->useCloud) . $this->inquiry_qris_endpoint; $helper = new Helpers(); $http_method = "POST"; $x_time_stamp = '2024-04-18T09:00:40+07:00'; $date = Carbon::parse($x_time_stamp); $time_stamp = $date->format("YmdHis"); $partner_id = $this->client_id; $client_secret = $this->client_secret; $access_token = $this->access_token; $store_id = $this->store_id; $external_id = "11044820240418"; $original_reference_no = "TNICEQR08108202404181012168473"; $reference_no = "ordNo2022120215134035"; $additionalInfo = (object)[]; $body = [ "originalReferenceNo" => $original_reference_no, "originalPartnerReferenceNo" => $reference_no, "merchantId" => $partner_id, "externalStoreId" => $store_id, "serviceCode" => "47", "additionalInfo" => $additionalInfo ]; $string_to_sign = $helper->generateStringToSign( $http_method, $this->inquiry_qris_endpoint, $access_token, $body, $x_time_stamp ); $signature = $helper->hmacSHA512Encoded( $string_to_sign, $client_secret, OPENSSL_ALGO_SHA512 ); $channel_id = "TNICEQR08101"; $header = $helper->generateHeader( $access_token, $x_time_stamp, $signature, $partner_id, $external_id, $channel_id ); $response = HttpUtil::postJsonRequestWithHeader($url, $body, $header); ``` PHP Native ```php $partnerId = "TNICEQR081"; $externalId = "11044820240418"; $timestamp = '2024-04-18T09:00:40+07:00'; $originalReferenceNo = "TNICEQR08108202404181012168473"; $originalPartnerReferenceNo = "ordNo2022120215134035"; $externalStoreId = "NicepayStoreID1"; $serviceCode = "47"; $accessToken = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJUTklDRVFSMDgxIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJOSUNFUEFZIiwiZXhwIjoiMjAyNC0wNC0xOFQwNTowMzo1NloifQ==.IN_MYPmwhWgxRYWnTBZ7RDgG6-UqjZSLfUx9Ayn37Ek="; // Step 1: Configure the SDK $config = NICEPay::builder() ->setIsProduction(false) ->setPrivateKey("MERCHANT_PRIVATE_KEY") ->setClientSecret("MERCHANT_CLIENT_SECRET") ->setPartnerId($partnerId) ->setExternalID($externalId) ->setTimestamp($timestamp) ->build(); // Step 2: Define the Request Body $requestBody = InquiryStatus::builder() ->setOriginalReferenceNo($originalReferenceNo) ->setOriginalPartnerReferenceNo($originalPartnerReferenceNo) ->setMerchantId($partnerId) ->setExternalStoreId($externalStoreId) ->setServiceCode($serviceCode) ->setAdditionalInfo((object)[]) ->build(); // Step 3: Execute the request try { $qrisService = new SnapQrisService($config); $response = $qrisService->inquiryStatus($requestBody, $accessToken); } catch (\Exception $e) { // Handle exceptions } ``` ```kotlin val config: NICEPay = NICEPay.Builder() .isProduction(false) .clientSecret(CLIENT_SECRET) .partnerId("TNICEQR081") .externalID("11044820240418") .timestamp("2024-04-18T09:00:40+07:00") .privateKey(PRIVATE_KEY) .build() val accessToken = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJUTklDRVFSMDgxIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJOSUNFUEFZIiwiZXhwIjoiMjAyNC0wNC0xOFQwNTowMzo1NloifQ==.IN_MYPmwhWgxRYWnTBZ7RDgG6-UqjZSLfUx9Ayn37Ek=" val checkStatusRequest: SnapCheckStatus = SnapCheckStatus.Builder() .merchantId("TNICEQR081") .originalPartnerReferenceNo("ordNo2022120215134035") .originalReferenceNo("TNICEQR08108202404181012168473") .serviceCode("47") .externalStoreId("NicepayStoreID1") .build() val response: NICEPayResponse? = snapQrisService.checkStatus(checkStatusRequest, accessToken, config) ``` CodeIgniter ```php $partnerId = "TNICEQR081"; $externalId = "11044820240418"; $timestamp = '2024-04-18T09:00:40+07:00'; $originalReferenceNo = "TNICEQR08108202404181012168473"; $originalPartnerReferenceNo = "ordNo2022120215134035"; $externalStoreId = "NicepayStoreID1"; $serviceCode = "47"; $accessToken = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJUTklDRVFSMDgxIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJOSUNFUEFZIiwiZXhwIjoiMjAyNC0wNC0xOFQwNTowMzo1NloifQ==.IN_MYPmwhWgxRYWnTBZ7RDgG6-UqjZSLfUx9Ayn37Ek="; // Hardcoded Bearer Token // Step 1: Configure the config $config = NICEPay::builder() ->setIsCloudServer(isCloudServer: false) ->setPrivateKey("MERCHANT_PRIVATE_KEY") ->setClientSecret("MERCHANT_CLIENT_SECRET") ->setPartnerId($partnerId) ->setExternalID($externalId) ->setTimestamp($timestamp) ->build(); // Step 2: Define the Inquiry Request Body $requestBody = InquiryStatusQris::builder() ->setOriginalReferenceNo($originalReferenceNo) ->setOriginalPartnerReferenceNo($originalPartnerReferenceNo) ->setMerchantId($partnerId) ->setExternalStoreId($externalStoreId) ->setServiceCode($serviceCode) ->setAdditionalInfo([]) ->build(); // Step 3: Execute the request $snapQrisService = new SnapQrisService(); // Call the inquiryStatusQris function $response = $snapQrisService->inquiryStatusQris($requestBody, $accessToken, $config); ``` ::: ### Response Parameter :::CodeblockTabs Sample Response ```json { "responseCode": "2005100", "responseMessage": "Successful", "originalReferenceNo": "TNICEQR08108202404181012168473", "originalPartnerReferenceNo": "ordNo2022120215134035", "serviceCode": "47", "latestTransactionStatus": "00", "paidTime": "2024-04-18T10:14:07+07:00", "amount": { "value": "100.00", "currency": "IDR" }, "additionalInfo": { "goodsNm": "Test SNAP Transaction Nicepay", "billingNm": "John Doe", "merchantId": "TNICEQR081", "paymentTrxSn": "101378968850945616", "cancelTrxSn": "", "userId": "101378968850945616", "externalStoreId": "NicepayStoreID1", "requestTime": "2024-04-18T10:12:16+07:00" } } ``` ::: [title] Registration - API Virtual Account SNAP [path] NICEPAY API/API SNAP/Payment API - SNAP/API Virtual Account SNAP/ # Tentang Registration - API Virtual Account SNAP *** API dengan standar SNAP ini digunakan untuk mengajukan pendaftaran sebelum melakukan pembayaran menggunakan metode pembayaran Virtual Account. :::hint{type="info"} - Jika Anda ingin melihat penjelasan umum metode pembayaran Virtual Account, Anda dapat mengunjungi [Panduan Bayar VA](docId\:bSNUZMHNlj9h0wRndsQYj). - Untuk pengaturan integrasi fitur NICEPAY Inquiry Virtual Account, Anda dapat mengunjungi halaman [API NICEPAY Inquiry Virtual Account SNAP](docId\:W-Zwlzxm-p6FyqA3tqaDD). ::: ## Spesifikasi Panjang Nomor Virtual Account Seperti yang sudah jelaskan pada halaman [Struktur Virtual Account](docId:9tV3ro3_Lj1f-guZ2gark), panjang dari nomor VA yang dapat dibuat berbeda-beda pada setiap Bank. Panjang nomor VA dapat ditentukan sendiri sesuai dengan kebutuhan bisnis selama nomor VA tersebut tidak melebihi kapasitas panjang maksimum yang sudah termasuk dengan angka prefix Bank dan prefix NICEPAY. Berikut adalah tabel persyaratan panjang nomor VA untuk beberapa Bank. | **Nama Bank** | **NICEPAY + Bank Prefix**
**Length** | **Max Total VA**
**Length** | | --------------------------------------- | ----------------------------------------- | -------------------------------- | | Central Asia (BCA) | 8 | 23 | | Rakyat (BRI) | 8 | 18 | | Mandiri | 8 | 19 | | Maybank | 8 | 16 | | Nasional (BNI) | 7 | 16 | | Permata | 7 | 16 | | Permata Syariah | 7 | 16 | | Commerce International Bankers (CIMB) | 7 | 19 | | Danamon | 7 | 16 | | KEB Hana | 7 | 16 | | Jabar Banten (BJB) | 7 | 16 | | Neo Commerce (BNC) | 11 | 19 | | Jakarta | 9 | 16 | | Syariah (BSI) | 8 | 16 | Catatan: - NICEPAY+Bank Prefix Length merupakan persyaratan panjang angka untuk nomor prefix NICEPAY dan Bank. :::hint{type="info"} **Contoh Kasus:** Apabila Anda sebagai Merchant ingin melakukan integrasi dengan VA Bank Mandiri, maka Anda wajib untuk memberikan ruang sebesar 8 digit untuk prefix VA yang terdiri dari prefix Bank dan prefix NICEPAY. Selanjutnya, angka setelah prefix akan terbagi menjadi 2 tipe sesuai dengan tipe VA yang ingin buat: 1. **Fixed VA**: Anda dapat melakukan kustomisasi angka setelah angka prefix VA yang NICEPAY sebut sebagai *customer id* atau `merFixAcctId` dengan catatan bahwa angka tersebut tidak lebih dari 19 digit panjang maksimal untuk nomor VA dari Bank Mandiri. 2. **Normal VA**: Anda tidak dapat melakukan kustomisasi angka setelah angka prefix VA karena angka tersebut akan melalui proses *generate *secara otomatis dan acak oleh sistem dengan catatan bahwa angka tersebut tidak lebih dari 19 digit panjang maksimal untuk nomor VA dari Bank Mandiri. ::: :::hint{type="warning"} Panjang nomor VA secara *default* adalah 16 digit. Kecuali ada skema khusus dari Bank, NICEPAY, dan Merchant. Meskipun setiap Bank dapat memiliki panjang nomor VA yang berbeda, Merchant disarankan untuk dapat mengakomodasi panjang nomor VA dalam satu deret maksimum 30 digit. ::: # Registration - API Virtual Account SNAP *** :::hint{type="warning"} Silakan mengajukan akses token terlebih dahulu untuk melakukan autentikasi melalui bagian [Request Access Token API - SNAP](docId\:GcGqBIYXG1Etcd0Ji9cHX). ::: | **Service Code** | `27` | | ---------------- | ---------------------------------------------- | | **API Endpoint** | `/api/v1.0/transfer-va/create-va` | | **HTTP Method** | **POST** | | **Description** | Untuk mengajukan pendaftaran transaksi VA | | **Content-Type** | `application/json` | ## Request Registration Header Parameter | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | **Contoh** | | --------------- | -------- | ---------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | | `Content-Type` | String | | Mandatory | `Application / JSON` | | | `Authorization` | String | | Mandatory | Bearer “`access_token`” | | | `X-TIMESTAMP` | String | | 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 | | Mandatory | Signature will be generated by Merchant.
[Panduan X-Signature - Symmetric](docId\:UZex33ReLyENKOgbJJnYp) | | | `X-PARTNER-ID` | String | 20 | Mandatory | `X-PARTNER-ID` = `CLIENT_ID` | | | `X-EXTERNAL-ID` | String | 40 | Mandatory | Unique Reference Number.
(`41807553358950093184`) | | | `CHANNEL-ID` | String | 20 | Mandatory | Unique Channel Merchant Credential ID Number.
Client ID + "01" = Channel ID
`"IONPAYTEST" + "01" = "IONPAYTEST01"` | IONPAYTEST01 | ## Request Registration Body Parameter :::hint{type="info"} Untuk parameter `partnerServiceId` dan `virtualAccountNo` dapat dikirim dengan nilai kosong. ::: | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | -------------------- | ------------ | ---------- | ------------- | ---------------------------------------------------- | | `partnerServiceId` | String | 20 | Mandatory | Partner Service ID / Prefix | | `customerNo` | String | 40 | Mandatory | Customer Number
(Mandatory for Fix type) | | `virtualAccountNo` | String | 25 | Mandatory | Virtual Account Number | | `virtualAccountName` | String | 100 | Mandatory | Virtual Account Name | | `trxId` | String
| 40 | Mandatory | Transaction ID
(Reference Number from Merchant) | | `totalAmount` | Object | | Optional | `"totalAmount": { `
` ... `
` }` | | `value` | String | 12 | Mandatory | Transaction Amount | | `currency` | String | 3 | Mandatory | Currency | | `additionalInfo` | Object | | Optional | `"additionalInfo": { `
` ... `
` }` | | `bankCd` | String | 4 | Mandatory | [Bank Code - API SNAP](docId:9WOQy5-1hlf_uCwshSDHO) | | `goodsNm` | String | 200 | Mandatory | Goods Name | | `dbProcessUrl` | String | | Mandatory | Notification URL | | `vacctValidDt` | String | 8 | Optional | Virtual Account Valid Date | | `vacctValidTm` | String | 6 | Optional | Virtual Account Valid Time | | `msId` | String | 20 | Optional | Merchant Seller ID | | `msFee` | String | 7 | Optional | Merchant Seller Fee | | `msFeeType` | String
| 2 | Optional | Merchant Seller Fee Type | | `mbFee` | String | 7 | Optional | Merchant Balance Fee | | `mbFeeType` | String
| 2 | Optional | Merchant Balance Fee Type | ## Response Registration Parameter | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | -------------------- | -------- | ---------- | ------------- | -------------------------------------------------------------------------------------------------------------------------- | | `responseCode` | String | | Mandatory | [General Response Code and Message - API SNAP](docId\:lKqJXSl5CMKdXYXxHYYSs) | | `responseMessage` | String | | Mandatory | Response Message | | `virtualAccountData` | Object | | Mandatory | `"virtualAccountData": { `
` ..., `
` "totalAmount": { `
` ... `
` } `
` }` | | `partnerServiceId` | String | 20 | Mandatory | Partner Service ID / Prefix (Mandatory for Fix type) | | `customerNo` | String | 40 | Mandatory | Customer Number (Mandatory for Fix type) | | `virtualAccountNo` | String | 25 | Mandatory | Virtual Account Number | | `virtualAccountName` | String | 100 | Mandatory | Virtual Account Name | | `trxId` | String | 40 | Mandatory | From Create VA Request (Reference
Number from Merchant) | | `totalAmount` | Object | | Optional | `"totalAmount": { `
` ... `
` }` | | `value` | String | 12 | Mandatory | Transaction Amount | | `currency` | String | 3 | Mandatory | Currency | | `additionalInfo` | Object | | Optional | `"additionalInfo": { `
` ... `
` }` | | `bankCd` | String | 4 | Mandatory | [Bank Code - API SNAP](docId:9WOQy5-1hlf_uCwshSDHO) | | `tXidVa` | String | 30 | Mandatory | Transaction ID of Virtual Account | | `goodsNm` | String | 200 | Mandatory | Goods Name | | `vacctValidDt` | String | 8 | Mandatory | Virtual Account Valid Date | | `vacctValidTm` | String | 6 | Mandatory | Virtual Account Valid Time | | `msId` | String | 20 | Optional | Merchant Seller ID | | `msFee` | String | 7 | Optional | Merchant Seller Fee | | `msFeeType` | String | 2 | Optional | Merchant Seller Fee Type | | `mbFee` | String | 7 | Optional | Merchant Balance Fee | | `mbFeeType` | String | 2 | Optional | Merchant Balance Fee Type | # Sample Parameter for Registration API Virtual Account SNAP *** ## Request Parameter :::CodeblockTabs cURL ```curl curl -X POST "https://dev.nicepay.co.id/nicepay/api/v1.0/transfer-va/create-va" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8=" \ -H "X-TIMESTAMP: 2024-04-30T10:11:40+07:00" \ -H "X-SIGNATURE: ufBw7R8RhW79IOiV/Hlv607M60qzAYBv8uZmbSrYb6/Thlo/FhQVP4xRyelUehoSS9o+QS6vWTKb/ygtucC+tQ==" \ -H "X-PARTNER-ID: IONPAYTEST" \ -H "X-EXTERNAL-ID: tXid202410142300021707638093" \ -H "CHANNEL-ID: IONPAYTEST" \ -d '{ "partnerServiceId": "", "customerNo": "", "virtualAccountNo": "", "virtualAccountName": "John Doe", "trxId": "2022020100000000000001", "totalAmount": { "value": "10000.00", "currency": "IDR" }, "additionalInfo": { "bankCd": "BMRI", "goodsNm": "John Doe", "dbProcessUrl": "https://testing.co.id/", "vacctValidDt": "", "vacctValidTm": "", "msId": "", "msFee": "", "msFeeType": "", "mbFee": "", "mbFeeType": "" } }' ``` Node.js ```nodejs const config = { isProduction: false, privateKey: cons.privateKey, clientSecret: cons.clientSecret, clientId: cons.clientId, isCloudServer: false, }; const parameter = { body: { partnerServiceId: "", customerNo: "", virtualAccountNo: "", virtualAccountName: "John Doe", trxId: "2022020100000000000001", totalAmount: { value: "10000.00", currency: "IDR", }, additionalInfo: { bankCd: "BMRI", goodsNm: "John Doe", dbProcessUrl: "https://testing.co.id/", vacctValidDt: "", vacctValidTm: "" }, }, headers: { X_EXTERNAL_ID: "tXid202410142300021707638093", CHANNEL_ID: "IONPAYTEST", }, }; let snap = new Snap(config); let endPoint = `/api/v1.0/transfer-va/create-va`; let response = snap.requestSnapTransaction(parameter, endPoint, accessToken, "POST"); ``` ```java config = NICEPay.builder() .isProduction(false) .clientSecret(DATA.CLIENT_SECRET) .partnerId(PARTNER_ID) .externalID(DATA.EXTERNAL_ID) .timestamp("2024-04-30T10:11:40+07:00") .privateKey(DATA.PRIVATE_KEY) .build(); var accessToken = Optional.ofNullable((NICEPayResponse) getToken()) .map(NICEPayResponse::getAccessToken) .orElseThrow(() -> new IllegalArgumentException("Token is null")); VirtualAccount virtualAccount = VirtualAccount.builder() .partnerServiceId("") .customerNo("") .virtualAccountNo("") .virtualAccountName("John Doe") .trxId("2022020100000000000001") .totalAmount("10000.00","IDR") .additionalInfo(new HashMap() { { put("bankCd","BMRI"); put("goodsNm", "John Doe"); put("dbProcessUrl", "https://testing.co.id/"); put("vacctValidDt", ""); put("vacctValidTm", ""); put("msId", ""); put("msFee", ""); put("msFeeType", ""); put("mbFee", ""); put("mbFeeType", ""); } }) .build(); NICEPayResponse response = SnapVaService.callGeneratedVA(virtualAccount, accessToken, config); ``` ```python bodyCreateToken = ( builderAccessToken.BuildAccessToken() .setGrantType("client_credentials") .setAdditionalInfo("") .build() ) totalAmount = { "value": "10000.00", "currency": "IDR" } additionalInfo = { "bankCd": "BMRI", "goodsNm": "John Doe", "dbProcessUrl": "https://testing.co.id/", "vacctValidDt": "", "vacctValidTm": "", "msId": "", "msFee": "", "msFeeType": "", "mbFee": "", "mbFeeType": "" } bodyCreateVA = ( builderVirtualAccount.BuildCreateVA() .setPartnerServiceId("") .setCustomerNo("") .setVirtualAccountNo("") .setVirtualAccountName("John Doe") .setTrxId("2022020100000000000001") .setTotalAmount(totalAmount) .setAdditionalInfo(additionalInfo) .build() ) environment = ( builderEnvironment.BuildEnvironment() .isCloud(False) .isProduction(False) .build() ) result = SnapService.serviceTransaction( bodyCreateToken.jsonAccessToken(), bodyCreateVA.jsonVACreate(), ConstantsEndpoints.createVA(), environment ) ``` C# ```csharp TestingConstantService config = new TestingConstantService(); string clientId = config.ClientId; string privateKey = config.PrivateKey; string timestamp = "2024-04-30T10:11:40+07:00"; string clientSecret = config.ClientSecret; string channelId = "IONPAYTEST"; string externalId = "tXid202410142300021707638093"; bool isProduction = false; bool isCloudServer = false; string accessToken = accessTokenObject.accessToken; ApiEndpoints apiEndpoints = new ApiEndpoints(); APIService vaService = new APIService(apiEndpoints, clientSecret, clientId, channelId, isProduction, isCloudServer); var bodyBuilder = new VirtualAccountBuilder() .SetVirtualAccountSnap( partnerServiceId: "", customerNo: "", virtualAccountNo: "", virtualAccountName: "John Doe", trxId: "2022020100000000000001", value: "10000.00", currency: "IDR", bankCd: "BMRI", goodsNm: "John Doe", dbProcessUrl: "https://testing.co.id/", vacctValidDt: "", vacctValidTm: "", msId: "", msFee: "", msFeeType: "", mbFee: "", mbFeeType: "" ).Build(); string createResponse = await vaService.SendPostRequest(apiEndpoints.CreateVA, accessToken, timestamp, bodyBuilder, externalId); ``` Laravel ```php protected $useProd = false; protected $useCloud = false; protected $create_va_endpoint = "/api/v1.0/transfer-va/create-va"; protected $client_id = "CLIENT_KEY_MERCHANT"; protected $key = "_PRIVATE_KEY_MERCHANT"; protected $client_secret = "_CLIENT_SECRET_MERCHANT"; protected $access_token = "_ACCESS_TOKEN_MERCHANT"; $url = HttpUtil::getNicepayDomain($this->useProd, $this->useCloud) . "/nicepay" . $this->create_va_endpoint; $helper = new Helpers(); $http_method = "POST"; $date = Carbon::now(); $x_time_stamp = $date->toIso8601String(); $time_stamp = $date->format("YmdHis"); $partner_id = $this->client_id; $client_secret = $this->client_secret; $access_token = $helper->generateAccessToken($this->client_id, $this->key); $external_id = "tXid202410142300021707638093"; $totalAmount = [ "value" => "15000.00", "currency" => "IDR" ]; $additionalInfo = [ "bankCd" => "CENA", "goodsNm" => "CENA", "dbProcessUrl" => "https://ptsv2.com/t/jhon/post", "vacctValidDt" => "", "vacctValidTm" => "", "msId" => "", "msFee" => "", "mbFee" => "", "mbFeeType" => "" ]; $body = [ "partnerServiceId" => "", "customerNo" => "", "virtualAccountNo" => "", "virtualAccountName" => "Testing Create Virtual Account Nicepay", "trxId" => "2022020100000000000001", "totalAmount" => $totalAmount, "additionalInfo" => $additionalInfo ]; $string_to_sign = $helper->generateStringToSign( $http_method, $this->create_va_endpoint, $access_token, $body, $x_time_stamp ); $signature = $helper->hmacSHA512Encoded( $string_to_sign, $client_secret, OPENSSL_ALGO_SHA512 ); $header = $helper->generateHeader( $access_token, $x_time_stamp, $signature, $partner_id, $external_id, $partner_id . "02" ); try { $response = HttpUtil::postJsonRequestWithHeader($url, $body, $header); } catch (\Exception $e) { echo "Request failed: " . $e->getMessage(); } ``` PHP Native ```php $timestamp = "2024-04-30T10:11:40+07:00"; $externalID = "tXid202410142300021707638093"; $config = NICEPay::builder() ->setIsProduction(false) ->setPrivateKey($this->oldKeyFormat) ->setClientSecret($this->clientSecret) ->setPartnerId($this->iMidTest) ->setExternalID($externalID) ->setTimestamp($timestamp) ->build(); $virtualAccountBuilder = VirtualAccount::builder(); $parameter = $virtualAccountBuilder ->setPartnerServiceId("") ->setCustomerNo("") ->setVirtualAccountNo("") ->setVirtualAccountName("John Doe") ->setTrxId("2022020100000000000001") ->setTotalAmount("10000.00", "IDR") ->setAdditionalInfo([ 'bankCd' => 'BMRI', 'goodsNm' => 'John Doe', 'dbProcessUrl' => 'https://testing.co.id/', 'vacctValidDt' => '', 'vacctValidTm' => '', 'msId' => '', 'msFee' => '', 'msFeeType' => '', 'mbFee' => '', 'mbFeeType' => '' ]) ->build(); $accessToken = self::getAccessToken($config); $snapVAService = new SnapVAService($config); $response = $snapVAService->generateVA($parameter, $accessToken); ``` ```kotlin val config: NICEPay = NICEPay.Builder() .isProduction(false) .clientSecret(TestingConstants.IONPAYTEST_CLIENT_SECRET) .partnerId("IONPAYTEST") .externalID("tXid202410142300021707638093") .timestamp("2024-04-30T10:11:40+07:00") .privateKey(TestingConstants.PRIVATE_KEY) .build() val accessToken = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8=" val snapVirtualAccountService: SnapVirtualAccountService = SnapVirtualAccountServiceImpl() val virtualAccount = SnapVirtualAccount.Builder() .partnerServiceId("1234") .customerNo("") .virtualAccountNo("") .virtualAccountName("TESTVaName") .trxId(DEFAULT_REFERENCE_NO) .totalAmount(DEFAULT_AMOUNT, "IDR") .additionalInfo( mapOf( "bankCd" to "BRIN", "goodsNm" to "TESTGoodsNm", "dbProcessUrl" to "https://merchant.com/test", "vacctValidDt" to "", "vacctValidTm" to "", "msId" to "", "msFee" to "", "msFeeType" to "", "mbFee" to "", "mbFeeType" to "" ) ) .build() val response: NICEPayResponse? = snapVirtualAccountService.createVA(virtualAccount, accessToken, config) ``` CodeIgniter ```php $const = new NicepayTestConst(); $this->clientSecret = $const::IMID_TEST_CLIENT_SECRET; $this->oldKeyFormat = $const::IMID_TEST_PRIVATE_KEY; $this->iMidTest = $const::IMID_TEST; $this->merchantKey = $const::IMID_COMMON_MERCHANT_KEY; $timestamp = Helper::getFormattedDate(); $config = NICEPay::builder() ->setIsCloudServer(isCloudServer: true) ->setPrivateKey($this->oldKeyFormat) ->setClientSecret($this->clientSecret) ->setPartnerId($this->iMidTest) ->setExternalID("tXid202410142300021707638093") ->setTimestamp($timestamp) ->build(); $virtualAccountBuilder = VirtualAccount::builder(); $parameter = $virtualAccountBuilder ->setPartnerServiceId("") ->setCustomerNo("") ->setVirtualAccountNo("") ->setVirtualAccountName("Nicepay PHP Test") ->setTrxId("2022020100000000000001") ->setTotalAmount('10000.00', 'IDR') ->setAdditionalInfo([ 'bankCd' => 'BMRI', 'goodsNm' => 'Jhon Doe', 'dbProcessUrl' => 'https://dev.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp', ]) ->build(); $accessToken = self::getAccessToken($config); $snapVAService = new SnapVAService(); try { $response = $snapVAService->generateVA($parameter, $accessToken, $config); } catch (\Exception $e) { // Handle exception if needed } ``` ::: ## Response Parameter :::CodeblockTabs Sample Response ```json { "responseCode": "2002700", "responseMessage": "Successful", "virtualAccountData": { "partnerServiceId": "", "customerNo": "", "virtualAccountNo": "70014000091733551548", "virtualAccountName": "Jhon Doe", "trxId": "2022020100000000000001", "totalAmount": { "value": "10000.00", "currency": "IDR" }, "additionalInfo": { "msId": "", "msFee": "", "msFeeType": "", "mbFee": "", "mbFeeType": "", "bankCd": "BMRI", "tXidVA": "IONPAYTEST02202410141733551548", "goodsNm": "Jhon Doe", "vacctValidDt": "20241016", "vacctValidTm": "173355" } } } ``` ::: [title] Produk NICEPAY [path] Mulai Segera/ # Jelajah Produk ::::LinkArray{contentSource="CUSTOM"} :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/8W07aQFTfhBkvs68dbFM9_payment.jpg"} Produk [Payment](docId\:cN5a57Nq9RzMUjE9FDnWm) memudahkan Merchant dalam melakukan proses transaksi untuk semua metode pembayaran. ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/RFCxNVNYEcziqLZxYisfI_checkout.jpg"} Produk [Checkout](docId\:yxIg_kKwRUKCb_lTM_1bc) memudahkan Merchant dalam proses transaksi *all-in-one *dengan halaman pembayaran khusus NICEPAY. ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/4xhWofmOe5mspbGnuFPZ__payout.jpg"} Kirim dana Disbursement untuk banyak tujuan sekaligus dan tarik tunai dari Convenience Store dengan [Payout](docId:_tBoQGqS-T6sk-ziXQl55). ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/5-7oiDQuJziCZq1M9vtxb_messaging.jpg"} Kirim pesan OTP hingga promosi melalui SMS kepada ribuan Pelanggan dengan [Messaging](docId\:TUr_6cb3iEKRgA0L6OO46). ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/ACEmLqKY4mw3LlvbUqm6Z_payment-link.jpg"} Pembayaran mudah melalui satu tautan, bebas pilih metode pembayaran apa saja dengan [Payment Link](docId\:ChpAc7d9l0s9A8mai3itC) . ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/je739WHQECICY1cfNWXjp_operasi-bisnis.jpg"} Lihat selengkapnya bagaimana NICEPAY dapat membantu bisnis Anda di [Operasi Bisnis](docId:8r87f_pn_ZI8LtKK3kq-K). ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/xN85b-MI1LMZdIBYaBGfa_api.jpg"} Panduan integrasi API dengan mudah dan lengkap dengan [NICEPAY API](docId:6qGtFCV3tHP1B_wS9zEqd). ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/WG8p27PZ0m_qDC2VOcc13_nicehub.jpg"} [NICEHub](docId\:LhDLrrC4HO1GT8pM-YRhZ) menyediakan informasi terkait produk NICEPAY untuk melakukan integrasi dengan mudah dan cepat pada CMS siap pakai maupun platform instan. ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/DGRWmQ7NafWyIHiBssPHd_merchant-bo.jpg"} Memantau segala proses transaksi pada bisnis Anda melalui portal [Merchant Back Office](docId\:VMD8YtiiJqku6H8dRhcS6). ::: :::: # Rekomendasi Produk Berikut rekomendasi produk dari kami yang cocok untuk kebutuhan bisnis Anda. | **Tipe Bisnis** | **Bagaimana NICEPAY Membantu Anda** | **Opsi Tipe Integrasi** | **Rekomendasi Produk** | | ------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------- | | **Freelancer & Merchant di Sosial Media Platform **(Facebook, Instagram, Tiktok) | Membantu Anda untuk menerima pembayaran dari berbagai metode dengan mudah & aman | Checkout API | [Payment Link](docId\:ChpAc7d9l0s9A8mai3itC) & [Checkout](docId\:yxIg_kKwRUKCb_lTM_1bc) | | **E-commerce** | Membantu Anda untuk menerima pembayaran dari berbagai metode tanpa mengubah alur User Checkout di *website* Anda serta mendukung integrasi berbagai macam multiparty platform seperti Magento
| - Integrasi API NICEPAY - Integrasi Multiparty Platform (Magento, Opencart, WooCommerce, SIRCLO, dll.) | [Payment](docId\:cN5a57Nq9RzMUjE9FDnWm) & [NICEHub](docId\:LhDLrrC4HO1GT8pM-YRhZ) | | ***SaaS*** | Menerima pembayaran dari berbagai metode tanpa mengubah alur User Checkout di *website* Anda & mendukung metode pembayaran bersifat langganan serta integrasi berbagai macam multiparty platform seperti Magento | * Integrasi API NICEPAY * Integrasi Multiparty Platform (Magento, Opencart, WooCommerce, SIRCLO, dll.) | [Payment](docId\:cN5a57Nq9RzMUjE9FDnWm) & [NICEHub](docId\:LhDLrrC4HO1GT8pM-YRhZ) | | **Corporation** | Menerima pembayaran di dalam *website* bisnis Anda & mengirimkan dana ke pihak yang dituju baik itu secara individu ataupun skala besar yang didukung lebih dari 140 Bank tujuan | Integrasi API | [Payment](docId\:cN5a57Nq9RzMUjE9FDnWm) & [Payout](docId:_tBoQGqS-T6sk-ziXQl55)
| | **Business Service **(Consultant, Construction & Law Firm) | Menerima pembayaran di dalam *website* bisnis Anda & mengirimkan dana ke pihak yang dituju baik itu secara individu ataupun skala besar yang didukung lebih dari 140 Bank tujuan | Integrasi API | [Payment](docId\:cN5a57Nq9RzMUjE9FDnWm) & [Payout](docId:_tBoQGqS-T6sk-ziXQl55) | ::::hint{type="info"} :::Iframe{code="ℹ️ Apabila Anda memiliki pertanyaan lebih lanjut atau jika bisnis Anda tidak tergolong dalam kategori di atas, silakan hubungi NICEPAY Customer Service atau tim Sales kami pada Marketing NICEPAY." iframeHeight="0"} ::: :::: Silakan cek laman [Produk & Biaya Layanan](docId:2deQYlDf8Az72oHGYaV7_) kami untuk mengetahui lebih rinci mengenai biaya layanan dari NICEPAY. [title] Status QRIS [path] NICEPAY API/API Playground/SNAP API Testing/QRIS/ { "id": "KAZmLG0bSlk-s9vzRfbjo", "type": "api-oas-v2", "data": { "method": "POST", "url": "https://dev.nicepay.co.id/nicepay/api/v1.0/qr/qr-mpm-query", "servers": [ { "url": "https://dev.nicepay.co.id/nicepay/api/v1.0/qr/qr-mpm-query" }, { "url": "https://staging.nicepay.co.id/nicepay/api/v1.0/qr/qr-mpm-query" }, { "url": "https://www.nicepay.co.id/nicepay/api/v1.0/qr/qr-mpm-query" } ], "name": "Status QRIS", "description": "", "contentType": "application/json", "request": { "pathParameters": [], "headerParameters": [ { "kind": "required", "name": "X-TIMESTAMP", "type": "string", "example": "2022-08-04T23:59:59+07:00" }, { "kind": "required", "name": "X-SIGNATURE", "type": "string", "default": "EMztJdlrulaR7I/iECF8ggjbb5KFaWurB2OJJ9V1TGBh9yxcaRf76ozN9IBfwBwI3Ft4qipQcrg1a0vh8Zhapw==" }, { "kind": "required", "name": "X-PARTNER-ID", "type": "string", "example": "TNICEQR081" }, { "kind": "required", "name": "X-EXTERNAL-ID", "type": "string", "example": "20230804230101" }, { "kind": "required", "name": "CHANNEL-ID", "type": "string", "example": "TNICEQR081" } ], "queryParameters": [], "bodyDataParameters": [ { "kind": "required", "name": "body", "type": "object", "description": "", "customType": "qrmpmquery_body", "schema": [ { "name": "originalReferenceNo", "kind": "required", "type": "string", "description": "NICPAY Transaction ID or Identifier", "example": "TNICEQR08108202309122320370700" }, { "name": "originalPartnerReferenceNo", "kind": "required", "type": "string", "description": "Unique Transaction ID from Merchant", "example": "" }, { "name": "merchantId", "kind": "required", "type": "string", "description": "Nicepay Merchant ID", "example": "TNICEQR081" }, { "name": "externalStoreId", "kind": "required", "type": "string", "description": "Merchant ID from Acquirer Pay Side", "example": "" }, { "name": "serviceCode", "kind": "required", "type": "string", "description": "Service Code", "example": "47" }, { "name": "additionalInfo", "kind": "required", "type": "object", "modelRef": "#/components/schemas/additionalInfoStatus", "customType": "additionalInfoStatus", "schema": [ { "name": "items", "kind": "optional", "type": "string", "example": "" } ] } ], "modelRef": "#/components/schemas/qrmpmquery_body", "complexItems": [ { "name": "object", "schema": [ { "name": "originalReferenceNo", "kind": "required", "type": "string", "description": "NICPAY Transaction ID or Identifier", "example": "TNICEQR08108202309122320370700" }, { "name": "originalPartnerReferenceNo", "kind": "required", "type": "string", "description": "Unique Transaction ID from Merchant", "example": "" }, { "name": "merchantId", "kind": "required", "type": "string", "description": "Nicepay Merchant ID", "example": "TNICEQR081" }, { "name": "externalStoreId", "kind": "required", "type": "string", "description": "Merchant ID from Acquirer Pay Side", "example": "" }, { "name": "serviceCode", "kind": "required", "type": "string", "description": "Service Code", "example": "47" }, { "name": "additionalInfo", "kind": "required", "type": "object", "modelRef": "#/components/schemas/additionalInfoStatus", "customType": "additionalInfoStatus", "schema": [ { "name": "items", "kind": "optional", "type": "string", "example": "" } ] } ], "modelRef": "#/components/schemas/StatusQRis", "customType": "StatusQRis" }, { "name": "object", "schema": [] } ], "complexType": "allOf", "isExpanded": true } ], "formDataParameters": [], "oAuthParameters": [ { "id": "Authorization", "name": "Authorization", "kind": "optional", "type": "http", "scheme": "bearer" } ] }, "responses": [ { "statusCode": "200", "description": "Successful", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Successful", "code": "{\n \"responseCode\": \"2005100\",\n \"responseMessage\": \"Successful\",\n \"virtualAccountData\": {\n \"originalReferenceNo\": \"TNICEQR08108202309122320370700\",\n \"originalPartnerReferenceNo\": \"ncpy20221017161458\",\n \"serviceCode\": \"47\",\n \"latestTransactionStatus\": \"00\",\n \"paidTime\": \"2023-09-12T23:20:38+07:00\",\n \"amount\": {\n \"value\": \"10000.00\",\n \"currency\": \"IDR\"\n },\n \"additionalInfo\": {\n \"goodsNm\": \"John Doe\",\n \"billingNm\": \"John Doe\",\n \"merchantId\": \"TNICEQR081\",\n \"paymentTrxSn\": \"\",\n \"cancelTrxSn\": \"\",\n \"userId\": \"\",\n \"externalStoreId\": \"NicepayStoreID1\",\n \"requestTime\": \"2023-09-12T23:20:37+07:00\"\n }\n }\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "SuccessfulStatusQris", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "2005100" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Successful" }, { "name": "originalReferenceNo", "kind": "optional", "type": "string", "description": "Original ReferenceNo", "example": "TNICEQR08108202309122320370700" }, { "name": "originalPartnerReferenceNo", "kind": "optional", "type": "string", "description": "Original Partner ReferenceNo", "example": "ncpy20221017161458" }, { "name": "serviceCode", "kind": "optional", "type": "string", "description": "Service Code", "example": "47" }, { "name": "latestTransactionStatus", "kind": "optional", "type": "string", "description": "Latest Transaction Status", "example": "00" }, { "name": "paidTime", "kind": "optional", "type": "string", "description": "Paid Time", "example": "2023-09-12T23:20:38+07:00" }, { "name": "amount", "kind": "optional", "type": "object", "modelRef": "#/components/schemas/amount", "customType": "amount", "schema": [ { "name": "value", "kind": "optional", "type": "string", "example": "" }, { "name": "currency", "kind": "optional", "type": "string", "example": "" } ] }, { "name": "additionalInfo", "kind": "optional", "type": "object", "modelRef": "#/components/schemas/additionalInfoResponseStatusQris", "customType": "additionalInfoResponseStatusQris", "schema": [ { "name": "goodsNm", "kind": "optional", "type": "string", "description": "Goods Name", "example": "John Doe" }, { "name": "billingNm", "kind": "optional", "type": "string", "description": "Billing Name", "example": "John Doe" }, { "name": "merchantId", "kind": "optional", "type": "string", "description": "Merchant ID", "example": "TNICEQR08" }, { "name": "paymentTrxSn", "kind": "optional", "type": "string", "description": "Payment TrxSn", "example": "" }, { "name": "cancelTrxSn", "kind": "optional", "type": "string", "description": "Cancel TrxSn", "example": "" }, { "name": "userId", "kind": "optional", "type": "string", "description": "User ID", "example": "" }, { "name": "externalStoreId", "kind": "optional", "type": "string", "description": "External StoreId", "example": "NicepayStoreID1" }, { "name": "requestTime", "kind": "optional", "type": "string", "description": "Request Time", "example": "2023-09-12T23:20:37+07:00" } ] } ], "modelRef": "#/components/schemas/SuccessfulStatusQris", "isExpanded": true } ] }, { "statusCode": "202", "description": "Request In Progress", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Request In Progress", "code": "{\n \"responseCode\": \"202XX00\",\n \"responseMessage\": \"Request In Progress\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "RequestInProgress", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "202XX00" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Request In Progress" } ], "modelRef": "#/components/schemas/RequestInProgress", "isExpanded": true } ] }, { "statusCode": "409", "description": "Duplicate partnerReferenceNo", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Duplicate partnerReferenceNo", "code": "{\n \"responseCode\": \"409XX01\",\n \"responseMessage\": \"Duplicate partnerReferenceNo\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "DuplicatePartnerReferenceNo", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "409XX01" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Duplicate partnerReferenceNo" } ], "modelRef": "#/components/schemas/DuplicatePartnerReferenceNo", "isExpanded": true } ] }, { "statusCode": "500", "description": "General Error", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "General Error", "code": "{\n \"responseCode\": \"500XX00\",\n \"responseMessage\": \"General Error\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "GeneralError", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "500XX00" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "General Error" } ], "modelRef": "#/components/schemas/GeneralError", "isExpanded": true } ] }, { "statusCode": "504", "description": "Request Timeout", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Request Timeout", "code": "{\n \"responseCode\": \"504XX00\",\n \"responseMessage\": \"Request Timeout\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "RequestTimeout", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "504XX00" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Request Timeout" } ], "modelRef": "#/components/schemas/RequestTimeout", "isExpanded": true } ] } ] }, "children": [ { "text": "" } ] } [title] API Non-SNAP [path] NICEPAY API/ :::hint{type="warning"} Bagian ini memuat referensi versi Non-. ::: ::::LinkArray{contentSource="CUSTOM"} :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/yrsXEUa9ibfCtk7cmsFO0-20260316-071426.jpg"} [Authentication](docId:_D-kQ0wA0XWRFReEX8mQd) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/LzMNdGVjrxwLfWsrr6MKh-20260316-071605.jpg"} [Payment API](docId\:OK8pnFvDrqo-4Qq3umLQz) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/UJWXKDQMSPtsV_RB3ZaHO-20260316-071626.jpg"} [Advance API](docId\:qyS-Qyem-hUj6iKk-tAu7) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/qjtb81t-rNmo2MXGbAnZU-20260316-071742.jpg"} [NICEPAY Code](docId\:kYd45uYYIjwzVs3dt8_rk) ::: :::: # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [API SNAP](docId\:Rz9KHBT6vz0PGg0jszAgn) untuk mengetahui terkait dengan standar . ::: :::VerticalSplitItem [API Messaging](docId\:Ywf0ueM6Dr7G3n9sBFpp3) untuk mengetahui terkait Messaging . ::: :::: [title] API Credit Card [path] NICEPAY API/API Non-SNAP/Payment API/ # Proses Pada API Kartu Kredit :::hint{type="info"} juga menerima Kartu Debit melalui sama dengan . ::: ::::LinkArray{contentSource="CUSTOM"} :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/Ff3E3uAP-TUU9xZs0dJth-20260316-091008.jpg"} [Registration - API Credit Card](docId\:LNVo8u5nDYbxuMSZN748m) digunakan untuk mendaftarkan saat pertama kali dibuat. ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/dcYGSOvStJYR5qT92BO_b-20260316-091148.jpg"} [Payment - API Credit Card](docId\:FcJslW1q-2oJhb0HWqJsj) digunakan untuk melakukan . ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/cXGpLV-NHG9MO0yyGpV5O-20260316-091247.jpg"} [Cancel - API Credit Card](docId\:wtiAnrXNbTTfKUY8FFEIo) digunakan untuk membatalkan sedang berjalan. ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/Ol0X783j41jRQXPI_JyzQ-20260316-091649.jpg"} [Status Inquiry - API Credit Card](docId\:voJ9rhAQRLcF-_74cYrFi) digunakan untuk memeriksa sudah berhasil. ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/WlAZaYhtJCPH9jyv6r_mT-20260316-091833.jpg"} [Notification - API Credit Card](docId\:kC5XHZ2fbwmcDcmh2iBJ5) digunakan untuk memeriksa sedang berjalan. ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/S8O85J0x9LG8GlhYb6Fn5-20260316-092204.jpg"} [Callback URL - API Credit Card](docId:_wkZgofIhjNSRhJWpN9zS) digunakan untuk kembali ke dan menampilkan pesan . ::: :::: [title] Authentication - API Checkout [path] NICEPAY API/API Checkout/ # Proses *Authentication* *** *Authentication* merupakan prosedur keamanan untuk mengenali identitas dari suatu *request* asing. Apabila identitas tersebut sudah dikenali oleh , maka *request* tersebut dapat mengakses tersebut. Dalam hal ini, membutuhkan identitas Key terlebih dahulu disebut `merchantKey` dari *request* , sehingga dapat terhubung dengan tanpa hambatan apapun. Selain `merchantKey`, juga dibutuhkan untuk mengirim *mandatory parameter*, yaitu `merchantToken`. ## Merchant Key Key terbagi menjadi dua tipe, yaitu Sandbox Credentials dan Production Credentials. ### Sandbox Credentials Apabila ingin melakukan uji coba kami terlebih dahulu sebelum melakukan dengan , silakan menggunakan kredensial telah disediakan di bawah ini dengan menggunakan `iMid` **IONPAYTEST**. :::hint{type="info"} `iMid` merupakan identitas atau ID sebagai pada . `iMid` hanya dikhususkan untuk penggunaan akan diberikan setelah resmi terdaftar sebagai kami. Untuk melakukan , silakan memakai `iMid` **IONPAYTEST **dan memakai Key khusus tersebut di *Sandbox Credentials.* ::: | `iMid `
******(Merchant ID)****** | **IONPAYTEST**
**(AutoPaid)** | | ------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- | | `merchantKey` | 33F49GnCMS1mFYlGXisbUDzVf2ATWCl9k3R++d5hDd3Frmuos/XLx8XhXpe+LDYAbpGKZYSwtlyyLOtS/8aD7A== | :::hint{type="info"} Kredensial di atas disediakan hanya untuk keperluan serta akan dibuat berhasil secara otomatis (`AutoPaid`). ::: ### Production/Live Credentials Apabila sudah resmi terdaftar menjadi dan ingin melakukan tahap dengan nyata, dapat melihat `merchantKey` yang kami buatkan khusus dengan iMid di dalam portal [Merchant Back Office](docId\:VMD8YtiiJqku6H8dRhcS6). Berikut langkah untuk mendapatkan `merchantKey`: 1. Akses *dashboard* [Merchant Back Office](https://bo.nicepay.co.id/logIn.do) . 2. [Profile](docId\:BabGGtWurVs0v13RqGnyS). 3. [Merchant Data](docId:7IhkFtaIHOX62F21vl8Bq). 4. *tab* `Other`. 5. *Scroll* ke bawah untuk mendapatkan `merchantKey` . ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/sXerwgaWCl-lFAYzimrFY_merchant-key.png "Panduan Melihat M_KEY / Merchant Key") :::hint{type="warning"} Jangan lupa untuk mencantumkan `iMid` sesuai dengan `iMid` terdaftar untuk saat melakukan dengan kami. ::: ## Merchant Token `MerchantToken` digunakan untuk melakukan autentikasi keamanan dengan . Parameter ini dibuat dengan menggunakan metode *hashing* `SHA-256` sudah termasuk `iMid`, `merchantKey`, serta variabel lain dibutuhkan. Berikut detail dari Token. ```javascript //Generate merchantToken// merchantData = timeStamp + iMid + refNo + amount + merchantKey; merTok = CryptoJS.SHA256(merchantData).toString(CryptoJS.enc.Hex); Sample: merchantData = 20221202101271 + IONPAYTEST + OrdNo-20221202101271 + 100000 + 33F49GnCMS1mFYlGXisbUDzVf2ATWCl9k3R++d5hDd3Frmuos/XLx8XhXpe+LDYAbpGKZYSwtlyyLOtS/8aD7A== merTok = d7c10cfccd64fdb21836f4330bb23f9ed357bc4b02420399d48b4661b89a55a0 ``` | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | | ------------- | -------- | ---------- | ---------------------------------------- | | `timeStamp` | N | 14 | Transaction Timestamp (`YYYYMMDDHHMMSS)` | | `iMid` | AN | 10 | ID | | `refNo` | ANS | 40 | 's Reference Number | | `amount` | N | 12 | Amount | | `merchantKey` | ANS | 88 | Key | ## NICEPAY API URL Berikut URL dapat gunakan sesuai dengan kebutuhan . URL ini harus di-*request* melalui protokol HTTPS agar dapat terhubung dengan kami. | **Environment** | **Protocol** | **Base URL** | | --------------- | ------------ | -------------------------------- | | Development | https | `https://dev.nicepay.co.id/` | | Staging | https | `https://staging.nicepay.co.id/` | | Production | https | `https://www.nicepay.co.id/` | ## Uji Coba Metode Pembayaran Setelah mendapatkan semua keperluan autentikasi agar dapat berinteraksi dengan kami, silakan kunjungi laman di bawah ini untuk uji dengan kami. | **Metode Pembayaran** | **Kredensial** | | --------------------- | ---------------------------------------------------------------- | | | [Integrasi & Testing Kartu Kredit](docId\:ZA5d5J-5w_gT44qGTxB5n) | | | [Integrasi & Testing VA](docId\:sts64cm0VYN3Q8_quNq23) | | | [Integrasi & Testing CVS](docId:6zSlSRyypvTgFXAKRIXHI) | | | [Integrasi & Testing Direct Debit](docId\:sHrV7hpVnWLt9ipNeCfE4) | | | [Integrasi & Testing E-Wallet](docId\:b9HPduhC2MPMLaLHIjCbO) | | | [Integrasi & Testing Paylater](docId\:ZEuw_0d227R_LUPBI3ptN) | | | [Integrasi & Testing GPN](docId\:LuCYNk98cX7upRb-xSZS3) | | | [Integrasi & Testing QRIS](docId\:tCFbU7--Xd0Sm5_rQ00_w) | | | [Integrasi & Testing Payout](docId\:LkYgPUsJyOVKICpo6yFHn) | [title] Implementasi SNAP [path] NICEPAY API/API SNAP/ # Tentang Implementasi SNAP *** sebagai penyedia jasa online menyediakan beberapa telah memiliki standardisasi . Penyesuaian untuk beberapa ke dalam standar telah dilakukan secara bertahap oleh . Demi keamanan dan kenyamanan dalam ber serta mengikuti kemajuan di , wajib memulai ke dalam dengan standar sesuai dengan arahan dari . Secara umum, tahapan implementasi mencakup: melengkapi dokumen serta informasi lain dibutuhkan dan melakukan bersama tim . mengunjungi [Panduan Implementasi SNAP](docId:9NC4zMt_CIYOOoQ3RweUm) untuk selengkapnya. # Daftar API SNAP Pada NICEPAY *** Berikut adalah daftar sudah memiliki standar . ::::LinkArray{contentSource="CUSTOM"} :::LinkArrayItem{headerType="COLOR" headerColor="#031e36"} [Request Access Token API - SNAP](docId\:GcGqBIYXG1Etcd0Ji9cHX) ::: :::LinkArrayItem{headerType="COLOR" headerColor="#031e36"} [Payment API - SNAP](docId:-M_V-II4nkTcxd6jiHTfg) ::: :::LinkArrayItem{headerType="COLOR" headerColor="#031e36"} [Payout API (Disbursement) - SNAP](docId\:pImeP_3g-q6QNBFmwvkOr) ::: :::LinkArrayItem{headerType="COLOR" headerColor="#031e36"} [Advance API - SNAP](docId\:iytnF1uTXSDGwvjRVS62b) ::: :::LinkArrayItem{headerType="COLOR" headerColor="#031e36"} [NICEPAY Code - API SNAP](docId\:R1lBLY8cilScdLGjWoFgc) ::: :::: # NICEPAY API URL *** Berikut URL harus di-*request* melalui protokol HTTPS agar dapat terhubung dengan . | **Environment** | **Protocol** | **Base URL** | | --------------- | ------------ | -------------------------------- | | Development | https | `https://dev.nicepay.co.id/` | | Staging | https | `https://staging.nicepay.co.id/` | | Production | https | `https://www.nicepay.co.id/` | # Panduan Implementasi SNAP *** ## Dokumen Pengantar Implementasi unduh dokumen diperlukan untuk melakukan implementasi pada lampiran di bawah ini. ::File{src="https://archbee-doc-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/o_U2Hu2Mtby86sRW6eTuU_dokumen-migrasi-snap-nicepay.zip" label="dokumen-migrasi-snap-nicepay.zip"} | **Nama Dokumen** | **Deskripsi** | | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Statement Letter - Bilingual | Surat pernyataan kesanggupan dan komitmen pengguna dalam pelaksanaan implementasi . | | Lampiran | Lampiran ini perlu diisi oleh telah menggunakan untuk memudahkan implementasi. | | Dokumen Hasil Pengujian Developer Site | Dokumen didapat dari Developer Site berisi hasil pengujian suatu dalam *positif case* dan *negative case* untuk didapat dari Developer Site .

Dokumen ini dapat diunduh pada portal Developer Site setelah melakukan pengujian . | ::::hint{type="info"} :::Iframe{iframeHeight="0" code=" Silakan kirim dokumen pengantar implementasi yang sudah terisi ke e-mail Tim NICEPAY."} ::: :::: ## Alur Implementasi SNAP ![Alur Panduan Implementasi](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/ulinaSEDUlZ_QT8kQkAMx_migrasi-snap-revised-2.png "Alur Panduan Implementasi") Deskripsi langkah untuk melakukan implementasi dengan : 1. melakukan pendaftaran terlebih dahulu pada [portal Asosiasi Sistem Pembayaran Indonesia (ASPI)](https://apidevportal.aspi-indonesia.or.id/sign-up). 2. melakukan uji aplikasi pengujian pada Asosiasi Sistem Pembayaran (ASPI). 3. mengunduh hasil uji aplikasi pengujian. 4. Setelah berhasil mengunduh hasil uji aplikasi pengujian: - mengirimkan hasil uji aplikasi pengujian kepada . - menerima hasil uji aplikasi pengujian. 5. Sebelum melakukan *environment dev*: - membagikan *public key environment dev* untuk *environment dev *kepada . - menerima *public key environment dev*. 6. mengirimkan kredensial berupa `client id` dan `client secret` untuk *environment dev *kepada . 7. Setelah mengirimkan kredensial kepada : - melalui fase *development*. - memberikan dokumen *Scenario* *Functional Test *kepada setelah menyelesaikan fase *development*. 8. melakukan uji coba berdasarkan panduan dalam dokumen *Scenario Functional Test*. 9. mengirimkan hasil dari dokumen *Scenario* *Functional Test *kepada . 10. memeriksa hasil dari dokumen *Scenario* *Functional Test *dan uji aplikasi pengujian. 11. Setelah selesai melakukan pemeriksaan dokumen: - Jika isi dokumen perlu direvisi, akan mengembalikan dokumen tersebut kepada . - Jika isi dokumen sudah sesuai regulasi verifikasi, akan mengirimkan pengajuan verifikasi kepada Asosiasi Sistem Pembayaran (ASPI). [title] Request Access Token - API NICEPAY Inquiry Convenience Store SNAP [path] NICEPAY API/API SNAP/Advance API - SNAP/API NICEPAY Inquiry Convenience Store SNAP/ # Tentang Request Access Token - API NICEPAY Inquiry Convenience Store SNAP *** Bagian ini berisi tentang terkait dengan standar digunakan pada dengan fitur Inquiry (NICO) agar dapat mengajukan token untuk melakukan &#xNAN;*.* # Request Access Token - API NICEPAY Inquiry Convenience Store SNAP *** :::hint{type="warning"} Sebelum melakukan proses integrasi, Merchant perlu mengirimkan base URL (Merchant Domain) via email kepada Tim Integrasi NICEPAY ([integration@nicepay.co.id](mailto\:integration@nicepay.co.id)) agar Merchant dapat mengakses API NICO. Setelah menerima URL Base, NICEPAY akan memberikan Public Key kepada Merchant, sehingga Merchant dapat langsung memulai proses integrasi. ::: ## Get Access Token akan mengajukan *generate *`access_token` kepada melalui . `access_token` diberikan akan mengikuti format dari dan memiliki waktu kedaluwarsa 15 menit. | **API Endpoint** | `https://[merchant-domain]/api/v.1.0/access-token/b2b` | | ---------------- | ------------------------------------------------------ | | **Method** | `POST` | | **Description** | Untuk melakukan *request access token* NICO | | **Content-type** | `application/json` | ## Request Access Token Header Parameter | **Parameter** | **Tipe** | **Kebutuhan** | **Deskripsi** | **Contoh** | | -------------- | -------- | ------------- | ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `Content-Type` | String | Mandatory | String Media Type of Resource | `application/json` | | `X-TIMESTAMP` | String | Mandatory | Timezone | `YYYY-MM-DDTHH:MM:SS`
(2024-01-22T15:00:01+07:00) | | `X-CLIENT KEY` | String | Mandatory | ID | IONPAYTEST | | `X-SIGNATURE` | String | Mandatory | Signature | Generated by /
created using asymmetric
signature SHA256withRSA algorithm
(`Private_Key`, `stringToSign`)
`stringToSign `= `client ID` + “`\|`” + `X-TIMESTAMP` | ## Request Access Token Body Parameter | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | ---------------- | -------- | ---------- | ------------- | --------------- | | `grantType` | String | 8 | Mandatory | Name | | `additionalInfo` | String | 17 | Mandatory | Goods/Item Name | ## Request Access Token Response Parameter | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | ----------------- | -------- | ---------- | ------------- | ------------------------ | | `responseCode` | String | 5 | Mandatory | Response Code | | `responseMessage` | String | 100 | Mandatory | Response Message | | `accessToken` | String | 150 | Mandatory | Access Token | | `tokenType` | String | 8 | Mandatory | Type Token | | `expiresIn` | String | 17 | Mandatory | Session Expiry in Second | | `additionalInfo` | String | 17 | Mandatory | Additional Information | ## Sample Parameter :::CodeblockTabs JSON Request ```json { "grantType": "client_credentials", "additionalInfo": {} } ``` JSON Response ```json { "responseCode": "2007300", "responseMessage": "Successful", "accessToken": "Xy8duZzAvv9bwDXxRxcb89tsuvk4MF4kx4lGfE4aCRVxR7XdERhbe1", "tokenType": "Bearer", "expiresIn": "900", "additionalInfo": {} } ``` ::: [title] Balance Inquiry - API Payout (Disbursement) SNAP [path] NICEPAY API/API SNAP/Payout API (Disbursement) - SNAP/ # Tentang Balance Inquiry - API Payout (Disbursement) SNAP *** API ini digunakan untuk mengajukan pemeriksaan *balance inquiry* dari suatu akun dalam proses Disbursement. # Request Balance Inquiry - API Payout (Disbursement) SNAP *** :::hint{type="warning"} Silakan mengajukan akses token terlebih dahulu untuk melakukan autentikasi melalui bagian [Request Access Token API - SNAP](docId\:GcGqBIYXG1Etcd0Ji9cHX). ::: | **Service Code** | `11` | | ---------------- | ---------------------------------------------------------------------------------------------------------- | | **API Endpoint** | [`/nicepay/api/v1.0/balance-inquiry`](https://www.nicepay.co.id/nicepay/api/v1.0/transfer/balance-inquiry) | | **HTTP Method** | **POST** | | **Description** | Check balance | | **Content-type** | `application/json` | ## Request Balance Inquiry Disbursement Header Parameter | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | **Contoh** | | --------------- | -------- | ---------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | | `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 | Signature will be generated by Merchant.
[Panduan X-Signature - Symmetric](docId\:UZex33ReLyENKOgbJJnYp) | | | `X-PARTNER-ID` | String | 20 | Mandatory | Unique Partner ID, Partner ID = Client ID | | | `X-EXTERNAL-ID` | String | 40 | Mandatory | Unique messaging Reference ID generated by Merchant. Numeric String. Reference number that should be unique in every transaction. | | | `CHANNEL-ID` | String | 20 | Mandatory | Unique Channel Merchant Credential ID Number
Client ID + "01" = Channel ID
`"IONPAYTEST" + "01" = "IONPAYTEST01"` | IONPAYTEST01 | ## Request Balance Inquiry Disbursement Body Parameter | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | ---------------- | -------- | ---------- | ------------- | ------------------------------------------------------- | | `accountNo` | String | 10 | Mandatory | Merchant identifier that is unique per each Merchant | | `additionalInfo` | Object | Variable | Optional | Additional information
`"additionalInfo": { ... }` | | `msId` | String | 20 | Conditional | Merchant Seller ID | ## Response Balance Inquiry Disbursement Parameter | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | ------------------ | --------------- | ---------- | ------------- | ------------------------------------------------------------------------------------------------------------------------- | | `responseCode` | String | 7 | Mandatory | Refer to [General Response Code and Message - API SNAP](docId\:lKqJXSl5CMKdXYXxHYYSs) list | | `responseMessage` | String | 150 | Mandatory | Refer to [General Response Code and Message - API SNAP](docId\:lKqJXSl5CMKdXYXxHYYSs) list | | `accountNo` | String | 10 | Mandatory | Merchant identifier that is unique per each
merchant | | `accountInfos` | Array of Object | | | Account information
`"accountInfos": [{ ... }]` | | `availableBalance` | Object | 20 | Mandatory | Balance Information
`"availableBalance": {...}` | | `value` | String | 12 | Mandatory | Transaction amount, If it’s IDR then value includes 2 decimal digits.
e.g. IDR 10.000,- will be placed with 10000.00 | | `currency` | String | 3 | Mandatory | Currency code based on ISO | | `additionalInfo` | Object | Variable | Optional | Additional information
`"additionalInfo": { ... }` | | `msId` | String | 20 | Optional | Merchant Seller Id | ## Sample Parameter :::CodeblockTabs Request Body ```json //HEADER SECTION Content-Type: application/json Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJQREpCIiwiZXhwIjoiMjAyNC0wNi0yNVQwNTozMzowOFoifQ==.1is9UaIjMi_xowEX-IyuwNUy0ufkJR6jsLIDduKTca0= X-TIMESTAMP: 2024-06-25T11:59:00+07:00 X-SIGNATURE: SeDmpduK08TVYkaZ83+OqVg2bjXX/oQT05wG4fUdRTDPYjMRcMLfDuQ2K3Q1AdXb/GzBm6qMlORyNfOQ8YgObQ== X-PARTNER-ID :IONPAYTEST X-EXTERNAL-ID: tXid202406251402271707638102 CHANNEL-ID: IONPAYTEST { "accountNo": "IONPAYTEST", "additionalInfo": { "msId": "" } } ``` Sample Response ```json { "responseCode": "2001100", "responseMessage": "Successful", "accountNo": "IONPAYTEST", "accountInfos": [ { "availableBalance": { "value": "41570962.00", "currency": "IDR" } } ], "additionalInfo": { "msId": "" } } ``` ::: [title] Payout Beneficiary Merchant Category - API SNAP [path] NICEPAY API/API SNAP/NICEPAY Code - API SNAP/ **Payout Beneficiary Merchant Category** berisi kode parameter untuk mengidentifikasi kategori Merchant dalam sistem NICEPAY khusus API SNAP. | **Parameter** | **Description** | | ------------- | ---------------------- | | `01` | Airlines | | `02` | Automotive | | `03` | Billers | | `04` | Charity & Donation | | `05` | Digital Content | | `06` | Education | | `07` | Electronic & Gadget | | `08` | Entertainment | | `09` | Fitness Club | | `10` | Financing | | `11` | Florist | | `12` | Food & Beverages | | `13` | Furniture | | `14` | Groceries | | `15` | Health & Beauty | | `16` | Hospitality | | `17` | Information Technology | | `18` | Insurance | | `19` | Logistic | | `20` | Marketplace | | `21` | Others | | `22` | P2P Lending | | `23` | Pharmacy | | `24` | Printing | | `25` | Retail | | `26` | Sport | | `27` | Telecommunication | | `28` | Ticketing | | `29` | Tour & Travel | | `30` | Transportation | | `31` | Accessories & Fashion | | `33` | E-Commerce Platform | | `34` | Services | [title] Payout [path] NICEPAY API/API Playground/SNAP API Testing/ [title] Postman Collection [path] NICEPAY API/API Playground/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/grLSn3t84MbzL5Jqz680G_postman-logo-orange-20211155x.png "Postman") menyediakan koleksi dapat diakses secara langsung dengan menggunakan aplikasi Postman. Fitur ini disediakan untuk mempermudah sebelum melakukan atau saat melakukan dengan . ::File{src="https://archbee-doc-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/cCO6EPlmZAR-IiOeA8oFX_public-nicepay-apipostman-collection.json" label="Public NICEPAY API.postman_collection.json"} # Cara Mendapatkan Koleksi Public API NICEPAY *** Berikut langkah-langkah untuk mendapatkan koleksi Public saat menggunakan Postman: 1. Unduh File Postman Collection di atas. 2. platform akan digunakan untuk melakukan uji coba. 3. akses pada platform Postman. 4. tempat untuk menyimpan koleksi `NICEPAY Public API`. 5. `Collection` pada *sidebar* sebelah kiri. 6. Gunakan pada folder `NICEPAY API V2 Payment` dan `NICEPAY API V2 Checkout` untuk mencoba terbaru milik . ## Cara Melakukan Testing Dengan Checkout API NICEPAY ![](https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-WWDiey7rXd7l3y2pTIF5h-20240830-065139.png "Testing Checkout API") Berikut langkah-langkah melakukan dengan menggunakan (*Redirect*) pada aplikasi Postman: 1. nama URL ingin diuji coba. 2. Periksa kesesuaian URL . 3. JSON pada *tab* `Body` pada kiri layar. 4. `Send`. 5. *Response* akan muncul pada *tab* `Body` kanan. 6. tekan `paymentUrl` untuk menyelesaikan . ## Cara Melakukan Testing Dengan Payment API NICEPAY ![](https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-Ser2fNcMaSzUKNiqOHSSF-20240830-065200.png "Testing Payment API") Berikut langkah-langkah melakukan dengan menggunakan Direct pada aplikasi Postman: 1. URL akan diuji coba. 2. Periksa kesesuaian URL . 3. JSON pada *tab* `Body` pada kiri layar. 4. `Send`. 5. *Response* akan muncul pada *tab* `Body` kanan. # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Authentication](docId:_D-kQ0wA0XWRFReEX8mQd) untuk mengetahui kredensial digunakan pada saat uji coba. ::: :::VerticalSplitItem [NICEPAY Library](docId:-LENDLmgn8oCjvBWCXVoo) untuk mengetahui SDK digunakan pada . ::: :::: [title] Balance Inquiry Payout [path] NICEPAY API/API Playground/SNAP API Testing/Payout (Disbursement)/ { "id": "7LONvY5dKQWt4r5qQp_bX", "type": "api-oas-v2", "data": { "method": "POST", "url": "https://dev.nicepay.co.id/nicepay/api/v1.0/transfer/balance-inquiry", "servers": [ { "url": "https://dev.nicepay.co.id/nicepay/api/v1.0/transfer/balance-inquiry" }, { "url": "https://staging.nicepay.co.id/nicepay/api/v1.0/transfer/balance-inquiry" }, { "url": "https://www.nicepay.co.id/nicepay/api/v1.0/transfer/balance-inquiry" } ], "name": "Balance Inquiry Payout", "description": "", "contentType": "application/json", "request": { "pathParameters": [], "headerParameters": [ { "kind": "required", "name": "X-TIMESTAMP", "type": "string", "example": "2022-08-28T10:11:40+07:00" }, { "kind": "required", "name": "X-SIGNATURE", "type": "string", "default": "JjadZ5BcnMJO7p+UrnZc0qqO639TE2Duar7lSDoeblFgwBWxW6r0m/YowmNbsRAY+nSVkyLyIhvFczQ/JdaPjQ==" }, { "kind": "required", "name": "X-PARTNER-ID", "type": "string", "example": "IONPAYTEST" }, { "kind": "required", "name": "X-EXTERNAL-ID", "type": "string", "example": "2023082823595905" }, { "kind": "required", "name": "CHANNEL-ID", "type": "string", "example": "IONPAYTEST" } ], "queryParameters": [], "bodyDataParameters": [ { "kind": "required", "name": "body", "type": "object", "example": "{\"merchantId\":\"IONPAYTEST\",\"additionalInfo\":{\"msId\":\"\"}}", "description": "", "customType": "balance_inquiry_payout_body", "schema": [ { "name": "merchantId", "kind": "required", "type": "string", "description": "Merchant identifier that is unique pereach merchant", "example": "" }, { "name": "additionalInfo", "kind": "optional", "type": "object", "modelRef": "#/components/schemas/additionalInfo", "customType": "additionalInfo", "schema": [ { "name": "msId", "kind": "optional", "type": "string", "description": "Value", "example": "" } ] } ], "modelRef": "#/components/schemas/balance_inquiry_payout_body", "complexItems": [ { "name": "object", "schema": [ { "name": "merchantId", "kind": "required", "type": "string", "description": "Merchant identifier that is unique pereach merchant", "example": "" }, { "name": "additionalInfo", "kind": "optional", "type": "object", "modelRef": "#/components/schemas/additionalInfo", "customType": "additionalInfo", "schema": [ { "name": "msId", "kind": "optional", "type": "string", "description": "Value", "example": "" } ] } ], "modelRef": "#/components/schemas/Balance-Inquiry-Payout", "customType": "Balance-Inquiry-Payout" }, { "name": "object", "schema": [] } ], "complexType": "allOf", "isExpanded": true } ], "formDataParameters": [], "oAuthParameters": [ { "id": "Authorization", "name": "Authorization", "kind": "optional", "type": "http", "scheme": "bearer" } ] }, "responses": [ { "statusCode": "200", "description": "Successful", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Successful", "code": "{\n \"responseCode\": \"2001100\",\n \"responseMessage\": \"Successful\",\n \"availableBalance\": {\n \"value\": \"1215233938.00\",\n \"currency\": \"IDR\"\n }\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "SuccessfulBalanceInquiryPayout", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "2000000" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Successful" }, { "name": "availableBalance", "kind": "optional", "type": "object", "modelRef": "#/components/schemas/availableBalance", "customType": "availableBalance", "schema": [ { "name": "value", "kind": "optional", "type": "string", "description": "Value", "example": "1215233938.00" }, { "name": "currency", "kind": "optional", "type": "string", "description": "Currency", "example": "IDR" } ] } ], "modelRef": "#/components/schemas/SuccessfulBalanceInquiryPayout", "isExpanded": true } ] }, { "statusCode": "202", "description": "Request In Progress", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Request In Progress", "code": "{\n \"responseCode\": \"202XX00\",\n \"responseMessage\": \"Request In Progress\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "RequestInProgress", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "202XX00" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Request In Progress" } ], "modelRef": "#/components/schemas/RequestInProgress", "isExpanded": true } ] }, { "statusCode": "409", "description": "Duplicate partnerReferenceNo", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Duplicate partnerReferenceNo", "code": "{\n \"responseCode\": \"409XX01\",\n \"responseMessage\": \"Duplicate partnerReferenceNo\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "DuplicatePartnerReferenceNo", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "409XX01" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Duplicate partnerReferenceNo" } ], "modelRef": "#/components/schemas/DuplicatePartnerReferenceNo", "isExpanded": true } ] }, { "statusCode": "500", "description": "General Error", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "General Error", "code": "{\n \"responseCode\": \"500XX00\",\n \"responseMessage\": \"General Error\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "GeneralError", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "500XX00" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "General Error" } ], "modelRef": "#/components/schemas/GeneralError", "isExpanded": true } ] }, { "statusCode": "504", "description": "Request Timeout", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Request Timeout", "code": "{\n \"responseCode\": \"504XX00\",\n \"responseMessage\": \"Request Timeout\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "RequestTimeout", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "504XX00" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Request Timeout" } ], "modelRef": "#/components/schemas/RequestTimeout", "isExpanded": true } ] } ] }, "children": [ { "text": "" } ] } [title] Approve Payout [path] NICEPAY API/API Playground/SNAP API Testing/Payout (Disbursement)/ { "id": "M7Bjb1hpzwp2WWf3nCLC-", "type": "api-oas-v2", "data": { "method": "POST", "url": "https://dev.nicepay.co.id/nicepay/api/v1.0/transfer/approve", "servers": [ { "url": "https://dev.nicepay.co.id/nicepay/api/v1.0/transfer/approve" }, { "url": "https://staging.nicepay.co.id/nicepay/api/v1.0/transfer/approve" }, { "url": "https://www.nicepay.co.id/nicepay/api/v1.0/transfer/approve" } ], "name": "Approve Payout", "description": "", "contentType": "application/json", "request": { "pathParameters": [], "headerParameters": [ { "kind": "required", "name": "X-TIMESTAMP", "type": "string", "example": "2022-08-28T10:11:40+07:00" }, { "kind": "required", "name": "X-SIGNATURE", "type": "string", "default": "dxmAqlk/feHhVDFfYOkDW5p7VbpPEgTzFNggwNsOY5Ukbqvf6OjWkfEKi6pQ8WrO60aHS2a7aZk0EsZ+bmREYw==" }, { "kind": "required", "name": "X-PARTNER-ID", "type": "string", "example": "IONPAYTEST" }, { "kind": "required", "name": "X-EXTERNAL-ID", "type": "string", "example": "2023082823595901" }, { "kind": "required", "name": "CHANNEL-ID", "type": "string", "example": "IONPAYTEST" } ], "queryParameters": [], "bodyDataParameters": [ { "kind": "optional", "name": "body", "type": "object", "example": "{\"originalReferenceNo\":\"IONPAYTEST07202308301826504375\",\"merchantId\":\"IONPAYTEST\",\"originalPartnerReferenceNo\":\"ref-998294194\"}", "description": "", "customType": "approve_payout_body", "schema": [ { "name": "originalPartnerReferenceNo", "kind": "required", "type": "string", "description": "Original transaction identifier on consumer system", "example": "" }, { "name": "originalReferenceNo", "kind": "required", "type": "string", "description": "Original transaction identifier on service provider system", "example": "" }, { "name": "merchantId", "kind": "required", "type": "string", "description": "Merchant identifier that is unique pereach merchant", "example": "" } ], "modelRef": "#/components/schemas/approve_payout_body", "complexItems": [ { "name": "object", "schema": [ { "name": "originalPartnerReferenceNo", "kind": "required", "type": "string", "description": "Original transaction identifier on consumer system", "example": "" }, { "name": "originalReferenceNo", "kind": "required", "type": "string", "description": "Original transaction identifier on service provider system", "example": "" }, { "name": "merchantId", "kind": "required", "type": "string", "description": "Merchant identifier that is unique pereach merchant", "example": "" } ], "modelRef": "#/components/schemas/Approve-Payout", "customType": "Approve-Payout" }, { "name": "object", "schema": [] } ], "complexType": "allOf", "isExpanded": true } ], "formDataParameters": [], "oAuthParameters": [ { "id": "Authorization", "name": "Authorization", "kind": "optional", "type": "http", "scheme": "bearer" } ] }, "responses": [ { "statusCode": "200", "description": "Successful", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Successful", "code": "{\n \"responseCode\": \"2000000\",\n \"responseMessage\": \"Successful\",\n \"originalPartnerReferenceNo\": \"ref-998294194\",\n \"originalReferenceNo\": \"IONPAYTEST07202308301826504375\",\n \"beneficiaryAccountNo\": \"903327200\",\n \"beneficiaryName\": \"Test\",\n \"beneficiaryBankCode\": \"BBBA\",\n \"amount\": {\n \"value\": \"10000.00\",\n \"currency\": \"IDR\"\n },\n \"transactionStatus\": \"03\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "SuccessfulApprovePayout", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "2000000" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Successful" }, { "name": "originalPartnerReferenceNo", "kind": "optional", "type": "string", "description": "Original Partner ReferenceNo", "example": "ref-998294194" }, { "name": "originalReferenceNo", "kind": "optional", "type": "string", "description": "Original ReferenceNo", "example": "IONPAYTEST07202308301826504375" }, { "name": "beneficiaryAccountNo", "kind": "optional", "type": "string", "description": "Beneficiary AccountNo", "example": "903327200" }, { "name": "beneficiaryName", "kind": "optional", "type": "string", "description": "Beneficiary Name", "example": "Test" }, { "name": "beneficiaryBankCode", "kind": "optional", "type": "string", "description": "Beneficiary BankCode", "example": "BBBA" }, { "name": "amount", "kind": "optional", "type": "object", "modelRef": "#/components/schemas/amount", "customType": "amount", "schema": [ { "name": "currency", "kind": "optional", "type": "string", "description": "Currency", "example": "IDR" }, { "name": "value", "kind": "optional", "type": "string", "description": "Value", "example": "10000.00" } ] }, { "name": "transactionStatus", "kind": "optional", "type": "string", "description": "Transaction Status", "example": "03" } ], "modelRef": "#/components/schemas/SuccessfulApprovePayout", "isExpanded": true } ] }, { "statusCode": "202", "description": "Request In Progress", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Request In Progress", "code": "{\n \"responseCode\": \"202XX00\",\n \"responseMessage\": \"Request In Progress\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "RequestInProgress", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "202XX00" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Request In Progress" } ], "modelRef": "#/components/schemas/RequestInProgress", "isExpanded": true } ] }, { "statusCode": "409", "description": "Duplicate partnerReferenceNo", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Duplicate partnerReferenceNo", "code": "{\n \"responseCode\": \"409XX01\",\n \"responseMessage\": \"Duplicate partnerReferenceNo\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "DuplicatePartnerReferenceNo", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "409XX01" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Duplicate partnerReferenceNo" } ], "modelRef": "#/components/schemas/DuplicatePartnerReferenceNo", "isExpanded": true } ] }, { "statusCode": "500", "description": "General Error", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "General Error", "code": "{\n \"responseCode\": \"500XX00\",\n \"responseMessage\": \"General Error\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "GeneralError", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "500XX00" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "General Error" } ], "modelRef": "#/components/schemas/GeneralError", "isExpanded": true } ] }, { "statusCode": "504", "description": "Request Timeout", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Request Timeout", "code": "{\n \"responseCode\": \"504XX00\",\n \"responseMessage\": \"Request Timeout\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "RequestTimeout", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "504XX00" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Request Timeout" } ], "modelRef": "#/components/schemas/RequestTimeout", "isExpanded": true } ] } ] }, "children": [ { "text": "" } ] } [title] Unbinding - Account Binding API E-Wallet (Direct Debit) SNAP [path] NICEPAY API/API SNAP/Payment API - SNAP/API E-Wallet (Direct Debit) SNAP/Account Binding - API E-Wallet (Direct Debit) SNAP/ # Tentang Unbinding - Account Binding API E-Wallet (Direct Debit) SNAP *** ini digunakan untuk melakukan pemutusan *account binding* terhadap akun pengguna milik Pelanggan yang terhubung dengan sesuai standar . Unbinding - Account Binding API E-Wallet (Direct Debit) SNAP ============================================================ *** | **Service Code** | `09` | | ---------------- | -------------------------------------------------- | | **API Endpoint** | `/nicepay/api/v1.0/registration-account-unbinding` | | **Method** | `POST` | ## Request Header Parameter for Unbinding - Account Binding API E-Wallet (Direct Debit) SNAP | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | --------------- | -------- | ---------- | ------------- | -------------------------------------------------------------------------------------------------------------- | | `Content-Type` | String | Variable | Mandatory | Content type, value always `application/json` | | `Authorization` | String | Variable | Mandatory | Bearer “`accessToken`” | | `X-TIMESTAMP` | String | Variable | Mandatory | Transaction date time, in format `YYYY-MMDDTHH:mm:ss+07:00`. Time must be in GMT+7 (Jakarta time) | | `X-SIGNATURE` | String | Variable | Mandatory | Signature will be generated automatically by | | `X-PARTNER-ID` | String | 10 | Mandatory | Unique ID, ID = Client ID | | `X-EXTERNAL-ID` | String | 40 | Mandatory | Unique messaging Reference ID generated by . Numeric String. Reference number that should be unique in every . | | `CHANNEL-ID` | String | 5 | Mandatory | Device identification on which s is currently being accessed by End User () | ## Request Body Parameter for Unbinding - Account Binding API E-Wallet (Direct Debit) SNAP | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | -------------------- | --------------------- | ---------- | ------------- | ------------------------------------------------------------------- | | `partnerReferenceNo` | String | 40 | Mandatory | Original identifier on provider | | `merchantId` | String | 10 | Mandatory | identifier that is unique per each | | `additionalInfo` | JSON
Object | Variable | Mandatory | Additional | | `referenceNo` | String | 40 | Mandatory | Transaction ID | | `mitraCd` | String | 4 | Mandatory | Code Example :
AstraPay : `ASTR`
AlloBank : `ALLO` | | `authCode` | String | 30 | Mandatory | Authentication Code for | ## Response Header Parameter for Unbinding - Account Binding API E-Wallet (Direct Debit) SNAP | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | -------------- | -------- | ---------- | ------------- | ------------------------------------------------------------------------------------------------- | | `Content-Type` | String | Variable | Mandatory | Content type, value always `application/json` | | `X-TIMESTAMP` | String | Variable | Mandatory | Transaction date time, in format `YYYY-MMDDTHH:mm:ss+07:00`. Time must be in GMT+7 (Jakarta time) | ## Response Body Parameter for Unbinding - Account Binding API E-Wallet (Direct Debit) SNAP | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | -------------------- | -------- | ---------- | ------------- | ------------------------------------------------------------------------ | | `responseCode` | String | 7 | Mandatory | Refer to response code list | | `responseMessage` | String | 150 | Mandatory | Debug message to provide more
| | `referenceNo` | String | 40 | Mandatory | Transaction ID | | `partnerReferenceNo` | String | 40 | Mandatory | identifier | | `additionalInfo` | String | Variable | Mandatory | Additional | | `mitraCd` | String | 4 | Mandatory | Code Example :
AstraPay : `ASTR`
AlloBank : `ALLO` | | `redirectUrl` | String | 256 | Optional | Redirect URL to process unbinding account | ## Sample Parameter for Unbinding - Account Binding API E-Wallet (Direct Debit) SNAP *** ### Request Parameter :::CodeblockTabs cURL ```curl curl -X POST \ 'https://dev.nicepay.co.id/nicepay/api/v1.0/registration-account-unbinding' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8=' \ -H 'X-TIMESTAMP: 2024-01-31T10:11:40+07:00' \ -H 'X-SIGNATURE: ufBw7R8RhW79IOiV/Hlv607M60qzAYBv8uZmbSrYb6/Thlo/FhQVP4xRyelUehoSS9o+QS6vWTKb/ygtucC+tQ==' \ -H 'X-PARTNER-ID: IONPAYTEST' \ -H 'X-EXTERNAL-ID: tXid202410142300021707638093' \ -H 'CHANNEL-ID: IONPAYTEST01' \ -d '{"partnerReferenceNo":"2020102900000000000001","merchantId":"IONPAYTEST","additionalInfo":{"referenceNo":"IONPAYTEST05202208121451526358","mitraCd":"ASTR","authCode":"nlleyvaQcB2SOkVjtF7ceCuC16BiqCc6DRrjaKOnnfRdToW8Tr"}}' ``` Node.js ```nodejs const config = { isProduction: false, privateKey: cons.privateKey, clientSecret: cons.clientSecret, clientId: "IONPAYTEST", isCloudServer: false, }; const ACCESS_TOKEN = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8="; const parameter = { body: { partnerReferenceNo: "2020102900000000000001", merchantId: "IONPAYTEST", additionalInfo: { referenceNo: "IONPAYTEST05202208121451526358", mitraCd: "ASTR", authCode: "nlleyvaQcB2SOkVjtF7ceCuC16BiqCc6DRrjaKOnnfRdToW8Tr" } }, headers: { X_EXTERNAL_ID: "tXid202410142300021707638093", CHANNEL_ID: "IONPAYTEST01", }, }; let snap = new Snap(config); let endPoint = `/api/v1.0/registration-account-unbinding`; let response = snap .requestSnapTransaction(parameter, endPoint, ACCESS_TOKEN, "POST"); ``` ::: ### Response Parameter :::CodeblockTabs Sample Response ```json { "responseCode": "2000900", "responseMessage": "Successful", "referenceNo": "IONPAYTEST05202208121451526358", "partnerReferenceNo": "2020102900000000000001", "additionalInfo": { "mitraCd": "ASTR", "redirectUrl": "https://redirect.com/account-unbinding/644efc4f9396cbf1075=" } } ``` ::: [title] Virtual Account - API Checkout [path] NICEPAY API/API Checkout/Payment - API Checkout/ # Tentang Virtual Account - API Checkout *** ini digunakan oleh untuk melakukan pengajuan kepada dengan menggunakan . # Alur Proses *** ![Alur Pembayaran VA dengan Checkout API](https://app.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/n88kWq7chrzSS1lWQ2LfE_nicepay-archbee-payment-va-new-va-redirect.png "Alur Pembayaran VA dengan Checkout API") Deskripsi langkah: 1. melakukan *checkout*. 2. mengirimkan data *checkout *kepada . 3. melakukan pengajuan *checkout *menggunakan Registration kepada . 4. mengalihkan kepada . 5. mengirimkan kepada . 6. memilih . 7. membayar menggunakan VA kepada . 8. melakukan . 9. mengirimkan hasil kepada . 10. mengirim kepada . 11. memperbarui . 12. mengirim `dbProcessUrl` kepada . 13. menerima . 14. mengajukan inquiry kepada . 15. menerima pengajuan. 16. mengirimkan *response* inquiry kepada . 17. menerima terakhir. 18. mengirim hasil kepada . # NICEPAY Secure Payment Page *** :::hint{type="info"} kunjungi [Panduan Bayar VA](docId\:bSNUZMHNlj9h0wRndsQYj) untuk dapat memberikan panduan kepada dalam metode . ::: ![Secure Payment Page](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/ohh_r6otn4iPQSs_4RfL1_image-id-nicepay-secure-payment-page-main-dashboard.jpg "Secure Payment Page") Gambar di atas adalah contoh dengan metode menggunakan Secure Page. arahkan untuk memilih pilihan ATM/ Transfer pada untuk dapat melakukan . ![Virtual Account - Secure Payment Page](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/TwVksBJaFLQHPmAF5iyJE_image-id-virtual-account-secure-payment-page.jpg "Virtual Account - Secure Payment Page") Setelah memilih metode dengan transfer , akan disediakan daftar dapat dipilih untuk melanjutkan . ![Success - Secure Payment Page](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/lJGSSmGnkUkR43VadviQ7_image-id-virtual-account-success-secure-payment-page.jpg "Success - Secure Payment Page") # API Checkout Transaction Payment *** Transaction untuk digunakan untuk *request* registrasi dan . | **API URL** | `/nicepay/redirect/v2/payment` | | ------------------- | ------------------------------------------- | | **Request Method** | `Redirect-GET` | | **Header** | `Content-Type: application/Form-UrlEncoded` | ## Request Parameters for Virtual Account - API Checkout (CallbackUrl) *** | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | --------------------------------------------------------- | -------- | ---------- | --------------------- | ----------------------------------------------------------- | | `paymentURL`
Required | ANS | 14 | URL
| https\://dev.nicepay.co.id/nicepay/redirect/v2/payment | | `tXid`
Required | AN | 30 | Transaction ID
| IONPAYTEST00202212231003086046 | ## Response Parameters for Virtual Account - API Checkout (CallbackUrl) *** | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ------------- | -------- | ---------- | ----------------------------------------------------------- | ----------------------------------------------------------- | | `resultCd` | N | 4 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | 0000 | | `resultMsg` | AN | 255 | Result Message: [Error Code](docId\:yEh1VA9k2y6sL1kQF2aWD) | SUCCESS | | `bankVacctNo` | N | 30 | Number | 111111101003086046

When Success | | `tXid` | AN | 30 | Transaction ID | IONPAYTEST00202212231003086046

When Success | | `referenceNo` | ANS | 40 | Order Number | ordNo20221223101289

When Success | | `amount` | N | 12 | Transaction Amount | 10000

When Success | | `transDt` | N | 8 | Transaction Date (`YYYYMMDD`) | 20221223

When Success | | `transTm` | N | 6 | Transaction Time (`HH24MISS`) | 100308

When Success | | `bankCd` | A | 4 | [Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | CENA

When Success | | `description` | AN | 100 | Transaction Description | Testing+Transaction+Virtual+Account

When Success | :::hint{type="info"} Catatan: *Response* akan dikirimkan melalui `callBackurl` dengan Content-type: `application/json` dan metode: `POST Parameter`. ::: ## Sample Parameter for Virtual Account - API Checkout (CallbackUrl) *** :::hint{type="success"} Pada saat *Checkout*, *response *dari *request * di-*hit *adalah Callback URL. ::: ### Request Parameter :::CodeblockTabs cURL ```curl curl -X GET "https://www.merchant.com/callbackUrl?resultCd=0000&resultMsg=SUCCESS&bankVacctNo=111111101003086046&tXid=IONPAYTEST00202212231003086046&referenceNo=ordNo20221223101289&transDt=20221223&transTm=100308&amount=10000&bankCd=CENA&description=Testing+Transaction+Virtual+Account" ``` ::: ### Callback Parameter :::CodeblockTabs Response Callback ```curl resultCd=0000 resultMsg=SUCCESS bankVacctNo=111111101003086046 tXid=IONPAYTEST00202212231003086046 referenceNo=ordNo20221223101289 transDt=20221223 transTm=100308 amount=10000 bankCd=CENA description=Testing+Transaction+Virtual+Account ``` ::: ## Callback Handling API Checkout Transaction Payment *** :::hint{type="success"} Saat *Callback *diterima `callbackUrl` , kami merekomendasikan untuk melakukan verifikasi Status dengan menggunakan [Status Inquiry - API Checkout](docId\:K9vBS87ev9_w5oJAU0et3). ::: :::hint{type="warning"} `Callback Handling` sangat penting untuk membantu meminimalisir tindakan *Fraud*. Kami sangat merekomendasikan untuk melakukan verifikasi menggunakan `Callback parameter` . ::: ::Image[]{src="https://app.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/v9H6Et-FTr7kKQ5pEtNHu_nicepay-api-checkout-api-callback-handling-flow-1.png" size="50" width="370" height="361" position="center" caption="Callback Handling API" alt="Callback Handling API" showCaption="true"} :::CodeblockTabs URL Callback ```json "callbackUrl" : "https://www.merchant.com/callbackUrl/" ``` Response Callback ```json resultCd:0000 resultMsg:SUCCESS bankVacctNo:111111101452274313 tXid:IONPAYTEST00202212201452274313 referenceNo:ordNo20221220141258 transDt:20221220 transTm:144009 amount:10000 bankCd:CENA description:Testing API ``` ::: [title] API E-Wallet (Direct Debit) SNAP [path] NICEPAY API/API SNAP/Payment API - SNAP/ # Tentang API E-Wallet (Direct Debit) SNAP *** Bagian ini berisi terkait dengan fitur Host to Host sesuai standar . # API E-Wallet (Direct Debit) SNAP *** ::::LinkArray{contentSource="CUSTOM"} :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/f7XBh4tYtymEGSO_5xD33-20250912-074344.jpg"} [Account Binding - API E-Wallet (Direct Debit) SNAP](docId\:jsV9P_nt63W2A27oRCy5U) digunakan untuk mendapatkan akses token pada *account binding* dan *balance inquiry*. ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-PaOqT3DSTABb-4bfh0z0o-20240806-032759.jpg"} [Registration - API E-Wallet (Direct Debit) SNAP](docId:66iE5aVXXL4uqw6hqFPVV) digunakan untuk mengajukan . ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-PHgFKaEkf6NZsIFEoxcLR-20240806-042206.jpg"} [Check Status Transaction - API E-Wallet (Direct Debit) SNAP](docId\:vB63D8suaKPYP-4bIOWx9) digunakan untuk memeriksa . ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-tCkcApKt9IHlRjhFSyipH-20240806-040315.jpg"} [Refund Transaction - API E-Wallet (Direct Debit) SNAP](docId:8-hlezmJtlz45LRJnXcEc) untuk melakukan pengembalian dana . ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-XdOTEC0EEEDmSjSi9PNDs-20240806-040357.jpg"} [Notification Transaction - API E-Wallet (Direct Debit) SNAP](docId\:jHs6CAvEoehyUj3Ji47Hh) digunakan untuk mengirimkan . ::: :::: # Alur Proses *** ![](https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-bkyA_mhq8hQjn1ZccF4At-20240827-040744.jpg "API E-Wallet (Direct Debit) SNAP Process Flow") Deskripsi Langkah: 1. mengirimkan data *checkout *kepada . 2. mengajukan *access token* kepada . 3. melakukan *generate access token.* 4. mengirimkan response kepada . 5. menerima *access token.* 6. melakukan *generate signature.* 7. mengirimkan* Request Registration Direct Debit* kepada . 8. Pada saat melakukan : 1. Jika secara umum: - melakukan *Create Transaction Request.* - mengirimkan *response *kepada . - menampilkan pengajuan kepada . - memasukkan kredensial/*login account.* - melakukan validasi. - mengirimkan *request submit payment* kepada . - mengirimkan kepada . - melakukan . 2. Jika OVO: - mengajukan kepada . - mengirimkan *push notification* kepada aplikasi OVO milik . - melakukan login pada aplikasi OVO. - melakukan kepada . - melakukan validasi . - mengirim *response *kepada . - mengirim *response *kepada . - menampilkan *response * kepada . 9. Pada saat : 1. Jika secara umum: - mengirimkan kepada . - menerima . - mengirimkan kepada . - menerima . - mengirimkan hasil pesanan. - mengalihkan kepada . 2. Jika OVO: - mengirimkan kepada . - menerima *response * dikirimkan oleh . - mengirim hasil pesanan kepada . 10. mengajukan pemeriksaan . 11. mengirim *response *pemeriksaan kepada . 12. menerima akhir. 13. menampilkan hasil kepada . # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem Kunjungi [API Virtual Account SNAP](docId:2XCcJFVmwY9jDmD6w09oN) untuk mengetahui terkait standar pada . ::: :::VerticalSplitItem Kunjungi [API QRIS SNAP](docId:2fWhBt1oPDQeRmQJBODlU) untuk mengetahui terkait standar pada . ::: :::: [title] Registration - API Credit Card [path] NICEPAY API/API Non-SNAP/Payment API/API Credit Card/ # Tentang Registration - API Credit Card *** Registrasi pada digunakan untuk mendaftarkan menggunakan sebelum melakukan . ::::LinkArray{contentSource="CUSTOM"} :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/lE0uMyNiD2_etwJKnm8Ql-20260316-093218.jpg"} [Full Payment & Installment - Registration API Credit Card](docId:_Ls7or4RN1z2Pgc8wH8lD) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/MlGVVD18YkLQmK3fW3ORr-20260316-093603.jpg"} [Recurring - Registration API Credit Card](docId\:SjreJJRgOns-SDo4dqNE2) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/RJJy6cUNi5W3LK-khRdS8-20260316-093749.jpg"} [Pre-Auth & Capture - Registration API Credit Card](docId\:VJ5k6iZOTkdPnRfMabAJ8) ::: :::: :::hint{type="info"} mengunjungi [Kartu Kredit](docId:1pHQ_XU3Dpep4hzX41lqg) untuk mengetahui penjelasan umum tentang . ::: [title] Payout API (Disbursement) - SNAP [path] NICEPAY API/API SNAP/ # Tentang Payout API (Disbursement) - SNAP *** Bagian ini berisi tentang informasi terkait API dengan standar SNAP yang digunakan untuk melakukan transaksi Payout (Disbursement). # Daftar Payout API (Disbursement) - SNAP *** ::::LinkArray :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-s4rHYcLyTJ9g0on1oIJ7T-20240806-030243.jpg"} [Registration - API Payout (Disbursement) SNAP](docId\:SgtN0VBKPUWVOV62EVREB) digunakan untuk mengajukan pendaftaran transaksi pembayaran. ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-3rcfkh7UopJ6AY-DBB914-20240806-030450.jpg"} [Approve Transaction - API Payout (Disbursement) SNAP](docId\:Q5UEc9-eqJxtmhVJtMbV7) digunakan untuk mengajukan persetujuan transaksi. ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-uPXRRfPitPjKDFBRApZsb-20240806-030507.jpg"} [Inquiry - API Payout (Disbursement) SNAP](docId\:GkYB9CEm1x0EzRv_wCLre) digunakan untuk mengajukan *inquiry *transaksi. ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-EM4F0A8lTdw8ZDI_vtImE-20240806-030524.jpg"} [Cancel Transaction - API Payout (Disbursement) SNAP](docId:25Q_ooJlYAS8krNpg6bb3) digunakan untuk mengajukan pembatalan transaksi. ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-4I46_cxvSUj6cx-1p-Ivp-20240806-030540.jpg"} [Reject Transaction - API Payout (Disbursement) SNAP](docId:926778w1tSetC6obRYhwX) digunakan untuk menolak transaksi. ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-OvqZ0bT0F8qgILM5VUXSJ-20240806-030603.jpg"} [Balance Inquiry - API Payout (Disbursement) SNAP](docId\:e-wNhrOEkkZ1Hxiqz7S_5) digunakan untuk mengajukan *balance inquiry*. ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-B3hXaRy-j_vIPqB65JtqK-20240806-030623.jpg"} [Notification - API Payout (Disbursement) SNAP](docId:23kjHEyImhQ75q-Pg1Y_R) digunakan untuk mengirimkan notifikasi transaksi. ::: :::: # Alur Proses *** ![](https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-rAakqMpf_AEf5ZeZN04RA-20240828-060719.jpg "Alur Proses Payout API SNAP") Deskripsi langkah: 1. Merchant mengajukan *access token* kepada NICEPAY. 2. NICEPAY melakukan *generate access token*. 3. NICEPAY mengirimkan *response access token* kepada Merchant. 4. Merchant menerima *access token*. 5. Merchant melakukan *generate signature*. 6. Merchant mengirimkan *data request* melalui API Registration kepada NICEPAY. 7. NICEPAY mengumpulkan data. 8. NICEPAY melakukan *generate* `TXID`. 9. Pada saat proses pengajuan: - Proses antara NICEPAY dan Merchant: - NICEPAY mengirimkan response `TXID` kepada Merchant. - Merchant menyimpan `txID`. - Proses antara NICEPAY dan Bank - NICEPAY mengajukan akun kepada Bank. - Bank melakukan validasi akun. - Bank mengirimkan *response *kepada NICEPAY. - NICEPAY menyimpan *response*. 10. Merchant melakukan *generate signature*. 11. Merchant mengirimkan *data approve* melalui API Approve kepada NICEPAY. 12. NICEPAY mengumpulkan *data request*. 13. Pada saat proses *Approve*: - Proses antara NICEPAY dan Merchant: - NICEPAY mengirimkan *response processing* kepada Merchant. - Proses antara NICEPAY dan Bank: - NICEPAY mengirimkan proses *batch *kepada Bank. - Bank melakukan proses *payroll*. - Bank mengirimkan *response data*. 14. NICEPAY mendapatkan *response*. 15. NICEPAY mengirimkan pesan notifikasi kepada Merchant. 16. Merchant mengajukan pemeriksaan status melalui Check Status API kepada NICEPAY. 17. NICEPAY mengirimkan *response check status *kepada Merchant. 18. Merchant menerima status akhir. # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem Kunjungi halaman [Request Access Token API - SNAP](docId\:GcGqBIYXG1Etcd0Ji9cHX) untuk mengetahui rincian API SNAP untuk mendapatkan akses token. ::: :::VerticalSplitItem Kunjungi halaman [Payment API - SNAP](docId:-M_V-II4nkTcxd6jiHTfg) untuk mengetahui rincian API SNAP yang digunakan pada metode pembayaran dalam sistem NICEPAY. ::: :::: ::::VerticalSplit{layout="middle"} :::VerticalSplitItem Kunjungi halaman [Advance API - SNAP](docId\:iytnF1uTXSDGwvjRVS62b) untuk mengetahui rincian API SNAP khusus NICEPAY yang lebih terdepan. ::: :::VerticalSplitItem ::: :::: [title] Advance API - SNAP [path] NICEPAY API/API SNAP/ # Tentang Advance API - SNAP *** Bagian ini berisi tentang informasi terkait API dengan standar SNAP khusus tipe transaksi yang lebih maju pada metode pembayaran tertentu. ::::LinkArray :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-J5yQtnsY7PaE4XOTJHJ8O-20240805-110009.jpg"} [API NICEPAY Inquiry Virtual Account SNAP](docId\:W-Zwlzxm-p6FyqA3tqaDD) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ho7Cq0xJG60lzOZLT7xI3-m09pvw2UsIgraX_T7aff8-20250610-073217.jpg"} [API NICEPAY Inquiry Convenience Store SNAP](docId\:EBWCa66a1Uy-zxThFtDCy) ::: :::: # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem Kunjungi halaman [Payment API - SNAP](docId:-M_V-II4nkTcxd6jiHTfg) untuk mengetahui rincian API SNAP yang digunakan pada metode pembayaran dalam sistem NICEPAY. ::: :::VerticalSplitItem Kunjungi halaman [Payout API (Disbursement) - SNAP](docId\:pImeP_3g-q6QNBFmwvkOr) untuk mengetahui rincian API SNAP pada Payout. ::: :::: [title] Registration Payout [path] NICEPAY API/API Playground/SNAP API Testing/Payout (Disbursement)/ { "id": "yXIF5xlUVLbXgr1ZgTmyO", "type": "api-oas-v2", "data": { "method": "POST", "url": "https://dev.nicepay.co.id/nicepay/api/v1.0/transfer/registration", "servers": [ { "url": "https://dev.nicepay.co.id/nicepay/api/v1.0/transfer/registration" }, { "url": "https://staging.nicepay.co.id/nicepay/api/v1.0/transfer/registration" }, { "url": "https://www.nicepay.co.id/nicepay/api/v1.0/transfer/registration" } ], "name": "Registration Payout", "description": "", "contentType": "application/json", "request": { "pathParameters": [], "headerParameters": [ { "kind": "required", "name": "X-TIMESTAMP", "type": "string", "example": "2022-08-28T10:11:40+07:00" }, { "kind": "required", "name": "X-SIGNATURE", "type": "string", "default": "Ou8dyOrYUCQvLtHp97bK47ObWNsd4CJRIpPstWmvEGUWnaQ1opo6+zjhC+U4QWIFwpBZaL2EZKzxIsnpY29dCw==" }, { "kind": "required", "name": "X-PARTNER-ID", "type": "string", "example": "IONPAYTEST" }, { "kind": "required", "name": "X-EXTERNAL-ID", "type": "string", "example": "2023082823595900" }, { "kind": "required", "name": "CHANNEL-ID", "type": "string", "example": "IONPAYTEST" } ], "queryParameters": [], "bodyDataParameters": [ { "kind": "optional", "name": "body", "type": "object", "example": "{\"beneficiaryAccountNo\":\"903327200\",\"description\":\"Test Snap Payout\",\"beneficiaryAddress\":\"Test Address\",\"payoutMethod\":\"0\",\"beneficiaryDOE\":\"220101\",\"msId\":\"\",\"deliveryId\":\"\",\"beneficiaryCoNo\":\"12345JP\",\"merchantId\":\"IONPAYTEST\",\"beneficiaryName\":\"Test\",\"beneficiaryPostalCode\":\"123456\",\"beneficiaryPhone\":\"081211111111\",\"partnerReferenceNo\":\"ref-998294194\",\"beneficiaryCoMgmtName\":\"Test Snap Payout\",\"beneficiaryMerCategory\":\"01\",\"amount\":{\"currency\":\"IDR\",\"value\":\"10000.00\"},\"beneficiaryCoShName\":\"\",\"beneficiaryPOE\":\"Test City\",\"reservedTm\":\"120000\",\"beneficiaryCustomerType\":\"1\",\"beneficiaryAuthPhoneNumber\":\"081211111111\",\"beneficiaryBankCode\":\"BBBA\",\"beneficiaryCustomerResidence\":\"1\",\"deliveryName\":\"Test\",\"reservedDt\":\"20230905\"}", "description": "", "customType": "registration_payout_body", "schema": [ { "name": "merchantId", "kind": "required", "type": "string", "description": "Merchant identifier that is unique per each merchant", "example": "" }, { "name": "msId", "kind": "optional", "type": "string", "description": "Merchant Seller Id", "example": "" }, { "name": "beneficiaryAccountNo", "kind": "required", "type": "string", "description": "Beneficiary Account Number", "example": "" }, { "name": "beneficiaryName", "kind": "required", "type": "string", "description": "Beneficiary Name", "example": "" }, { "name": "beneficiaryPhone", "kind": "required", "type": "string", "description": "Beneficiary Phone", "example": "" }, { "name": "beneficiaryCustomerResidence", "kind": "required", "type": "string", "description": "1 = Indonesia, 2 = Non Indonesia", "example": "" }, { "name": "beneficiaryCustomerType", "kind": "required", "type": "string", "description": "1 = Personal, 2 = Company, 3 = Government", "example": "" }, { "name": "beneficiaryPostalCode", "kind": "optional", "type": "string", "description": "Beneficiary Postal Code", "example": "" }, { "name": "payoutMethod", "kind": "required", "type": "string", "description": "0 = Over Booking, 2 = Online Trans, 3 = SKN, 4 = RTGS", "example": "" }, { "name": "beneficiaryBankCode", "kind": "required", "type": "string", "description": "Beneficiary Bank Code", "example": "" }, { "name": "amount", "kind": "required", "type": "object", "modelRef": "#/components/schemas/amount", "customType": "amount", "schema": [ { "name": "currency", "kind": "optional", "type": "string", "description": "Currency", "example": "IDR" }, { "name": "value", "kind": "optional", "type": "string", "description": "Value", "example": "10000.00" } ] }, { "name": "partnerReferenceNo", "kind": "required", "type": "string", "description": "Transaction ID from Merchant", "example": "" }, { "name": "reservedDt", "kind": "optional", "type": "string", "description": "Format 2022-08-28T10:11:40+07:00. Time must be in GM(Jakarta time)", "example": "" }, { "name": "reservedTm", "kind": "optional", "type": "string", "description": "Format 2022-08-28T10:11:40+07:00. Time must be in GM(Jakarta time)", "example": "" }, { "name": "description", "kind": "optional", "type": "string", "description": "Description Transaction", "example": "" }, { "name": "deliveryName", "kind": "optional", "type": "string", "description": "Name of the beneficiary or recipient", "example": "" }, { "name": "deliveryId", "kind": "optional", "type": "string", "description": "Recipient's identification number such as ID card, passport, dlicense", "example": "" }, { "name": "beneficiaryPOE", "kind": "optional", "type": "string", "description": "Beneficiary place of establishment", "example": "" }, { "name": "beneficiaryDOE", "kind": "optional", "type": "string", "description": "Beneficiary date of establishment", "example": "" }, { "name": "beneficiaryCoNo", "kind": "optional", "type": "string", "description": "Beneficiary business license number (NIB/TDB)", "example": "" }, { "name": "beneficiaryAddress", "kind": "optional", "type": "string", "description": "Beneficiary company address", "example": "" }, { "name": "beneficiaryMerCategory", "kind": "optional", "type": "string", "example": "" }, { "name": "beneficiaryAuthPhoneNumber", "kind": "optional", "type": "string", "description": "Beneficiary Authorized Phone Number", "example": "" }, { "name": "beneficiaryCoMgmtName", "kind": "optional", "type": "string", "description": "Beneficiary Company Management Name", "example": "" }, { "name": "beneficiaryCoShName", "kind": "optional", "type": "string", "description": "Beneficiary Company Shareholder Name", "example": "" } ], "modelRef": "#/components/schemas/registration_payout_body", "complexItems": [ { "name": "object", "schema": [ { "name": "merchantId", "kind": "required", "type": "string", "description": "Merchant identifier that is unique per each merchant", "example": "" }, { "name": "msId", "kind": "optional", "type": "string", "description": "Merchant Seller Id", "example": "" }, { "name": "beneficiaryAccountNo", "kind": "required", "type": "string", "description": "Beneficiary Account Number", "example": "" }, { "name": "beneficiaryName", "kind": "required", "type": "string", "description": "Beneficiary Name", "example": "" }, { "name": "beneficiaryPhone", "kind": "required", "type": "string", "description": "Beneficiary Phone", "example": "" }, { "name": "beneficiaryCustomerResidence", "kind": "required", "type": "string", "description": "1 = Indonesia, 2 = Non Indonesia", "example": "" }, { "name": "beneficiaryCustomerType", "kind": "required", "type": "string", "description": "1 = Personal, 2 = Company, 3 = Government", "example": "" }, { "name": "beneficiaryPostalCode", "kind": "optional", "type": "string", "description": "Beneficiary Postal Code", "example": "" }, { "name": "payoutMethod", "kind": "required", "type": "string", "description": "0 = Over Booking, 2 = Online Trans, 3 = SKN, 4 = RTGS", "example": "" }, { "name": "beneficiaryBankCode", "kind": "required", "type": "string", "description": "Beneficiary Bank Code", "example": "" }, { "name": "amount", "kind": "required", "type": "object", "modelRef": "#/components/schemas/amount", "customType": "amount", "schema": [ { "name": "currency", "kind": "optional", "type": "string", "description": "Currency", "example": "IDR" }, { "name": "value", "kind": "optional", "type": "string", "description": "Value", "example": "10000.00" } ] }, { "name": "partnerReferenceNo", "kind": "required", "type": "string", "description": "Transaction ID from Merchant", "example": "" }, { "name": "reservedDt", "kind": "optional", "type": "string", "description": "Format 2022-08-28T10:11:40+07:00. Time must be in GM(Jakarta time)", "example": "" }, { "name": "reservedTm", "kind": "optional", "type": "string", "description": "Format 2022-08-28T10:11:40+07:00. Time must be in GM(Jakarta time)", "example": "" }, { "name": "description", "kind": "optional", "type": "string", "description": "Description Transaction", "example": "" }, { "name": "deliveryName", "kind": "optional", "type": "string", "description": "Name of the beneficiary or recipient", "example": "" }, { "name": "deliveryId", "kind": "optional", "type": "string", "description": "Recipient's identification number such as ID card, passport, dlicense", "example": "" }, { "name": "beneficiaryPOE", "kind": "optional", "type": "string", "description": "Beneficiary place of establishment", "example": "" }, { "name": "beneficiaryDOE", "kind": "optional", "type": "string", "description": "Beneficiary date of establishment", "example": "" }, { "name": "beneficiaryCoNo", "kind": "optional", "type": "string", "description": "Beneficiary business license number (NIB/TDB)", "example": "" }, { "name": "beneficiaryAddress", "kind": "optional", "type": "string", "description": "Beneficiary company address", "example": "" }, { "name": "beneficiaryMerCategory", "kind": "optional", "type": "string", "example": "" }, { "name": "beneficiaryAuthPhoneNumber", "kind": "optional", "type": "string", "description": "Beneficiary Authorized Phone Number", "example": "" }, { "name": "beneficiaryCoMgmtName", "kind": "optional", "type": "string", "description": "Beneficiary Company Management Name", "example": "" }, { "name": "beneficiaryCoShName", "kind": "optional", "type": "string", "description": "Beneficiary Company Shareholder Name", "example": "" } ], "modelRef": "#/components/schemas/Registration-Payout", "customType": "Registration-Payout" }, { "name": "object", "schema": [] } ], "complexType": "allOf", "isExpanded": true } ], "formDataParameters": [], "oAuthParameters": [ { "id": "Authorization", "name": "Authorization", "kind": "optional", "type": "http", "scheme": "bearer" } ] }, "responses": [ { "statusCode": "200", "description": "Successful", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Successful", "code": "{\n \"responseCode\": \"2000000\",\n \"responseMessage\": \"Successful\",\n \"partnerReferenceNo\": \"ref-998294194\",\n \"originalReferenceNo\": \"IONPAYTEST07202308301826504375\",\n \"beneficiaryaccountNo\": \"903327200\",\n \"beneficiaryName\": \"Test\",\n \"payoutMethod\": \"0\",\n \"beneficiaryBankCode\": \"BBBA\",\n \"amount\": {\n \"value\": \"10000.00\",\n \"currency\": \"IDR\"\n }\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "SuccessfulRegistrationPayout", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "2000000" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Successful" }, { "name": "partnerReferenceNo", "kind": "optional", "type": "string", "description": "Partner ReferenceNo", "example": "ref-998294194" }, { "name": "originalReferenceNo", "kind": "optional", "type": "string", "description": "Original ReferenceNo", "example": "IONPAYTEST07202308301826504375" }, { "name": "beneficiaryaccountNo", "kind": "optional", "type": "string", "description": "Beneficiary accountNo", "example": "903327200" }, { "name": "beneficiaryName", "kind": "optional", "type": "string", "description": "Beneficiary Name", "example": "Test" }, { "name": "payoutMethod", "kind": "optional", "type": "string", "description": "Payout Method", "example": "0" }, { "name": "beneficiaryBankCode", "kind": "optional", "type": "string", "description": "Beneficiary BankCode", "example": "BBBA" }, { "name": "amount", "kind": "optional", "type": "object", "modelRef": "#/components/schemas/amount", "customType": "amount", "schema": [ { "name": "currency", "kind": "optional", "type": "string", "description": "Currency", "example": "IDR" }, { "name": "value", "kind": "optional", "type": "string", "description": "Value", "example": "10000.00" } ] } ], "modelRef": "#/components/schemas/SuccessfulRegistrationPayout", "isExpanded": true } ] }, { "statusCode": "202", "description": "Request In Progress", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Request In Progress", "code": "{\n \"responseCode\": \"202XX00\",\n \"responseMessage\": \"Request In Progress\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "RequestInProgress", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "202XX00" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Request In Progress" } ], "modelRef": "#/components/schemas/RequestInProgress", "isExpanded": true } ] }, { "statusCode": "409", "description": "Duplicate partnerReferenceNo", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Duplicate partnerReferenceNo", "code": "{\n \"responseCode\": \"409XX01\",\n \"responseMessage\": \"Duplicate partnerReferenceNo\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "DuplicatePartnerReferenceNo", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "409XX01" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Duplicate partnerReferenceNo" } ], "modelRef": "#/components/schemas/DuplicatePartnerReferenceNo", "isExpanded": true } ] }, { "statusCode": "500", "description": "General Error", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "General Error", "code": "{\n \"responseCode\": \"500XX00\",\n \"responseMessage\": \"General Error\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "GeneralError", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "500XX00" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "General Error" } ], "modelRef": "#/components/schemas/GeneralError", "isExpanded": true } ] }, { "statusCode": "504", "description": "Request Timeout", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Request Timeout", "code": "{\n \"responseCode\": \"504XX00\",\n \"responseMessage\": \"Request Timeout\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "RequestTimeout", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "504XX00" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Request Timeout" } ], "modelRef": "#/components/schemas/RequestTimeout", "isExpanded": true } ] } ] }, "children": [ { "text": "" } ] } [title] API NICEPAY Inquiry Convenience Store SNAP [path] NICEPAY API/API SNAP/Advance API - SNAP/ # Tentang API NICEPAY Inquiry Convenience Store SNAP *** Bagian ini berisi tentang terkait dengan standar digunakan pada dengan fitur Inquiry (NICO). Pada fitur ini, data berada di sisi . Sehingga, pada setiap dari , melakukan inquiry data , konfirmasi , dan melakukan *request* ke . # Daftar API NICEPAY Inquiry Convenience Store SNAP *** ::::LinkArray :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ho7Cq0xJG60lzOZLT7xI3-VftI97Bd4s814U0RUBIlO-20250610-070035.jpg"} [Request Access Token - API NICEPAY Inquiry Convenience Store SNAP](docId\:Bo7josDlhHB-_TMdE6TGS) digunakan untuk mengajukan *request access token*. ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ho7Cq0xJG60lzOZLT7xI3-2ZtZrFWtRANrTmBaAdy-q-20250610-070458.jpg"} [Inquiry - API NICEPAY Inquiry Convenience Store SNAP](docId\:AwHBy9XkuBX3Nvm7pB70U) digunakan untuk mengajukan pemeriksaan status pembayaran. ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ho7Cq0xJG60lzOZLT7xI3-mRnsIvIGRYJjeHm6zx7rU-20250610-070432.jpg"} [Payment - API NICEPAY Inquiry Convenience Store SNAP](docId\:w9map2LRmyYOiH0jHzqfz) digunakan untuk mengajukan pembayaran. ::: :::: # Alur Proses *** ![](https://archbee-image-uploads.s3.amazonaws.com/ho7Cq0xJG60lzOZLT7xI3-r9jcjuLj2hgjsDHcyv9XL-20250516-093435.jpg "Alur Proses API NICO SNAP") Deskripsi Langkah: 1. Pelanggan melakukan checkout pesanan kepada Merchant. 2. Merchant melakukan validasi dan generate payNo. 3. Merchant mengirimkan payNo kepada Pelanggan. 4. Pelanggan menampilkan payNo yang dikirimkan oleh Merchant. 5. NICEPAY mengajukan token kepada Merchant. 6. Merchant melakukan validasi dan generate token. 7. Merchant mengirimkan response kepada NICEPAY. 8. NICEPAY menerima token. 9. Convenience Store memasukkan payNo. 10. Convenience Store melakukan proses inquiry data kepada NICEPAY. 11. NICEPAY mengajukan inquiry data kepada Merchant. 12. Merchant memeriksa transaksi. 13. Merchant mengirimkan informasi response inquiry data kepada NICEPAY. 14. NICEPAY menerima informasi inquiry data. 15. NICEPAY mengirimkan informasi response inquiry data kepada Convenience Store. 16. Convenience Store menerima informasi inquiry data. 17. Convenience Store melakukan proses pembayaran. 18. Convenience Store mengajukan pembayaran kepada NICEPAY. 19. NICEPAY mengajukan pembayaran kepada Merchant. 20. Setelah Merchant menerima pembayaran, kemudian: - Merchant menampilkan response pembayaran kepada Pelanggan. - Proses antara Merchant, NICEPAY, dan Pelanggan: - Merchant mengirimkan response pembayaran kepada NICEPAY. - NICEPAY menerima informasi pembayaran. - NICEPAY mengirimkan informasi pembayaran kepada Convenience Store. - Convenience Store menerima informasi pembayaran. - Convenience Store menampilkan response pembayaran kepada Pelanggan. [title] Installment Type Code - API SNAP [path] NICEPAY API/API SNAP/NICEPAY Code - API SNAP/ *Installment Type* adalah jenis sistem metode pembayaran cicilan yang akan dilakukan oleh Pelanggan. Bagian ini diimplementasi oleh Developer pada sistem menggunakan parameter `instmntType`. Parameter ini digunakan pada metode pembayaran Kartu Kredit untuk menentukan apakah pembayaran dilakukan secara penuh atau cicilan. Dengan menggunakan `instmntType`, penggunaan *value code index, *antara lain: | **Nilai Kode (*****Value Code)*** | **Deskripsi** | | --------------------------------- | ------------------- | | `1` | Full Payment | | `2` | Installment Payment | [title] Authentication [path] NICEPAY API/API Non-SNAP/ # Proses *Authentication* *** *Authentication* merupakan prosedur keamanan untuk mengenali identitas dari suatu *request* asing. Apabila identitas tersebut sudah dikenali oleh , maka *request* tersebut dapat mengakses tersebut. Dalam hal ini, membutuhkan identitas Key terlebih dahulu disebut `merchantKey` dari *request* , sehingga dapat terhubung dengan tanpa hambatan apapun. Selain `merchantKey`, juga dibutuhkan untuk mengirim *mandatory parameter*, yaitu `merchantToken`. ## Merchant Key Key terbagi menjadi dua tipe, yaitu Sandbox Credentials dan Production Credentials. ### Sandbox Credentials Apabila ingin melakukan uji coba kami terlebih dahulu sebelum melakukan dengan , silakan menggunakan kredensial telah disediakan di bawah ini dengan menggunakan `iMid` **IONPAYTEST**. :::hint{type="info"} `iMid` merupakan identitas atau ID sebagai pada . `iMid` hanya dikhususkan untuk penggunaan akan diberikan setelah resmi terdaftar sebagai kami. Untuk melakukan , silakan memakai `iMid` **IONPAYTEST **dan memakai Key khusus tersebut di *Sandbox Credentials.* ::: | `iMid `
******(Merchant ID)****** | **IONPAYTEST**
**(AutoPaid)** | | ------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- | | `merchantKey` | 33F49GnCMS1mFYlGXisbUDzVf2ATWCl9k3R++d5hDd3Frmuos/XLx8XhXpe+LDYAbpGKZYSwtlyyLOtS/8aD7A== | :::hint{type="info"} Kredensial di atas disediakan hanya untuk keperluan serta akan dibuat berhasil secara otomatis (`AutoPaid`). ::: ### Production/Live Credentials Apabila sudah resmi terdaftar menjadi dan ingin melakukan tahap dengan nyata, dapat melihat `merchantKey` yang kami buatkan khusus dengan iMid di dalam portal [Merchant Back Office](docId\:VMD8YtiiJqku6H8dRhcS6). Berikut langkah untuk mendapatkan `merchantKey`: 1. Akses *dashboard* [Merchant Back Office](https://bo.nicepay.co.id/logIn.do) . 2. [Profile](docId\:QCQLE2qARHiRIYKBlQaGD). 3. [Merchant Data](docId\:nhLxfdnlMApjpL1c2lwiP). 4. *tab* `Other`. 5. *Scroll* ke bawah untuk mendapatkan `merchantKey` . ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/sXerwgaWCl-lFAYzimrFY_merchant-key.png "Panduan Melihat M_KEY / Merchant Key") :::hint{type="warning"} Jangan lupa untuk mencantumkan `iMid` sesuai dengan `iMid` terdaftar untuk saat melakukan dengan kami. ::: ## Merchant Token `MerchantToken` digunakan untuk melakukan autentikasi keamanan dengan . Parameter ini dibuat dengan menggunakan metode *hashing* `SHA-256` sudah termasuk `iMid`, `merchantKey`, serta variabel lain dibutuhkan. Berikut detail dari Token. ```javascript //Generate merchantToken// merchantData = timeStamp + iMid + refNo + amount + merchantKey; merTok = CryptoJS.SHA256(merchantData).toString(CryptoJS.enc.Hex); Sample: merchantData = 20221202101271 + IONPAYTEST + OrdNo-20221202101271 + 100000 + 33F49GnCMS1mFYlGXisbUDzVf2ATWCl9k3R++d5hDd3Frmuos/XLx8XhXpe+LDYAbpGKZYSwtlyyLOtS/8aD7A== merTok = d7c10cfccd64fdb21836f4330bb23f9ed357bc4b02420399d48b4661b89a55a0 ``` | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | | ------------- | -------- | ---------- | ---------------------------------------- | | `timeStamp` | N | 14 | Transaction Timestamp (`YYYYMMDDHHMMSS)` | | `iMid` | AN | 10 | ID | | `refNo` | ANS | 40 | 's Reference Number | | `amount` | N | 12 | Amount | | `merchantKey` | ANS | 88 | Key | ## NICEPAY API URL Berikut URL dapat gunakan sesuai dengan kebutuhan . URL ini harus di-*request* melalui protokol HTTPS agar dapat terhubung dengan kami. | **Environment** | **Protocol** | **Base URL** | | --------------- | ------------ | -------------------------------- | | Development | https | `https://dev.nicepay.co.id/` | | Staging | https | `https://staging.nicepay.co.id/` | | Production | https | `https://www.nicepay.co.id/` | ## Uji Coba Metode Pembayaran Setelah mendapatkan semua keperluan autentikasi agar dapat berinteraksi dengan kami, silakan kunjungi laman di bawah ini untuk uji dengan kami. | **Metode Pembayaran** | **Kredensial** | | --------------------- | ---------------------------------------------------------------- | | | [Integrasi & Testing Kartu Kredit](docId\:ZA5d5J-5w_gT44qGTxB5n) | | | [Integrasi & Testing CVS](docId:6zSlSRyypvTgFXAKRIXHI) | | | [Integrasi & Testing Direct Debit](docId\:sHrV7hpVnWLt9ipNeCfE4) | | | [Integrasi & Testing Paylater](docId\:ZEuw_0d227R_LUPBI3ptN) | | | [Integrasi & Testing GPN](docId\:LuCYNk98cX7upRb-xSZS3) | [title] Mitra Code - API SNAP [path] NICEPAY API/API SNAP/NICEPAY Code - API SNAP/ Code digunakan sebagai *value *(Nilai) `mitraCd` pada , , , , dan . # General *** | **Nilai** | **Deskripsi** | **Metode Pembayaran** | | --------- | ----------------------------------- | --------------------- | | `ALMA` | Alfamart, Lawson, Dan+Dan, Alfamidi | | | `INDO` | Indomaret | | | `BCAC` | BCA KlikPay | | | `JENC` | Jenius Pay | | | `AKLP` | Akulaku | | | `KDVI` | Kredivo | | | `IDNA` | Indodana | | | `OVOE` | OVO | | | `LINK` | LinkAja | | | `DANA` | DANA | | | `ESHP` | ShopeePay | | | `ASTR` | Astrapay | | | `QSHP` | ShopeePay | | | `NOBU` | NOBU | | [title] Refund QRIS [path] NICEPAY API/API Playground/SNAP API Testing/QRIS/ { "id": "w222UQKfFpNuXMqSZjW5t", "type": "api-oas-v2", "data": { "method": "POST", "url": "https://dev.nicepay.co.id/nicepay/api/v1.0/qr/qr-mpm-refund", "servers": [ { "url": "https://dev.nicepay.co.id/nicepay/api/v1.0/qr/qr-mpm-refund" }, { "url": "https://staging.nicepay.co.id/nicepay/api/v1.0/qr/qr-mpm-refund" }, { "url": "https://www.nicepay.co.id/nicepay/api/v1.0/qr/qr-mpm-refund" } ], "name": "Refund QRIS", "description": "", "contentType": "application/json", "request": { "pathParameters": [], "headerParameters": [ { "kind": "required", "name": "X-TIMESTAMP", "type": "string", "example": "2022-08-04T23:59:59+07:00" }, { "kind": "required", "name": "X-SIGNATURE", "type": "string", "default": "EMztJdlrulaR7I/iECF8ggjbb5KFaWurB2OJJ9V1TGBh9yxcaRf76ozN9IBfwBwI3Ft4qipQcrg1a0vh8Zhapw==" }, { "kind": "required", "name": "X-PARTNER-ID", "type": "string", "example": "TNICEQR081" }, { "kind": "required", "name": "X-EXTERNAL-ID", "type": "string", "example": "20230804230101" }, { "kind": "required", "name": "CHANNEL-ID", "type": "string", "example": "TNICEQR081" } ], "queryParameters": [], "bodyDataParameters": [ { "kind": "required", "name": "body", "type": "object", "example": "{\"originalPartnerReferenceNo\":\"ncpy20221017161458\",\"originalReferenceNo\":\"TNICEQR08108202309122320370700\",\"partnerRefundNo\":\"ncpy20221017161458\",\"merchantId\":\"TNICEQR081\",\"externalStoreId\":\"NicepayStoreID1\",\"refundAmount\":{\"refundAmount\":{\"value\":\"10000.00\",\"currency\":\"IDR\"}},\"reason\":\"Refund Trans\",\"additionalInfo\":{\"cancelType\":\"1\"}}", "description": "", "customType": "refund_body", "schema": [ { "name": "originalReferenceNo", "kind": "required", "type": "string", "description": "Transaction ID (Generated by Nicepay)", "example": "TNICEQR08108202309122320370700" }, { "name": "originalPartnerReferenceNo", "kind": "required", "type": "string", "description": "Unique Transaction ID from Merchant", "example": "" }, { "name": "partnerRefundNo", "kind": "required", "type": "string", "description": "Merchant refund reference number", "example": "" }, { "name": "merchantId", "kind": "required", "type": "string", "description": "Nicepay Merchant ID", "example": "TNICEQR081" }, { "name": "externalStoreId", "kind": "required", "type": "string", "description": "Merchant ID from Acquirer Pay Side", "example": "" }, { "name": "refundAmount", "kind": "required", "type": "object", "modelRef": "#/components/schemas/refundAmount", "customType": "refundAmount", "schema": [ { "name": "value", "kind": "optional", "type": "string", "example": "" }, { "name": "currency", "kind": "optional", "type": "string", "example": "" } ] }, { "name": "reason", "kind": "required", "type": "string", "description": "Reason of cancel", "example": "" }, { "name": "additionalInfo", "kind": "required", "type": "object", "modelRef": "#/components/schemas/additionalInfo", "customType": "additionalInfo", "schema": [ { "name": "cancelType", "kind": "optional", "type": "string", "example": "" } ] } ], "modelRef": "#/components/schemas/refund_body", "complexItems": [ { "name": "object", "schema": [ { "name": "originalReferenceNo", "kind": "required", "type": "string", "description": "Transaction ID (Generated by Nicepay)", "example": "TNICEQR08108202309122320370700" }, { "name": "originalPartnerReferenceNo", "kind": "required", "type": "string", "description": "Unique Transaction ID from Merchant", "example": "" }, { "name": "partnerRefundNo", "kind": "required", "type": "string", "description": "Merchant refund reference number", "example": "" }, { "name": "merchantId", "kind": "required", "type": "string", "description": "Nicepay Merchant ID", "example": "TNICEQR081" }, { "name": "externalStoreId", "kind": "required", "type": "string", "description": "Merchant ID from Acquirer Pay Side", "example": "" }, { "name": "refundAmount", "kind": "required", "type": "object", "modelRef": "#/components/schemas/refundAmount", "customType": "refundAmount", "schema": [ { "name": "value", "kind": "optional", "type": "string", "example": "" }, { "name": "currency", "kind": "optional", "type": "string", "example": "" } ] }, { "name": "reason", "kind": "required", "type": "string", "description": "Reason of cancel", "example": "" }, { "name": "additionalInfo", "kind": "required", "type": "object", "modelRef": "#/components/schemas/additionalInfo", "customType": "additionalInfo", "schema": [ { "name": "cancelType", "kind": "optional", "type": "string", "example": "" } ] } ], "modelRef": "#/components/schemas/RefundQRis", "customType": "RefundQRis" }, { "name": "object", "schema": [] } ], "complexType": "allOf", "isExpanded": true } ], "formDataParameters": [], "oAuthParameters": [ { "id": "Authorization", "name": "Authorization", "kind": "optional", "type": "http", "scheme": "bearer" } ] }, "responses": [ { "statusCode": "200", "description": "Successful", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Successful", "code": "{\n \"responseCode\": \"2007800\",\n \"responseMessage\": \"Successful\",\n \"originalReferenceNo\": \"TNICEQR08108202309122320370700\",\n \"referenceNo\": \"TNICEQR08108202309122320370700\",\n \"partnerRefundNo\": \"ncpy20221017161458\",\n \"refundTime\": \"2023-09-12T23:20:40+07:00\",\n \"refundAmount\": {\n \"value\": \"10000.00\",\n \"currency\": \"IDR\"\n },\n \"additionalInfo\": {\n \"cancelTrxSn\": \"\"\n }\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "SuccessfulRefundQris", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "2007800" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Successful" }, { "name": "originalReferenceNo", "kind": "optional", "type": "string", "description": "Original ReferenceNo", "example": "TNICEQR08108202309122320370700" }, { "name": "referenceNo", "kind": "optional", "type": "string", "description": "ReferenceNo", "example": "TNICEQR08108202309122320370700" }, { "name": "partnerRefundNo", "kind": "optional", "type": "string", "description": "Partner RefundNo", "example": "ncpy20221017161458" }, { "name": "refundTime", "kind": "optional", "type": "string", "description": "Refund Time", "example": "2023-09-12T23:20:40+07:00" }, { "name": "refundAmount", "kind": "optional", "type": "object", "modelRef": "#/components/schemas/amount", "customType": "amount", "schema": [ { "name": "value", "kind": "optional", "type": "string", "example": "" }, { "name": "currency", "kind": "optional", "type": "string", "example": "" } ] }, { "name": "additionalInfo", "kind": "optional", "type": "object", "modelRef": "#/components/schemas/additionalInfoResponseRefundQris", "customType": "additionalInfoResponseRefundQris", "schema": [ { "name": "cancelTrxSn", "kind": "optional", "type": "string", "description": "Cancel TrxSn", "example": "" } ] } ], "modelRef": "#/components/schemas/SuccessfulRefundQris", "isExpanded": true } ] }, { "statusCode": "202", "description": "Request In Progress", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Request In Progress", "code": "{\n \"responseCode\": \"202XX00\",\n \"responseMessage\": \"Request In Progress\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "RequestInProgress", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "202XX00" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Request In Progress" } ], "modelRef": "#/components/schemas/RequestInProgress", "isExpanded": true } ] }, { "statusCode": "409", "description": "Duplicate partnerReferenceNo", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Duplicate partnerReferenceNo", "code": "{\n \"responseCode\": \"409XX01\",\n \"responseMessage\": \"Duplicate partnerReferenceNo\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "DuplicatePartnerReferenceNo", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "409XX01" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Duplicate partnerReferenceNo" } ], "modelRef": "#/components/schemas/DuplicatePartnerReferenceNo", "isExpanded": true } ] }, { "statusCode": "500", "description": "General Error", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "General Error", "code": "{\n \"responseCode\": \"500XX00\",\n \"responseMessage\": \"General Error\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "GeneralError", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "500XX00" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "General Error" } ], "modelRef": "#/components/schemas/GeneralError", "isExpanded": true } ] }, { "statusCode": "504", "description": "Request Timeout", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Request Timeout", "code": "{\n \"responseCode\": \"504XX00\",\n \"responseMessage\": \"Request Timeout\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "RequestTimeout", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "504XX00" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Request Timeout" } ], "modelRef": "#/components/schemas/RequestTimeout", "isExpanded": true } ] } ] }, "children": [ { "text": "" } ] } [title] Check Status Transaction - API E-Wallet (Direct Debit) SNAP [path] NICEPAY API/API SNAP/Payment API - SNAP/API E-Wallet (Direct Debit) SNAP/ # Tentang Check Status Transaction - API E-Wallet (Direct Debit) SNAP *** API ini digunakan untuk melakukan pemeriksaan status transaksi yang dilakukan dengan metode pembayaran E-Wallet dengan Fitur Direct Debit Host to Host yang sesuai standar SNAP. # Check Status Transaction - API E-Wallet (Direct Debit) SNAP *** :::hint{type="warning"} Silakan mengajukan akses token terlebih dahulu untuk melakukan autentikasi melalui bagian [Request Access Token API - SNAP](docId\:GcGqBIYXG1Etcd0Ji9cHX). ::: | **Service Code** | `55` | | ---------------- | ----------------------------------------------------------------------------------- | | **API Endpoint** | [`/api/v1.0/debit/status`](https://dev.nicepay.co.id/nicepay/api/v1.0/debit/status) | | **HTTP Method** | **POST** | | **Description** | Request check status for authentication | | **Content-type** | `application/json` | ## Request Header Parameter for Check Status Transaction - API E-Wallet (Direct Debit) SNAP *** | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | **Contoh** | | --------------- | -------- | ---------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | | `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 | Signature will be generated by Merchant.
[Panduan X-Signature - Symmetric](docId\:UZex33ReLyENKOgbJJnYp) | | | `X-PARTNER-ID` | String | 20 | Mandatory | `X-PARTNER-ID` = `CLIENT_ID` | | | `X-EXTERNAL-ID` | String | 40 | Mandatory | Unique Reference Number
(`41807553358950093184`) | | | `CHANNEL-ID` | String | 20 | Mandatory | Unique Channel Merchant Credential ID Number
Client ID + "01" = Channel ID
`"IONPAYTEST" + "01" = "IONPAYTEST01"` | IONPAYTEST01 | ## Request Body Parameter for Check Status Transaction - API E-Wallet (Direct Debit) SNAP *** | **Parameter** | **Tipe** | **Kebutuhan** | **Ukuran** | **Deskripsi atau Contoh** | | ---------------------------- | -------------------- | ------------- | ---------- | -------------------------------------------------------------------------------------------------------------------------- | | `merchantId` | String | Mandatory | 10 | Merchant identifier that is unique per each Merchant | | `subMerchantId` | String | Optional | 32 | Sub Merchant ID | | `originalReferenceNo` | String | Mandatory | 40 | Original transaction identifier on service provider system | | `originalPartnerReferenceNo` | String | Mandatory | 40 | Original transaction identifier on consumer system | | `externalStoreId` | String | Optional | 32 | Unique identifier of Shop ID in Client system | | `serviceCode` | String | Mandatory | 2 | Transaction type indicator (service code of the original transaction request) | | `amount` | Array of JSON Object | Mandatory | Variable | Amount of transaction
`"amount": { `
` "value": "12345678.00", `
`"currency": "IDR" `
` }` | | `value` | String | Mandatory | 12 | Value | | `currency` | String | Mandatory | 3 | Currency | | `transactionDate` | String | Optional | 25 | Transaction date: ISO8601, in format `YYYYMMDDTHH: mm:ss+07:00`.
Time must be in GMT+7 (Jakarta time). | | `additionalInfo` | JSON Object | Optional | Variable | Additional information | ## Response Parameter for Check Status Transaction - API E-Wallet (Direct Debit) SNAP *** | **Nama Parameter BI** | **Tipe Parameter** | **Kebutuhan** | **NICEPAY Parameter** | **Deskripsi atau Contoh** | | ---------------------------- | -------------------- | ------------- | --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `responseCode` | String | Mandatory | 7 | Refer to [General Response Code and Message - API SNAP](docId\:lKqJXSl5CMKdXYXxHYYSs) list | | `responseMessage` | String | Mandatory | 150 | Refer to [General Response Code and Message - API SNAP](docId\:lKqJXSl5CMKdXYXxHYYSs) list | | `originalReferenceNo` | String | Mandatory | 40 | Original transaction identifier on service provider system | | `originalPartnerReferenceNo` | String | Mandatory | 40 | Original transaction identifier on service provider system. Must be filled upon successful transaction | | `serviceCode` | String | Mandatory | 2 | Transaction type indicator (service code of the original transaction request) | | `latestTransactionStatus` | String | Mandatory | 2 | Category code .
Example:
`00`: Success
`01`: Initiated
`02`: Paying
`03`: Pending
`04`: Refunded
`05`: Canceled
`06`: Failed
`07`: Not found | | `transactionStatusDesc` | String | Optional | 50 | Description status transaction | | `transAmount` | Array of JSON Object | Mandatory | Variable | Amount of transaction
`"transAmount": { `
` "currency": "IDR", `
` "value": "239.00" `
` }` | | `value` | String | Mandatory | 12 | Value | | `currency` | String | Mandatory | 3 | Currency | | `paidTime` | String | Conditional | 25 | Transaction date: ISO 8601 `YYYY-MM `
`DDThh:mm:ss`

If the the transaction is `Success`, it will contain time from after payment completely successful. Meanwhile for transactions that are `Pending` or `Failed`, it will contain time from during initial payment request to the Partner. | | `additionalInfo` | JSON Object | Optional | Variable | Additional Information
`"additionalInfo": { `
` ... }` | | `mitra_cd` | String | Mandatory | 4 | [Mitra Code - API SNAP](docId\:mebNfCDEq1GFUs9oE_MOF)
Example:
ShopeePay: `ESHP`
OVO: `OVOE`
LinkAja: `LINK`
DANA: `DANA`
AstraPay: `ASTR` | | `goodsNm` | String | Mandatory | 200 | Goods Name | | `billingNm` | String | Mandatory | 100 | Buyer Name | | `billingPhone` | String | Mandatory | 20 | Buyer Phone Number | ## Sample Parameter for Check Status Transaction API E-Wallet (Direct Debit) SNAP *** ### Request Parameter :::CodeblockTabs cURL ```curl curl -X POST \ 'https://dev.nicepay.co.id/nicepay/api/v1.0/debit/status' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8=' \ -H 'X-TIMESTAMP: 2024-12-31T10:11:40+07:00' \ -H 'X-SIGNATURE: ufBw7R8RhW79IOiV/Hlv607M60qzAYBv8uZmbSrYb6/Thlo/FhQVP4xRyelUehoSS9o+QS6vWTKb/ygtucC+tQ==' \ -H 'X-PARTNER-ID: TNICEEW051' \ -H 'X-EXTERNAL-ID: tXid202402111402271707638100' \ -H 'CHANNEL-ID: TNICEEW05101' \ -d '{"merchantId":"23489182303312","subMerchantId":"23489182303312","originalPartnerReferenceNo":"2020102900000000000001","originalReferenceNo":"TNICEEW05105202210141451109841","serviceCode":"54","transactionDate":"2020-12-21T14:56:11+07:00","externalStoreId":"239840198240795109","amount":{"value":"12345678.00","currency":"IDR"},"additionalInfo":{}}' ``` Node.js ```nodejs // --- Debit Payment Status Data (TNICEEW051 Context) --- const PARTNER_ID = "TNICEEW051"; const ACCESS_TOKEN = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8="; const X_TIMESTAMP = "2024-12-31T10:11:40+07:00"; const X_EXTERNAL_ID = "tXid202402111402271707638100"; const CHANNEL_ID = "TNICEEW05101"; const MERCHANT_ID_BODY = "23489182303312"; const STORE_ID = "239840198240795109"; const SUB_MERCHANT_ID = "23489182303312"; const PARTNER_REF_NO = "2020102900000000000001"; const ORIGINAL_REF_NO = "TNICEEW05105202210141451109841"; const SERVICE_CODE = "54"; const TRANSACTION_DATE = "2020-12-21T14:56:11+07:00"; const AMOUNT_VALUE = "12345678.00"; // Step 1: Configure the SDK const config = { isProduction: false, privateKey: cons.privateKey, clientSecret: cons.clientSecret, clientId: PARTNER_ID, // TNICEEW051 isCloudServer: false, }; // Step 2: Define the Debit Status Inquiry Request Parameters let paramCheckStatus = { body: { merchantId: MERCHANT_ID_BODY, subMerchantId: SUB_MERCHANT_ID, originalPartnerReferenceNo: PARTNER_REF_NO, originalReferenceNo: ORIGINAL_REF_NO, serviceCode: SERVICE_CODE, transactionDate: TRANSACTION_DATE, externalStoreId: STORE_ID, amount: { value: AMOUNT_VALUE, currency: "IDR", }, additionalInfo: {} }, headers: { X_EXTERNAL_ID: X_EXTERNAL_ID, CHANNEL_ID: CHANNEL_ID, }, }; let snap = new Snap(config); let endPoint = `/api/v1.0/debit/status`; let response = snap .requestSnapTransaction(paramCheckStatus, endPoint, ACCESS_TOKEN, "POST"); ``` ```java final String PARTNER_ID = "TNICEEW05"; // X-PARTNER-ID from cURL final String X_EXTERNAL_ID = "tXid202402111402271707638100"; final String X_TIMESTAMP = "2024-12-31T10:11:40+07:00"; final String ACCESS_TOKEN = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8="; // Step 1: Configuration (TNICEEW05 context) final NICEPay config2 = NICEPay.builder() .isProduction(false) .clientSecret("YOUR_CLIENT_SECRET") .partnerId(PARTNER_ID) .externalID(X_EXTERNAL_ID) .timestamp(X_TIMESTAMP) .privateKey("YOUR_PRIVATE_KEY") .build(); final var accessToken = ACCESS_TOKEN; // Step 2: Request Body (Debit Status Inquiry Payload) final InquiryStatus requestData = InquiryStatus.builder() .merchantId("23489182303312") // merchantId from cURL body .subMerchantId("23489182303312") // subMerchantId from cURL body .originalPartnerReferenceNo("2020102900000000000001") .originalReferenceNo("TNICEEW05105202210141451109841") .serviceCode("54") .transactionDate("2020-12-21T14:56:11+07:00") .externalStoreId("239840198240795109") .amount("12345678.00", "IDR") // additionalInfo is implicitly an empty object as per cURL .build(); // Step 3: Execute the Inquiry NICEPayResponse response = SnapInquiryStatusService.callServiceEwalletCheckStatus(requestData, accessToken, config2); ``` ```python PARTNER_ID = "TNICEEW051" SUB_MERCHANT_ID = "23489182303312" ORIGINAL_REF_NO = "TNICEEW05105202210141451109841" ORIGINAL_PARTNER_REF_NO = "2020102900000000000001" SERVICE_CODE = "54" TRANSACTION_DATE = "2020-12-21T14:56:11+07:00" EXTERNAL_STORE_ID = "239840198240795109" AMOUNT_VALUE = "12345678.00" bodyCreateToken = ( builderAccessToken.BuildAccessToken() .setGrantType("client_credentials") .setAdditionalInfo({}) .build() ) amount = { "value": AMOUNT_VALUE, "currency": "IDR" } additionalInfo = {} bodyDirectDebitInquiry = ( builderDirectDebit.BuildDirectDebitInquiry() .setMerchantId(PARTNER_ID) .setSubMerchantId(SUB_MERCHANT_ID) .setOriginalPartnerReferenceNo(ORIGINAL_PARTNER_REF_NO) .setOriginalReferenceNo(ORIGINAL_REF_NO) .setServiceCode(SERVICE_CODE) .setTransactionDate(TRANSACTION_DATE) .setExternalStoreId(EXTERNAL_STORE_ID) .setAmount(amount) .setAdditionalInfo(additionalInfo) .build() ) environment = (builderEnvironment.BuildEnvironment() .isCloud(False) .isProduction(False) .build()) result = SnapService.serviceTransaction(bodyCreateToken.jsonAccessToken(), bodyDirectDebitInquiry.jsonDirectDebitInquiry(), ConstantsEndpoints.inquiryDirectDebit(), environment) ``` C# ```csharp const string PARTNER_ID = "TNICEEW051"; const string CHANNEL_ID = "TNICEEW05101"; const string X_TIMESTAMP = "2024-12-31T10:11:40+07:00"; const string X_EXTERNAL_ID = "tXid202402111402271707638100"; const string ACCESS_TOKEN = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8="; string privateKey = config.PrivateKey; string clientSecret = config.ClientSecret; string clientId = PARTNER_ID; string timestamp = X_TIMESTAMP; string channelId = CHANNEL_ID; string random = SignatureGeneratorUtils.GenerateRandomNumberString(8); bool isProduction = false; bool isCloudServer = false; string signature = SignatureGeneratorUtils.GenerateSignature(privateKey, clientId, timestamp); // Create Ewallet service ApiEndpoints apiEndpoints = new ApiEndpoints(); APIService ewalletService = new APIService(apiEndpoints, clientSecret, clientId, channelId, isProduction, isCloudServer); SnapEwalletServices snapEwalletServices = new SnapEwalletServices(clientId); string createRequestBody = snapEwalletServices.GenerateStatusEwalletRequest( merchantId: "23489182303312", subMerchantId: "23489182303312", originalPartnerReferenceNo: "2020102900000000000001", originalReferenceNo: "TNICEEW05105202210141451109841", serviceCode: "54", transactionDate: DateTime.Parse("2020-12-21T14:56:11+07:00"), externalStoreId: "239840198240795109", amountValue: "12345678.00", currency: "IDR" ); Console.WriteLine("Inquiry Ewallet Request: " + createRequestBody); // Send POST request string externalId = X_EXTERNAL_ID; string createResponse = await ewalletService.SendPostRequest(apiEndpoints.StatusEwallet, accessToken, timestamp, createRequestBody, externalId); Console.WriteLine("Inquiry Ewallet Response: " + createResponse); ``` Laravel ```php const string ACCESS_TOKEN = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8="; const string X_TIMESTAMP = "2024-12-31T10:11:40+07:00"; const string X_EXTERNAL_ID = "tXid202402111402271707638100"; const string CHANNEL_ID = "TNICEEW05101"; protected $useProd = false; protected $useCloud = false; protected $inquiry_ewallet_endpoint = "/api/v1.0/debit/status"; // Corrected endpoint for status inquiry // Credential protected $client_id = "TNICEEW051"; PROTECTED $key = "_PRIVATE_KEY_MERCHANT"; PROTECTED $client_secret = "_CLIENT_SECRET_MERCHANT"; PROTECTED $access_token = ACCESS_TOKEN; PROTECTED $store_id = "239840198240795109"; $url = HttpUtil::getNicepayDomain($this->useProd, $this->useCloud) . $this->inquiry_ewallet_endpoint; $helper = new Helpers(); $http_method = "POST"; $x_time_stamp = X_TIMESTAMP; $partner_id = $this->client_id; $client_secret = $this->client_secret; $access_token = $this->access_token; $store_id = $this->store_id; $external_id = X_EXTERNAL_ID; $channel_id = CHANNEL_ID; $amount = [ "value" => "12345678.00", "currency" => "IDR" ]; $additionalInfo = new \stdClass(); $body = [ "merchantId" => "23489182303312", // merchantId from cURL body "subMerchantId" => "23489182303312", "originalPartnerReferenceNo" => "2020102900000000000001", "originalReferenceNo" => "TNICEEW05105202210141451109841", "serviceCode" => "54", "transactionDate" => "2020-12-21T14:56:11+07:00", "externalStoreId" => "239840198240795109", "amount" => $amount, "additionalInfo" => $additionalInfo ]; $string_to_sign = $helper->generateStringToSign( $http_method, $this->inquiry_ewallet_endpoint, $access_token, $body, $x_time_stamp ); $signature = $helper->hmacSHA512Encoded( $string_to_sign, $client_secret, OPENSSL_ALGO_SHA512 ); $header = $helper->generateHeader( $access_token, $x_time_stamp, $signature, $partner_id, $external_id, $channel_id ); print_r($string_to_sign); print_r("\r\n"); print_r($header); print_r($body); try { $response = HttpUtil::postJsonRequestWithHeader($url, $body, $header); } catch (Exception $e) { // Handle exception } ``` PHP Native ```php $config = NICEPay::builder() ->setIsProduction(false) ->setPrivateKey($this->oldKeyFormat) ->setClientSecret($this->clientSecret) ->setPartnerId("TNICEEW051") ->setExternalID("tXid202402111402271707638100") ->setTimestamp("2024-12-31T10:11:40+07:00") ->build(); $accessToken = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8="; $requestBody = InquiryStatus::builder() ->setMerchantId("23489182303312") ->setSubMerchantId("23489182303312") ->setOriginalPartnerReferenceNo("2020102900000000000001") ->setOriginalReferenceNO("TNICEEW05105202210141451109841") ->setServiceCode("54") ->setTransactionDate("2020-12-21T14:56:11+07:00") ->setExternalStoreId("239840198240795109") ->setAmount("12345678.00", "IDR") ->setAdditionalInfo([]) ->build(); $snapEwalletService = new SnapEwalletService($config); $response = $snapEwalletService->inquiryStatus($requestBody, $accessToken); ``` ```kotlin const val PARTNER_ID = "TNICEEW051" const val X_EXTERNAL_ID = "tXid202402111402271707638100" const val X_TIMESTAMP = "2024-12-31T10:11:40+07:00" const val ACCESS_TOKEN = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8=" // Step 1: Initialize the NICEPay Configuration (Header context) var config: NICEPay = NICEPay.Builder() .isProduction(false) .clientSecret("YOUR_CLIENT_SECRET") .partnerId(PARTNER_ID) .externalID(X_EXTERNAL_ID) .timestamp(X_TIMESTAMP) .privateKey("YOUR_PRIVATE_KEY") .build() // Step 2: Define the Static Status Request Body val checkStatusEwallet: SnapCheckStatus = SnapCheckStatus.Builder() .merchantId("23489182303312") .subMerchantId("23489182303312") .originalPartnerReferenceNo("2020102900000000000001") .originalReferenceNo("TNICEEW05105202210141451109841") .serviceCode("54") .transactionDate("2020-12-21T14:56:11+07:00") .externalStoreId("239840198240795109") .amount("12345678.00", "IDR") .build() // Step 3: Execute the Inquiry (Removed dynamic token fetching) val response: NICEPayResponse? = snapEwalletService.checkStatus(checkStatusEwallet, ACCESS_TOKEN, config) ``` CodeIgniter ```php $config = NICEPay::builder() ->setIsProduction(false) ->setIsCloudServer(isCloudServer: true) ->setPrivateKey($this->oldKeyFormat) ->setClientSecret($this->clientSecret) ->setPartnerId("TNICEEW051") ->setExternalID("tXid202402111402271707638100") ->setTimestamp("2024-12-31T10:11:40+07:00") ->build(); $accessToken = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8="; $requestBody = InquiryStatusEwallet::builder() ->setMerchantId("23489182303312") ->setSubMerchantId("23489182303312") ->setOriginalPartnerReferenceNo("2020102900000000000001") ->setOriginalReferenceNO("TNICEEW05105202210141451109841") ->setServiceCode("54") ->setTransactionDate("2020-12-21T14:56:11+07:00") ->setExternalStoreId("239840198240795109") ->setAmount("12345678.00", "IDR") ->setAdditionalInfo([]) ->build(); $snapEwalletService = new SnapEwalletService(); try { $response = $snapEwalletService->inquiryStatusEwallet($requestBody, $accessToken, $config); } catch (\Exception $e) { // Handle exception } ``` ::: ### Response Parameter :::CodeblockTabs Sample Response ```json { "responseCode": "2005500", "responseMessage": "Successful", "originalPartnerReferenceNo": "2020102900000000000001", "originalReferenceNo": "TNICEEW05105202210141451109841", "serviceCode": "54", "latestTransactionStatus": "00", "transactionStatusDesc": "success", "transAmount": { "currency": "IDR", "value": "100.00" }, "paidTime": "2020-12-21T14:56:11+07:00", "additionalInfo": { "mitra_cd": "DANA", "goodsNm": "Merchant Goods 1", "billingNm": "Buyer Name", "billingPhone": "02112345678" } } ``` ::: [title] Payment API [path] NICEPAY API/API Non-SNAP/ **Payment API** memfasilitasi sebagai untuk membuat *payment page* sendiri sehingga dapat membuat fitur tersebut sesuai dengan kebutuhan , serta mendukung yang lebih cepat, aman, dan dapat diandalkan oleh setia . mencakup beberapa terdiri dari: ::::LinkArray{contentSource="CUSTOM"} :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/L7x3tmF0u011Cf4Km-TId-20260316-084005.jpg"} [API Credit Card](docId\:cyRgujq86sHzFaLML0S1E) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/VOL7Ln_3yn1w_OzzVJFnB-20260316-084125.jpg"} [API Convenience Store](docId\:D27aRe5Bm0Ax39UkpPmtl) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/J6P3EKBJ18_RgPGNHm8r8-20260316-084240.jpg"} [API Direct Debit](docId\:AZ85J1cVqOJWBAdGrimaw) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/NXwiS_wTVoWiB7jCLPPZb_header-non-snap-payment-api-paylater.jpg"} [API Paylater](docId:5yKOH01P6iksF7kv727Cd) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/GVhrykfxd4PWNNE6lOFkB-20260316-085030.jpg"} [API GPN](docId:6rUfOgfHR_rfbzArq8Fsv) ::: :::: # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [API Checkout](docId\:Djp90D-rlCNeDCzKwGC-d) untuk mengetahui digunakan pada *checkout*. ::: :::VerticalSplitItem [Advance API](docId\:qyS-Qyem-hUj6iKk-tAu7) untuk mengetahui rincian khusus lebih terdepan. ::: :::: ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [NICEPAY Code](docId\:kYd45uYYIjwzVs3dt8_rk) untuk mengetahui arti kode digunakan oleh . ::: :::VerticalSplitItem ::: :::: [title] Request Access Token [path] NICEPAY API/API Playground/SNAP API Testing/Request Access Token/ { "id": "Q7nh7Lloa6StyLcRfbiWx", "type": "api-oas-v2", "data": { "method": "POST", "url": "https://dev.nicepay.co.id/nicepay/v1.0/access-token/b2b", "servers": [ { "url": "https://dev.nicepay.co.id/nicepay/v1.0/access-token/b2b" }, { "url": "https://staging.nicepay.co.id/nicepay/v1.0/access-token/b2b" }, { "url": "https://www.nicepay.co.id/nicepay/v1.0/access-token/b2b" } ], "name": "Request Access Token", "description": "", "contentType": "application/json", "request": { "pathParameters": [], "headerParameters": [ { "kind": "required", "name": "X-SIGNATURE", "type": "string", "default": "icZEJ7mPLLNNs+DdQo94BnOl9ywU3LY1iU/OxMlB+sIwJr1OVGBWhhc1H8r033l3DZPuyWmhsm8TL4GbBlXsIAj92NYiNlG6mktfoDpYrdqzXgDMYLWKtrYiaai2wpelY+8KLP86iA6+LIE5gEpwSm7j8iFK6RTJKV12VEMszds=" }, { "kind": "required", "name": "X-CLIENT-KEY", "type": "string", "example": "IONPAYTEST" }, { "kind": "required", "name": "X-TIMESTAMP", "type": "string", "example": "2022-08-04T23:59:59+07:00" } ], "queryParameters": [], "bodyDataParameters": [ { "kind": "required", "name": "body", "type": "object", "example": "{\"grantType\":\"client_credentials\",\"additionalInfo\":{}}", "description": "", "customType": "b2b_body", "schema": [ { "name": "grantType", "kind": "required", "type": "string", "example": "client_credentials" }, { "name": "additionalInfo", "kind": "optional", "type": "object", "description": "", "example": "", "schema": [] } ], "modelRef": "#/components/schemas/b2b_body", "complexItems": [ { "name": "object", "schema": [ { "name": "grantType", "kind": "required", "type": "string", "example": "client_credentials" }, { "name": "additionalInfo", "kind": "optional", "type": "object", "description": "", "example": "", "schema": [] } ], "modelRef": "#/components/schemas/Request-Access-Token", "customType": "Request-Access-Token" }, { "name": "object", "schema": [] } ], "complexType": "allOf", "isExpanded": true } ], "formDataParameters": [], "oAuthParameters": [] }, "responses": [ { "statusCode": "200", "description": "Success", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Successful", "code": "{\n \"responseCode\": \"0000\",\n \"responseMessage\": \"Successful\",\n \"accessToken\": \"Xy8duZzAvv9bwDXxRxcb89tsuvk4MF4kx4lGfE4aCRVxR7XdERhbe1\",\n \"tokenType\": \"Bearer\",\n \"expiresIn\": \"900\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "Success", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "2007300" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Successful" }, { "name": "accessToken", "kind": "optional", "type": "string", "description": "A string representing an authorization issued to the client that used to access protected resources", "example": "Xy8duZzAvv9bwDXxRxcb89tsuvk4MF4kx4lGfE4aCRVxR7XdERhbe1" }, { "name": "tokenType", "kind": "optional", "type": "string", "description": "The access token type", "example": "Bearer" }, { "name": "expiresIn", "kind": "optional", "type": "string", "description": "Session expiry in seconds -> 900 (15 minutes)", "example": "900" } ], "modelRef": "#/components/schemas/Success", "isExpanded": true } ] }, { "statusCode": "202", "description": "Request In Progress", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Request In Progress", "code": "{\n \"responseCode\": \"202XX00\",\n \"responseMessage\": \"Request In Progress\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "RequestInProgress", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "202XX00" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Request In Progress" } ], "modelRef": "#/components/schemas/RequestInProgress", "isExpanded": true } ] }, { "statusCode": "401", "description": "Unauthorized [reason]", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Unauthorized [reason]", "code": "{\n \"responseCode\": \"401XX00\",\n \"responseMessage\": \"Unauthorized [reason]\"\n}" }, { "label": "Access Token Invalid", "code": "{\n \"responseCode\": \"401XX01\",\n \"responseMessage\": \"Access Token Invalid\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "UnauthorizedReason", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "401XX00" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Unauthorized [reason]" } ], "modelRef": "#/components/schemas/UnauthorizedReason", "isExpanded": true } ] }, { "statusCode": "409", "description": "Duplicate partnerReferenceNo", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Duplicate partnerReferenceNo", "code": "{\n \"responseCode\": \"409XX01\",\n \"responseMessage\": \"Duplicate partnerReferenceNo\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "DuplicatePartnerReferenceNo", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "409XX01" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Duplicate partnerReferenceNo" } ], "modelRef": "#/components/schemas/DuplicatePartnerReferenceNo", "isExpanded": true } ] }, { "statusCode": "500", "description": "General Error", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "General Error", "code": "{\n \"responseCode\": \"500XX00\",\n \"responseMessage\": \"General Error\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "GeneralError", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "500XX00" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "General Error" } ], "modelRef": "#/components/schemas/GeneralError", "isExpanded": true } ] }, { "statusCode": "504", "description": "Request Timeout", "jsonExample": "", "isExpanded": true, "subExamples": [ { "label": "Request Timeout", "code": "{\n \"responseCode\": \"504XX00\",\n \"responseMessage\": \"Request Timeout\"\n}" } ], "schema": [ { "kind": "optional", "type": "object", "customType": "RequestTimeout", "schema": [ { "name": "responseCode", "kind": "optional", "type": "string", "description": "Response Code", "example": "504XX00" }, { "name": "responseMessage", "kind": "optional", "type": "string", "description": "Response Message", "example": "Request Timeout" } ], "modelRef": "#/components/schemas/RequestTimeout", "isExpanded": true } ] } ] }, "children": [ { "text": "" } ] } [title] Registration - API Checkout [path] NICEPAY API/API Checkout/ # Tentang Registration - API Checkout *** Langkah pada** Registration - API Checkout** ini berfungsi untuk mendaftarkan sebuah *request checkout *belanja dari kepada kami. Sehingga dapat membayar jumlah yang ditagihkan pada *payment page* sediakan. Pada prinsipnya, semua pada memiliki sama. Hanya saja membedakan adalah pada setiap . :::hint{type="info"} Pada saat melakukan , melakukan pendaftaran pesanan sebelum dapat melakukan pada diinginkan melalui tautan didapatkan. kunjungi [Payment - API Checkout](docId\:YnNFZr9aonpJ7ZIKAFYSx) untuk mengetahui penjelasan lebih rinci terkait khusus . ::: # Registration - API Checkout (All Payment Method) *** Untuk dapat menggunakan seluruh pada kecuali , diperlukan untuk mendaftarkan tersebut dengan Registrasi ini. Berikut nya: | **API URL** | `/nicepay/redirect/v2/registration` | | ------------------ | ----------------------------------------------------------------- | | **Method** | **POST** | | **Header** | `Content-Type: application/json` | | **Merchant Token** | SHA256 (`timestamp`+ `iMid`+ `referenceNo`+ `amt`+ `merchantKey`) | ## Request Parameter for Registration - API Checkout *** | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | -------------------------------------------------------------------------------------------------------------------------------- | ------------- | ---------- | ----------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `iMid`
Required | AN | 10 | ID | IONPAYTEST | | `timeStamp`
Required | N | 14 | Request Timestamp
(`YYYYMMDDHH24MISS`) | 20230516660517 | | `payMethod`
Required | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | 00 | | `bankCd`
Optional for VA | A | 4 | [Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | CENA | | `currency`
Required | AN | 3 | Currency | IDR | | `amt`
Required | N | 12 | Transaction Amount | 10000 | | `referenceNo`
Required | ANS | 40 | Order Number | MerchantReferenceNumber001 | | `merchantToken`
Required | AN | 255 | Token | 4686062c297a3e48cf385953f411bbd48753bb70b041f2113a3e7c2e99c54f3c | | `callBackUrl`
Required | AN | 255 | Result Forward URL | https\://www\.merchant.com/callbackUrl/ | | `dbProcessUrl`
Required | AN | 255 | Notification URL | https\://www\.merchant.com/dbProcessUrl | | `goodsNm`
Required | AN | 100 | Goods Name | Goods 1 | | `mitraCd`
Optional For CVS, Direct Debit, E-Wallet & Paylater | AN | 4 | [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8) | DANA | | `vacctValidDt`
Required For VA | N | 8 | VA Expiry Date
(`YYYYMMDD`) | 20230531 | | `vacctValidTm`
Required For VA | N | 8 | VA Expiry Time
(`HH24MISS`) | 235959 | | `description`
Required | AN | 100 | Transaction Description | This Is The Description Of The | | `billingNm`
Required | A | 100 | Billing Name | John Doe | | `billingPhone`
Required | N | 15 | Billing Phone | 08123456789 | | `billingEmail`
Required | AN | 40 | Billing E-mail | john.doe\@example.com | | `billingAddr` | AN | 100 | Billing Address | Jln. Raya Casablanka Kav.88 | | `billingCity`
Required | A | 50 | Billing City | South Jakarta | | `billingState`
Required | A | 50 | Billing State | DKI Jakarta | | `billingPostCd`
Required | N | 10 | Billing Post Number | 10200 | | `billingCountry`
Required | A | 10 | Billing Country | | | `userIP` | AN | 15 | User IP | 127.0.0.1 | | `cartData`
Required | AN | 4000 | Cart Data | \{\\"count\\":\\"1\\",\\"item\\":\[\{\\"goods\_id\\":\\"BB12345678\\",\\"goods\_detail\\":\\"BB123456\\",\\"goods\_name\\":\\"iPhone5S\\",\\"goods\_amt\\":\\"10000\\",\\"goods\_type\\":\\"Smartphone\\",\\"goods\_url\\":\\"http\://merchant.com/cellphones/iphone5s\_64g\\",\\"goods\_quantity\\":\\"1\\",\\"goods\_sellers\_id\\":\\"SEL123\\",\\"goods\_sellers\_name\\":\\"Sellers1\\"}]} | | `deliveryNm` | A | 30 | Delivery Name | 's Name | | `deliveryPhone` | N | 15 | Delivery Phone | 08123456789 | | `deliveryAddr` | AN | 100 | Delivery Address | Jln. Dr.Saharjo No.88 | | `deliveryCity` | A | 50 | Delivery City | South Jakarta | | `deliveryState` | A | 50 | Delivery State | DKI Jakarta | | `deliveryPostCd` | N | 10 | Delivery Post Number | 10201 | | `deliveryCountry` | A | 10 | Delivery Country | | | `vat` | N | 12 | Value Added Tax () | | | `fee` | N | 12 | Service Fee | | | `notaxAmt` | N | 12 | Tax Free Amount | | | `reqDt` | N | 8 | Request Date
(`YYYYMMDD`) | | | `reqTm` | N | 6 | Request Time
(`HH24MISS`) | | | `reqDomain` | AN | 100 | Request Domain | merchant.com | | `reqServerIP` | AN | 15 | Request Server IP | 127.0.0.1 | | `reqClientVer` | AN | 50 | Request Client Version | | | `userSessionID` | AN | 100 | User Session ID | | | `userAgent` | AN | 100 | User Agent Information | | | `userLanguage` | A | 2 | User Language | | | `sellers`
Required For Paylater | `JSON String` | 4000 | Seller Data | \[\{"sellersId": "SEL123","sellersNm": "Sellers 1","sellersEmail":"sellers\@test.com","sellersAddress": \{"sellerNm": "Sellers","sellerLastNm": "1","sellerAddr": "jalan berbangsa 1","sellerCity":"Jakarta Barat","sellerPostCd": "12344","sellerPhone":"08123456789","sellerCountry": "ID"}}] | | `instmntType`
Required For CC & Paylater | N | 2 | [Installment Type Code](docId:7CIX-U_4z295XgtNVEsbO) | 1 (For Pre-Auth & Recurring default 1) | | `instmntMon`
Required For CC & Paylater | N | 2 | Installment Month
`1`: 1 Month/Full , *if* `instmntType`*:* `null`*/1* | 1 (For Pre-Auth & Recurring default 1) | | `recurrOpt`
Required For CC | N | 2 | `0`: Automatic Cancel
`1`: Do not cancel
`2`: Do not make token | 2 | | `merFixAcctId`
Required For VA (Fixed Type) | AN | 40 | Reserved VA ID |
(Maks. 8 Digit Angka) | | `payValidDt`
Required For CVS | N | 8 | CVS Expiry Date (`YYYYMMDD`) | 20221212 | | `payValidTm`
Required For CVS | N | 6 | CVS Expiry Time (`HH24MISS`) | 201012 | | `paymentExpDt`
Required | N | 8 | QR Expiry Date (`YYYYMMDD`) | 20221208 | | `paymentExpTm`
Required | N | 6 | QR Expiry Time (`HH24MISS`) | 092330 | | `shopId` | AN | 25 | Shop ID | "" | ### Konfigurasi Payment Method & Bank/Mitra untuk Pelanggan Parameter `payMethod` memungkinkan untuk mengatur ditampilkan kepada pada . | **payMethod** | **Impact** | | ------------- | --------------------------------------- | | `00` | Menampilkan semua tersedia (default). | | `01` – `08` | Menampilkan hanya satu ditentukan. | Jika ingin menampilkan seluruh seperti biasa, silakan gunakan `payMethod = '00'` tanpa perlu menambahkan `bankCd` maupun `mitraCd`. Kode `payMethod` yang sesuai digunakan untuk mengarahkan ke tertentu. Pada beberapa , juga dapat menentukan kanal secara spesifik menggunakan `bankCd` atau `mitraCd`. **Contoh:** - Menampilkan semua yang tersedia → `payMethod = '00'`. - Hanya menampilkan → `payMethod = '01'`. - Hanya menampilkan BCA → `payMethod = '02'`, `bankCd = 'CENA'`. - Hanya menampilkan DANA → `payMethod = '05'`, `mitraCd = 'DANA'`. :::hint{type="warning"} **Catatan penting mengenai penggunaan parameter Bank/Mitra:** - Parameter `bankCd` hanya dapat digunakan untuk (`02`). - Parameter `mitraCd` hanya dapat digunakan untuk (`03`), (`04`), (`05`), dan (`06`). - Parameter `bankCd` dan `mitraCd` tidak dapat digunakan pada (`01`) dan (`08`). ::: ## Response Parameters for Registration - API Checkout *** | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ------------- | -------- | ---------- | ---------------------------------------------------------- | -------------------------------------------------------- | | `resultCd` | N | 4 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | 0000 | | `resultMsg` | AN | 255 | [Result Message](docId\:yEh1VA9k2y6sL1kQF2aWD) | SUCCESS | | `tXid` | AN | 30 | Transaction ID | IONPAYTEST00202305161555223616

When Success | | `referenceNo` | ANS | 40 | Order Number | ReferenceNumber001 | | `payMethod` | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok)
| 00

When Success | | `amt` | N | 12 | Amount | 10000

When Success | | `transDt` | N | 8 | Transaction Date
(`YYYYMMDD`) | 20230516

When Success | | `transTm` | N | 6 | Transaction Time
(`HH24MISS`) | 135959

When Success | | `description` | AN | 100 | Transaction Description | This Is The Description Of The

When Success | | `currency` | AN | 3 | Currency | IDR

When Success | | `goodsNm` | AN | 100 | Goods Name | Goods 1

When Success | | `billingNm` | A | 100 | Buyer Name | John Doe

When Success | | `payValidDt` | N | 8 | CVS Expiry Date
(`YYYYMMDD`) | null | | `payValidTm` | N | 6 | CVS Expiry Time
(`HH24MISS`) | null | | `bankCd` | A | 4 | [Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | CENA | | `mitraCd` | A | 4 | [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8) | DANA | | `paymentURL` | AN | 40 | Redirect URL | https\://www\.nicepay.co.id/nicepay/redirect/v2/payment | :::hint{type="success"} Setelah sudah didaftarkan, arahkan langsung menuju kami untuk melakukan . periksa [Payment - API Checkout](docId\:YnNFZr9aonpJ7ZIKAFYSx) untuk mengetahui penjelasan lebih rinci. ::: ## Sample Parameter for Registration - API Checkout *** ### Request Parameter :::CodeblockTabs cURL ```curl curl --location 'https://dev.nicepay.co.id/nicepay/redirect/v2/registration' \ --header 'Content-Type: application/json' \ --data-raw '{ "timeStamp" : "20251110141120", "iMid" : "IONPAYTEST", "payMethod" : "00", "currency" : "IDR", "referenceNo" : "ordNo20251110141120", "merchantToken" : "9da3d4c498aab78d9aa5f320713d3fffad1d50acd4d2d1ea9d18bb164bbf0d60", "mitraCd" : "", "amt" : "10000", "instmntType" : "1", "instmntMon" : "1", "callBackUrl" : "https://dev.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp", "dbProcessUrl" : "https://ptsv2.com/t/Sibedul/post", "goodsNm" : "Goods", "billingNm" : "Hantu Kesorean", "billingPhone" : "081234567890", "billingEmail" : "sample@mail.com", "billingAddr" : "Jl. Sample Address", "billingCity" : "South Jakarta", "billingState" : "DKI Jakarta", "billingCountry" : "Indonesia", "billingPostCd" : "12800", "deliveryNm" : "John Doe", "deliveryPhone" : "081234567890", "deliveryAddr" : "Jln. Sample Address", "deliveryCity" : "West Jakarta", "deliveryState" : "DKI Jakarta", "deliveryCountry" : "Indonesia", "deliveryPostCd" : "12800", "description" : "Testing Checkout API", "userIP" : "127.0.0.1", "userLanguage" : "ko-KR,en-US;q=0.8,ko;q=0.6,en;q=0.4", "cartData" : "{\"count\":\"1\",\"item\":[{\"goods_id\":\"BB12345678\",\"goods_detail\":\"BB123456\",\"goods_name\":\"iPhone5S\",\"goods_amt\":\"10000\",\"goods_type\":\"Smartphone\",\"goods_url\":\"http://merchant.com/cellphones/iphone5s_64g\",\"goods_quantity\":\"1\",\"goods_sellers_id\":\"SEL123\",\"goods_sellers_name\":\"Sellers1\"}]}", "sellers" :"[{\"sellersId\":\"SEL123\",\"sellersNm\":\"Sellers1\",\"sellersEmail\":\"sellers@test.com\",\"sellersUrl\":\"http://nicestore.store\",\"sellersAddress\":{\"sellerNm\":\"Sellers\",\"sellerLastNm\":\"1\",\"sellerAddr\":\"jalanberbangsa1\",\"sellerCity\":\"JakartaBarat\",\"sellerPostCd\":\"12344\",\"sellerPhone\":\"08123456789\",\"sellerCountry\":\"ID\"}}]", "msId" : "", "msFee" : "", "msFeeType" : "", "escrowCl" : "" }' ``` Node.js ```nodejs const SecondApiVersion = require("../lib/secondApiVersion.js"); const config = { isProduction: false, isCloudServer: false, merchantKey: "YOUR_MERCHANT_KEY", }; const parameter = { timeStamp: "20251110141120", iMid: "IONPAYTEST", payMethod: "00", currency: "IDR", referenceNo: "ordNo20251110141120", mitraCd: "", amt: "10000", instmntType: "1", instmntMon: "1", callBackUrl: "https://dev.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp", dbProcessUrl: "https://ptsv2.com/t/Sibedul/post", goodsNm: "Goods", billingNm: "Hantu Kesorean", billingPhone: "081234567890", billingEmail: "sample@mail.com", billingAddr: "Jl. Sample Address", billingCity: "South Jakarta", billingState: "DKI Jakarta", billingCountry: "Indonesia", billingPostCd: "12800", deliveryNm: "John Doe", deliveryPhone: "081234567890", deliveryAddr: "Jln. Sample Address", deliveryCity: "West Jakarta", deliveryState: "DKI Jakarta", deliveryCountry: "Indonesia", deliveryPostCd: "12800", description: "Testing Checkout API", userIP: "127.0.0.1", userLanguage: "ko-KR,en-US;q=0.8,ko;q=0.6,en;q=0.4", cartData: '{"count":"1","item":[{"goods_id":"BB12345678","goods_detail":"BB123456","goods_name":"iPhone5S","goods_amt":"10000","goods_type":"Smartphone","goods_url":"http://merchant.com/cellphones/iphone5s_64g","goods_quantity":"1","goods_sellers_id":"SEL123","goods_sellers_name":"Sellers1"}]}', sellers: '[{"sellersId":"SEL123","sellersNm":"Sellers1","sellersEmail":"sellers@test.com","sellersUrl":"http://nicestore.store","sellersAddress":{"sellerNm":"Sellers","sellerLastNm":"1","sellerAddr":"jalanberbangsa1","sellerCity":"JakartaBarat","sellerPostCd":"12344","sellerPhone":"08123456789","sellerCountry":"ID"}}]', msId: "", msFee: "", msFeeType: "", escrowCl: "", }; let secondVersion = new SecondApiVersion(config); let response = secondVersion .requestAPI(parameter, "/redirect/v2/registration"); ``` ```java config = NICEPay.builder() .isProduction(false) .isCloudServer(false) .build(); String timeStamp = "20251110141120"; String iMid = "IONPAYTEST"; String reffNo = "ordNo20251110141120"; String amount = "10000"; Redirect request = Redirect.builder() .timeStamp(timeStamp) .iMid(iMid) .payMethod("00") .currency("IDR") .amt(amount) .referenceNo(reffNo) .goodsNm("Goods") .billingNm("Hantu Kesorean") .billingPhone("081234567890") .billingEmail("sample@mail.com") .billingAddr("Jl. Sample Address") .billingCity("South Jakarta") .billingState("DKI Jakarta") .billingPostCd("12800") .billingCountry("Indonesia") .deliveryNm("John Doe") .deliveryPhone("081234567890") .deliveryAddr("Jln. Sample Address") .deliveryCity("West Jakarta") .deliveryState("DKI Jakarta") .deliveryPostCd("12800") .deliveryCountry("Indonesia") .dbProcessUrl("https://ptsv2.com/t/Sibedul/post") .callBackUrl("https://dev.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp") .vat("") .fee("") .notaxAmt("") .description("Testing Checkout API") .merchantToken(timeStamp, iMid, reffNo, amount, MERCHANT_KEY) .reqTm("") .reqDt("") .reqDomain("") .reqServerIP("") .reqClientVer("") .userIP("127.0.0.1") .userSessionID("") .userAgent("") .userLanguage("ko-KR,en-US;q=0.8,ko;q=0.6,en;q=0.4") .cartData("{\"count\":\"1\",\"item\":[{\"goods_id\":\"BB12345678\",\"goods_detail\":\"BB123456\",\"goods_name\":\"iPhone5S\",\"goods_amt\":\"10000\",\"goods_type\":\"Smartphone\",\"goods_url\":\"http://merchant.com/cellphones/iphone5s_64g\",\"goods_quantity\":\"1\",\"goods_sellers_id\":\"SEL123\",\"goods_sellers_name\":\"Sellers1\"}]}") .sellers("[{\"sellersId\":\"SEL123\",\"sellersNm\":\"Sellers1\",\"sellersEmail\":\"sellers@test.com\",\"sellersUrl\":\"http://nicestore.store\",\"sellersAddress\":{\"sellerNm\":\"Sellers\",\"sellerLastNm\":\"1\",\"sellerAddr\":\"jalanberbangsa1\",\"sellerCity\":\"JakartaBarat\",\"sellerPostCd\":\"12344\",\"sellerPhone\":\"08123456789\",\"sellerCountry\":\"ID\"}}]") .mitraCd("") .instmntType("1") .instmntMon("1") .recurrOpt("") .bankCd("") .vacctValidDt("") .vacctValidTm("") .payValidDt("") .paymentExpTm("") .merFixAcctId("") .paymentExpDt("") .payValidTm("") .shopId("") .msId("") .msFee("") .msFeeType("") .escrowCl("") .build(); NICEPayResponseV2 response = V2RedirectService.callV2RedirectRegistration(request, config); ``` ```python amt = "10000" itemCartData = { "goods_id": "BB12345678", "goods_name": "iPhone5S", "goods_detail": "BB123456", "goods_amt": amt, "goods_quantity": "1", "goods_type": "Smartphone", "goods_url": "http://merchant.com/cellphones/iphone5s_64g", "goods_sellers_id": "SEL123", "goods_sellers_name": "Sellers1" } itemSellersAddress = { "sellerNm": "Sellers", "sellerLastNm": "1", "sellerAddr": "jalanberbangsa1", "sellerCity": "JakartaBarat", "sellerPostCd": "12344", "sellerCountry": "ID", "sellerPhone": "08123456789" } bodyCartData = ( builderCartData.BuildCartData() .setCount("1") .setItem(itemCartData) .build() ) bodySellers = ( builderSellers.BuildSellers() .setSellerId("SEL123") .setSellerNm("Sellers1") .setSellerEmail("sellers@test.com") .setSellerUrl("http://nicestore.store") .setSellerAddress(itemSellersAddress) .build() ) bodyRequest = ( builderRequest.BuildRequest() .setPayMethod("00") .setInstmntType("1") .setInstmntMon("1") .setRecurrOpt("") .setBankCd("") .setMitraCd("") .setVacctValidDt("") .setVacctValidTm("") .setMerFixAcctId("") .setPayValidDt("") .setPayValidTm("") .setPaymentExpDt("") .setPaymentExpTm("") .setAmt(amt) .build() ) environment = (builderEnvironment.BuildEnvironment() .isCloud(False) .isProduction(False) .build()) response = ServiceNicepay.serviceRedirect(DataGenerator.getTransactionBody(bodyRequest.jsonRequest(), bodyCartData.jsonCartData(), bodySellers.jsonSellers()), environment) ``` C# ```csharp string merchantKey = "YOUR_MERCHANT_KEY"; string clientId = "IONPAYTEST"; string timestamp = "20251110141120"; string refNo = "ordNo20251110141120"; string amount = "10000"; bool isProduction = false; bool isCloudServer = false; var builder = new MerchantTokenBuilder() .SetTimeStamp(timestamp) .SetIMid(clientId) .SetRefNo(refNo) .SetAmount(amount) .SetMerchantKey(merchantKey); // Act: Menghasilkan merchantToken string merchantToken = builder.BuildMerchantToken(); var cartData = new { count = "1", item = new[] { new { goods_id = "BB12345678", goods_detail = "BB123456", goods_name = "iPhone5S", goods_amt = amount, goods_type = "Smartphone", goods_url = "http://merchant.com/cellphones/iphone5s_64g", goods_quantity = "1", goods_sellers_id = "SEL123", goods_sellers_name = "Sellers1" } } }; string cartDataJson = JsonConvert.SerializeObject(cartData); string sellersJson = "[{\"sellersId\":\"SEL123\",\"sellersNm\":\"Sellers1\",\"sellersEmail\":\"sellers@test.com\",\"sellersUrl\":\"http://nicestore.store\",\"sellersAddress\":{\"sellerNm\":\"Sellers\",\"sellerLastNm\":\"1\",\"sellerAddr\":\"jalanberbangsa1\",\"sellerCity\":\"JakartaBarat\",\"sellerPostCd\":\"12344\",\"sellerPhone\":\"08123456789\",\"sellerCountry\":\"ID\"}}]"; var Bodybuilder = new NicepayRequestBuilder() // BASE REQUEST MANDATORY .SetCommonFields( iMid: clientId, timeStamp: timestamp, payMethod: "00", currency: "IDR", amt: amount, referenceNo: refNo, goodsNm: "Goods", merchantToken: merchantToken ) .SetUserInfo( userIP: "127.0.0.1", userSessionID: "", userAgent: "", userLanguage: "ko-KR,en-US;q=0.8,ko;q=0.6,en;q=0.4" ) .SetCallBackUrl(callBackUrl: "https://dev.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp") .SetDbProcessUrl("https://ptsv2.com/t/Sibedul/post") .SetCartData(cartData: cartDataJson) .SetSellers(sellersJson) // Assuming a .SetSellers() method exists .SetBillingInfo( billingNm: "Hantu Kesorean", billingPhone: "081234567890", billingEmail: "sample@mail.com", billingAddr: "Jl. Sample Address", billingCity: "South Jakarta", billingState: "DKI Jakarta", billingPostCd: "12800", billingCountry: "Indonesia" ) // FOR VA .setBankCd(bankCd: "") .SetVaExpiry( vacctValidDt: "", vacctValidTm: "" ) // FOR EWALLET .setMitraCd(mitraCd: "") //FOR CC .setCreditCard( instmntType: "1", instmntMon: "1", recurrOpt: "" ) //FOR QRIS .setPaymentExp( paymentExpDt: "", paymentExpTm: "" ) .SetDeliveryInfo( deliveryNm: "John Doe", deliveryPhone: "081234567890", deliveryAddr: "Jln. Sample Address", deliveryCity: "West Jakarta", deliveryState: "DKI Jakarta", deliveryPostCd: "12800", deliveryCountry: "Indonesia" ); ApiEndpoints apiEndpoints = new ApiEndpoints(); Dictionary payload = Bodybuilder.Build(); string jsonPayload = Newtonsoft.Json.JsonConvert.SerializeObject(payload); var registrationService = new NicepayRegistrationService(apiEndpoints, isProduction, isCloudServer); var result = await registrationService.SendPostAsync(apiEndpoints.RegistRedirectV2, payload); ``` Laravel ```php $url = HttpUtil::getNicepayDomain($this->useProd, $this->useCloud) . $this->registration_endpoint; $timestamp = "20251110141120"; $reference_no = "ordNo20251110141120"; $amt = $this->amt; $merchant_token = $this->generateMerchantToken($timestamp, $this->imid, $reference_no, $amt, $this->mer_key); $cartData = '{"count":"1","item":[{"goods_id":"BB12345678","goods_detail":"BB123456","goods_name":"iPhone5S","goods_amt":"10000","goods_type":"Smartphone","goods_url":"http://merchant.com/cellphones/iphone5s_64g","goods_quantity":"1","goods_sellers_id":"SEL123","goods_sellers_name":"Sellers1"}]}'; $sellers = '[{"sellersId":"SEL123","sellersNm":"Sellers1","sellersEmail":"sellers@test.com","sellersUrl":"http://nicestore.store","sellersAddress":{"sellerNm":"Sellers","sellerLastNm":"1","sellerAddr":"jalanberbangsa1","sellerCity":"JakartaBarat","sellerPostCd":"12344","sellerPhone":"08123456789","sellerCountry":"ID"}}]'; $body = [ "timeStamp" => $timestamp, "iMid" => $this->imid, "payMethod" => "00", "currency" => "IDR", "referenceNo" => $reference_no, "merchantToken" => $merchant_token, "mitraCd" => "", "amt" => $this->amt, "instmntType" => "1", "instmntMon" => "1", "callBackUrl" => "https://dev.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp", "dbProcessUrl" => "https://ptsv2.com/t/Sibedul/post", "goodsNm" => "Goods", "billingNm" => "Hantu Kesorean", "billingPhone" => "081234567890", "billingEmail" => "sample@mail.com", "billingAddr" => "Jl. Sample Address", "billingCity" => "South Jakarta", "billingState" => "DKI Jakarta", "billingCountry" => "Indonesia", "billingPostCd" => "12800", "deliveryNm" => "John Doe", "deliveryPhone" => "081234567890", "deliveryAddr" => "Jln. Sample Address", "deliveryCity" => "West Jakarta", "deliveryState" => "DKI Jakarta", "deliveryCountry" => "Indonesia", "deliveryPostCd" => "12800", "description" => "Testing Checkout API", "userIP" => "127.0.0.1", "userLanguage" => "ko-KR,en-US;q=0.8,ko;q=0.6,en;q=0.4", "cartData" => $cartData, "sellers" => $sellers, "msId" => "", "msFee" => "", "msFeeType" => "", "escrowCl" => "" ]; try { $response = HttpUtil::postJsonRequest($url, $body); } catch (Throwable $th) { return HttpUtil::generateErrorResponse($th); } ``` PHP Native ```php $timestamp = Helper::getFormattedTimestampV2(); $referenceNo = "ordNo20251110141120"; $amount = "10000"; $config = NICEPay::builder() ->setIsProduction(false) ->setTimestamp($timestamp) ->build(); $parameter = Redirect::builder() ->setTimeStamp($timestamp) ->setIMid(TestConst::$IMID_TEST) ->setPayMethod("00") ->setCurrency("IDR") ->setReferenceNo($referenceNo) ->setAmt($amount) ->setMerchantToken($timestamp, TestConst::$IMID_TEST, $referenceNo, $amount, $this->merchantKey) ->setCallBackUrl("https://dev.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp") ->setDbProcessUrl("https://ptsv2.com/t/Sibedul/post") ->setGoodsNm("Goods") ->setBillingNm("Hantu Kesorean") ->setBillingPhone("081234567890") ->setBillingEmail("sample@mail.com") ->setBillingAddr("Jl. Sample Address") ->setBillingCity("South Jakarta") ->setBillingState("DKI Jakarta") ->setBillingCountry("Indonesia") ->setBillingPostCd("12800") ->setDeliveryNm("John Doe") ->setDeliveryPhone("081234567890") ->setDeliveryAddr("Jln. Sample Address") ->setDeliveryCity("West Jakarta") ->setDeliveryState("DKI Jakarta") ->setDeliveryCountry("Indonesia") ->setDeliveryPostCd("12800") ->setDescription("Testing Checkout API") ->setUserIP("127.0.0.1") ->setUserLanguage("ko-KR,en-US;q=0.8,ko;q=0.6,en;q=0.4") ->setCartData( "{\"count\":\"1\",\"item\":[{\"goods_id\":\"BB12345678\",\"goods_detail\":\"BB123456\",\"goods_name\":\"iPhone5S\",\"goods_amt\":\"10000\",\"goods_type\":\"Smartphone\",\"goods_url\":\"http://merchant.com/cellphones/iphone5s_64g\",\"goods_quantity\":\"1\",\"goods_sellers_id\":\"SEL123\",\"goods_sellers_name\":\"Sellers1\"}]}" ) ->setSellers("[{\"sellersId\":\"SEL123\",\"sellersNm\":\"Sellers1\",\"sellersEmail\":\"sellers@test.com\",\"sellersUrl\":\"http://nicestore.store\",\"sellersAddress\":{\"sellerNm\":\"Sellers\",\"sellerLastNm\":\"1\",\"sellerAddr\":\"jalanberbangsa1\",\"sellerCity\":\"JakartaBarat\",\"sellerPostCd\":\"12344\",\"sellerPhone\":\"08123456789\",\"sellerCountry\":\"ID\"}}]") ->setMitraCd("") ->setInstmntType("1") ->setInstmntMon("1") ->build(); $v2RedirectService = new V2RedirectService($config); try { $response = $v2RedirectService->registration($parameter); } catch (NicepayError $e) { $this->fail("Exception thrown: " . $e->getMessage()); } ``` CodeIgniter ```php $timestamp = "20251110141120"; $configBuilder = NICEPay::builder(); $config = $configBuilder ->setIsProduction(false) ->setIsCloudServer(false) ->build(); $reffNo = "ordNo20251110141120"; $amount = "10000"; $cartData = [ "count" => "1", "item" => [[ "goods_id" => "BB12345678", "goods_detail" => "BB123456", "goods_name" => "iPhone5S", "goods_amt" => $amount, // Replace dynamically if needed "goods_type" => "Smartphone", "goods_url" => "http://merchant.com/cellphones/iphone5s_64g", "goods_quantity" => "1", "goods_sellers_id" => "SEL123", "goods_sellers_name" => "Sellers1" ]] ]; $sellers = "[{\"sellersId\":\"SEL123\",\"sellersNm\":\"Sellers1\",\"sellersEmail\":\"sellers@test.com\",\"sellersUrl\":\"http://nicestore.store\",\"sellersAddress\":{\"sellerNm\":\"Sellers\",\"sellerLastNm\":\"1\",\"sellerAddr\":\"jalanberbangsa1\",\"sellerCity\":\"JakartaBarat\",\"sellerPostCd\":\"12344\",\"sellerPhone\":\"08123456789\",\"sellerCountry\":\"ID\"}}]"; $RedirectBuilder = Redirect::builder(); $parameter = $RedirectBuilder ->setTimeStamp($timestamp) ->setIMid("IONPAYTEST") ->setPayMethod("00") ->setCurrency("IDR") ->setDescription("Testing Checkout API") ->setBankCd("") ->setAmt($amount) ->setReferenceNo($reffNo) ->setMerchantToken($timestamp, $this->iMidTest, $reffNo, $amount, $this->merchantKey) // Unchanged as requested ->setVacctValidDt("") ->setVacctValidTm("") ->setMerFixAcctId("") ->setDbProcessUrl("https://ptsv2.com/t/Sibedul/post") ->setCallBackUrl("https://dev.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp") ->setGoodsNm("Goods") ->setCartData(json_encode($cartData)) ->setSellers($sellers) ->setBillingNm("Hantu Kesorean") ->setBillingPhone("081234567890") ->setBillingEmail("sample@mail.com") ->setBillingAddr("Jl. Sample Address") ->setBillingCity("South Jakarta") ->setBillingState("DKI Jakarta") ->setBillingPostCd("12800") ->setBillingCountry("Indonesia") ->setUserIP("127.0.0.1") ->setUserLanguage("ko-KR,en-US;q=0.8,ko;q=0.6,en;q=0.4") ->setDeliveryNm("John Doe") ->setDeliveryPhone("081234567890") ->setDeliveryAddr("Jln. Sample Address") ->setDeliveryCity("West Jakarta") ->setDeliveryState("DKI Jakarta") ->setDeliveryPostCd("12800") ->setDeliveryCountry("Indonesia") ->setInstmntType("1") ->setInstmntMon("1") ->setMitraCd("") ->setMsId("") ->setMsFee("") ->setMsFeeType("") ->setEscrowCl("") ->build(); $v2VaService = new V2RedirectService($config); try { $response = $v2VaService->registration($parameter); } ``` ::: ### Response Parameter :::CodeblockTabs Sample Response ```json { "resultCd": "0000", "resultMsg": "SUCCESS", "tXid": "IONPAYTEST00202511101446495037", "referenceNo": "ordNo20251110141120", "payMethod": "00", "amt": "10000", "transDt": "20251110", "transTm": "144649", "description": "Testing Checkout API", "currency": "IDR", "goodsNm": "Goods", "billingNm": "Hantu Kesorean", "payValidDt": null, "payValidTm": null, "bankCd": null, "mitraCd": null, "paymentURL": "https://dev.nicepay.co.id/nicepay/redirect/v2/payment" } ``` ::: # Cart Data, Paylater Cart Data, & Paylater Seller Data for Registration - API Checkout *** *Cart Data* pada berguna untuk mendeklarasikan *item* apa saja akan di-*checkout* beserta rincian dan harga per *item*. *Cart Data* ini berlaku untuk semua , kecuali menggunakan dikarenakan memiliki *Cart Data* khusus. ## Cart Data for Registration - API Checkout *** :::hint{type="success"} - `cartData` harus dilepas dalam bentuk *string*. - Karakter spesial tidak didukung dalam `cartData`. - Pastikan bahwa `count` sama dengan jumlah *object* `item`. - Pastikan bahwa `goods_amt` x `goods_quantity` sama dengan `amt`. ::: | **Parameter** | **Deskripsi** | **Contoh** | | ------------- | ---------------------------------------------------------------------------------------------------------- | ---------- | | `Count` | Total jumlah dari keseluruhan *cart data* | 2 | | `Item` | Terbagi menjadi 5 macam , yaitu `img_url`, `goods_name`, `goods_detail`, `goods_amt`, dan `goods_quantity` | - | Penjelasan detail pada parameter **Item**. | **Parameter** | **Deskripsi** | **Contoh** | | ---------------- | -------------------------------------- | ---------------------------- | | `img_url` | URL Gambar Barang (Ukuran 50px x 50px) | http\://img.aaa.com/ima1.jpg | | `goods_name` | Nama Barang | Item 1 Name | | `goods_detail` | Deskripsi Detail Barang | Item 1 Detail | | `goods_amt` | Harga Barang | 700 | | `goods_quantity` | Jumlah Barang | 1 | :::CodeblockTabs Card Data ```json { "count": "2", "item": [ { "img_url": "http://img.aaa.com/ima1.jpg", "goods_name": "Item 1 Name", "goods_detail": "Item 1 Detail", "goods_amt": "700", "goods_quantity": "1" }, { "img_url": "http://img.aaa.com/ima2.jpg", "goods_name": "Item 2 Name", "goods_detail": "Item 2 Detail", "goods_amt": "300", "goods_quantity": "1" } ] } ``` ::: ## Paylater Cart Data for Registration - API Checkout *** | **Parameter** | **Deskripsi** | | ------------------------------ | --------------------- | | `count` | Total Cart Data Count | | `item` | List of Goods | | `item` -> `goods_id` | Goods ID | | `item` -> `goods_detail` | Goods Detail | | `item` -> `goods_name` | Goods Name | | `item` -> `goods_amt` | Goods Amount | | `item` -> `goods_type` | Goods Type | | `item` -> `goods_url` | Goods URL | | `item` -> `goods_quantity` | Goods Quantity | | `item` -> `goods_sellers_id` | Seller's ID | | `item` -> `goods_sellers_name` | Seller's Name | :::hint{type="info"} `cartData` wajib dilepas dalam format *string*. ::: :::CodeblockTabs Paylater Cart Data ```json { "count": "2", "item": [ { "goods_id": "BB12345678", "goods_detail": "BB123456", "goods_name": "iPhone 5S", "goods_amt": "6000000", "goods_type": "Smartphone", "goods_url": "http://merchant.com/cel lphones/iphone5s_64g", "goods_quantity": "1", "goods_sellers_id": "SEL123", "goods_sellers_name": "Sellers 1" }, { "goods_id": "AZ14565678", "goods_name": "Hailee Sneakers Blink Silver", "goods_amt": "250000", "goods_url": "http://merchant.com/fashion/shoes/sneakers-blinkshoes", "goods_type": "Sneakers", "goods_quantity": "2", "goods_sellers_id": "SEL124", "goods_ sellers_name": "Sellers 2" } ] } ``` ::: :::hint{type="info"} - `cartData` secara spesifik untuk . - Pastikan - `count`berdasarkan dengan nomor tipe barang-barang. - Pastikan `goods_sellers_id` dan `goods_sellers_name` berisi sesuai dengan `sellers` pada *Registration*. ::: ## Paylater Sellers Data for Registration - API Checkout *** | **Parameter** | **Deskripsi** | | ----------------------------------- | -------------------- | | `sellersId` | Seller's ID | | `sellersNm` | Seller's Name | | `sellersEmail` | Seller's E-mail | | `sellersUrl` | Seller's URL | | `sellersAddress` -> `sellerNm` | Seller's Name | | `sellersAddress` -> `sellerLastNm` | Seller's Last Name | | `sellersAddress` -> `sellerAddr` | Seller's Address | | `sellersAddress` -> `sellerCity` | Seller's City | | `sellersAddress` -> `sellerPostCd` | Seller's Postal Code | | `sellersAddress` -> `sellerPhone` | Seller's Phone | | `sellersAddress` -> `sellerCountry` | Seller's Country | :::CodeblockTabs Paylater Sellers Data ```json [ { "sellersId": "SEL123", "sellersNm": "Sellers 1", "sellersEmail": "sellers@test.com", "sellersUrl": "http://nicestore.store", "sellersAddress": { "sellerNm": "Sellers", "sellerLastNm": "1", "sellerAddr": "jalan berbangsa 1", "sellerCity": "Jakarta Barat", "sellerPostCd": "12344", "sellerPhone": "08123456789", "sellerCountry": "ID" } }, { "sellersId": "SEL124", "sellersNm": "Sellers 2", "sellersEmail": "sellers2@test.com", "sellersUrl": "http://nicestore.store", "sellersAddress": { "sellerNm": "Sellers", "sellerLastNm": "2", "sellerAddr": "jalan berkelok 3", "sellerCity": "Jakarta Utara", "sellerPostCd": "12222", "sellerPhone": "081255556789", "sellerCountry": "ID" } } ] ``` ::: [title] Status Inquiry - API Checkout [path] NICEPAY API/API Checkout/ # Tentang Status Inquiry - API Checkout *** Setelah sukses melakukan dengan [Registration - API Checkout](docId:1y_mEI3eZUS-XW2YPhGyp) , siap untuk melakukan secara *real* dengan . Namun, rekomendasikan melakukan [API Checkout](docId\:Djp90D-rlCNeDCzKwGC-d) lainnya seperti Inquiry ini. ini digunakan untuk memeriksa ajukan pada [Registration - API Checkout](docId:1y_mEI3eZUS-XW2YPhGyp) sebelumnya seperti berhasil atau gagal nya. Ketika sudah selesai dilakukan, akan menerima secara otomatis dari kami, sangat merekomendasikan untuk memeriksa kembali tersebut dengan menggunakan [Status Inquiry - API Checkout](docId\:K9vBS87ev9_w5oJAU0et3). # Status Inquiry - API Checkout *** | **API URL** | `/nicepay/direct/v2/inquiry` | | ------------------- | ----------------------------------------------------------------- | | **Request Method** | `POST` | | **Header** | `Content-Type: application/json`**** | | **Merchant Token** | SHA256 (`timestamp`+ `iMid`+ `referenceNo`+ `amt`+ `merchantKey`) | :::hint{type="info"} Ketika diterima oleh `dbProcessUrl` , kami sangat merekomendasikan untuk melakukan verifikasi dengan menggunakan [Status Inquiry - API Checkout](docId\:K9vBS87ev9_w5oJAU0et3). ::: ## Notification Handling :::hint{type="info"} `Notification Handling` berguna untuk meminimalisir aksi penipuan, kami sangat merekomendasikan para untuk melakukan verifikasi `Notification Handling`. ::: ::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/W9M8IuHjqQ6IrGJiumu13_nicepay-api-checkout-api-notification-handling-flow-1.png" size="50" width="370" height="361" caption="Status Inquiry - Notification Handling" position="center" darkWidth="370" darkHeight="361" showCaption="true"} ## Request Parameters for Status Inquiry - API Checkout | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ---------------------------------------------------------- | -------- | ---------- | ---------------------------------- | ---------------------------------------------------------------- | | `timeStamp`
Required | N | 14 | Request Date (`YYYYMMDDHH24MISS`) | 20221012080918 | | `tXid`
Required | AN | 30 | Transaction ID
| IONPAYTEST00202212191025073439 | | `iMid`
Required | AN | 10 | ID
| IONPAYTEST | | `referenceNo`
Required | ANS | 40 | Order Number
| ORDER20221012080918 | | `amt`
Required | N | 12 | Transaction Amount
| 10000 | | `merchantToken`
Required | AN | 255 | Token
| d8d0968892c568bc6ff5adc17cd755f85334a0b58fce85392682993a9ba653ed | ## Response Parameters for Status Inquiry - API Checkout | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ------------- | -------- | ---------- | ----------------------------------------------------------- | ------------------------------ | | `resultCd` | N | 4 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | 0000 | | `resultMsg` | AN | 255 | Result Message: [Error Code](docId\:yEh1VA9k2y6sL1kQF2aWD) | (empty) | | `tXid` | AN | 30 | Transaction ID | IONPAYTEST00202212191025073439 | | `iMid` | AN | 10 | ID | IONPAYTEST | | `referenceNo` | ANS | 40 | Order Number | ORDER20221012080918 | | `payMethod` | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | 00 | | `amt` | N | 12 | Amount | 10000 | | `cancelAmt` | N | 12 | Cancel Amount | null | | `reqDt` | N | 8 | Transaction Request Date (`YYYYMMDD`) | 20221219 | | `reqTm` | N | 6 | Transaction Request Time (`HH24MISS`) | 102507 | | `transDt` | N | 8 | Transaction Date (`YYYYMMDD`) | null | | `transTm` | N | 6 | Transaction Time (`HH24MISS`) | null | | `depositDt` | N | 8 | Transaction Deposit Date (`YYYYMMDD`) | null | | `depositTm` | N | 6 | Transaction Deposit Time (`HH24MISS`) | null | | `currency` | A | 3 | Currency | IDR | | `goodsNm` | AN | 100 | Goods Name | Test Transaction | | `billingNm` | A | 100 | Buyer Name | John Doe | | `status` | N | 1 | [Payment Status Code](docId:8m3-7Smhm_jhdrE5pCRzp) | null | ### Additional - Credit Card | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ---------------- | -------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------- | | `authNo` | N | 10 | Approval Number | | | `issuBankCd` | A | 4 | [Issuing Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | | | `acquBankCd` | A | 4 | [Acquiring Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | | | `acquBankNm` | A | 255 | Acquiring Name | | | `issuBankNm` | A | 255 | Issuing Name | | | `cardNo` | ANS | 20 | Card Number with Masking | | | `cardExpYymm` | N | 4 | Card Expiration (`YYMM`) | | | `instmntMon` | N | 2 | Installment Month
`1`: 1 Month/Full , jika `instmntType`*:* *null/1*
`3`: 3 Months
`6`: 6 Months
`12`: 12 Months | | | `instmntType` | N | 2 | [Installment Type Code](docId:7CIX-U_4z295XgtNVEsbO) | | | `preauthToken` | AN | 255 | Pre-Auth Token (Needed for Capture ) | | | `recurringToken` | AN | 255 | Recurring Token (Needed for Recurring ) | | | `ccTransType` | N | 2 | Credit Card Transaction Type | | | `acquStatus` | N | 2 | Purchase Status
`1`: Normal
`2`: Recurring
`3`: Pre-Auth
`4`: Capture | | | `acquirerData` | Array | 20 | A dynamic array consisting of a unique reference number RRN that is provided by ing when a refund is ed. This reference number can be used by to track of refund with . | `"acquirerData": {`
` "rrn": "332608321717"`
` }` | | `vat` | N | 12 | | | | `fee` | N | 12 | Service Fee | | | `notaxAmt` | N | 12 | Tax-Fee Amount | | ### Additional - Virtual Account | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | -------------- | -------- | ---------- | ---------------------------------------- | -------------------- | | `bankCd` | A | 4 | [Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | | | `vacctNo` | N | 16 | Number | | | `vacctValidDt` | N | 8 | VA Expiry date (`YYYYMMDD`) | | | `vacctValidTm` | N | 6 | VA Expiry time (`HH24MISS`) | | ### Additional - Others | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ------------- | -------- | ---------- | -------------------------------------------------------------------- | -------------------- | | `mitraCd` | A | 4 | [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8)
(CVS, , , Paylater) | | | `payNo` | N | 12 | CVS Number (CVS) | | | `payValidDt` | N | 8 | CVS Expiry Date (`YYYYMMDD`) (CVS) | | | `payValidTm` | N | 6 | CVS Expiry time (`HH24MISS`) (CVS) | | | `receiptCode` | ANS | 20 | Authorization Code (CVS) | | | `mRefNo` | AN | 20 | Reference Number () | | ## Sample Parameter for Status Inquiry - API Checkout *** ### Request Parameter :::CodeblockTabs cURL ```curl curl --location 'https://dev.nicepay.co.id/nicepay/direct/v2/inquiry' \ --header 'Content-Type: application/json' \ --data '{ "timeStamp" : "20251111021168", "iMid" : "IONPAYTEST", "tXid" : "IONPAYTEST02202511110206549179", "referenceNo" : "ordNo20251111021198", "amt" : "10000", "merchantToken" : "3c88adc387f1971beccc7189779281756c11ffcf9337f7ab5e8c8e5e1947be08" }' ``` Node.js ```nodejs const SecondApiVersion = require("../lib/secondApiVersion.js"); const cons = require("./sharedConfig.js"); const config = { isProduction: false, isCloudServer: false, merchantKey: cons.merchantKey, }; const parameter = { "timeStamp": "20251111021168", "iMid": "IONPAYTEST", "tXid": "IONPAYTEST02202511110206549179", "referenceNo": "ordNo20251111021198", "amt": "10000" }; let secondVersion = new SecondApiVersion(config); let response = secondVersion .requestAPI(parameter, "/direct/v2/inquiry"); ``` ```java config =NICEPay.builder() .isProduction(false) .isCloudServer(false) .clientSecret(CLIENT_SECRET) .partnerId(PARTNER_ID) .externalID(TestingConstants.EXTERNAL_ID) .timestamp(TIMESTAMP) .privateKey(PRIVATE_KEY_CLOUD) .build(); String timeStamp = "20251111021168"; String iMid = "IONPAYTEST"; String tXid = "IONPAYTEST02202511110206549179"; String reffNo = "ordNo20251111021198"; String amount = "10000"; InquiryStatus requestData = InquiryStatus.builder() .timeStamp(timeStamp) .tXid(tXid) .iMid(iMid) .merchantToken(timeStamp, iMid, reffNo, amount, TestingConstants.MERCHANT_KEY) .referenceNo(reffNo) .amt(amount) .build(); NICEPayResponseV2 result = V2InquiryStatusService.callV2InquiryStatus(requestData, config); ``` ```python from python_nicepay.data.builder import builderEnvironment from python_nicepay.data.builder.v2.professional import builderInquiry from python_nicepay.data.builder.v2.professional.dataGenerator import DataGenerator from python_nicepay.service.v2EnterpriseService import ServiceNicepay bodyInquiry = ( builderInquiry.BuildInquiry() .setTxid("IONPAYTEST02202511110206549179") .setReferenceNo("ordNo20251111021198") .setAmt("10000") .build() ) environment = (builderEnvironment.BuildEnvironment() .isCloud(False) .isProduction(False) .build()) response = ServiceNicepay.serviceInquiry(DataGenerator.getInquiryBody(bodyInquiry.jsonInquiry()), environment) ``` C# ```csharp TestingConstantService config = new TestingConstantService(); string merchantKey = config.MerKey; string clientId = "IONPAYTEST"; string timestamp = "20251111021168"; string refNo = "ordNo20251111021198"; string amount = "10000"; bool isProduction = false; bool isCloudServer = false; var builder = new MerchantTokenBuilder() .SetTimeStamp(timestamp) .SetIMid(clientId) .SetRefNo(refNo) .SetAmount(amount) .SetMerchantKey(merchantKey); // Act: Menghasilkan merchantToken string merchantToken = builder.BuildMerchantToken(); var Bodybuilder = new NicepayRequestBuilder() .SetCheckStatus( iMid : clientId, timeStamp : timestamp, tXid : "IONPAYTEST02202511110206549179", amt : amount, referenceNo : refNo, merchantToken: merchantToken ); ApiEndpoints apiEndpoints = new ApiEndpoints(); Dictionary payload = Bodybuilder.Build(); string jsonPayload = Newtonsoft.Json.JsonConvert.SerializeObject(payload); var registrationService = new NicepayRegistrationService(apiEndpoints,isProduction, isCloudServer); var result = await registrationService.SendPostAsync(apiEndpoints.InquiryV2,payload); ``` Laravel ```php // Endpoint $url = HttpUtil::getNicepayDomain($this->useProd, $this->useCloud) . $this->inquiry_endpoint; // Request body parameter $timestamp = "20251111021168"; $txid = "IONPAYTEST02202511110206549179"; $reference_no = "ordNo20251111021198"; $amt = "10000"; $merchant_token = $this->generateMerchantToken($timestamp, $this->imid, $reference_no, $this->amt, $this->mer_key); $body = [ "timeStamp" => $timestamp, "tXid" => $txid, "iMid" => $this->imid, "merchantToken" => $merchant_token, "referenceNo" => $reference_no, "amt" => $amt, ]; try { $response = HttpUtil::postJsonRequest($url, $body); } catch (Throwable $th) { return $this->generateErrorResponse($th); } ``` PHP Native ```php $iMidTest = "IONPAYTEST"; $merchantKey = TestConst::$MERCHANT_KEY; $config = NICEPay::builder() ->setIsProduction(false) ->build(); $timeStamp = "20251111021168"; $reffNo = "ordNo20251111021198"; $amount = "10000"; $parameter = InquiryStatus::builder() ->setTimeStamp($timeStamp) ->setTxId("IONPAYTEST02202511110206549179") ->setIMid($iMidTest) ->setMerchantToken($timeStamp, $iMidTest, $reffNo, $amount, $this->merchantKey) ->setReferenceNo($reffNo) ->setAmt($amount) ->build(); try { $v2RedirectService = new V2RedirectService($config); $response = $v2RedirectService ->inquiryStatus($parameter); } catch (NicepayError $e) { } ``` ```kotlin var config: NICEPay? = NICEPay.Builder() .isProduction(false) .clientSecret(TestingConstants.CLIENT_SECRET) .partnerId(TestingConstants.PARTNER_ID) .externalID(TestingConstants.EXTERNAL_ID) .timestamp(TestingConstants.TIMESTAMP) .privateKey(TestingConstants.PRIVATE_KEY) .build() val timeStamp = "20251111021168" val tXid = "IONPAYTEST02202511110206549179" val iMid = "IONPAYTEST" val referenceNo = "ordNo20251111021198" val amount = "10000" val request: DirectV2CheckStatus = DirectV2CheckStatus.Builder() .timeStamp(timeStamp) .tXid(tXid) .iMid(iMid) .merchantKey(DEFAULT_MERCHANT_KEY) .referenceNo(referenceNo) .amt(amount) .build() val response: NICEPayResponseV2 = v2VirtualAccountService.checkStatus(request, config)!! ``` CodeIgniter ```php $iMidTest = "IONPAYTEST"; $this->merchantKey = $testConst::IMID_COMMON_MERCHANT_KEY; $this->v2Config = NICEPay::builder() ->setIsProduction(false) ->build(); $timeStamp = "20251111021168"; $reffNo = "ordNo20251111021198"; $amount = "10000"; $config = $this->v2Config; $parameter = InquiryStatus::builder() ->setTimeStamp($timeStamp) ->setTxId("IONPAYTEST02202511110206549179") ->setIMid($this->iMidTest) ->setMerchantToken($timeStamp, $this->iMidTest, $reffNo, $amount, $this->merchantKey) ->setReferenceNo($reffNo) ->setAmt($amount) ->build(); try { $v2VaService = new V2VAService($config); // You can use chosen payment method service $response = $v2VaService->inquiryStatus($parameter); } catch (Exception $e) { } ``` ::: ### Response Parameter :::CodeblockTabs Sample Response ```json { "tXid": "IONPAYTEST02202511110206549179", "iMid": "IONPAYTEST", "currency": "IDR", "amt": "10000", "instmntMon": null, "instmntType": "1", "referenceNo": "ordNo20251111021198", "goodsNm": "Goods", "payMethod": "02", "billingNm": "Hantu Kesorean", "reqDt": "20251111", "reqTm": "020654", "status": "0", "resultCd": "0000", "resultMsg": "paid", "cardNo": null, "preauthToken": null, "acquBankCd": null, "issuBankCd": null, "vacctValidDt": "20280128", "vacctValidTm": "235959", "vacctNo": "7812001000000605", "bankCd": "IBBK", "payNo": null, "mitraCd": null, "receiptCode": null, "cancelAmt": null, "transDt": "20251111", "transTm": "020654", "recurringToken": null, "ccTransType": null, "payValidDt": null, "payValidTm": null, "mRefNo": null, "acquStatus": null, "cardExpYymm": null, "acquBankNm": null, "issuBankNm": null, "depositDt": "20251111", "depositTm": "020705", "paymentExpDt": null, "paymentExpTm": null, "paymentTrxSn": null, "cancelTrxSn": null, "userId": null, "shopId": null } ``` ::: [title] Notification Transaction - API E-Wallet (Direct Debit) SNAP [path] NICEPAY API/API SNAP/Payment API - SNAP/API E-Wallet (Direct Debit) SNAP/ # Tentang Notification Transaction - API E-Wallet (Direct Debit) SNAP *** API ini digunakan untuk mengirimkan notifikasi transaksi pembayaran pada metode pembayaran E-Wallet dengan Fitur Direct Debit Host to Host yang sesuai standar SNAP. # Panduan Validasi X-SIGNATURE *** Berikut adalah cara untuk melakukan validasi X-SIGNATURE pada Request Header Notify: `SHA256withRSA (Public_Key, stringToSign) stringToSign = client_ID + “|” + X-TIMESTAMP` :::hint{type="warning"} Informasi khusus API Notifikasi SNAP terkait kredensial `Public_Key` akan diberikan oleh tim NICEPAY kepada Merchant melalui email, karena kredensial `Public_Key` yang akan digunakan di API Notifikasi SNAP berbeda dengan API Transaksi SNAP (Registration, Inquiry & Payment). Silakan menghubungi Tim Integrasi melalui email ([integration@nicepay.co.id](mailto\:integration@nicepay.co.id)) untuk informasi atau bantuan lebih lanjut. ::: Berikut adalah contoh hasil X-SIGNATURE dari cara validasi di atas: `mYyscWBs00bm0TJQ/xY7Uu1Goh8qXJyYSlo88rFrhQ+mlyQkMtq NKMlZDpS+` # Merchant Notification - API E-Wallet (Direct Debit) SNAP *** | **Service Code** | `56` | | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **API Endpoint** | `[merchant-domain]/api/v1.0/debit/notify` | | **HTTP Method** | `POST` | | **Content-type** | `application/json` | | **Description** | Transaction Result Notification (when success)

If your use firewall, add allow policy for IP =
IP Public environtment Production:
`103.20.51.34`
`103.20.51.33`
`18.98.96.50`

IP Public environtment Dev:
`103.20.51.39`
`103.20.51.40`
`18.98.96.54` | ## Request Header Parameter for Notification Transaction - API E-Wallet (Direct Debit) SNAP | **Parameter** | **Tipe** | **Kebutuhan** | **Deskripsi** | | -------------- | -------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `Content-Type` | String | Mandatory | `Application / JSON` | | `X-TIMESTAMP` | String | 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-CLIENT-KEY` | String | Mandatory | Unique Partner ID, Partner ID = Client ID | | `X-SIGNATURE` | String | Mandatory | Signature will be generated by Merchant.
[Panduan X-Signature - Symmetric](docId\:UZex33ReLyENKOgbJJnYp) | ## Request Body Parameter for Notification Transaction - API E-Wallet (Direct Debit) SNAP | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | ---------------------------- | -------- | ---------- | ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `originalReferenceNo` | String | 40 | Mandatory | Original transaction identifier on service
provider system | | `originalPartnerReferenceNo` | String | 40 | Mandatory | Original transaction identifier on consumer
system | | `externalStoreId` | String | 32 | Optional | Unique identifier of shop id in client system | | `amount` | Object | Variable | Mandatory | Amount of transaction | | `value` | String | 12 | Mandatory | Value | | `currency` | String | 3 | Mandatory | Currency | | `latestTransactionStatus` | String | 2 | Mandatory | Category code for the status of the
transaction. Example :
`00`- Success
`06`- Failed | | `transactionStatusDesc` | String | 50 | Optional | Description status transaction | | `additionalInfo` | Object | Variable | Mandatory | Additional information | | `transactionDateTime` | String | 25 | Optional | Transaction Date Using ISO-8601 Format
`YYYY-MM-DDTHH:MM:SS` | | `mitraCd` | String | 4 | Mandatory | [Mitra Code - API SNAP](docId\:mebNfCDEq1GFUs9oE_MOF)

Example :
OVO : `OVOE`
Link Aja : `LINK`
DANA : `DANA`
ShopeePay : `ESHP` | | `goodsNm` | String | 200 | Mandatory | Goods Name | | `billingNm` | String | 100 | Mandatory | Buyer Name | | `billingPhone` | String | 20 | Mandatory | Buyer Phone Number | ## Response Header Parameter for Notification Transaction - API E-Wallet (Direct Debit) SNAP | **Parameter** | **Tipe** | **Kebutuhan** | **Deskripsi** | | -------------- | -------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `Content-Type` | String | Mandatory | `Application / JSON` | | `X-TIMESTAMP` | String | 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`.
| ## Response Body Parameter for Notification Transaction - API E-Wallet (Direct Debit) SNAP | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | ----------------- | -------- | ---------- | ------------- | ---------------------------------------------------------------------------- | | `responseCode` | String | 7 | Mandatory | [General Response Code and Message - API SNAP](docId\:lKqJXSl5CMKdXYXxHYYSs) | | `responseMessage` | String | 150 | Mandatory | Response Message | ## Sample Parameter for Notification Transaction - API E-Wallet (Direct Debit) SNAP *** ### Request Parameter :::CodeblockTabs cURL ```curl curl -X POST \ 'https://merchant.com/api/v1.0/debit/notify' \ -H 'Content-type: application/json' \ -H 'X-TIMESTAMP: 2023-11-23T07:44:11+07:00' \ -H 'X-SIGNATURE: 85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5' \ -H 'X-CLIENT-KEY: 82150823919040624621823174737537' \ -d '{"originalPartnerReferenceNo":"2020102977770000000009","originalReferenceNo":"TNICEEW05108202210141451109841","amount":{"value":"10000.00","currency":"IDR"},"latestTransactionStatus":"00","transactionStatusDesc":"Success","externalStoreId":"91863213913112","additionalInfo":{"transactionDateTime":"2019-07-03T12:08:56-07:00","mitra_cd":"DANA","goodsNm":"Merchant Goods 1","billingNm":"Buyer Name","billingPhone":"02112345678"}}' ``` ::: ### Response Parameter :::CodeblockTabs Sample Response ```json { "responseCode": "2005600", "responseMessage": "Success" } ``` ::: [title] Inquiry - API Payout (Disbursement) SNAP [path] NICEPAY API/API SNAP/Payout API (Disbursement) - SNAP/ # Tentang Inquiry - API Payout (Disbursement) SNAP *** API ini digunakan untuk mendapatkan rincian transaksi inquiry yang melalui proses Disbursement. # Inquiry - API Payout (Disbursement) SNAP *** :::hint{type="warning"} Silakan mengajukan akses token terlebih dahulu untuk melakukan autentikasi melalui bagian [Request Access Token API - SNAP](docId\:GcGqBIYXG1Etcd0Ji9cHX). ::: | **API Endpoint** | [`/nicepay/api/v1.0/transfer/inquiry`](https://www.nicepay.co.id/nicepay/api/v1.0/transfer/inquiry) | | ---------------- | --------------------------------------------------------------------------------------------------- | | **HTTP Method** | **POST** | | **Description** | Untuk mendapatkan rincian transaksi inquiry yang melalui proses Disbursement. | | **Content-type** | `application/json` | ## Request Inquiry Disbursement Header Parameter | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | **Contoh** | | --------------- | -------- | ---------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | | `Content-Type` | String | 127 | Mandatory | Content type, value always `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 | Signature will be generated by Merchant.
[Panduan X-Signature - Symmetric](docId\:UZex33ReLyENKOgbJJnYp) | | | `X-PARTNER-ID` | String | 20 | Mandatory | Unique Partner ID, Partner ID = Client ID | | | `X-EXTERNAL-ID` | String | 40 | Mandatory | Unique messaging reference id generated by Merchant. Numeric String. Reference number that
should be unique in every transaction. | | | `CHANNEL-ID` | String | 5 | Mandatory | Unique Channel Merchant Credential ID Number.
Client ID + "01" = Channel ID
`"IONPAYTEST" + "01" = "IONPAYTEST01"` | IONPAYTEST01 | ## Request Inquiry Disbursement Body Parameter | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | ---------------------------- | -------- | ---------- | ------------- | ---------------------------------------------------------- | | `merchantId` | String | 10 | Mandatory | Merchant identifier that is unique per each Merchant | | `originalReferenceNo` | String | 40 | Mandatory | Original transaction identifier on service provider system | | `originalPartnerReferenceNo` | String | 40 | Mandatory | Original transaction identifier on consumer system | | `beneficiaryAccountNo` | String | 25 | Mandatory | Beneficiary Account Number | ## Response Inquiry Disbursement Parameter | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | ------------------------------ | -------------------- | ---------- | ------------- | ------------------------------------------------------------------------------------------------------------------------- | | `responseCode` | String | 7 | Mandatory | Refer to [General Response Code and Message - API SNAP](docId\:lKqJXSl5CMKdXYXxHYYSs) list | | `responseMessage` | String | 150 | Mandatory | Refer to [General Response Code and Message - API SNAP](docId\:lKqJXSl5CMKdXYXxHYYSs) 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. | | `beneficiaryAccountNo` | String | 25 | Mandatory | Beneficiary Account Number | | `beneficiaryName` | String | 100 | Mandatory | Beneficiary Name | | `beneficiaryCustomerResidence` | String | 2 | Mandatory | Beneficiary Customer Residence:
`1`: Indonesia
`2`: Non Indonesia | | `beneficiaryCustomerType` | String | 2 | Mandatory | Beneficiary Customer Type:
`1`: Personal
`2`: Company
`3`: Government | | `beneficiaryBankCode` | String | 4 | Mandatory | Beneficiary [Bank Code - API SNAP](docId:9WOQy5-1hlf_uCwshSDHO) | | `amount` | Array of JSON Object | Variable | Mandatory | Amount Information
`"amount": {...}` | | `value` | String | 12 | Mandatory | Transaction amount, If it’s IDR then value includes 2 decimal digits.
e.g. IDR 10.000,- will be placed with 10000.00 | | `currency` | String | 3 | Mandatory | Currency code based on ISO | | `transactionDate` | String | 25 | Mandatory | Transaction Date | | `latestTransactionStatus` | String | 2 | Mandatory | [Transaction Status - API SNAP](docId\:XxlWrB0Q8XVkSMaO7ti9a) | | `transactionStatusDesc` | String | 50 | Optional | Transaction Status Description | ## Sample Parameter :::CodeblockTabs Request Body ```json //HEADER SECTION Content-Type: application/json Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8= X-TIMESTAMP: 2024-12-31T10:11:40+07:00 X-SIGNATURE: ufBw7R8RhW79IOiV/Hlv607M60qzAYBv8uZmbSrYb6/Thlo/FhQVP4xRyelUehoSS9o+QS6vWTKb/ygtucC+tQ== X-PARTNER-ID :IONPAYTEST X-EXTERNAL-ID: eXid202402111402271707638105 CHANNEL-ID: IONPAYTEST { "merchantId": "IONPAYTEST", "originalPartnerReferenceNo": "order1677048512514", "originalReferenceNo": "IONPAYTEST07202302221348332909", "beneficiaryAccountNo": "5345000060" } ``` Sample Response ```json { "responseCode": "2000000", "responseMessage": "Successful", "originalPartnerReferenceNo": "order1677048512514", "originalReferenceNo": "IONPAYTEST07202302221348332909", "beneficiaryAccountNo": "5345000060", "beneficiaryName": "IONPAY NETWORKS", "beneficiaryBankCode": "CENA", "beneficiaryCustomerResidence": "1", "beneficiaryCustomerType": "1", "amount": { "value": "10000.00", "currency": "IDR" }, "latestTransactionStatus": "03", "transactionStatusDesc": "Pending" } ``` ::: [title] Inquiry - API NICEPAY Inquiry Virtual Account SNAP [path] NICEPAY API/API SNAP/Advance API - SNAP/API NICEPAY Inquiry Virtual Account SNAP/ # Tentang Inquiry - API NICEPAY Inquiry Virtual Account SNAP *** Bagian ini berisi tentang informasi terkait API dengan standar SNAP yang digunakan pada metode pembayaran Virtual Account dengan fitur NICEPAY Inquiry Virtual Account (NIVA) agar dapat memeriksa status transaksi*.* # Inquiry - API NICEPAY Inquiry Virtual Account SNAP *** :::hint{type="warning"} Silakan mengajukan akses token terlebih dahulu untuk melakukan autentikasi melalui bagian [Request Access Token - API NICEPAY Inquiry Virtual Account SNAP](docId\:tbDHyMKVQK7C20nUkjB0N). ::: | **Service Code** | `24` | | ---------------- | ------------------------------------------------------ | | **API Endpoint** | `[merchant-domain]/api/v1.0/transfer-va/inquiry` | | **Method** | `HTTP` `POST` | | **Description** | Untuk melakukan pemeriksaan status transaksi NIVA | | **Content-type** | `application/json` | :::hint{type="info"} Pada saat melakukan , akan mengirimkan Public Key kepada . Kemudian, wajib memberi terkait *endpoint * Inquiry VA dan mengirimkan Client ID & Client Secret sesuai dengan spesifikasi kepada tim . Hal tersebut perlu dilakukan agar dapat mengajukan akses token dan melakukan *inquiry* data berada di sisi . Sehingga, dapat dijalankan dengan lancar oleh . ::: ## Request Inquiry Header Parameter | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | **Contoh** | | --------------- | -------- | ---------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | | `Content-Type` | String | | Mandatory | `Application / JSON` | | | `Authorization` | String | | Mandatory | Bearer “`access_token`” | | | `X-TIMESTAMP` | String | | 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 | | Mandatory | Signature will be generated by Merchant.
[Panduan X-Signature - Symmetric](docId\:UZex33ReLyENKOgbJJnYp) | | | `X-PARTNER-ID` | String | 20 | Mandatory | `X-PARTNER-ID` = `CLIENT_ID` | | | `X-EXTERNAL-ID` | String | 40 | Mandatory | Unique Reference Number
(`41807553358950093184`) | | | `CHANNEL-ID` | String | | Mandatory | Unique Channel Merchant Credential ID Number.
Client ID + "01" = Channel ID
`"IONPAYTEST" + "01" = "IONPAYTEST01"` | IONPAYTEST01 | ## Request Inquiry Body Parameter | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | ------------------ | -------- | ---------- | ------------- | ----------------------------------------------------------------- | | `partnerServiceId` | String | 20 | Mandatory | Partner Service ID / Prefix | | `customerNo` | String | 40 | Mandatory | Customer Number | | `virtualAccountNo` | String | 25 | Mandatory | Virtual Account Number | | `inquiryRequestId` | String | 40 | Mandatory | Unique Identifier for this Inquiry | | `additionalInfo` | Object | | Mandatory | `"additionalInfo": { `
` ... `
` }` | | `bankCd` | String | 4 | Mandatory | [Bank Code - API SNAP](docId:9WOQy5-1hlf_uCwshSDHO) | ## Response Inquiry Parameter | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | -------------------- | -------- | ---------- | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `responseCode` | String | | Mandatory | [General Response Code and Message - API SNAP](docId\:lKqJXSl5CMKdXYXxHYYSs) | | `responseMessage` | String | | Mandatory | Response Message | | `virtualAccountData` | Object | | Mandatory | `"virtualAccountData": { `
` "partnerServiceId": "70151021", `
` "customerNo": "89101110", `
` "virtualAccountNo": "7015102189101110", `
` "virtualAccountName": "John Test", `
` "inquiryRequestId": "41807553358950093184", `
` "totalAmount": { `
` .... `
` } `
` },` | | `partnerServiceId` | String | 20 | Mandatory | Partner Service ID / Prefix | | `customerNo` | String | 40 | Mandatory | Customer Number (Mandatory for Fix Type) | | `virtualAccountNo` | String | 25 | Mandatory | Virtual Account Number | | `virtualAccountName` | String | 100 | Mandatory | Virtual Account Name | | `inquiryRequestId` | String | 40 | Mandatory | Unique Identifier for this Inquiry | | `totalAmount` | Object | | Mandatory | `"totalAmount": { `
` .... `
` }` | | `value` | String | 12 | Mandatory | Value | | `currency` | String | 3 | Mandatory | Currency | | `additionalInfo` | Object | | Mandatory | `"additionalInfo": { `
` ... `
` }` | | `trxId` | String | 40 | Mandatory | Merchant Order Number | | `goodsNm` | String | 200 | Mandatory | Goods Name | ## Sample Parameter :::CodeblockTabs Sample Request ```json //HEADER SECTION Content-Type: application/json Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8= X-TIMESTAMP: 2024-12-31T10:11:40+07:00 X-SIGNATURE: ufBw7R8RhW79IOiV/Hlv607M60qzAYBv8uZmbSrYb6/Thlo/FhQVP4xRyelUehoSS9o+QS6vWTKb/ygtucC+tQ== X-PARTNER-ID: FIXOPEN001 X-EXTERNAL-ID: tXid202402111402271707638114 CHANNEL-ID: FIXOPEN001 { "partnerServiceId": "70151021", "customerNo": "89101110", "virtualAccountNo": "7015102189101110", "inquiryRequestId": "41807553358950093184", "additionalInfo": { "bankCd": "BMRI" } } ``` Sample Response ```json { "responseCode": "2002400", "responseMessage": "Success", "virtualAccountData": { "partnerServiceId": "70151021", "customerNo": "89101110", "virtualAccountNo": "7015102189101110", "virtualAccountName": "John Test", "inquiryRequestId": "41807553358950093184", "totalAmount": { "value": "10000.00", "currency": "IDR" } }, "additionalInfo": { "trxId": "ref100000001", "goodsNm": "Test Item" } } ``` ::: [title] QRIS - API Checkout [path] NICEPAY API/API Checkout/Payment - API Checkout/ # Tentang QRIS - API Checkout *** ini digunakan oleh untuk melakukan pengajuan kepada . # Alur Proses *** ![Alur Proses QRIS](https://app.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/_wtkHu0TMt0wTFc0TglEl_nicepay-archbee-payment-qris-redirect-v2.png "Alur Proses QRIS") Deskripsi langkah: 1. melakukan *checkout.* 2. mengirimkan data kepada . 3. mengirim pengajuan *checkout *menggunakan Registration kepada . 4. melakukan pendaftaran *checkout*. 5. mengalihkan menuju . 6. menampilkan kepada . 7. memilih . 8. memindai QR dan mengirim hasil kepada . 9. melakukan . 10. mengirimkan hasil *payment note *kepada . 11. mengirimkan atau pesan kepada 12. memperbaharui . 13. mengirimkan `dbProcessUrl` kepada . 14. menerima . 15. mengajukan inquiry kepada . 16. menerima pengajuan. 17. mengirim *response * inquiry kepada . 18. menerima akhir. 19. mengirimkan hasil kepada . # NICEPAY Secure Payment Page *** ![Secure Payment Page](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/ohh_r6otn4iPQSs_4RfL1_image-id-nicepay-secure-payment-page-main-dashboard.jpg "Secure Payment Page") Gambar di atas adalah contoh *Checkout *dengan metode menggunakan Secure Page. :::hint{type="warning"} tidak dapat kembali ke Secure setelah memilih karena kode QR sudah berhasil dibuat dan sudah berjalan. Apabila ingin memilih lain, maka wajib membuat ulang dari awal. ::: ![QRIS - Secure Payment Page](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/HUJ4NCKTWLW0MPqQzgPme_image-id-qris-secure-payment-page.jpg "QRIS - Secure Payment Page") Setelah pilih metode dengan , kode QR akan muncul pada berikutnya. dapat langsung memindai kode tersebut dengan mengikuti panduan [Panduan Bayar QRIS](docId\:og8vGEkiCoG9mupWHrrJ0) atau mengunduh gambar terlebih dahulu melalui `Download Gambar QR`. ![Success - Secure Payment ](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/Fw_8zMbhp1O8Rzd-IL7mC_image-id-qris-success-secure-payment-page.jpg "Success - Secure Payment ") :::hint{type="warning"} Apabila kode QR belum berhasil dipakai untuk , akan tetapi sudah lebih dahulu kedaluwarsa, maka harus mengulang *generate *kode QR dengan kembali menuju *checkout *terlebih dahulu. ::: # API Checkout Transaction Payment *** | **API url** | `/nicepay/redirect/v2/payment` | | ------------------- | ------------------------------------------- | | **Request Method** | `Redirect-GET` | | **Header** | `Content-Type: application/Form-UrlEncoded` | ## Request Parameter for QRIS - API Checkout (CallbackUrl) *** Berikut adalah daftar Request Parameter untuk pada . | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | --------------------------------------------------------- | -------- | ---------- | --------------------- | ------------------------------------------------------------------------------------------------------------------- | | `paymentURL`
Required | URL | 14 | URL
| [https://www.nicepay.co.id/nicepay/redirect/v2/payment](https://www.nicepay.co.id/nicepay/redirect/v2/payment) | | `tXid`
Required | AN | 30 | Transaction ID
| IONPAYTEST00202103191252519205 | ## Response Parameter for QRIS - API Checkout (CallbackUrl) *** | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ---------------- | -------- | ---------- | ----------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | | `resultCd` | N | 4 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | 0000 | | `resultMsg` | AN | 255 | Result Message: [Error Code](docId\:yEh1VA9k2y6sL1kQF2aWD) | Success | | `tXid` | AN | 30 | Transaction ID
(Key from ) | TESTTEST0300202008070951284276

When success | | `referenceNo` | ANS | 40 | Order Number | ord20200807090809

When success | | `amount` | N | 12 | Transaction Amount | 1000

When success | | `transDt` | N | 8 | Registration Date (`YYYYMMDD`) | 20200808

When success | | `transTm` | N | 6 | Registration Time (`HH24MISS`) | 120000

When success | | `description ` | AN | 100 | Transaction Description | This is Testing Transaction

When success | | `authNo ` | N | 10 | Approval Number | 1234567890

When success – Only CC (Additional) | | `recurringToken` | AN | 255 | Recurring Token | 5b949971aea6d468bebef20fec7b067abde88e52a4520925cd28dfa840ce5abc

When success – Only CC (Additional) | | `cardNo` | ANS | 20 | Card Number with Masking | 420192\*\*\*\*\*\*2327
 
When success – Only CC | | `acquBankCd` | A | - | [Acquiring Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | BMRI

When success – Only CC | | `issuBankCd` | A | - | [Issuing Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | OTHR

When success – Only CC | | `vat ` | N | 12 | Number | 0

When success , CC | | `fee` | N | 12 | Service Fee | 0

When success , CC | | `notaxAmt` | N | 12 | Tax-Free Amount | 0

When success , CC | | `bankCd` | A | 4 | [Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | BMRI | | `mitraCd` | A | 4 | [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8) | OVOE

When success , , | | `bankVacctNo` | N | 20 | VA Number | 447770956314286

When success – VA | | `payNo` | N | 20 | Number | 9041071059504308

When success – CVS | | `currency` | A | 3 | Currency | IDR

When success – , | | `goodsNm` | AN | 100 | Goods name | Testing Transaction

When success – , | | `billingNm` | A | 100 | Billing Name | IONPAY NETWORK TESTING

When success – , | | `payMethod` | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | 03

When success – , | :::hint{type="info"} Catatan: Response akan dikirimkan melalui `callBackurl` dengan Content-type: `application/x-www-form-urlencoded` dan metode: `POST Parameter`. ::: ## Sample Parameter for QRIS - API Checkout (CallbackUrl) *** :::hint{type="success"} Pada saat *Checkout*, *response* dari *request* di-*hit* adalah Callback URL. ::: ### Request Parameter :::CodeblockTabs cURL ```curl curl -X GET "https://www.merchant.com/callbackUrl?ccTransType=1&fee=0&tXid=IONPAYTEST00202212201540174369&amt=1000¬axAmt=0&cardNo=46161111****1111&issuBankCd=BMRI&matchCl=1&preauthToken=null&cardExpYymm=2603&acquBankNm=Mandiri&payMethod=01¤cy=IDR&instmntMon=1&cc_trans_type=1&issuBankNm=Mandiri&merchantToken=dc1dd9e57ff6c4db341654ae31e623cab4d4d8057b2d0b58bef43ccb0da3b494&goodsNm=Goods+For+Testing+Credit+Card&referenceNo=ordNo20221220151243&authNo=174300&transTm=154017&cpGuaranteeableStatus=null&recurringToken=null&vat=0&instmntType=1&billingNm=John+Doe&acquBankCd=BMRI&transDt=20221220&status=0" ``` ::: ### Callback Parameter :::CodeblockTabs Response Callback ```curl resultCd=0000 resultMsg=SUCCESS tXid=IONPAYTEST00202212211103524783 referenceNo=ORDERKU345 payMethod=09 amt=12000 billingNm=John+Doe authNo=150367 cardNo=62210082****0590 acquBankCd=ARTJ issuBankCd=ARTJ acquBankNm=Artajasa issuBankNm=Artajasa ``` ::: ## Callback Handling API Checkout Transaction Payment *** :::hint{type="success"} Saat *Callback *diterima `callbackUrl` , kami merekomendasikan untuk melakukan verifikasi Status dengan menggunakan [Status Inquiry - API Checkout](docId\:K9vBS87ev9_w5oJAU0et3). ::: :::hint{type="warning"} `Callback Handling` sangat penting untuk membantu meminimalisir tindakan *Fraud*. Kami sangat merekomendasikan untuk melakukan verifikasi menggunakan `Callback parameter`. ::: ::Image[]{src="https://app.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/OUMptNJjJPMmefkBqRpQS_nicepay-api-checkout-api-callback-handling-flow-1.png" size="50" width="370" height="361" position="center" caption="Alur Callback Handling" alt="Alur Callback Handling" showCaption="true"} :::CodeblockTabs URL Callback ```none https://merchant.com/callback-nicepay?resultCd=0000&resultMsg=SUCCESS&tXid=IONPAYTEST00202212211103524783&referenceNo=ORDERKU345&payMethod=09&amt=12000&billingNm=John+Doe&authNo=150367&cardNo=62210082****0590&acquBankCd=ARTJ&issuBankCd=ARTJ&acquBankNm=Artajasa&issuBankNm=Artajasa ``` Response Callback ```json resultCd=0000 resultMsg=SUCCESS tXid=IONPAYTEST00202212211103524783 referenceNo=ORDERKU345 payMethod=09 amt=12000 billingNm=John+Doe authNo=150367 cardNo=62210082****0590 acquBankCd=ARTJ issuBankCd=ARTJ acquBankNm=Artajasa issuBankNm=Artajasa ``` ::: [title] Access Token B2B & B2B2C - Account Binding API E-Wallet (Direct Debit) SNAP [path] NICEPAY API/API SNAP/Payment API - SNAP/API E-Wallet (Direct Debit) SNAP/Account Binding - API E-Wallet (Direct Debit) SNAP/ # Tentang Access Token B2B & B2B2C - Account Binding API E-Wallet (Direct Debit) SNAP *** Bagian ini berisi tentang rincian terkait kebutuhan akses token dengan standar digunakan agar dapat melakukan terkait B2B dan B2B2C. Access Token B2B - Account Binding API E-Wallet (Direct Debit) SNAP =================================================================== *** :::hint{type="info"} Kunjungi [Account Binding - API E-Wallet (Direct Debit) SNAP](docId\:jsV9P_nt63W2A27oRCy5U) untuk mengetahui alur mendapatkan akses token pada *account binding*. ::: Access Token B2B digunakan oleh untuk menginisiasi dengan . | **Service Code** | `73` | | ---------------- | --------------------------------------- | | **API Endpoint** | `/nicepay/v1.0/access-token/b2b` | | **Method** | `POST` | | **Description** | Get Access Token B2B Specification | ## Request Header Parameter for Access Token B2B - Account Binding API E-Wallet (Direct Debit) SNAP *** | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | -------------- | -------- | ---------- | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `Content-Type` | String | Variable | Mandatory | `Application/Json` | | `X-TIMESTAMP` | String | Variable | Mandatory | `yyyy-MM-ddTHH:mm:ss.SSSTZD`
(2022-03-21T10🕚40+07:00) | | `X-CLIENT-KEY` | String | Variable | Mandatory | Credential Client ID | | `X-SIGNATURE` | String | Variable | Mandatory | `X-SIGNATURE`: created using asymmetric
signature SHA256withRSA algorithm
(`Private_Key`, `stringToSign`)
`stringToSign `= client ID + “\|” + `X-TIMESTAMP` | ## Request Body Parameter for Access Token B2B - Account Binding API E-Wallet (Direct Debit) SNAP *** | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | ---------------- | ----------- | ---------- | ------------- | ---------------------------------------- | | `grantType` | String | Variable | Mandatory | Grant Type Value: “`client_credentials`” | | `additionalInfo` | JSON Object | Variable | Mandatory | Additional Information | ## Response Header Parameter for Access Token B2B - Account Binding API E-Wallet (Direct Debit) SNAP *** | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | -------------- | -------- | ---------- | ------------- | ------------------------------------------------------------------------------------------------- | | `Content-Type` | String | Variable | Mandatory | Content type, value always `application/json` | | `X-TIMESTAMP` | String | Variable | Mandatory | Transaction date time, in format `YYYY-MMDDTHH:mm:ss+07:00`. Time must be in GMT+7 (Jakarta time) | ## Response Body Parameter for Access Token B2B - Account Binding API E-Wallet (Direct Debit) SNAP *** | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | ----------------- | -------- | ---------- | ------------- | ------------------------------------------------------- | | `responseCode` | String | Variable | Mandatory | Refer to response code list | | `responseMessage` | String | Variable | Mandatory | Debug message to provide | | `accessToken` | String | 2048 | Mandatory | Token Authorization that used for Shopee Pay Services | | `tokenType` | String | Variable | Mandatory | Token Type Value: “Bearer” | | `expiresIn` | String | 3 | Mandatory | Token Validate Time | ## Sample Parameter for Access Token B2B - Account Binding API E-Wallet (Direct Debit) SNAP *** ### Request Parameter :::CodeblockTabs cURL ```curl curl -X POST \ 'https://dev.nicepay.co.id/nicepay/v1.0/access-token/b2b' \ -H 'Content-Type: application/json' \ -H 'X-SIGNATURE: aFHq5SNdWO5Pq2vwZk4ztd9Cu3OvblG6NezGwLX3GC2mRJorDHPeZpR3V+RXrPC8ojcyCwQy01FSipmA8YdQvz1hOth7aekXzhigYCRNS34EHYEoFGD1YMHVFRvxn2Fu8HAd6wTvPNy2X2rbUS3hWrJsfa5cHu8wKVb7zPCuxNc=' \ -H 'X-CLIENT-KEY: IONPAYTEST' \ -H 'X-TIMESTAMP: 2024-01-31T10:11:40+07:00' \ -d '{"grantType": "client_credentials", "additionalInfo": {}}' ``` Node.js ```nodejs const config = { isProduction: false, privateKey: cons.privateKey, clientSecret: cons.clientSecret, clientId: "IONPAYTEST", isCloudServer: false, externalId: "eXid202402111402271707638098", timestamp: "2024-01-31T10:11:40+07:00", }; const tokenBody = { "grantType ": "client_credentials", "additionalInfo": {} }; let snap = new Snap(config); let response = snap.requestSnapAccessToken(tokenBody); ``` ```java config = NICEPay.builder() .isProduction(false) .clientSecret("YOUR_CLIENT_SECRET") .partnerId("IONPAYTEST") .externalID("eXid202402111402271707638098") .timestamp("2024-01-31T10:11:40+07:00") .privateKey("YOUR_PRIVATE_KEY") .build(); AccessToken accessToken = AccessToken.builder() .grantType("client_credentials") .additionalInfo(new HashMap<>()) .build(); NICEPayResponse result = SnapTokenService.callGetAccessToken(accessToken, config); ``` ```python bodyCreateToken = ( builderAccessToken.BuildAccessToken() .setGrantType("client_credentials") .setAdditionalInfo({}) .build() ) environment = (builderEnvironment.BuildEnvironment() .isCloud(False) .isProduction(False) .build()) result = SnapService.serviceOAUTH(bodyCreateToken.jsonAccessToken(), environment) ``` C# ```csharp const string CLIENT_ID = "IONPAYTEST"; const string X_TIMESTAMP = "2024-01-31T10:11:40+07:00"; const bool IS_PRODUCTION = false; const bool IS_CLOUD_SERVER = false; // Generate signature using values directly string signature = SignatureGeneratorUtils.GenerateSignature(config.PrivateKey, CLIENT_ID, X_TIMESTAMP); // Get access token var tokenRequester = new AccessTokenRequester(); string accessTokenResponse = await tokenRequester.GetAccessTokenAsync(CLIENT_ID, signature, X_TIMESTAMP, IS_PRODUCTION, IS_CLOUD_SERVER); dynamic accessTokenObject = JObject.Parse(accessTokenResponse); string accessToken = accessTokenObject.accessToken; ``` Laravel ```php protected $useProd = false; protected $useCloud = false; protected $access_token_endpoint = "/nicepay/v1.0/access-token/b2b"; protected $client_id = "IONPAYTEST"; PROTECTED $key = "_PRIVATE_KEY_MERCHANT"; $url = HttpUtil::getNicepayDomain($this->useProd, $this->useCloud) . $this->access_token_endpoint; $helper = new Helpers(); $x_time_stamp = "2024-01-31T10:11:40+07:00"; $client_id = $this->client_id; $bd = [ "grantType" => "client_credentials", "additionalInfo" => new \stdClass() ]; $string_to_sign = $client_id . "|" . $x_time_stamp; $signature = $helper->generateSignature($string_to_sign, $this->key, OPENSSL_ALGO_SHA256); $header = $helper->generateHeaderAccessToken($x_time_stamp, $client_id, $signature); try { $response = Http::withHeaders($header)->post($url, $bd); } catch (Exception $e) { // Handle exception } ``` PHP Native ```php const string PARTNER_ID = "IONPAYTEST"; const string X_TIMESTAMP = "2024-01-31T10:11:40+07:00"; const string X_EXTERNAL_ID = "eXid202402111402271707638098"; $config = NICEPay::builder() ->setIsProduction(false) ->setPrivateKey("_YOUR_PRIVATE_KEY_") ->setClientSecret("_YOUR_CLIENT_SECRET_") ->setPartnerId(PARTNER_ID) ->setExternalID(X_EXTERNAL_ID) ->setTimestamp(X_TIMESTAMP) ->build(); $tokenBody = AccessToken::builder() ->setGrantType('client_credentials') ->setAdditionalInfo([]) ->build(); $snap = new Snap($config); try { $response = $snap->requestSnapAccessToken($tokenBody); } catch (\Exception $e) { // Handle exception } ``` ```kotlin const val PARTNER_ID = "IONPAYTEST" const val EXTERNAL_ID = "eXid202402111402271707638098" // Used for general context consistency const val TIMESTAMP = "2024-01-31T10:11:40+07:00" // Step 1: Initialize the NICEPay Configuration var config: NICEPay = NICEPay.Builder() .isProduction(false) .clientSecret("YOUR_CLIENT_SECRET") // Placeholder .partnerId(PARTNER_ID) .externalID(EXTERNAL_ID) .timestamp(TIMESTAMP) .privateKey("YOUR_PRIVATE_KEY") // Placeholder .build() val service: SnapAccessTokenService = SnapAccessTokenServiceImpl() // Step 2: Define the Access Token Request Body val request = AccessToken.Builder() .grantType("client_credentials") .additionalInfo(emptyMap()) .build() // Step 3: Execute the Access Token Request val response = service.getAccessToken(request, config) ``` CodeIgniter ```php $config = NICEPay::builder() ->setIsProduction(false) ->setIsCloudServer(true) ->setPrivateKey($private_key) ->setClientSecret($client_secret) ->setPartnerId("IONPAYTEST") ->setExternalID("eXid202402111402271707638098") ->setTimestamp("2024-01-31T10:11:40+07:00") ->build(); $data = AccessToken::builder() ->setGrantType("client_credentials") ->setAdditionalInfo([]) ->build(); $snap = new Snap($config); $response = $snap->requestSnapAccessToken($data); ``` ::: ### Response Parameter :::CodeblockTabs Sample Response ```json { "responseCode": "2007300", "responseMessage": "Successful", "accessToken": "Xy8duZzAvv9bwDXxRxcb89tsuvk4MF4kx4lGfE4aCRVxR7XdERhbe1", "tokenType": "Bearer", "expiresIn": "900" } ``` ::: # Access Token B2B2C - Account Binding API E-Wallet (Direct Debit) SNAP *** Access Token B2B2C digunakan oleh untuk menginisiasi menggunakan akun sudah terhubung pada . | **Service Code** | `74` | | ---------------- | ----------------------------------------- | | **API Endpoint** | `/nicepay/api/v1.0/access-token/b2b2c` | | **Method** | `POST` | | **Description** | Get Access Token B2B2C Specification | ## Request Header Parameter for Access Token B2B2C - Account Binding API E-Wallet (Direct Debit) SNAP | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | -------------- | -------- | ---------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `Content-Type` | String | Variable | Mandatory | `Application/Json` | | `X-TIMESTAMP` | String | Variable | Mandatory | `yyyy-MM-ddTHH:mm:ss.SSSTZD`
(2022-03-21T10🕚40+07:00) | | `X-CLIENT-KEY` | String | Variable | Mandatory | Credential Client ID | | `X-SIGNATURE` | String | Variable | Mandatory | `X-SIGNATURE`: created using asymmetric
signature `SHA256withRSA `algorithm
(`Private_Key`, `stringToSign`)
`stringToSign` = Client ID + “\|” + `X-TIMESTAMP` | ## Request Body Parameter for Access Token B2B2C - Account Binding API E-Wallet (Direct Debit) SNAP | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | -------------------- | ----------- | ---------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `grantType` | String | 32 | Mandatory | Apply token request key type, can be `AUTHORIZATION_CODE` or `REFRESH_TOKEN` | | `authCode` | String | 256 | Conditional | The authorization code received after User provides consent. Mandatory if `grantType` = `AUTHORIZATION_CODE` | | `refreshToken` | String | 512 | Conditional | Refresh token to get a new `accessToken` where User doesn't need to provide consent again. Mandatory if `grantType` = `REFRESH_TOKEN`. Refresh Token should be less than access token validity and will be manage by PJP’s application to generate a new `access_token`. | | `additionalInfo` | JSON Object | Variable | Mandatory | Additional | | `partnerReferenceNo` | String | 40 | Mandatory | identifier from | | `mitraCd` | String | 4 | Mandatory | Code
`AstraPay` : `ASTR`
`AlloBank` : `ALLO` | ## Response Header Parameter for Access Token B2B2C - Account Binding API E-Wallet (Direct Debit) SNAP | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | -------------- | -------- | ---------- | ------------- | ------------------------------------------------------------------------------------------------------ | | `Content-Type` | String | Variable | Mandatory | Content type, value always `application/json` | | `X-TIMESTAMP` | String | Variable | Mandatory | Transaction date time, in format `YYYY-MMDDTHH:mm:ss+07:00`. Time must be in GMT+7 (Jakarta time) | ## Response Body Parameter for Access Token B2B2C - Account Binding API E-Wallet (Direct Debit) SNAP | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | ------------------------ | ----------- | ---------- | ------------- | ----------------------------------------------------------------------------------------- | | `responseCode` | String | 7 | Mandatory | Refer to response code list | | `responseMessage` | String | 40 | Mandatory | Debug message to provide more | | `accessToken` | String | 50 | Mandatory | Authorization in form of a string given to user and used to access protected resources | | `tokenType` | String | 50 | Mandatory | Bearer Token | | `accessTokenExpiryTime` | String | 50 | Mandatory | Access token valid time will be 15 days format ISO8601 | | `refreshToken` | String | 50 | Mandatory | Random string used by user to get a new `accessToken` to access user data by format UUID | | `refreshTokenExpiryTime` | String | 50 | Mandatory | Time for `refreshToken` to expire | | `additionalInfo` | JSON Object | Variable | Mandatory | Additional | | `partnerReferenceNo` | String | 40 | Mandatory | identifier from | | `referenceNo` | String | 40 | Mandatory | Transaction ID | | `mitraCd` | String | 4 | Mandatory | Code
AstraPay : `ASTR`
Allo Bank : `ALLO` | ## Sample Parameter for Access Token B2B2C - Account Binding API E-Wallet (Direct Debit) SNAP *** ### Request Parameter :::CodeblockTabs cURL ```curl curl -X POST \ 'https://dev.nicepay.co.id/nicepay/v1.0/access-token/b2bc' \ -H 'Content-Type: application/json' \ -H 'X-SIGNATURE: aFHq5SNdWO5Pq2vwZk4ztd9Cu3OvblG6NezGwLX3GC2mRJorDHPeZpR3V+RXrPC8ojcyCwQy01FSipmA8YdQvz1hOth7aekXzhigYCRNS34EHYEoFGD1YMHVFRvxn2Fu8HAd6wTvPNy2X2rbUS3hWrJsfa5cHu8wKVb7zPCuxNc=' \ -H 'X-CLIENT-KEY: IONPAYTEST' \ -H 'X-TIMESTAMP: 2024-01-31T10:11:40+07:00' \ -d '{"grantType":"AUTHORIZATION_CODE","authCode":"3p8Uuq0dkDBPagBvbFIo1QodNzZaJJXXITpL9mFRsWAS","refreshToken":"3911773a-d3ac-4b4f-8a6c-406c21d6883d","additionalInfo":{"partnerReferenceNo":"202208121451526358","mitraCd":"ASTR"}}' ``` ::: ### Response Parameter :::CodeblockTabs Sample Response ```json { "grantType": "AUTHORIZATION_CODE", "authCode": "3p8Uuq0dkDBPagBvbFIo1QodNzZaJJXXITpL9mFRsWAS", "refreshToken": "3911773a-d3ac-4b4f-8a6c-406c21d6883d", "additionalInfo": { "partnerReferenceNo": "202208121451526358", "mitraCd": "ASTR" } } ``` ::: [title] Registration - Account Binding API E-Wallet (Direct Debit) SNAP [path] NICEPAY API/API SNAP/Payment API - SNAP/API E-Wallet (Direct Debit) SNAP/Account Binding - API E-Wallet (Direct Debit) SNAP/ # Tentang Registration - Account Binding API E-Wallet (Direct Debit) SNAP *** ini digunakan untuk menginisiasi proses *account binding* pada sesuai standar . Registration - Account Binding API E-Wallet (Direct Debit) SNAP =============================================================== *** :::hint{type="info"} Kunjungi [Account Binding - API E-Wallet (Direct Debit) SNAP](docId\:jsV9P_nt63W2A27oRCy5U) untuk mengetahui alur *account binding*. ::: ini digunakan untuk memulai menghubungkan akun pengguna milik akan digunakan pada dengan . | **Service Code** | `07` | | ---------------- | ------------------------------------------------ | | **API Endpoint** | `/nicepay/api/v1.0/registration-account-binding` | | **Method** | `POST` | ## Request Header Parameter for Registration - Account Binding API E-Wallet (Direct Debit) SNAP *** | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | --------------- | -------- | ---------- | ------------- | -------------------------------------------------------------------------------------------------------------- | | `Content-Type` | String | Variable | Mandatory | Content type, value always `application/json` | | `Authorization` | String | Variable | Mandatory | Bearer “`accessToken`” | | `X-TIMESTAMP` | String | Variable | Mandatory | Transaction date time, in format `YYYY-MMDDTHH:mm:ss+07:00`. Time must be in GMT+7 (Jakarta time) | | `X-SIGNATURE` | String | Variable | Mandatory | Signature will be generated automatically by | | `X-PARTNER-ID` | String | 10 | Mandatory | Unique ID, ID = Client ID | | `X-EXTERNAL-ID` | String | 40 | Mandatory | Unique messaging Reference ID generated by . Numeric String. Reference number that should be unique in every . | | `CHANNEL-ID` | String | 5 | Mandatory | Device identification on which s is currently being accessed by End User () | ## Request Body Parameter for Registration - Account Binding API E-Wallet (Direct Debit) SNAP *** | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | -------------------- | ----------- | ---------- | ------------- | -------------------------------------------------------------------- | | `partnerReferenceNo` | String | 40 | Mandatory | identifier | | `merchantId` | String | 10 | Mandatory | identifier that is unique per each | | `additionalData` | JSON Object | Variable | Mandatory | Additional Data | | `userId` | String | 100 | Mandatory | Name | | `email` | String | 40 | Mandatory | Email | | `phoneNo` | String | 15 | Mandatory | Phone Number | | `additionalInfo` | JSON Object | Variable | Mandatory | Additional | | `mitraCd` | String | 4 | Mandatory | Code Example :
AstraPay : ASTR
AlloBank : ALLO | | `callBackUrl` | String | 255 | Mandatory | result forward URL (on browser) | ## Response Header Parameter for Registration - Account Binding API E-Wallet (Direct Debit) SNAP *** | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | -------------- | -------- | ---------- | ------------- | ------------------------------------------------------------------------------------------------- | | `Content-Type` | String | Variable | Mandatory | Content type, value always `application/json` | | `X-TIMESTAMP` | String | Variable | Mandatory | Transaction date time, in format `YYYY-MMDDTHH:mm:ss+07:00`. Time must be in GMT+7 (Jakarta time) | ## Response Body Parameter for Registration - Account Binding API E-Wallet (Direct Debit) SNAP *** | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | -------------------- | ----------- | ---------- | ------------- | ---------------------------------------- | | `responseCode` | String | 7 | Mandatory | Refer to response code list | | `responseMessage` | String | 150 | Mandatory | Debug message to provide more
| | `referenceNo` | String | 40 | Mandatory | Transaction ID | | `partnerReferenceNo` | String | 40 | Mandatory | transaction identifier | | `redirectUrl` | String | 255 | Mandatory | Redirect URL to binding account | | `additionalInfo` | JSON Object | Variable | Mandatory | Additional | | `mitraCd` | String | 4 | Mandatory | Code | | `authCode` | String | 30 | Mandatory | Authentication Code for | ## Sample Parameter for Registration - Account Binding API E-Wallet (Direct Debit) SNAP *** ### Request Parameter :::CodeblockTabs cURL ```curl curl -X POST \ 'https://dev.nicepay.co.id/nicepay/api/v1.0/registration-account-binding' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8=' \ -H 'X-TIMESTAMP: 2024-01-31T10:11:40+07:00' \ -H 'X-SIGNATURE: ufBw7R8RhW79IOiV/Hlv607M60qzAYBv8uZmbSrYb6/Thlo/FhQVP4xRyelUehoSS9o+QS6vWTKb/ygtucC+tQ==' \ -H 'X-PARTNER-ID: IONPAYTEST' \ -H 'X-EXTERNAL-ID: tXid202410142300021707638093' \ -H 'CHANNEL-ID: IONPAYTEST01' \ -d '{"partnerReferenceNo":"2020102900000000000001","merchantId":"IONPAYTEST","additionalData":{"userId":"John Doe","email":"john.doe@email.com"},"phoneNo":"0899345678864332","additionalInfo":{"mitraCd":"ASTR","callBackUrl":"https://merchant.com/ProcesscallBackUrlUrl"}}' ``` Node.js ```nodejs const config = { isProduction: false, privateKey: cons.privateKey, clientSecret: cons.clientSecret, clientId: "IONPAYTEST", isCloudServer: false, }; const ACCESS_TOKEN = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8="; const parameter = { body: { partnerReferenceNo: "2020102900000000000001", merchantId: "IONPAYTEST", additionalData: { userId: "John Doe", email: "john.doe@email.com" }, phoneNo: "0899345678864332", additionalInfo: { mitraCd: "ASTR", callBackUrl: "https://merchant.com/ProcesscallBackUrlUrl" } }, headers: { X_EXTERNAL_ID: "tXid202410142300021707638093", CHANNEL_ID: "IONPAYTEST01", }, }; let snap = new Snap(config); let endPoint = `/api/v1.0/registration-account-binding`; let response = snap .requestSnapTransaction(parameter, endPoint, ACCESS_TOKEN, "POST"); ``` ::: ### Response Parameter :::CodeblockTabs Sample Response ```json { "responseCode": "2000700", "responseMessage": "Successful", "referenceNo": "IONPAYTEST05202208121451526358", "partnerReferenceNo": "2020102900000000000001", "redirectUrl": "https://redirect.com/account-binding/644efc4f9bb145efa6cf1e396", "additionalInfo": { "mitraCd": "ASTR", "authCode": "nlleyvaQcB2SOkVjtF7ceCuC16BiqCc6DRrjaKOnnfRdToW8Tr" } } ``` ::: [title] Approve Transaction - API Payout (Disbursement) SNAP [path] NICEPAY API/API SNAP/Payout API (Disbursement) - SNAP/ # Tentang Request Approve - API Payout (Disbursement) SNAP *** API ini digunakan untuk menyetujui proses yang diajukan pada saat pendaftaran. Kemudian, data transaksi akan lanjut untuk dieksekusi. # Request Approve - API Payout (Disbursement) SNAP *** :::hint{type="warning"} Silakan mengajukan akses token terlebih dahulu untuk melakukan autentikasi melalui bagian [Request Access Token API - SNAP](docId\:GcGqBIYXG1Etcd0Ji9cHX). ::: | **API Endpoint** | [`/nicepay/api/v1.0/transfer/approve`](https://dev.nicepay.co.id/nicepay/api/v1.0/transfer/approve) | | ---------------- | --------------------------------------------------------------------------------------------------- | | **HTTP Method** | **POST** | | **Description** | Approve Payout Transaction | | **Content-type** | `application/json` | ## Request Approve Disbursement Header Parameter | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | **Contoh** | | --------------- | -------- | ---------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | | `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 | Signature will be generated by Merchant.
[Panduan X-Signature - Symmetric](docId\:UZex33ReLyENKOgbJJnYp) | | | `X-PARTNER-ID` | String | 20 | Mandatory | Unique Partner ID, Partner ID = Client ID | | | `X-EXTERNAL-ID` | String | 40 | Mandatory | Unique messaging Reference ID generated by
Merchant. Numeric String. Reference number that
should be unique in every transaction. | | | `CHANNEL-ID` | String | 20 | Mandatory | Unique Channel Merchant Credential ID Number.
Client ID + "01" = Channel ID
`"IONPAYTEST" + "01" = "IONPAYTEST01"` | IONPAYTEST01 | ## Request Approve Disbursement Body Parameter | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | ---------------------------- | -------- | ---------- | ------------- | ---------------------------------------------------------- | | `originalPartnerReferenceNo` | String | 40 | Mandatory | Original transaction identifier on consumer system | | `originalReferenceNo` | String | 40 | Mandatory | Original transaction identifier on service provider system | | `merchantId` | String | 10 | Mandatory | Merchant identifier that is unique per each Merchant | ## Response Approve Disbursement Parameter | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | ---------------------------- | ------------------------- | ---------- | ------------- | ----------------------------------------------------------------------------------------------------------------------------------- | | `responseCode` | String | 7 | Mandatory | Refer to [General Response Code and Message - API SNAP](docId\:lKqJXSl5CMKdXYXxHYYSs) | | `responseMessage` | String | 150 | Mandatory | Refer to [General Response Code and Message - API SNAP](docId\:lKqJXSl5CMKdXYXxHYYSs) | | `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. | | `beneficiaryAccountNo` | String | 25 | Mandatory | Beneficiary Account Number | | `beneficiaryName` | String | 100 | Mandatory | Beneficiary Name | | `beneficiaryBankCode` | String | 4 | Mandatory | Beneficiary [Bank Code - API SNAP](docId:9WOQy5-1hlf_uCwshSDHO) | | `amount` | Array of JSON
Object | Variable | Mandatory | Amount Information
`"amount": {...}` | | `value` | String | 12 | Mandatory | Transaction amount, If it’s IDR then value
includes 2 decimal digits.
e.g. IDR 10.000,- will be placed with
10000.00 | | `currency` | String | 3 | Mandatory | Currency code based on ISO | | `transactionStatus` | String | 2 | Mandatory | [Transaction Status - API SNAP](docId\:XxlWrB0Q8XVkSMaO7ti9a) | ## Sample Parameter :::CodeblockTabs Request Body ```json //HEADER SECTION Content-Type: application/json Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8= X-TIMESTAMP: 2024-12-31T10:11:40+07:00 X-SIGNATURE: ufBw7R8RhW79IOiV/Hlv607M60qzAYBv8uZmbSrYb6/Thlo/FhQVP4xRyelUehoSS9o+QS6vWTKb/ygtucC+tQ== X-PARTNER-ID :IONPAYTEST X-EXTERNAL-ID: eXid202402111402271707638104 CHANNEL-ID: IONPAYTEST { "merchantId": "IONPAYTEST", "originalReferenceNo": "IONPAYTEST07202302221348332909", "originalPartnerReferenceNo": "order1677048512514" } ``` Sample Response ```json { "responseCode": "2000000", "responseMessage": "Successful", "originalPartnerReferenceNo": "order1677048512514", "originalReferenceNo": "IONPAYTEST07202302221348332909", "beneficiaryAccountNo": "5345000060", "beneficiaryName": "NICEPAY", "beneficiaryBankCode": "CENA", "amount": { "value": "10000.00", "currency": "IDR" }, "transactionStatus": "03" } ``` ::: [title] Notification - API Checkout [path] NICEPAY API/API Checkout/ # Tentang Notification - API Checkout *** mengirimkan *push notification* melalui `dbProcessUrl` . harus memastikan tidak melakukan Blacklist IP dan melakukan Whitelist IP untuk mendapatkan *push notification* hanya dikirim dari server . # Notification - API Checkout *** | **Method** | `POST` | | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Merchant Token** | SHA256 ( `iMid`+ `tXid` + `amt`+ `merchantKey`) | | **IP** | IP Public environtment Production:
`103.20.51.34`
`103.20.51.33`
`18.98.96.50`

IP Public environtment Dev:
`103.20.51.39`
`103.20.51.40`
`18.98.96.54` | | **User-Agent** | `User-Agent: Jakarta Commons-HttpClient/3.1` | ## Notification Parameter for Notification - API Checkout | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | --------------- | -------- | ---------- | ---------------------------------------------------------------------------------------------------------------- | -------------------- | | `tXid` | N | 30 | Transaction ID | | | `merchantToken` | AN | 255 | Token | | | `referenceNo` | ANS | 40 | Order Number | | | `payMethod` | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | | | `amt` | N | 12 | Amount | | | `transDt` | N | 8 | Transaction Date | | | `transTm` | N | 6 | Transaction Time | | | `currency` | A | 3 | Currency | | | `goodsNm` | AN | 100 | Goods Name | | | `billingNm` | A | 100 | Billing Name | | | `matchCl` | N | 1 | Amount Match Flag:
[Notification Match Amount Indicator](docId\:WdoGjBeqc1VmRdFJqG1ZE) | | | `status` | A | 1 | Deposit Status: [Notification Status Code](docId\:CdRwf99UxER6PH64ADA2C)
`0` : Deposit
`1` : Reversal | | :::hint{type="info"} Ketika diterima pada `dbProcessUrl` , kami sangat menyarankan untuk melakukan verifikasi kembali dengan menggunakan [Status Inquiry - API Checkout](docId\:K9vBS87ev9_w5oJAU0et3). ::: ### Additional Parameter for Credit Card Notification | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ---------------- | -------- | ---------- | ---------------------------------------------------------------------------------------------------------------------------------- | -------------------- | | `authNo` | N | 10 | Approval Number | | | `IssueBankCd` | A | 4 | [Issuing Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | | | `IssueBankNm` | A | 255 | Issuing Name | | | `acquBankCd` | A | 4 | [Acquiring Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | | | `acquBankNm` | A | 255 | Acquiring Name | | | `cardNo` | ANS | 20 | Card Number with Masking | | | `cardExpYymm` | N | 4 | Card Expiration (`YYMM`) | | | `instmntMon` | N | 2 | Installment Month
`1`: 1 Month/Full , jika `instmntType`*: null/1*
`3`: 3 Months
`6`: 6 Months
`12`: 12 Months | | | `instmntType` | N | 2 | [Installment Type Code](docId:7CIX-U_4z295XgtNVEsbO) | | | `preauthToken` | AN | 255 | Pre-Auth Token | | | `recurringToken` | AN | 255 | Recurring token | | | `ccTransType` | A | 2 | Transaction Type
`1` : Normal
`2` : Recurring
`3` : Pre-Auth
`4` : Captured | | | `vat` | N | 12 | Number | | | `fee` | N | 12 | Service Fee | | | `notaxAmt` | N | 12 | Tax Free Amount | | ### Additional Parameter for Virtual Account Notification | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | -------------- | -------- | ---------- | ----------------------------------------- | -------------------- | | `bankCd` | A | 4 | [Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | | | `vacctNo` | N | 16 | VA Number | | | `vacctValidDt` | N | 8 | VA Expiry Date (`YYYYMMDD`) | | | `vacctValidTm` | N | 6 | VA Expiry Time (`HH24MISS`) | | | `depositDt` | N | 8 | Deposit Date (`YYYYMMDD`) | | | `depositTm` | N | 6 | Deposit Time (`HH24MISS`) | | ### Additional Parameter for Others Payment Method Notification | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ------------- | -------- | ---------- | ------------------------------------------- | -------------------- | | `mitraCd` | A | 4 | [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8) | | | `payNo` | N | 12 | Number | | | `payValidDt` | N | 8 | Expiry Date (`YYYYMMDD`) | | | `payValidTm` | N | 6 | Expiry Time (`HH24MISS`) | | | `receiptCode` | ANS | 20 | Authorization Number | | | `mRefNo` | AN | 18 | Reference Number | | | `depositDt` | N | 8 | Deposit Date (`YYYYMMDD`) | | | `depositTm` | N | 6 | Deposit Time (`HH24MISS`) | | :::hint{type="warning"} *Merchant Token* diterima dari *Notification*, harus melakukan perbandingan kembali secara internal untuk mencegah palsu/tidak berlaku. ::: ## Sample Parameter for Notification - API Checkout *** ### Request Parameter :::CodeblockTabs cURL ```curl curl --location 'https://www.merchant-dbprocessurl.com' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --data-urlencode 'ccTransType=1' \ --data-urlencode 'fee=0' \ --data-urlencode 'tXid=TESTMPGS0401202510271659168614' \ --data-urlencode 'amt=20' \ --data-urlencode 'notaxAmt=0' \ --data-urlencode 'cardNo=51234500****0008' \ --data-urlencode 'issuBankCd=BTPN' \ --data-urlencode 'matchCl=1' \ --data-urlencode 'preauthToken=null' \ --data-urlencode 'cardExpYymm=3912' \ --data-urlencode 'acquBankNm=CIMB' \ --data-urlencode 'payMethod=01' \ --data-urlencode 'currency=IDR' \ --data-urlencode 'instmntMon=1' \ --data-urlencode 'cc_trans_type=1' \ --data-urlencode 'issuBankNm=BTPN' \ --data-urlencode 'merchantToken=8fb6a2b3748fea22590c58db8679d5b35e0781b33b1ad995823026fc0bcaa882' \ --data-urlencode 'goodsNm=Payment of Reference No 382-20251027165916' \ --data-urlencode 'referenceNo=382-20251027165916' \ --data-urlencode 'authNo=320082' \ --data-urlencode 'transTm=165916' \ --data-urlencode 'cpGuaranteeableStatus=null' \ --data-urlencode 'recurringToken=null' \ --data-urlencode 'vat=0' \ --data-urlencode 'instmntType=1' \ --data-urlencode 'billingNm=Inka Fazarillah' \ --data-urlencode 'acquBankCd=BNIA' \ --data-urlencode 'transDt=20251027' \ --data-urlencode 'status=0' ``` ::: ### Response Parameter :::CodeblockTabs Sample Response ```json { "resultCd": "200", "resultMsg": "SUCCESS", } // Response is customizable, Nicepay will read the http Status Code for success indicator ``` ::: [title] Payment - API NICEPAY Inquiry Virtual Account SNAP [path] NICEPAY API/API SNAP/Advance API - SNAP/API NICEPAY Inquiry Virtual Account SNAP/ # Tentang Payment - API NICEPAY Inquiry Virtual Account SNAP *** Bagian ini berisi tentang informasi terkait API dengan standar SNAP yang digunakan pada metode pembayaran Virtual Account dengan fitur NICEPAY Inquiry Virtual Account (NIVA) yang memberikan kebebasan untuk Merchant menyimpan data pelanggan dan membuat nomor Virtual Account sendiri di sistemnya selama masih mengikuti ketentuan pembuatan nomor VA dari NICEPAY. # Payment - API NICEPAY Inquiry Virtual Account SNAP *** :::hint{type="warning"} Silakan mengajukan akses token terlebih dahulu untuk melakukan autentikasi melalui bagian [Request Access Token - API NICEPAY Inquiry Virtual Account SNAP](docId\:tbDHyMKVQK7C20nUkjB0N). ::: | **Service Code** | `25` | | ---------------- | ------------------------------------------------ | | **API Endpoint** | `[merchant-domain]/api/v1.0/transfer-va/payment` | | **HTTP Method** | `HTTP` `POST` | | **Description** | Untuk melakukan pembayaran transaksi NIVA | | **Content-type** | `application/json` | :::hint{type="info"} Pada saat melakukan proses integrasi, NICEPAY akan mengirimkan Public Key kepada Merchant. Kemudian, Merchant wajib memberi informasi terkait *endpoint *API Inquiry VA dan mengirimkan Client ID & Client Secret sesuai dengan spesifikasi NICEPAY kepada tim NICEPAY. Hal tersebut perlu dilakukan agar NICEPAY dapat mengajukan akses token dan melakukan *inquiry* data Pelanggan yang berada di sisi Merchant. Sehingga, proses pembayaran dapat dijalankan dengan lancar oleh Pelanggan Anda. ::: ## Request Payment Header Parameter | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | **Contoh** | | --------------- | -------- | ---------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | | `Content-Type` | String | | Mandatory | `Application / JSON` | | | `Authorization` | String | | Mandatory | Bearer “`access_token`” | | | `X-TIMESTAMP` | String | | 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 | | Mandatory | Signature will be generated by Merchant.
[Panduan X-Signature - Symmetric](docId\:UZex33ReLyENKOgbJJnYp) | | | `X-PARTNER-ID` | String | 20 | Mandatory | `X-PARTNER-ID` = `CLIENT_ID` | | | `X-EXTERNAL-ID` | String | 40 | Mandatory | Unique Reference Number
(`41807553358950093184`) | | | `CHANNEL-ID` | String | | Mandatory | Unique Channel Merchant Credential ID Number.
Client ID + "01" = Channel ID
`"IONPAYTEST" + "01" = "IONPAYTEST01"` | IONPAYTEST01 | ## Request Payment Body Parameter | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | ----------------------- | -------- | ---------- | ------------- | ------------------------------------------------------ | | `partnerServiceId` | String | 20 | Mandatory | Partner Service ID / Prefix | | `customerNo` | String | 40 | Mandatory | Customer Number | | `virtualAccountNo` | String | 25 | Mandatory | Virtual Account Number | | `virtualAccountName` | String | 100 | Optional | Virtual Account Name | | `trxId` | String | 40 | Mandatory | Merchant Order Number | | `paymentRequestId` | String | 128 | Mandatory | TXID (Transaction ID Generated by ) | | `hashedSourceAccountNo` | String | 32 | Optional | Source account number in hash or unhash depend on Bank | | `sourceBankCode` | String | 11 | Optional | Source account Bank | | `paidAmount` | Object | | Mandatory | Total Amount
`"paidAmount": {...}` | | `value` | String | 12 | Mandatory | Value | | `currency` | String | 3 | Mandatory | Currency | | `trxDateTime` | String | 25 | Optional | Date Transaction | | `additionalInfo` | Object | | Mandatory | Additional Information
`"additionalInfo": {...}` | | `bankCd` | String | 4 | Mandatory | [Bank Code - API SNAP](docId:9WOQy5-1hlf_uCwshSDHO) | ## Response Payment Parameter | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | -------------------- | -------- | ---------- | ------------- | ---------------------------------------------------------------------------- | | `responseCode` | String | | Mandatory | [General Response Code and Message - API SNAP](docId\:lKqJXSl5CMKdXYXxHYYSs) | | `responseMessage` | String | | Mandatory | Response Message | | `virtualAccountData` | Object | | Mandatory | | | `partnerServiceId` | String | 20 | Mandatory | Partner Service ID / Prefix | | `customerNo` | String | 40 | Mandatory | Customer Number | | `virtualAccountNo` | String | 25 | Mandatory | Virtual Account Number | | `virtualAccountName` | String | 100 | Mandatory | Virtual Account Name | | `trxId` | String | 40 | Mandatory | Reference Number from Merchant | | `paymentRequestId` | String | 128 | Mandatory | TXID (Transaction ID Generated by ) | | `paidAmount` | Object | | Mandatory | Total Amount
`"paidAmount": {...}` | | `value` | String | 12 | Mandatory | Transaction Amount | | `currency` | String | 3 | Mandatory | Currency | | `trxDateTime` | String | 25 | Optional | Date Transaction | | `additionalInfo` | Object | | Optional | Additional Information
`"additionalInfo": {...}` | | `goodsNm` | String | 200 | Mandatory | Goods Name | ## Sample Parameter :::CodeblockTabs Sample Request ```json //HEADER SECTION Content-Type: application/json Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8= X-TIMESTAMP: 2024-12-31T10:11:40+07:00 X-SIGNATURE: ufBw7R8RhW79IOiV/Hlv607M60qzAYBv8uZmbSrYb6/Thlo/FhQVP4xRyelUehoSS9o+QS6vWTKb/ygtucC+tQ== X-PARTNER-ID: FIXOPEN001 X-EXTERNAL-ID: tXid202402111402271707638113 CHANNEL-ID: FIXOPEN001 { "partnerServiceId": "70151021", "customerNo": "10000001", "virtualAccountNo": "7015102110000001", "virtualAccountName": "John Test", "trxId": "ref100000001", "trxDateTime": "2024-02-01T15:40:06+07:00", "paymentRequestId": "FIXOPEN0010000000006", "hashedSourceAccountNo": "abcdefghij12345", "sourceBankCode": "008", "paidAmount": { "value": "10000.00", "currency": "IDR" }, "additionalInfo": { "bankCd": "BMRI", } } ``` Sample Response ```json { "responseCode": "2002500", "responseMessage": "Successful", "virtualAccountData": { "partnerServiceId": "70151021", "customerNo": "10000001", "virtualAccountNo": "7015102110000001", "virtualAccountName": "John Test", "paymentRequestId": "FIXOPEN0010000000006", "paidAmount": { "value": "100000.00", "currency": "IDR" }, "trxDateTime": "2024-02-01T15:40:06+07:00", "trxId": "ref100000001" }, "additionalInfo": { "goodsNm": "Test Item", } } ``` ::: [title] Registration - API E-Wallet (Direct Debit) SNAP [path] NICEPAY API/API SNAP/Payment API - SNAP/API E-Wallet (Direct Debit) SNAP/ # Tentang Registration - API E-Wallet (Direct Debit) SNAP *** API ini digunakan untuk mengajukan pendaftaran transaksi melakukan pembayaran menggunakan metode pembayaran E-Wallet dengan Fitur Direct Debit Host to Host yang sesuai standar SNAP. # Registration - API E-Wallet (Direct Debit) SNAP *** :::hint{type="warning"} Silakan mengajukan akses token terlebih dahulu untuk melakukan autentikasi melalui bagian [Request Access Token API - SNAP](docId\:GcGqBIYXG1Etcd0Ji9cHX). ::: | **Service Code** | `54` | | ---------------- | ----------------------------------------------------------------------------------------------------------------------- | | **API Endpoint** | [`/nicepay/api/v1.0/debit/payment-host-to-host`](https://dev.nicepay.co.id/nicepay/api/v1.0/debit/payment-host-to-host) | | **HTTP Method** | `POST` | | **Description** | Request Direct Debit transaction for authentication payment | | **Content-type** | `application/json` | ## Request Header Parameter for Registration - API E-Wallet (Direct Debit) SNAP *** | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | **Contoh** | | --------------- | -------- | ---------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | | `Content-Type` | String | 127 | Mandatory | Content type, value always `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 | Signature will be generated by Merchant.
[Panduan X-Signature - Symmetric](docId\:UZex33ReLyENKOgbJJnYp) | | | `X-PARTNER-ID` | String | 20 | Mandatory | Unique Partner ID, Partner ID = Client ID | | | `X-EXTERNAL-ID` | String | 40 | Mandatory | Unique messaging Reference ID generated by Merchant. Numeric String. Reference number that should be unique in every transaction. | | | `CHANNEL-ID` | String | 20 | Mandatory | Unique Channel Merchant Credential ID Number.
Client ID + "01" = Channel ID
`"IONPAYTEST" + "01" = "IONPAYTEST01"` | IONPAYTEST01 | ## Request Body Parameter for Registration - API E-Wallet (Direct Debit) SNAP *** | **Parameter** | **Tipe** | **Kebutuhan** | **Ukuran** | **Deskripsi atau Contoh** | | -------------------- | -------------------- | ------------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `partnerReferenceNo` | String | Mandatory | 40 | Transaction ID from Merchant | | `merchantId` | String | Mandatory | 10 | Merchant Identifier that is unique per each Merchant | | `subMerchantId` | String | Optional | 32 | Sub-Merchant Identifier | | `externalStoreId` | String | Optional | 32 | Unique Identifier of Shop ID in Client system | | `amount` | Array of JSON Object | Mandatory | Variable | Amount Information | | `value` | String | Mandatory | 12 | Transaction amount, including thecents | | `currency` | String | Mandatory | 3 | Currency code based on ISO | | `urlParams` | Array of JSON Object | Mandatory | Variable | Notify URL that Merchant must send the payment
notification.

`"urlParams":[ `
` {...}, {...} `
` ]` | | `url` | String | Mandatory | 512 | Indicates the URL of the Client’s app to redirect back to once payment has been completed in Merchant.

Merchant accepts HTTP links and URL scheme
formats. | | `type` | String | Mandatory | 32 | Indicates the type of the sent URL. Only accepts
‘`PAY_RETURN`” and ‘`PAY_NOTIFY`” value. | | `isDeeplink` | String | Mandatory | 1 | Indicates whether the URL is a deep link or not, only
accepts ‘Y’ value | | `validUpTo` | String | Optional | 25 | The time when the payment will be automatic only expired. ISO 8601, in `YYYY-MMDDTHH` format.
`mm:ss+07:00`. Time must be in GMT+7 (Jakarta time). | | `pointOfInitiation` | String | Optional | 20 | Used for getting more info regarding source of
request of the ser | | `additionalInfo` | Array of JSON Object | Optional | Variable | Additional information
`"additionalInfo":{...}` | | `mitraCd` | String | Mandatory | 4 | [Mitra Code - API SNAP](docId\:mebNfCDEq1GFUs9oE_MOF)
Example:
ShopeePay: `ESHP`
OVO: `OVOE`
LinkAja: `LINK`
DANA: `DANA`
AstraPay: `ASTR` | | `goodsNm` | String | Mandatory | 200 | Goods Name | | `billingNm` | String | Mandatory | 100 | Buyer Name | | `billingPhone` | String | Mandatory | 20 | Buyer Phone Number | | `billingEmail` | String | Optional | 40 | Buyer E-mail | | `callBackUrl` | String | Mandatory | 500 | Payment result forward URL (on browser) | | `dbProcessUrl` | String | Mandatory | 500 | Payment Notification URL (Async Notification) | | `cartData` | String | Mandatory | 4000 | `{Format_``JSON_String}`

`{`
` "count": "2",`
` "item": [`
` {...},`
` {...}`
` ]`
`}` | | `msId` | String | Optional | 20 | Merchant Seller ID | | `msFee` | String | Optional | 7 | Merchant Seller Fee | | `msFeeType` | String | Optional | 2 | Merchant Seller Fee Type | | `mbFee` | String | Optional | 7 | Merchant Balance Fee | | `mbFeeType` | String | Optional | 2 | Merchant Balance Fee Type | ## Response Parameter for Registration - API E-Wallet (Direct Debit) SNAP *** | **Parameter** | **Tipe** | **Kebutuhan** | **Ukuran** | **Deskripsi atau Contoh** | | ---------------------- | -------- | ------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------- | | `responseCode` | String | Mandatory | 7 | Refer to [General Response Code and Message - API SNAP](docId\:lKqJXSl5CMKdXYXxHYYSs) list | | `responseMessage` | String | Mandatory | 150 | Refer to [General Response Code and Message - API SNAP](docId\:lKqJXSl5CMKdXYXxHYYSs) list | | `partnerReferenceNo` | String | Mandatory | 40 | Merchant transaction identifier | | `referenceNo` | String | Mandatory | 40 | Original transaction identifier on service
provider system | | `appRedirectUrl`
| String | Optional | 2048 | Returns an URL scheme to payment page
in native app
**For ShopeePay, this value will be deprecated** | | `webRedirectUrl` | String | Optional | 2048 | Partner checkout URL | | `additionalInfo` | String | Optional | Variable | Additional information
`"additionalInfo": { ...}` | | `redirectToken` | String | Optional | 255 | Partner checkout token | ## Sample Parameter for Registration API E-Wallet (Direct Debit) SNAP *** ### Request Parameter :::CodeblockTabs cURL ```curl curl -X POST \ 'https://dev.nicepay.co.id/nicepay/api/v1.0/debit/payment-host-to-host' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8=' \ -H 'X-TIMESTAMP: 2024-12-31T10:11:40+07:00' \ -H 'X-SIGNATURE: ufBw7R8RhW79IOiV/Hlv607M60qzAYBv8uZmbSrYb6/Thlo/FhQVP4xRyelUehoSS9o+QS6vWTKb/ygtucC+tQ==' \ -H 'X-PARTNER-ID: TNICEEW051' \ -H 'X-EXTERNAL-ID: tXid202402111402271707638099' \ -H 'CHANNEL-ID: TNICEEW051' \ -d '{"partnerReferenceNo":"2020102900000000000001","merchantId":"TNICEEW05","subMerchantId":"310928924949487","amount":{"value":"12345678.00","currency":"IDR"},"urlParams":[{"url":"https://test1.bi.go.id/v1/test","type":"PAY_NOTIFY","isDeeplink":"Y"},{"url":"https://test2.bi.go.id/v1/test","type":"PAY_RETURN","isDeeplink":"Y"}],"externalStoreId":"239840198240795109","validUpTo":"2020-12-23T07:44:11+07:00","pointOfInitiation":"Mobile App","additionalInfo":{"mitraCd":"DANA","goodsNm":"Merchant Goods 1","billingNm":"Buyer Name","billingPhone":"02112345678","billingEmail":"jhondoe@gmail.com","callBackUrl":"http://www.merchant.com/callback","dbProcessUrl":"http://www.merchant.com/notification","cartData":"{\"count\":\"2\",\"item\":[{\"img_url\":\"http://img.aaa.com/ima1.jpg\",\"goods_name\":\"Item 1 Name\",\"goods_detail\":\"Item 1 Detail\",\"goods_amt\":\"0.00\",\"goods_quantity\":\"1\"},{\"img_url\":\"http://img.aaa.com/ima2.jpg\",\"goods_name\":\"Item 2 Name\",\"goods_detail\":\"Item 2 Detail\",\"goods_amt\":\"12345678.00\",\"goods_quantity\":\"1\"}]}","msId":"","msFee":"","msFeeType":"","mbFee":"","mbFeeType":""}}' ``` Node.js ```nodejs const PARTNER_ID = "TNICEEW051"; const X_EXTERNAL_ID = "tXid202402111402271707638099"; const X_TIMESTAMP = "2024-12-31T10:11:40+07:00"; const CHANNEL_ID = "TNICEEW051"; const config = { isProduction: false, privateKey: cons.privateKey, clientSecret: cons.clientSecret, clientId: PARTNER_ID, isCloudServer: false, }; const ACCESS_TOKEN = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8="; const parameter = { body: { partnerReferenceNo: "2020102900000000000001", merchantId: PARTNER_ID, subMerchantId: "310928924949487", amount: { value: "12345678.00", currency: "IDR" }, urlParams: [ { url: "https://test1.bi.go.id/v1/test", type: "PAY_NOTIFY", isDeeplink: "Y" }, { url: "https://test2.bi.go.id/v1/test", type: "PAY_RETURN", isDeeplink: "Y" } ], externalStoreId: "239840198240795109", validUpTo: "2020-12-23T07:44:11+07:00", pointOfInitiation: "Mobile App", additionalInfo: { mitraCd: "DANA", goodsNm: "Merchant Goods 1", billingNm: "Buyer Name", billingPhone: "02112345678", billingEmail: "jhondoe@gmail.com", callBackUrl: "http://www.merchant.com/callback", dbProcessUrl: "http://www.merchant.com/notification", cartData: "{\"count\":\"2\",\"item\":[{\"img_url\":\"http://img.aaa.com/ima1.jpg\",\"goods_name\":\"Item 1 Name\",\"goods_detail\":\"Item 1 Detail\",\"goods_amt\":\"0.00\",\"goods_quantity\":\"1\"},{\"img_url\":\"http://img.aaa.com/ima2.jpg\",\"goods_name\":\"Item 2 Name\",\"goods_detail\":\"Item 2 Detail\",\"goods_amt\":\"12345678.00\",\"goods_quantity\":\"1\"}]}", msId: "", msFee: "", msFeeType: "", mbFee: "", mbFeeType: "" } }, headers: { X_TIMESTAMP: X_TIMESTAMP, X_PARTNER_ID: PARTNER_ID, X_EXTERNAL_ID: X_EXTERNAL_ID, CHANNEL_ID: CHANNEL_ID, }, }; let snap = new Snap(config); let endPoint = `/api/v1.0/debit/payment-host-to-host`; // Updated Endpoint let response = snap .requestSnapTransaction(parameter, endPoint, ACCESS_TOKEN, "POST"); ``` ```java final String PARTNER_ID = "TNICEEW051"; // Adjusted from TNICEEW05 final String EXTERNAL_ID = "tXid202402111402271707638099"; final String TIMESTAMP = "2024-12-31T10:11:40+07:00"; final String ACCESS_TOKEN = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8="; // Step 1: Configuration (using hardcoded values) config = NICEPay.builder() .isProduction(false) .isCloudServer(false) .clientSecret("YOUR_CLIENT_SECRET") .partnerId(PARTNER_ID) .externalID(EXTERNAL_ID) .timestamp(TIMESTAMP) .privateKey("YOUR_PRIVATE_KEY") .build(); // Step 2: Define the Request Body (Ewallet model repurposed for Debit H2H) Ewallet ewallet = Ewallet.builder() .partnerReferenceNo("2020102900000000000001") .merchantId(PARTNER_ID) .subMerchantId("310928924949487") .externalStoreId("239840198240795109") .validUpTo("2020-12-23T07:44:11+07:00") .pointOfInitiation("Mobile App") .amount("12345678.00", "IDR") .additionalInfo( new HashMap() {{ put("mitraCd", "DANA"); put("goodsNm", "Merchant Goods 1"); put("billingNm", "Buyer Name"); put("billingPhone", "02112345678"); put("billingEmail", "jhondoe@gmail.com"); put("callBackUrl", "https://test1.bi.go.id/v1/test"); put("dbProcessUrl", "https://test1.bi.go.id/v1/test"); put("cartData", "{\"count\":\"2\",\"item\":[{\"img_url\":\"http://img.aaa.com/ima1.jpg\",\"goods_name\":\"Item 1 Name\",\"goods_detail\":\"Item 1 Detail\",\"goods_amt\":\"0.00\",\"goods_quantity\":\"1\"},{\"img_url\":\"http://img.aaa.com/ima2.jpg\",\"goods_name\":\"Item 2 Name\",\"goods_detail\":\"Item 2 Detail\",\"goods_amt\":\"12345678.00\",\"goods_quantity\":\"1\"}]}"); put("msId", ""); put("msFee", ""); put("msFeeType", ""); put("mbFee", ""); put("mbFeeType", ""); }}) .urlParams(new String[][]{ {"https://test1.bi.go.id/v1/test", "PAY_NOTIFY", "Y"}, {"https://test2.bi.go.id/v1/test", "PAY_RETURN", "Y"} }) .build(); // Step 3: Execute the Request (Removed dynamic token fetching) NICEPayResponse response = SnapEwalletService.callServiceEwalletPayment(ewallet, ACCESS_TOKEN, config); ``` ```python bodyCreateToken = ( builderAccessToken.BuildAccessToken() .setGrantType("client_credentials") .setAdditionalInfo({}) .build() ) amount = { "value": "12345678.00", "currency": "IDR" } urlParams = [ { "url": "https://test1.bi.go.id/v1/test", "type": "PAY_NOTIFY", "isDeeplink": "Y" }, { "url": "https://test2.bi.go.id/v1/test", "type": "PAY_RETURN", "isDeeplink": "Y" } ] additionalInfo = { "mitraCd": "DANA", "goodsNm": "Merchant Goods 1", "billingNm": "Buyer Name", "billingPhone": "02112345678", "billingEmail": "jhondoe@gmail.com", "callBackUrl": "http://www.merchant.com/callback", "dbProcessUrl": "http://www.merchant.com/notification", "cartData": '{"count":"2","item":[{"img_url":"http://img.aaa.com/ima1.jpg","goods_name":"Item 1 Name","goods_detail":"Item 1 Detail","goods_amt":"0.00","goods_quantity":"1"},{"img_url":"http://img.aaa.com/ima2.jpg","goods_name":"Item 2 Name","goods_detail":"Item 2 Detail","goods_amt":"12345678.00","goods_quantity":"1"}]}', "msId": "", "msFee": "", "msFeeType": "", "mbFee": "", "mbFeeType": "" } bodyDirectDebit = ( builderDirectDebit.BuildDirectDebit() .setPartnerReferenceNo("2020102900000000000001") .setMerchantId("TNICEEW051") .setSubMerchantId("310928924949487") .setExternalStoreId("239840198240795109") .setValidUpTo("2020-12-23T07:44:11+07:00") .setPointOfInitiation("Mobile App") .setAmount(amount) .setUrlParams(urlParams) .setAdditionalInfo(additionalInfo) .build() ) environment = (builderEnvironment.BuildEnvironment() .isCloud(False) .isProduction(False) .build()) result = SnapService.serviceTransaction(bodyCreateToken.jsonAccessToken(), bodyDirectDebit.jsonDirectDebit(), ConstantsEndpoints.directDebit(), environment) ``` C# ```csharp // --- C# Host-to-Host Debit Payment Snippet (TNICEEW051) --- // Hardcoded Access Token const string ACCESS_TOKEN = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8="; // Assuming privateKey, clientId, timestamp, isProduction, isCloudServer are defined/loaded elsewhere. // Define urlParams in a variable as requested var urlParams = new List> { new Dictionary { { "url", "https://test1.bi.go.id/v1/test" }, { "type", "PAY_NOTIFY" }, { "isDeeplink", "Y" } }, new Dictionary { { "url", "https://test2.bi.go.id/v1/test" }, { "type", "PAY_RETURN" }, { "isDeeplink", "Y" } } }; string signature = SignatureGeneratorUtils.GenerateSignature(privateKey, "TNICEEW051", "2024-12-31T10:11:40+07:00"); // Create Ewallet service (using updated parameters) ApiEndpoints apiEndpoints = new ApiEndpoints(); APIService ewalletService = new APIService(apiEndpoints, clientSecret, "TNICEEW051", "TNICEEW051", isProduction, isCloudServer); var bodyBuilder = new EwalletBuilder() .SetEwalletSnap( partnerReferenceNo: "2020102900000000000001", merchantId: "TNICEEW051", externalStoreId: "239840198240795109", value: "12345678.00", currency: "IDR", subMerchantId: "310928924949487", validUpTo: "2020-12-23T07:44:11+07:00", mitraCd: "DANA", goodsNm: "Merchant Goods 1", billingNm: "Buyer Name", billingPhone: "02112345678", urlParams: urlParams, // Used the variable here cartData: "{\"count\":\"2\",\"item\":[{\"img_url\":\"http://img.aaa.com/ima1.jpg\",\"goods_name\":\"Item 1 Name\",\"goods_detail\":\"Item 1 Detail\",\"goods_amt\":\"0.00\",\"goods_quantity\":\"1\"},{\"img_url\":\"http://img.aaa.com/ima2.jpg\",\"goods_name\":\"Item 2 Name\",\"goods_detail\":\"Item 2 Detail\",\"goods_amt\":\"12345678.00\",\"goods_quantity\":\"1\"}]}", dbProcessUrl: "http://www.merchant.com/notification", callBackUrl: "http://www.merchant.com/callback", msId: "", msFee: "", msFeeType: "", mbFee: "", mbFeeType: "", pointOfInitiation: "Mobile App" ).Build(); string jsonPayload = JsonConvert.SerializeObject(bodyBuilder); string createResponse = await ewalletService.SendPostRequest(apiEndpoints.PaymentEwallet, ACCESS_TOKEN, "2024-12-31T10:11:40+07:00", bodyBuilder, "tXid202402111402271707638099"); ``` Laravel ```php protected $useProd = false; protected $useCloud = false; protected $payment_host_to_host_endpoint = "/api/v1.0/debit/payment-host-to-host"; protected $client_id = "TNICEEW051"; PROTECTED $key = "_PRIVATE_KEY_MERCHANT"; PROTECTED $client_secret = "_CLIENT_SECRET_MERCHANT"; PROTECTED $access_token = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8="; PROTECTED $store_id = "239840198240795109"; $url = HttpUtil::getNicepayDomain($this->useProd, $this->useCloud) . $this->payment_host_to_host_endpoint; $helper = new Helpers(); $http_method = "POST"; $x_time_stamp = "2024-12-31T10:11:40+07:00"; $partner_id = "TNICEEW051"; $client_secret = $this->client_secret; $access_token = $this->access_token; $store_id = $this->store_id; $external_id = "tXid202402111402271707638099"; $channel_id = "TNICEEW051"; $body = [ "partnerReferenceNo" => "2020102900000000000001", "merchantId" => $partner_id, "subMerchantId" => "310928924949487", "amount" => [ "value" => "12345678.00", "currency" => "IDR" ], "urlParams" => [ [ "url" => "https://test1.bi.go.id/v1/test", "type" => "PAY_NOTIFY", "isDeeplink" => "Y" ], [ "url" => "https://test2.bi.go.id/v1/test", "type" => "PAY_RETURN", "isDeeplink" => "Y" ] ], "externalStoreId" => $store_id, "validUpTo" => "2020-12-23T07:44:11+07:00", "pointOfInitiation" => "Mobile App", "additionalInfo" => [ "mitraCd" => "DANA", "goodsNm" => "Merchant Goods 1", "billingNm" => "Buyer Name", "billingPhone" => "02112345678", "billingEmail" => "jhondoe@gmail.com", "callBackUrl" => "http://www.merchant.com/callback", "dbProcessUrl" => "http://www.merchant.com/notification", "cartData" => '{"count":"2","item":[{"img_url":"http://img.aaa.com/ima1.jpg","goods_name":"Item 1 Name","goods_detail":"Item 1 Detail","goods_amt":"0.00","goods_quantity":"1"},{"img_url":"http://img.aaa.com/ima2.jpg","goods_name":"Item 2 Name","goods_detail":"Item 2 Detail","goods_amt":"12345678.00","goods_quantity":"1"}]}', "msId" => "", "msFee" => "", "msFeeType" => "", "mbFee" => "", "mbFeeType" => "" ] ]; $string_to_sign = $helper->generateStringToSign( $http_method, $this->payment_host_to_host_endpoint, $access_token, $body, $x_time_stamp ); $signature = $helper->hmacSHA512Encoded( $string_to_sign, $client_secret, OPENSSL_ALGO_SHA512 ); $header = $helper->generateHeader( $access_token, $x_time_stamp, $signature, $partner_id, $external_id, $channel_id ); try { $response = HttpUtil::postJsonRequestWithHeader($url, $body, $header); } catch (Exception $e) { // Handle exception } ``` PHP Native ```php $this->configSnap = NICEPay::builder() ->setIsProduction(false) ->setClientSecret("_YOUR_CLIENT_SECRET_") ->setPartnerId("TNICEEW051") ->setExternalID("tXid202402111402271707638099") ->setTimestamp("2024-12-31T10:11:40+07:00") ->setPrivateKey("_YOUR_PRIVATE_KEY_") ->build(); $requestBody = Ewallet::builder() ->partnerReferenceNo("2020102900000000000001") ->merchantId("TNICEEW051") ->subMerchantId("310928924949487") ->externalStoreId("239840198240795109") ->validUpTo("2020-12-23T07:44:11+07:00") ->pointOfInitiation("Mobile App") ->amount("12345678.00", "IDR") ->additionalInfo( [ "mitraCd" => "DANA", "goodsNm" => "Merchant Goods 1", "billingNm" => "Buyer Name", "billingPhone" => "02112345678", "billingEmail" => "jhondoe@gmail.com", "callBackUrl" => "http://www.merchant.com/callback", "dbProcessUrl" => "http://www.merchant.com/notification", "cartData" => '{"count":"2","item":[{"img_url":"http://img.aaa.com/ima1.jpg","goods_name":"Item 1 Name","goods_detail":"Item 1 Detail","goods_amt":"0.00","goods_quantity":"1"},{"img_url":"http://img.aaa.com/ima2.jpg","goods_name":"Item 2 Name","goods_detail":"Item 2 Detail","goods_amt":"12345678.00","goods_quantity":"1"}]}', "msId" => "", "msFee" => "", "msFeeType" => "", "mbFee" => "", "mbFeeType" => "" ] ) ->urlParams([ ["https://test1.bi.go.id/v1/test", "PAY_NOTIFY", "Y"], ["https://test2.bi.go.id/v1/test", "PAY_RETURN", "Y"] ]) ->build(); $accessToken = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8="; $ewalletService = new SnapEwalletService($this->configSnap); try { $response = $ewalletService->paymentEwallet($requestBody, $accessToken); } catch (\Exception $e) { // Handle exception } ``` ```kotlin // Hardcoded Access Token const val ACCESS_TOKEN = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8=" // Step 1: Initialize the NICEPay Configuration var config: NICEPay = NICEPay.Builder() .isProduction(false) .clientSecret("YOUR_CLIENT_SECRET") .partnerId("TNICEEW05") .externalID("tXid202402111402271707638099") .timestamp("2024-12-31T10:11:40+07:00") .privateKey("YOUR_PRIVATE_KEY") .build() // Step 2: Define the Static Request Body val ewallet = SnapEwallet.Builder() .partnerReferenceNo("2020102900000000000001") .merchantId("TNICEEW05") .subMerchantId("310928924949487") .externalStoreId("239840198240795109") .validUpTo("2020-12-23T07:44:11+07:00") .pointOfInitiation("Mobile App") .amount("12345678.00", "IDR") .additionalInfo( mapOf( "mitraCd" to "DANA", "goodsNm" to "Merchant Goods 1", "billingNm" to "Buyer Name", "billingPhone" to "02112345678", "billingEmail" to "jhondoe@gmail.com", "callBackUrl" to "http://www.merchant.com/callback", "dbProcessUrl" to "http://www.merchant.com/notification", "cartData" to "{\"count\":\"2\",\"item\":[{\"img_url\":\"http://img.aaa.com/ima1.jpg\",\"goods_name\":\"Item 1 Name\",\"goods_detail\":\"Item 1 Detail\",\"goods_amt\":\"0.00\",\"goods_quantity\":\"1\"},{\"img_url\":\"http://img.aaa.com/ima2.jpg\",\"goods_name\":\"Item 2 Name\",\"goods_detail\":\"Item 2 Detail\",\"goods_amt\":\"12345678.00\",\"goods_quantity\":\"1\"}]}", "msId" to "", "msFee" to "", "msFeeType" to "", "mbFee" to "", "mbFeeType" to "" ) ) .urlParams( arrayOf( arrayOf("https://test1.bi.go.id/v1/test", "PAY_NOTIFY", "Y"), arrayOf("https://test2.bi.go.id/v1/test", "PAY_RETURN", "Y") ) ) .build() // Step 3: Execute the Request val response = snapEwalletService.paymentHostToHost(ewallet, ACCESS_TOKEN, config) ``` CodeIgniter ```php const string ACCESS_TOKEN = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8="; $config = NICEPay::builder() ->setIsProduction(false) ->setIsCloudServer(isCloudServer: true) ->setPrivateKey("_YOUR_PRIVATE_KEY_") ->setClientSecret("_YOUR_CLIENT_SECRET_") ->setPartnerId("TNICEEW051") ->setExternalID("tXid202402111402271707638099") ->setTimestamp("2024-12-31T10:11:40+07:00") ->build(); $urlParams = [ ["https://test1.bi.go.id/v1/test", "PAY_NOTIFY", "Y"], ["https://test2.bi.go.id/v1/test", "PAY_RETURN", "Y"] ]; $requestBody = Ewallet::builder() ->setPartnerReferenceNo("2020102900000000000001") ->setMerchantId("TNICEEW051") ->setSubMerchantId("310928924949487") ->setExternalStoreId("239840198240795109") ->setValidUpTo("2020-12-23T07:44:11+07:00") ->setPointOfInitiation("Mobile App") ->setAmount("12345678.00", "IDR") ->setAdditionalInfo( [ "mitraCd" => "DANA", "goodsNm" => "Merchant Goods 1", "billingNm" => "Buyer Name", "billingPhone" => "02112345678", "billingEmail" => "jhondoe@gmail.com", "callBackUrl" => "http://www.merchant.com/callback", "dbProcessUrl" => "http://www.merchant.com/notification", "cartData" => '{"count":"2","item":[{"img_url":"http://img.aaa.com/ima1.jpg","goods_name":"Item 1 Name","goods_detail":"Item 1 Detail","goods_amt":"0.00","goods_quantity":"1"},{"img_url":"http://img.aaa.com/ima2.jpg","goods_name":"Item 2 Name","goods_detail":"Item 2 Detail","goods_amt":"12345678.00","goods_quantity":"1"}]}', "msId" => "", "msFee" => "", "msFeeType" => "", "mbFee" => "", "mbFeeType" => "" ] ) ->setUrlParams($urlParams) ->build(); $snapEwalletService = new SnapEwalletService(); try { $response = $snapEwalletService->paymentEwallet($requestBody, ACCESS_TOKEN, $config); } catch (\Exception $e) { // Handle exception } ``` ::: ### Response Parameter :::CodeblockTabs Sample Response ```json { "responseCode": "2005400", "responseMessage": "Successful", "partnerReferenceNo": "2020102900000000000001", "referenceNo": "TNICEEW05105202210141451109841", "webRedirectUrl": "https://pjsp.com/universal?bizNo=REF993883&...", "additionalInfo": { "redirectToken": " df548fff93e82aad9174c657820a85aa5d10042535157c7e89f52499" } } ``` ::: [title] Direct Debit - API Checkout [path] NICEPAY API/API Checkout/Payment - API Checkout/ # Tentang Direct Debit - API Checkout *** ini digunakan oleh untuk melakukan pengajuan kepada untuk menggunakan . # Alur Proses *** ![Alur Pembayaran Direct Debit (Click Pay)](https://app.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/8KMCainQ7lgYtOEZKbwlh_nicepay-archbee-payment-clickpay-new-clickpay-redirect.png "Alur Pembayaran Direct Debit (Click Pay)") Deskripsi langkah: 1. mengajukan *checkout *kepada . 2. akan melakukan pendaftaran menggunakan Registration kepada . 3. menyimpan regist*.* 4. mengarahkan menuju . 5. menampilkan kepada . 6. memilih . 7. memasukkan data (Jenius: Cashtag). 8. mengirimkan dipilih kepada . 9. mengajukan kepada . 10. melakukan *authentication.* 11. mengirimkan *authentication *kepada . 12. melakukan *authentication.* 13. mengajukan *charge *kepada . 14. melakukan . 15. mengirimkan hasil kepada . 16. mengirimkan *push notification *kepada . 17. melakukan validasi . 18. melakukan perubahan . 19. mengirimkan kepada . 20. mengajukan pemeriksaan menggunakan Status kepada . 21. mengirimkan *response * kepada . 22. menerima akhir. 23. mengirim konfirmasi perubahan kepada . # NICEPAY Secure Payment Page *** ![Secure Payment Page](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/ohh_r6otn4iPQSs_4RfL1_image-id-nicepay-secure-payment-page-main-dashboard.jpg "Secure Payment Page") Gambar di atas adalah contoh dengan metode menggunakan Secure Page. ![Direct Debit - Secure Payment Page](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/Hi9iC4Ydspm3SLN-Dkw7o_image-id-direct-debit-secure-payment-page.jpg "Direct Debit - Secure Payment Page") Setelah memilih metode dengan , akan dialihkan ke untuk memilih diinginkan. Selanjutnya, akan dialihkan ke *form* untuk memasukan identitas . Pada contoh di atas, bila memilih Jenius, akan diminta untuk memasukan data *Cashtag* pada *form* telah disediakan. Setelah melengkapi *form*, dapat melanjutkan . Kemudian, dapat melanjutkan sampai *order payment* sukses. ![Success - Secure Payment Page](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/ImvxatwsGqNZFY_UtbvpU_image-id-direct-debit-success-secure-payment-page.jpg "Success - Secure Payment Page") Proses *request* registrasi telah selesai. dapat melanjutkan sampai dengan penyelesaian dengan mengikuti panduan [Panduan Bayar Direct Debit](docId\:eJ49bFx8eJVfBsoGQORTO). # API Checkout Transaction Payment *** | **API URL** | `/nicepay/redirect/v2/payment` | | ------------------- | ------------------------------------------- | | **Request Method** | `Redirect-GET` | | **Header** | `Content-Type: application/Form-UrlEncoded` | ## Request Parameter for Direct Debit - API Checkout (CallbackUrl) *** | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | --------------------------------------------------------- | -------- | ---------- | --------------------- | ----------------------------------------------------------- | | `paymentURL`
Required | ANS | 14 | URL
| https\://dev.nicepay.co.id/nicepay/redirect/v2/payment | | `tXid`
Required | AN | 30 | Transaction ID
| TNICECP04100202305250918306465 | ## Response Parameter for Direct Debit - API Checkout (CallbackUrl) *** | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | --------------------------------------------------------------------------------------------------------------------------------------- | -------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------- | | `status` | N | 1 | [Transaction Status](docId:8m3-7Smhm_jhdrE5pCRzp) | 0 | | `merchantToken` | AN | 255 | Token | 46ca2f8a7b0b24ad57e49f879764718e40839f67d00c22b3f79ba328f2a0a8aa

When Success | | `goodsNm`
Direct Debit, E-Wallet, Payloan | AN | 100 | Goods Name | Jhon+Doe

When Success | | `billingNm`
Direct Debit, E-Wallet, Payloan | A | 100 | Billing Name | Jhon+Doe

When Success | | `referenceNo` | ANS | 40 | Order Number | ORD20230525090536

When Success | | `mitraCd`
Direct Debit, E-Wallet, Payloan | A | 4 | [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8) | JENC

When Success | | `tXid` | AN | 30 | Transaction ID | TNICECP04100202305250918306465

When Success | | `amt` | N | 12 | Transaction Amount | 5000

When Success | | `receiptCode` | ANS | 20 | Authorization Number | 951527524097

When Success | | `instmntType` | N | 2 | [Installment Type Code](docId:7CIX-U_4z295XgtNVEsbO) | 2

When Success | | `instmntMon` | N | 2 | Installment Month
`1`: 1 Month/Full , jika `instmntType`*:* *null/1*
`3`: 3 Months
`6`: 6 Months
`12`: 12 Months | 1

When Success | | `matchCl` | N | 1 | [Notification Match Amount Indicator](docId\:WdoGjBeqc1VmRdFJqG1ZE) | 0

When Success | | `mRefNo` | AN | 18 | Reference Number | 202305250918303

When Success | | `payMethod` | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | 04

When Success | | `currency` | A | 3 | Currency | IDR

When Success | :::hint{type="info"} Catatan: Response akan dikirimkan melalui `callBackurl` dengan Content-type: `application/json` dan metode: `POST Parameter`. ::: ## Sample Parameter for Direct Debit - API Checkout (CallbackUrl) *** :::hint{type="success"} Pada saat *Checkout*, *response *dari *request * di-*hit *adalah Callback URL. ::: ### Request Parameter :::CodeblockTabs cURL ```curl curl -X GET "https://www.merchant.com/callbackUrl?resultCd=0000&resultMsg=Please+do+payment+on+jenius+pay+apps&tXid=TNICECP04100202305250918306465&referenceNo=ORD20230525090536&amt=&transDt=20230525&transTm=091830" ``` ::: ### Callback Parameter :::CodeblockTabs Response Callback ```curl merchantToken=46ca2f8a7b0b24ad57e49f879764718e40839f67d00c22b3f79ba328f2a0a8aa goodsNm=Jhon+Doe referenceNo=ORD20230525090536 mitraCd=JENC tXid=TNICECP04100202305250918306465 amt=5000 receiptCode=951527524097 instmntType=2 billingNm=Jhon+Doe matchCl=0 mRefNo=202305250918303 payMethod=04 currency=IDR instmntMon=1 status=0 ``` ::: ## Callback Handling API Checkout Payment *** :::hint{type="success"} Saat *Callback *diterima `callbackUrl` , kami merekomendasikan untuk melakukan verifikasi Status dengan menggunakan [Status Inquiry - API Checkout](docId\:K9vBS87ev9_w5oJAU0et3) ::: :::hint{type="warning"} `Callback Handling` sangat penting untuk membantu meminimalisir tindakan *Fraud*. Kami sangat merekomendasikan untuk melakukan verifikasi menggunakan `Callback parameter`. ::: ::Image[]{src="https://app.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/fzdlOKawzyYatnepwv43z_nicepay-api-checkout-api-callback-handling-flow-1.png" size="50" width="370" height="361" position="center" caption="Alur Callback Handling" alt="Alur Callback Handling" darkWidth="370" darkHeight="361" showCaption="true"} :::CodeblockTabs URL Callback ```json https://www.merchant.com/callbackUrl?resultCd=0000&resultMsg=Please+do+payment+on+jenius+pay+apps&tXid=TNICECP04100202305250918306465&referenceNo=ORD20230525090536&amt=&transDt=20230525&transTm=091830 ``` Response Callback ```json merchantToken=46ca2f8a7b0b24ad57e49f879764718e40839f67d00c22b3f79ba328f2a0a8aa goodsNm=Jhon+Doe referenceNo=ORD20230525090536 mitraCd=JENC tXid=TNICECP04100202305250918306465 amt=5000 receiptCode=951527524097 instmntType=2 billingNm=Jhon+Doe matchCl=0 mRefNo=202305250918303 payMethod=04 currency=IDR instmntMon=1 status=0 ``` ::: [title] Credit Card - API Checkout [path] NICEPAY API/API Checkout/Payment - API Checkout/ # Tentang Credit Card - API Checkout *** Terdapat beberapa hal wajib ketahui dalam menggunakan untuk metode agar lancar bersama kami: 1. Proses Flow 3Ds/Non-3Ds. 2. Fitur Full . 3. Fitur Installment. # Alur Proses *** :::hint{type="info"} kunjungi [Fitur Kartu Kredit](docId\:cgLxG10p9zmVtuX_-b7ga) untuk memeriksa penjelasan mengenai 3Ds. ::: ## 3Ds ![Alur Pembayaran CC - Redirect 3Ds](https://app.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/-B7a6C3IMu5oNYpnz84pR_nicepay-archbee-payment-cc-new-cc-redirect-3ds.png "Alur Pembayaran CC - Redirect 3Ds") Deskripsi langkah alur *Redirect* dengan 3Ds: 1. melakukan *checkout*. 2. mengirim data kepada . 3. mengajukan menggunakan Registration kepada . 4. mendaftarkan data . 5. mengalihkan pada milik kepada . 6. mengirimkan kepada . 7. memilih . 8. memasukkan data kartu. 9. mengirimkan data kartu kepada . 10. mem kalkulasi FDS. 11. mengajukan 3Ds kepada . 12. melakukan validasi 3Ds. 13. mengirimkan *response *URL 3Ds kepada . 14. menerima *response *verifikasi. 15. mengalihkan kepada autentikasi ACS. 16. membuat *response *OTP. 17. mengirimkan OTP kepada . 18. menerima OTP. 19. memasukkan OTP. 20. mengirimkan OTP kepada . 21. melakukan verifikasi OTP. 22. mengirimkan hasil 3Ds kepada . 23. menerima hasil pemeriksaan. 24. mengajukan kepada . 25. melakukan . 26. mengirimkan kepada . 27. melakukan *redirect* `callbackUrl` kepada . 28. menampilkan hasil `callbackUrl` kepada . 29. mengirim kepada . 30. menerima . 31. melakukan pengajuan inquiry ke . 32. menerima pengajuan. 33. secara otomatis mengirimkan *response * inquiry kepada . 34. menerima terakhir. 35. mengirim hasil kepada . ## Non-3Ds ![Alur Pembayaran CC - Redirect Non-3Ds](https://app.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/eAcndroEzJ_AXG8-rTp7B_nicepay-archbee-payment-cc-redirect-non3ds.png "Alur Pembayaran CC - Redirect Non-3Ds") Deskripsi langkah alur *Redirect* dengan Non-3Ds: 1. melakukan *checkout*. 2. mengajukan *checkout *kepada . 3. mendaftarkan data *checkout*. 4. mengirimkan *response *berupa formulir data kartu. 5. mengajukan *checkout *kepada . 6. mendaftarkan pesanan dengan menggunakan Registration kepada . 7. menyimpan *order registration.* 8. mengalihkan kepada . 9. mengirim kepada . 10. memilih . 11. memasukkan rincian kartu. 12. mengajukan menggunakan kepada . 13. melakukan kalkulasi FDS. 14. mengajukan kepada . 15. melakukan verifikasi pengajuan. 16. mengirimkan pengajuan konfirmasi kepada . 17. mengajukan /*charge *kepada . 18. melakukan . 19. mengirim *response * kepada . 20. mengirim menggunakan `callBackUrl` dan `dbProcessUrl` kepada . 21. menerima . 22. mengajukan pemeriksaan kepada . 23. mengirimkan *response *pemeriksaan . 24. menerima terakhir. 25. mengirimkan hasil pesanan kepada . # NICEPAY Secure Payment Page *** :::hint{type="info"} membuka [Panduan Bayar Kartu Kredit](docId\:pf0yYjEhAE07p65seIrFt) untuk dapat memberikan panduan kepada dalam metode . ::: ![Secure Payment Page](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/ohh_r6otn4iPQSs_4RfL1_image-id-nicepay-secure-payment-page-main-dashboard.jpg "Secure Payment Page") Gambar di atas adalah contoh dengan metode menggunakan Secure Page. Setelah memilih metode dengan , akan diminta untuk memasukan data kartunya. Sistem akan secara otomatis mengenali jenis kartu BIN seperti gambar di bawah ini, misalnya VISA atau Mastercard, American Express, dan lain-lain nantinya kartunya pun akan berbeda sesuai dengan tipe jenis kartu digunakan. Setelah selesai memasukkan data kartu, dapat melanjutkan . ![Credit Card - Secure Payment Page](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/FGFHVNQ_Aarn4LvZs4gBF_image-id-kartu-kredit-secure-payment-page.jpg) Kemudian, akan berjalan. Apabila berhasil maka tampilan akan muncul seperti gambar berikut. ![Success - Secure Payment Page](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/ojhnI_sZwKQea4vXtTgBj_image-id-kartu-kredit-success-secure-payment-page.jpg "Success - Secure Payment Page") :::hint{type="info"} kunjungi [Payment - API Checkout](docId\:YnNFZr9aonpJ7ZIKAFYSx) untuk mengetahui langkah selanjutnya perihal `payment handling`. ::: # API Checkout Transaction Payment *** | **API URL** | `/nicepay/redirect/v2/payment` | | ------------------- | ------------------------------------------- | | **Request Method** | `Redirect-GET` | | **Header** | `Content-Type: application/Form-UrlEncoded` | :::hint{type="info"} *Endpoint* di atas dapat digunakan untuk dengan tipe Full . ::: # Full Payment Credit Card - API Checkout (CallbackUrl) *** Pada Full , membayar secara penuh nominal ditagihkan dalam sekali bayar. Berikut adalah rincian digunakan pada . ## Request Parameter for Full Payment Credit Card - API Checkout (CallbackUrl) *** | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | --------------------------------------------------------- | -------- | ---------- | --------------------- | ----------------------------------------------------------- | | `paymentURL`
Required | ANS | 14 | URL
| https\://dev.nicepay.co.id/nicepay/redirect/v2/payment | | `tXid`
Required | AN | 30 | Transaction ID
| IONPAYTEST00202203211640309389 | :::hint{type="info"} Untuk , dengan Full dan Installment mendapatkan *response* sama. ::: ## Response Parameter for Full Payment Credit Card - API Checkout (CallbackUrl) *** | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ---------------- | -------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------- | | `status` | N | 1 | [Transaction Status](docId:8m3-7Smhm_jhdrE5pCRzp) | 0 | | `tXid` | AN | 30 | Transaction ID | IONPAYTEST00202212201540174369

When Success | | `referenceNo` | AN | 40 | Order Number | ordNo20221220151243

When Success | | `payMethod` | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | 01

When Success | | `amt` | N | 12 | Transaction Amount | 1000

When Success | | `notaxAmt` | N | 12 | Tax Fee Amount | 0

When Success | | `vat` | N | 12 | Value Added Tax () | 0

When Success | | `fee` | N | 12 | Service Fee | 0

When Success | | `currency` | A | 3 | Currency | IDR

When Success | | `goodsNm` | AN | 100 | Goods Name | Goods+For+Testing+Credit+Card

When Success | | `billingNm` | A | 100 | Billing Name | John+Doe

When Success | | `transDt` | N | 8 | Transaction Date (`YYYYMMDD`) | 20221220

When Success | | `transTm` | N | 6 | Transaction Time (`HH24MISS`) | 154017

When Success | | `authNo` | N | 10 | Approval Number | 174300

When Success (Additional) | | `issuBankCd` | A | 4 | [Issuing Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | BMRI

When Success | | `acquBankCd` | A | 4 | [Acquiring Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | BMRI

When Success | | `issuBankNm` | A | 255 | Issuing Name | Mandiri

When Success | | `acquBankNm` | A | 255 | Acquiring Name | Mandiri

When Success | | `ccTransType` | AN
| 2 | Credit Card Transaction Type:
`1`: Normal
`2`: Recurring
`3`: Pre-Auth
`4`: Capture | 1

When Success | | `cardNo` | ANS | 20 | Card Number With Masking | 46161111\*\*\*\*1111

When Success | | `cardExpYymm` | N | 4 | Card Expiration (`YYMM`) | 2707

When Success | | `instmntType` | N | 2 | [Installment Type Code](docId:7CIX-U_4z295XgtNVEsbO) | 1

When Success | | `instmntMon` | N | 2 | Installment Month
`1`: 1 Month/Full , jika `instmntType`*:* *null/1*
`3`: 3 Months
`6`: 6 Months
`12`: 12 Months | 1

When Success | | `recurringToken` | AN | 255 | Recurring Token | null

When Success | | `preauthToken` | AN | 255 | Pre-Auth Token | null

When Success | | `matchCl` | N | 1 | [Notification Match Amount Indicator](docId\:WdoGjBeqc1VmRdFJqG1ZE) | 1

When Success | | `merchantToken` | AN | 255 | Token | 8f5b330a549c167b53b4b9fd5f2d2eba897a64235c1610524074ec59f8884e8a

When Success | ## Sample Parameter for Full Payment Credit Card - API Checkout (CallbackUrl) *** ### Request Parameter :::CodeblockTabs cURL ```curl curl -X GET "https://www.merchant.com/callbackUrl?ccTransType=1&fee=0&tXid=IONPAYTEST00202212201540174369&amt=1000¬axAmt=0&cardNo=46161111****1111&issuBankCd=BMRI&matchCl=1&preauthToken=null&cardExpYymm=2603&acquBankNm=Mandiri&payMethod=01¤cy=IDR&instmntMon=1&cc_trans_type=1&issuBankNm=Mandiri&merchantToken=dc1dd9e57ff6c4db341654ae31e623cab4d4d8057b2d0b58bef43ccb0da3b494&goodsNm=Goods+For+Testing+Credit+Card&referenceNo=ordNo20221220151243&authNo=174300&transTm=154017&cpGuaranteeableStatus=null&recurringToken=null&vat=0&instmntType=1&billingNm=John+Doe&acquBankCd=BMRI&transDt=20221220&status=0" ``` ::: ### Callback Parameter :::CodeblockTabs Response Callback ```curl status=0 tXid=IONPAYTEST00202212201540174369 referenceNo=ordNo20221220151243 payMethod=01 amt=1000 notaxAmt=0 vat=0 fee=0 currency=IDR goodsNm=Goods+For+Testing+Credit+Card billingNm=John+Doe transDt=20221220 transTm=154017 authNo=174300 issuBankCd=BMRI acquBankCd=BMRI issuBankNm=Mandiri acquBankNm=Mandiri ccTransType=1 cardNo=46161111****1111 cardExpYymm=2707 instmntType=1 instmntMon=1 recurringToken=null preauthToken=null matchCl=1 merchantToken=8f5b330a549c167b53b4b9fd5f2d2eba897a64235c1610524074ec59f8884e8a ``` ::: :::hint{type="info"} Catatan: Response akan dikirimkan melalui `callBackurl` dengan Content-type: `application/json` dan metode: `POST Parameter`. ::: :::hint{type="success"} Untuk pada , *response* dari *request * didapat setelah melakukan Call Request adalah Callback URL. ::: ## Callback Handling API Checkout Transaction Payment *** :::hint{type="info"} `tXid` tidak akan sama dengan *request hold. *Proses Capture akan memastikan bahwa nilai `amount` di-*capture* tidak melebihi dana dimiliki. ::: :::hint{type="success"} Saat *Callback *diterima `callbackUrl` , kami merekomendasikan untuk melakukan verifikasi Status dengan menggunakan [Status Inquiry - API Checkout](docId\:K9vBS87ev9_w5oJAU0et3). ::: :::hint{type="warning"} `Callback Handling` sangat penting untuk membantu meminimalisir tindakan *Fraud*. Kami sangat merekomendasikan untuk melakukan verifikasi menggunakan `Callback parameter`. ::: ::Image[]{src="https://app.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/ccwlMZjgo0gOioQqjK2oO_nicepay-api-checkout-api-callback-handling-flow-1.png" size="60" width="370" height="361" position="center" caption="Alur Callback Handling" alt="Alur Callback Handling" darkWidth="370" darkHeight="361" showCaption="true"} :::CodeblockTabs URL Callback ```json "callbackUrl" : "https://www.merchant.com/callbackUrl/" ``` Response Callback ```json { "resultCd":"0000", "resultMsg":"SUCCESS", "tXid":"IONPAYTEST01202212141112221428", "referenceNo":"", "payMethod":"01", "amt":"10000", "transDt":"20221212", "transTm":"121212", "description":"Testing Credit Card Transaction", "authNo":"080623", "issuBankCd":"OTHR" "acquBankCd":"BMRI", "cardNo":"453211*****1111", "goodsNm":"Test Transaction Nicepay" "billingNm":"John Doe", "currency":"IDR", "timeStamp":"20221212121212", "merchantToken":"2035d2295d9578fffb40137186f0203474142ae3e57992d4847826c5fcaffce6", "cardExpYymm":"2712", "instmntMon":"1", "instmntType":"1", "ccTransType":"1" } ``` ::: [title] Refund Transaction - API QRIS SNAP [path] NICEPAY API/API SNAP/Payment API - SNAP/API QRIS SNAP/ # Tentang Refund Transaction - API QRIS SNAP *** API dengan standar SNAP ini digunakan untuk melakukan proses pengembalian dana transaksi pada metode pembayaran QRIS. ## Aturan dan Kondisi Pengembalian Dana Transaksi *** Bagian ini akan menjelaskan terkait aturan dan kondisi pengembalian dana yang berlaku pada saat pembatalan transaksi. | **Kondisi Pengembalian Dana ShopeePay** | **Ketentuan Pengembalian Dana** | | -------------------------------------------------------- | ------------------------------------------------- | | Pembatalan sebelum di bayar. | Status berubah menjadi Kedaluwarsa (status `5`). | | Pengembalian dana secara daring untuk umum. | Hanya berlaku jika *belum mencapai 365 hari*. | | Pengembalian dana diajukan pada pukul 00:00 - 05:00 WIB. | Otomatis **Rejected**. | | Transaksi *Off-Us* ≤ 7 hari. | **Online Refund** tersedia. | | Transaksi *Off-Us* 8-365 hari. | Dialihkan ke **Manual Refund**. | | Transaksi *Off-Us* > 365 hari. | Pengembalian dana tidak lagi tersedia. | :::hint{type="info"} kunjungi [Integrasi & Testing QRIS](docId\:tCFbU7--Xd0Sm5_rQ00_w) untuk lebih lengkap terkait aturan dan kondisi pengembalian dana . ::: # Refund Transaction - API QRIS SNAP *** :::hint{type="warning"} Silakan mengajukan akses token terlebih dahulu sebelum menggunakan Refund Transaction API melalui bagian [Request Access Token API - SNAP](docId\:GcGqBIYXG1Etcd0Ji9cHX). ::: | **Service Code** | `78` | | ---------------- | ------------------------------------ | | **API Endpoint** | `/nicepay/api/v1.0/qr/qr-mpm-refund` | | **HTTP Method** | **POST** | | **Description** | Refund Transaction QRIS API | | **Content-type** | `application/json` | ## Request Header Parameter for Refund Transaction - API QRIS SNAP *** | **Nama Parameter Header** | **Tipe** | **Kebutuhan** | **Deskripsi** | **Contoh** | | ------------------------- | ----------------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | | `Content-Type` | String (127) | Mandatory | Type of the content | `Application/Json` | | `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`. | | | `Authorization` | String (Variable) | Mandatory | "Bearer" + \{`access_token`} | | | `X-SIGNATURE` | String (Variable) | Mandatory | Signature will be generated by Merchant.
[Panduan X-Signature - Symmetric](docId\:UZex33ReLyENKOgbJJnYp) | | | `X-PARTNER-ID` | String
(20) | Mandatory | NICEPAY Client ID (`MID`) | IONPAYTEST | | `X-EXTERNAL-ID` | String
(40) | Mandatory | Unique messaging Reference ID generated by Merchant. Numeric String. Reference number that should be unique in every transaction in One Day. | | | `CHANNEL-ID` | String
(20) | Mandatory | Unique Channel Merchant Credential ID Number.
Client ID + "01" = Channel ID
`"IONPAYTEST" + "01" = "IONPAYTEST01"` | IONPAYTETS01 | ## Request Body Parameter for Refund Transaction - API QRIS SNAP *** | **Nama Parameter BI** | **Tipe Parameter** | **Kebutuhan** | **Parameter NICEPAY** | **Deskripsi** | **Contoh** | | ---------------------------- | ------------------ | ------------- | ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------ | | `originalReferenceNo` | String (40) | Mandatory | `tXId` | NICEPAY Transaction ID or Identifier | IONPAYTEST08202106091121206416 | | `originalPartnerReferenceNo` | String (40) | Mandatory | `referenceNo` | Unique Transaction ID from Merchant | ncpy20221017161458 | | `partnerRefundNo` | String (40) | Mandatory | `merReferenceRefundNo` | Merchant Refund Reference Number | ncpy20221017161458 | | `merchantId` | String (10) | Mandatory | `iMid` | NICEPAY Merchant ID | IONPAYTEST | | `externalStoreId` | String (32) | Mandatory | `storeCd` | Merchant ID from Acquirer Pay Side | NICEPAY | | `refundAmount` | Object | Mandatory | | `"refundAmount": { `
` "value": ..., `
` "currency": ... `
` },` | | | - `value` | String (12) | Mandatory | `amt` | Transaction Amount

Note: Amount Format, currently only supported IDR (Indonesian Currency Rupiah) then value includes 2 decimal digits which are seperated by a dot (.) | 10000.00 | | `currency` | String (3) | Mandatory | `currency` | Default Value: IDR | IDR | | `reason` | String (256) | Mandatory | `cancelMsg` | Reason of Cancel | Refund Trans | | `additionalInfo` | Object | Mandatory | - | `"additionalInfo": { `
` "cancelType" : "1" `
` }` | - | | `cancelType` | String (2) | Mandatory | `cancelType` | `1`: Full Cancellation
`2`: Partial Cancellation | 1 | ## Response Parameter for Refund Transaction - API QRIS SNAP *** | **Nama Parameter BI** | **Tipe Parameter** | **Kebutuhan** | **Parameter NICEPAY** | **Deskripsi** | **Contoh** | | --------------------- | ------------------ | ------------- | ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------ | | `responseCode` | String (7) | Mandatory | `responseCd` | Error code to specify the error returned
[General Response Code and Message - API SNAP](docId\:lKqJXSl5CMKdXYXxHYYSs) | 2007800 | | `responseMessage` | String (150) | Mandatory | `responseMsg` | Debug message to provide more information | Successful | | `originalReferenceNo` | String (40) | Mandatory | `canceltXid` | NICEPAY Transaction ID or Identifier that need to be cancelled | IONPAYTEST082021017161458 | | `refundNo` | String (40) | Mandatory | `tXid` | Unique Refund ID from NICEPAY | IONPAYTEST08202106091121206416 | | `partnerRefundNo` | String (40) | Mandatory | `merReferenceRefundNo` | Merchant refund reference number | ncpy20221017161458 | | `refundAmount` | Object | Mandatory | | `"refundAmount": { `
` "value": "10000.00", `
` "currency": "IDR" `
` }` | | | - `value` | String (12) | Mandatory | `amt` | Transaction Amount

Note: Amount Format, currently only supported IDR (Indonesian Currency Rupiah) then value includes 2 decimal digits which are seperated by a dot (.) | 10000.00 | | - `currency` | String (3) | Mandatory | `currency` | Default Value: IDR | IDR | | `refundTime` | String (25) | Mandatory | `transDt`,
`transTm` | Update time of the individual Refund.
The value will be returned for successful invalidate request.
Using ISO-8601 Timestamp Format.
(`YYYY-MM-DDTHH:MM:SS`) | 2022-07-20T07:15:00+07:00 | | `additionalInfo` | Object | Mandatory | - | `"additionalInfo": { `
` "cancelTrxSn": "07202210051341224326" `
`}` | - | | - `cancelTrxSn` | String (32) | Mandatory | - | Refund Transaction Number From Acquirer Side | 07202210051341224326 | ## Sample Parameter for Refund Transaction - API QRIS SNAP *** ### Request Parameter :::CodeblockTabs cURL ```curl curl -X POST \ 'https://dev.nicepay.co.id/nicepay/api/v1.0/qr/qr-mpm-refund' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8=' \ -H 'X-TIMESTAMP: 2024-12-31T10:11:40+07:00' \ -H 'X-SIGNATURE: ufBw7R8RhW79IOiV/Hlv607M60qzAYBv8uZmbSrYb6/Thlo/FhQVP4xRyelUehoSS9o+QS6vWTKb/ygtucC+tQ==' \ -H 'X-PARTNER-ID: IONPAYTEST' \ -H 'X-EXTERNAL-ID: eXid202402111402271707638098' \ -H 'CHANNEL-ID: IONPAYTEST' \ -d '{"originalReferenceNo":"ncpy20221017161458","originalPartnerReferenceNo":"IONPAYTEST08202106091121206416","partnerRefundNo":"ncpy20221017161458","merchantId":"IONPAYTEST","externalStoreId":"NICEPAY","refundAmount":{"value":"10000.00","currency":"IDR"},"reason":"Refund Trans","additionalInfo":{"cancelType":"1"}}' ``` Node.js ```nodejs // Data from the QRIS Refund request const partnerId = "IONPAYTEST"; const channelId= "IONPAYTEST"; const externalId = "eXid202402111402271707638098"; const timestamp = "2024-12-31T10:11:40+07:00"; const accessToken = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8="; // Step 1: Configure the config const config = { isProduction: false, privateKey: "MERCHANT_PRIVATE_KEY", clientSecret: "MERCHANT_CLIENT_SECRET", clientId: partnerId, isCloudServer: false, }; // Step 2: Define the QRIS Refund Request Parameters let parameterRefund = { body: { originalReferenceNo: "ncpy20221017161458", originalPartnerReferenceNo: "IONPAYTEST08202106091121206416", partnerRefundNo: "ncpy20221017161458", merchantId: partnerId, externalStoreId: "NICEPAY", refundAmount: { value: "10000.00", currency: "IDR", }, reason: "Refund Trans", additionalInfo: { cancelType: "1", }, }, headers: { X_TIMESTAMP: timestamp, X_PARTNER_ID: partnerId, X_EXTERNAL_ID: externalId, CHANNEL_ID: channelId, }, }; // Step 3: Execute the Refund Request let endPoint = `/api/v1.0/qr/qr-mpm-refund`; let snap = new Snap(config); let response = snap .requestSnapTransaction(parameterRefund, endPoint, accessToken, "POST"); ``` ```java String accessToken = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8="; // Step 1: Initialize the NICEPay Configuration NICEPay config = NICEPay.builder() .isProduction(false) .clientSecret("YOUR_CLIENT_SECRET") // Placeholder for actual secret .partnerId("IONPAYTEST") .externalID("eXid202402111402271707638098") .timestamp("2024-12-31T10:11:40+07:00") .privateKey("YOUR_PRIVATE_KEY") // Placeholder for actual key .build(); // Step 2: Define the QRIS Refund Request Body Cancel requestData = Cancel.builder() .merchantId("IONPAYTEST") .externalStoreId("NICEPAY") .originalReferenceNo("ncpy20221017161458") .originalPartnerReferenceNo("IONPAYTEST08202106091121206416") .partnerRefundNo("ncpy20221017161458") .reason("Refund Trans") .refundAmount("10000.00", "IDR") .additionalInfo(Map.of("cancelType", "1")) .build(); // Step 3: Execute the QRIS Refund NICEPayResponse result = SnapCancelService.callServiceQrisRefund(requestData, accessToken, config); ``` ```python CLIENT_ID = "IONPAYTEST" EXTERNAL_STORE_ID = "NICEPAY" ORIGINAL_REF_NO = "ncpy20221017161458" ORIGINAL_PARTNER_REF_NO = "IONPAYTEST08202106091121206416" PARTNER_REFUND_NO = "ncpy20221017161458" REFUND_REASON = "Refund Trans" REFUND_VALUE = "10000.00" bodyCreateToken = ( builderAccessToken.BuildAccessToken() .setGrantType("client_credentials") .setAdditionalInfo("") .build() ) refundAmount = { "value": REFUND_VALUE, "currency": "IDR" } additionalInfo = { "cancelType": "1" } bodyQrisInquiry = ( builderQris.BuildQrisRefund() .setMerchantId(CLIENT_ID) .setExternalStoreId(EXTERNAL_STORE_ID) .setOriginalReferenceNo(ORIGINAL_REF_NO) .setOriginalPartnerReferenceNo(ORIGINAL_PARTNER_REF_NO) .setPartnerRefundNo(PARTNER_REFUND_NO) .setRefundAmount(refundAmount) .setReason(REFUND_REASON) .setAdditionalInfo(additionalInfo) .build() ) environment = (builderEnvironment.BuildEnvironment() .isCloud(False) .isProduction(False) .build()) result = SnapService.serviceTransaction(bodyCreateToken.jsonAccessToken(), bodyQrisInquiry.jsonQrisRefund(), ConstantsEndpoints.refundQris(), environment) ``` C# ```csharp const string NEW_CLIENT_ID = "IONPAYTEST"; const string NEW_EXTERNAL_ID = "eXid202402111402271707638098"; const string NEW_CHANNEL_ID = "IONPAYTEST"; const string REFUND_AMOUNT = "10000.00"; const string REFUND_CURRENCY = "IDR"; const string ORIGINAL_REF_NO = "ncpy20221017161458"; const string ORIGINAL_PARTNER_REF_NO = "IONPAYTEST08202106091121206416"; const string EXTERNAL_STORE_ID = "NICEPAY"; const string CANCEL_TYPE = "1"; const string REASON = "Refund Trans"; TestingConstant config = new TestingConstant(); string privateKey = ; string timestamp = DateTimeOffset.Now.ToString("yyyy-MM-ddTHH:mm:sszzz"); string clientSecret = config.ClientSecret; string channelId = NEW_CHANNEL_ID; string random = SignatureGeneratorUtils.GenerateRandomNumberString(8); bool isProduction = false; bool isCloudServer = true; string signature = SignatureGeneratorUtils.GenerateSignature(privateKey, NEW_CLIENT_ID, timestamp); var tokenRequester = new AccessTokenRequester(); string accessTokenResponse = await tokenRequester.GetAccessTokenAsync(NEW_CLIENT_ID, signature, timestamp, isProduction, isCloudServer); dynamic accessTokenObject = JObject.Parse(accessTokenResponse); string accessToken = accessTokenObject.accessToken; Console.WriteLine("Inquiry Ewallet Akses token: " + accessToken); ApiEndpoints apiEndpoints = new ApiEndpoints(); APIService qrisService = new APIService(apiEndpoints, clientSecret, NEW_CLIENT_ID, channelId, isProduction, isCloudServer); SnapQrisServices snapQrisServices = new SnapQrisServices(NEW_CLIENT_ID); string createRequestBody = snapQrisServices.GenerateRefundQris( originalReferenceNo: ORIGINAL_REF_NO, originalPartnerReferenceNo: ORIGINAL_PARTNER_REF_NO, merchantId: NEW_CLIENT_ID, partnerRefundNo: "RFND" + random, externalStoreId: EXTERNAL_STORE_ID, value: REFUND_AMOUNT, cancelType: CANCEL_TYPE, currency: REFUND_CURRENCY, reason : REASON ); string externalId = NEW_EXTERNAL_ID; string createResponse = await qrisService.SendPostRequest(apiEndpoints.RefundQris, accessToken, timestamp, createRequestBody, externalId); Console.WriteLine("Refund Qris Response: " + createResponse); ``` Laravel ```php protected $useProd = false; protected $useCloud = false; protected $refund_qris_endpoint = "/api/v1.0/qr/qr-mpm-refund"; // Credential protected $client_id = "IONPAYTEST"; PROTECTED $key = "_PRIVATE_KEY_MERCHANT"; PROTECTED $client_secret = "_CLIENT_SECRET_MERCHANT"; PROTECTED $access_token = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8="; PROTECTED $store_id = "NICEPAY"; $url = HttpUtil::getNicepayDomain($this->useProd, $this->useCloud) . $this->refund_qris_endpoint; $helper = new Helpers(); $http_method = "POST"; $x_time_stamp = "2024-12-31T10:11:40+07:00"; $partner_id = $this->client_id; $client_secret = $this->client_secret; $access_token = $this->access_token; $store_id = $this->store_id; $external_id = "eXid202402111402271707638098"; $channel_id = "IONPAYTEST"; $refundAmount = [ "value" => "10000.00", "currency" => "IDR" ]; $additionalInfo = [ "cancelType" => "1" ]; $body = [ "originalReferenceNo" => "ncpy20221017161458", "originalPartnerReferenceNo" => "IONPAYTEST08202106091121206416", "partnerRefundNo" => "ncpy20221017161458", "merchantId" => $partner_id, "externalStoreId" => $store_id, "refundAmount" => $refundAmount, "reason" => "Refund Trans", "additionalInfo" => $additionalInfo ]; $string_to_sign = $helper->generateStringToSign( $http_method, $this->refund_qris_endpoint, $access_token, $body, $x_time_stamp ); $signature = $helper->hmacSHA512Encoded( $string_to_sign, $client_secret, OPENSSL_ALGO_SHA512 ); $header = $helper->generateHeader( $access_token, $x_time_stamp, $signature, $partner_id, $external_id, $channel_id ); try { $response = HttpUtil::postJsonRequestWithHeader($url, $body, $header); } catch (Exception $e) { // Handle exception } ``` PHP Native ```php $config = NICEPay::builder() ->setIsProduction(false) ->setPrivateKey("_YOUR_PRIVATE_KEY_") ->setClientSecret("_YOUR_CLIENT_SECRET_") ->setPartnerId("IONPAYTEST") ->setExternalID("eXid202402111402271707638098") ->setTimestamp("2024-12-31T10:11:40+07:00") ->build(); $requestBody = Cancel::builder() ->setOriginalReferenceNo("ncpy20221017161458") ->setOriginalPartnerReferenceNo("IONPAYTEST08202106091121206416") ->setPartnerRefundNo("ncpy20221017161458") ->setMerchantId("IONPAYTEST") ->setExternalStoreId("NICEPAY") ->setRefundAmount("10000.00", "IDR") ->setReason("Refund Trans") ->setAdditionalInfo( ["cancelType" => "1"] ) ->build(); $accessToken = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8="; $qrisService = new SnapQrisService($config); $response = $qrisService->refund($requestBody, $accessToken); ``` ```kotlin const val ACCESS_TOKEN = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8=" // Step 1: Initialize the NICEPay Configuration var config: NICEPay = NICEPay.Builder() .isProduction(false) .clientSecret("YOUR_CLIENT_SECRET") .partnerId("IONPAYTEST") .externalID("eXid202402111402271707638098") .timestamp("2024-12-31T10:11:40+07:00") .privateKey("YOUR_PRIVATE_KEY") // Placeholder .build() // Step 2: Define the QRIS Refund Request Body val refundQris: SnapCancel = SnapCancel.Builder() .merchantId("IONPAYTEST") .originalPartnerReferenceNo("IONPAYTEST08202106091121206416") .originalReferenceNo("ncpy20221017161458") .partnerRefundNo("ncpy20221017161458") .externalStoreId("NICEPAY") .refundAmount("10000.00", "IDR") .reason("Refund Trans") .additionalInfo( mapOf( "cancelType" to "1" ) ) .build() // Step 3: Execute the Refund val response: NICEPayResponse? = snapQrisService.refund(refundQris, ACCESS_TOKEN, config) ``` CodeIgniter ```php $config = NICEPay::builder() ->setIsProduction(false) ->setIsCloudServer(isCloudServer: true) ->setPrivateKey("_YOUR_PRIVATE_KEY_") ->setClientSecret("_YOUR_CLIENT_SECRET_") ->setPartnerId("IONPAYTEST") ->setExternalID("eXid202402111402271707638098") ->setTimestamp("2024-12-31T10:11:40+07:00") ->build(); $requestBody = RefundQris::builder() ->setOriginalReferenceNo("ncpy20221017161458") ->setOriginalPartnerReferenceNo("IONPAYTEST08202106091121206416") ->setPartnerRefundNo("ncpy20221017161458") ->setMerchantId("IONPAYTEST") ->setExternalStoreId("NICEPAY") ->setRefundAmount("10000.00", "IDR") ->setReason("Refund Trans") ->setAdditionalInfo(["cancelType" => "1"]) ->build(); $accessToken = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8="; $snapQrisService = new SnapQrisService($config); try { $response = $snapQrisService->refund($requestBody, $accessToken, $config); } catch (\Exception $e) { // Handle exception } ``` ::: ### Response Parameter :::CodeblockTabs Sample Response ```json { "responseCode": "2007800", "responseMessage": "Successful", "originalReferenceNo": "IONPAYTEST082021017161458", "refundNo": "IONPAYTEST08202106091121206416", "partnerRefundNo": "ncpy20221017161458", "refundAmount": { "value": "10000.00", "currency": "IDR" }, "refundTime": "2022-07-20T07:15:00+07:00", "additionalInfo": { "cancelTrxSn": "07202210051341224326" } } ``` ::: [title] Refund Transaction - API E-Wallet (Direct Debit) SNAP [path] NICEPAY API/API SNAP/Payment API - SNAP/API E-Wallet (Direct Debit) SNAP/ # 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. # Refund Transaction - API E-Wallet (Direct Debit) SNAP *** :::hint{type="warning"} Silakan mengajukan akses token terlebih dahulu untuk melakukan autentikasi melalui bagian [Request Access Token API - SNAP](docId\:GcGqBIYXG1Etcd0Ji9cHX). ::: | **Service Code** | `58` | | ---------------- | ----------------------------------------------------------------------------------- | | **API Endpoint** | [`/api/v1.0/debit/refund`](https://dev.nicepay.co.id/nicepay/api/v1.0/debit/refund) | | **HTTP Method** | **POST** | | **Description** | Request refund transaction for authentication | | **Content-type** | `application/json` | ## Request Header Parameter for Refund Transaction - API E-Wallet (Direct Debit) SNAP *** | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | **Contoh** | | --------------- | -------- | ---------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | | `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 | Signature will be generated by Merchant.
[Panduan X-Signature - Symmetric](docId\:UZex33ReLyENKOgbJJnYp) | | | `X-PARTNER-ID` | String | 20 | Mandatory | `X-PARTNER-ID` = `CLIENT_ID` | | | `X-EXTERNAL-ID` | String | 40 | Mandatory | Unique Reference Number
(`41807553358950093184`) | | | `CHANNEL-ID` | String | 20 | Mandatory | Unique Channel Merchant Credential ID Number.
Client ID + "01" = Channel ID
`"IONPAYTEST" + "01" = "IONPAYTEST01"` | IONPAYTEST01 | ## Request Body Parameter for Refund Transaction - API E-Wallet (Direct Debit) SNAP *** | **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 Parameter for Refund Transaction - API E-Wallet (Direct Debit) SNAP *** | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | ---------------------------- | -------------------- | ---------- | ------------- | ---------------------------------------------------------------------------------------------------------------------------------- | | `responseCode` | String | 7 | Mandatory | Refer to [General Response Code and Message - API SNAP](docId\:lKqJXSl5CMKdXYXxHYYSs) list | | `responseMessage` | String | 150 | Mandatory | Refer to [General Response Code and Message - API SNAP](docId\:lKqJXSl5CMKdXYXxHYYSs) 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 for Refund Transaction API E-Wallet (Direct Debit) SNAP *** ### Request Parameter :::CodeblockTabs cURL ```curl curl -X POST \ 'https://dev.nicepay.co.id/nicepay/api/v1.0/debit/refund' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8=' \ -H 'X-TIMESTAMP: 2024-12-31T10:11:40+07:00' \ -H 'X-SIGNATURE: ufBw7R8RhW79IOiV/Hlv607M60qzAYBv8uZmbSrYb6/Thlo/FhQVP4xRyelUehoSS9o+QS6vWTKb/ygtucC+tQ==' \ -H 'X-PARTNER-ID: TNICEEW051' \ -H 'X-EXTERNAL-ID: tXid202402111402271707638101' \ -H 'CHANNEL-ID: TNICEEW05101' \ -d '{"merchantId":"00007100010926","subMerchantId":"310928924949487","originalPartnerReferenceNo":"2020102900000000000001","originalReferenceNo":"TNICEEW05105202210141451109841","partnerRefundNo":"239850918204981205970","refundAmount":{"value":"10000.00","currency":"IDR"},"externalStoreId":"124928924949487","reason":"Customer complain","additionalInfo":{"refundType":"1"}}' ``` Node.js ```nodejs const config = { isProduction: false, privateKey: cons.privateKey, clientSecret: cons.clientSecret, clientId: "TNICEEW051", isCloudServer: false, }; let parameterRefund = { body: { merchantId: "00007100010926", subMerchantId: "310928924949487", originalPartnerReferenceNo: "2020102900000000000001", originalReferenceNo: "TNICEEW05105202210141451109841", partnerRefundNo: "239850918204981205970", refundAmount: { value: "10000.00", currency: "IDR", }, externalStoreId: "124928924949487", reason: "Customer complain", additionalInfo: { refundType: "1", }, }, headers: { X_TIMESTAMP: "2024-12-31T10:11:40+07:00", X_PARTNER_ID: "TNICEEW051", X_EXTERNAL_ID: "tXid202402111402271707638101", CHANNEL_ID: "TNICEEW05101", }, }; let endPoint = `/api/v1.0/debit/refund`; // Refund endpoint let snap = new Snap(config); let response = snap .requestSnapTransaction( parameterRefund, endPoint, "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8=", // ACCESS_TOKEN "POST" ); ``` ```java String accessToken = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8="; // Step 1: Initialize the NICEPay Configuration config = NICEPay.builder() .isProduction(false) .clientSecret("YOUR_CLIENT_SECRET") .partnerId("TNICEEW051") .externalID("tXid202402111402271707638101") .timestamp("2024-12-31T10:11:40+07:00") .privateKey("YOUR_PRIVATE_KEY") .build(); // Step 2: Define the Debit Refund Request Body Cancel requestData = Cancel.builder() .merchantId("00007100010926") .subMerchantId("310928924949487") .originalPartnerReferenceNo("2020102900000000000001") .originalReferenceNo("TNICEEW05105202210141451109841") .partnerRefundNo("239850918204981205970") .refundAmount("10000.00", "IDR") .externalStoreId("124928924949487") .reason("Customer complain") .refundType("1") .build(); // Step 3: Execute the Refund NICEPayResponse Result = SnapCancelService.callServiceEwalletCancel(requestData, accessToken, config); ``` ```python bodyCreateToken = ( builderAccessToken.BuildAccessToken() .setGrantType("client_credentials") .setAdditionalInfo({}) .build() ) bodyDirectDebitRefund = ( builderDirectDebit.BuildDirectDebitRefund() .setPartnerRefundNo("239850918204981205970") .setMerchantId("TNICEEW051") .setSubMerchantId("310928924949487") .setOriginalPartnerReferenceNo("2020102900000000000001") .setOriginalReferenceNo("TNICEEW05105202210141451109841") .setExternalStoreId("124928924949487") .setReason("Customer complain") .setRefundAmount({ "value": "10000.00", "currency": "IDR" }) .setAdditionalInfo({ "refundType": "1" }) .build() ) environment = (builderEnvironment.BuildEnvironment() .isCloud(False) .isProduction(False) .build()) result = SnapService.serviceTransaction(bodyCreateToken.jsonAccessToken(), bodyDirectDebitRefund.jsonDirectDebitRefund(), ConstantsEndpoints.refundDirectDebit(), environment) ``` C# ```csharp TestingConstant config = new TestingConstant(); string privateKey = config.PrivateKey; string clientSecret = config.ClientSecret; // Variables used multiple times for configuration/header generation const string CLIENT_ID = "TNICEEW051"; const string CHANNEL_ID = "TNICEEW05101"; const string X_TIMESTAMP = "2024-12-31T10:11:40+07:00"; const string ACCESS_TOKEN = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8="; string clientId = CLIENT_ID; string timestamp = X_TIMESTAMP; string channelId = CHANNEL_ID; bool isProduction = false; bool isCloudServer = false; if (string.IsNullOrEmpty(clientId) || string.IsNullOrEmpty(clientSecret)) { Console.WriteLine("clientId or clientSecret cannot be empty."); Assert.Fail("clientId or clientSecret cannot be empty."); return; } // Generate signature string signature = SignatureGeneratorUtils.GenerateSignature(privateKey, clientId, timestamp); // Get access token (B2B flow) var tokenRequester = new AccessTokenRequester(); string accessTokenResponse = await tokenRequester.GetAccessTokenAsync(clientId, signature, timestamp, isProduction, isCloudServer); dynamic accessTokenObject = JObject.Parse(accessTokenResponse); string accessToken = ACCESS_TOKEN; // Using hardcoded token // Create Ewallet service ApiEndpoints apiEndpoints = new ApiEndpoints(); APIService ewalletService = new APIService(apiEndpoints, clientSecret, clientId, channelId, isProduction, isCloudServer); SnapEwalletServices snapEwalletServices = new SnapEwalletServices(clientId); string createRequestBody = snapEwalletServices.GenerateRefundEwalletRequest( merchantId: "00007100010926", subMerchantId: "310928924949487", originalPartnerReferenceNo: "2020102900000000000001", originalReferenceNo: "TNICEEW05105202210141451109841", partnerRefundNo: "239850918204981205970", externalStoreId: "124928924949487", refundAmountValue: "10000.00", currency: "IDR", reason : "Customer complain", refundType : "1" ); Console.WriteLine("Refund Ewallet Request: " + createRequestBody); string createResponse = await ewalletService.SendPostRequest( apiEndpoints.RefundEwallet, accessToken, timestamp, createRequestBody, "tXid202402111402271707638101" ); Console.WriteLine("Refund Ewallet Response: " + createResponse); ``` Laravel ```php string ACCESS_TOKEN = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8="; string X_TIMESTAMP = "2024-12-31T10:11:40+07:00"; string X_EXTERNAL_ID = "tXid202402111402271707638101"; string CHANNEL_ID = "TNICEEW05101"; protected $useProd = false; protected $useCloud = false; protected $refund_ewallet_endpoint = "/api/v1.0/debit/refund"; // Credential protected $client_id = "TNICEEW051"; PROTECTED $key = "_PRIVATE_KEY_MERCHANT"; PROTECTED $client_secret = "_CLIENT_SECRET_MERCHANT"; PROTECTED $access_token = ACCESS_TOKEN; PROTECTED $store_id = "124928924949487"; $url = HttpUtil::getNicepayDomain($this->useProd, $this->useCloud) . $this->refund_ewallet_endpoint; $helper = new Helpers(); $http_method = "POST"; $x_time_stamp = X_TIMESTAMP; $partner_id = $this->client_id; $client_secret = $this->client_secret; $access_token = $this->access_token; $store_id = $this->store_id; $external_id = X_EXTERNAL_ID; $partner_refund_no = "239850918204981205970"; $refundAmount = [ "value" => "10000.00", "currency" => "IDR" ]; $additionalInfo = [ "refundType" => "1" ]; $body = [ "merchantId" => "00007100010926", "subMerchantId" => "310928924949487", "originalReferenceNo" => "TNICEEW05105202210141451109841", "originalPartnerReferenceNo" => "2020102900000000000001", "partnerRefundNo" => $partner_refund_no, "refundAmount" => $refundAmount, "externalStoreId" => $store_id, "reason" => "Customer complain", "additionalInfo" => $additionalInfo ]; $string_to_sign = $helper->generateStringToSign( $http_method, $this->refund_ewallet_endpoint, $access_token, $body, $x_time_stamp ); $signature = $helper->hmacSHA512Encoded( $string_to_sign, $client_secret, OPENSSL_ALGO_SHA512 ); $header = $helper->generateHeader( $access_token, $x_time_stamp, $signature, $partner_id, $external_id, CHANNEL_ID ); try { $response = HttpUtil::postJsonRequestWithHeader($url, $body, $header); } catch (Exception $e) { // Handle exception } ``` PHP Native ```php $config = NICEPay::builder() ->setIsProduction(false) ->setClientSecret(TestConst::$CLIENT_SECRET) ->setPartnerId("TNICEEW051") ->setExternalID("tXid202402111402271707638101") ->setTimestamp("2024-12-31T10:11:40+07:00") ->setPrivateKey(TestConst::$PRIVATE_KEY) ->build(); $requestBody = Cancel::builder() ->setMerchantId("00007100010926") ->setSubMerchantId("310928924949487") ->setOriginalPartnerReferenceNo("2020102900000000000001") ->setOriginalReferenceNo("TNICEEW05105202210141451109841") ->setPartnerRefundNo("239850918204981205970") ->setRefundAmount("10000.00", "IDR") ->setExternalStoreId("124928924949487") ->setReason("Customer complain") ->setRefundType("1") ->build(); $accessToken = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8="; $snapEwalletService = new SnapEwalletService($config); try { $response = $snapEwalletService->refund($requestBody, $accessToken); } catch (\Exception $e) { // Handle exception } ``` ```kotlin const val ACCESS_TOKEN = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8=" // Step 1: Initialize the NICEPay Configuration var config: NICEPay = NICEPay.Builder() .isProduction(false) .clientSecret("YOUR_CLIENT_SECRET") .partnerId("TNICEEW051") .externalID("tXid202402111402271707638101") .timestamp("2024-12-31T10:11:40+07:00") .privateKey("YOUR_PRIVATE_KEY") .build() // Step 2: Define the Static Debit Refund Request Body val refundEwallet: SnapCancel = SnapCancel.Builder() .merchantId("00007100010926") .subMerchantId("310928924949487") .originalPartnerReferenceNo("2020102900000000000001") .originalReferenceNo("TNICEEW05105202210141451109841") .partnerRefundNo("239850918204981205970") .externalStoreId("124928924949487") .refundAmount("10000.00", "IDR") .refundType("1") .reason("Customer complain") .build() // Step 3: Execute the Refund val response: NICEPayResponse? = snapEwalletService.refund(refundEwallet, ACCESS_TOKEN, config) ``` CodeIgniter ```php $config = NICEPay::builder() ->setIsProduction(false) ->setIsCloudServer(isCloudServer: true) ->setPrivateKey($this->oldKeyFormat) ->setClientSecret($this->clientSecret) ->setPartnerId("TNICEEW051") ->setExternalID("tXid202402111402271707638101") ->setTimestamp("2024-12-31T10:11:40+07:00") ->build(); $accessToken = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8="; $requestBody = RefundEwallet::builder() ->setMerchantId("00007100010926") ->setSubMerchantId("310928924949487") ->setOriginalPartnerReferenceNo("2020102900000000000001") ->setOriginalReferenceNO("TNICEEW05105202210141451109841") ->setPartnerRefundNo("239850918204981205970") ->setRefundAmount("10000.00", "IDR") ->setExternalStoreId("124928924949487") ->setReason("Customer complain") ->setAdditionalInfo(["refundType" => "1"]) ->build(); $snapEwalletService = new SnapEwalletService(); try { $response = $snapEwalletService->refundEwallet($requestBody, $accessToken, $config); } catch (\Exception $e) { // Handle exception } ``` ::: ### Response Parameter :::CodeblockTabs Sample Response ```json { "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" } } ``` ::: [title] Reject Transaction - API Payout (Disbursement) SNAP [path] NICEPAY API/API SNAP/Payout API (Disbursement) - SNAP/ # Tentang Reject Transaction - API Payout (Disbursement) SNAP *** API ini digunakan untuk menolak pengajuan proses Disbursement yang dibuat pada saat pendaftaran. # Reject Transaction - API Payout (Disbursement) SNAP *** :::hint{type="warning"} Silakan mengajukan akses token terlebih dahulu untuk melakukan autentikasi melalui bagian [Request Access Token API - SNAP](docId\:GcGqBIYXG1Etcd0Ji9cHX). ::: | **API Endpoint** | `/nicepay/api/v1.0/transfer/reject` | | ---------------- | ----------------------------------- | | **HTTP Method** | **POST** | | **Description** | Reject Payout Transaction | | **Content-type** | `application/json` | ## Request Reject Disbursement Header Parameter | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | **Contoh** | | --------------- | -------- | ---------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | | `Content-Type` | String | 127 | Mandatory | Content type, value always `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 | Signature will be generated by Merchant.
[Panduan X-Signature - Symmetric](docId\:UZex33ReLyENKOgbJJnYp) | | | `X-PARTNER-ID` | String | 20 | Mandatory | Unique Partner ID, Partner ID = Client ID | | | `X-EXTERNAL-ID` | String | 40 | Mandatory | Unique messaging Reference ID generated by Merchant. Numeric String. Reference number that should be unique in every transaction. | | | `CHANNEL-ID` | String | 20 | Mandatory | Unique Channel Merchant Credential ID Number.
Client ID + "01" = Channel ID
`"IONPAYTEST" + "01" = "IONPAYTEST01"` | IONPAYTEST01 | ## Request Reject Disbursement Body Parameter | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | ---------------------------- | -------- | ---------- | ------------- | ---------------------------------------------------------- | | `merchantId` | String | 10 | Mandatory | Merchant identifier that is unique per each Merchant | | `originalReferenceNo` | String | 40 | Mandatory | Original transaction identifier on service provider system | | `originalPartnerReferenceNo` | String | 40 | Mandatory | Original transaction identifier on consumer system | ## Response Reject Disbursement Parameter | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Description** | | ---------------------------- | -------------------- | ---------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------ | | `responseCode` | String | 7 | Mandatory | Refer to [General Response Code and Message - API SNAP](docId\:lKqJXSl5CMKdXYXxHYYSs) list | | `responseMessage` | String | 150 | Mandatory | Refer to [General Response Code and Message - API SNAP](docId\:lKqJXSl5CMKdXYXxHYYSs) 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. | | `beneficiaryAccountNo` | String | 25 | Mandatory | Beneficiary Account Number | | `beneficiaryName` | String | 100 | Mandatory | Beneficiary Name | | `beneficiaryBankCode` | String | 4 | Mandatory | Beneficiary [Bank Code - API SNAP](docId:9WOQy5-1hlf_uCwshSDHO) | | `amount` | Array of JSON Object | Variable | Mandatory | Amount Information
`"amount": {...}` | | `value` | String | 12 | Mandatory | Transaction amount, If it’s IDR then value includes
2 decimal digits.
e.g. IDR 10.000,- will be placed with 10000.00 | | `currency` | String | 3 | Mandatory | Currency code based on ISO | ## Sample Parameter :::CodeblockTabs Request Body ```json //HEADER SECTION Content-Type: application/json Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8= X-TIMESTAMP: 2024-12-31T10:11:40+07:00 X-SIGNATURE: ufBw7R8RhW79IOiV/Hlv607M60qzAYBv8uZmbSrYb6/Thlo/FhQVP4xRyelUehoSS9o+QS6vWTKb/ygtucC+tQ== X-PARTNER-ID :IONPAYTEST X-EXTERNAL-ID: eXid202402111402271707638107 CHANNEL-ID: IONPAYTEST { "merchantId": "IONPAYTEST", "originalPartnerReferenceNo": "order1677061504913", "originalReferenceNo": "IONPAYTEST07202302221725064187" } ``` Sample Response ```json { "responseCode": "2000000", "responseMessage": "Successful", "originalPartnerReferenceNo": "order1677061504913", "originalReferenceNo": "IONPAYTEST07202302221725064187", "beneficiaryAccountNo": "5345000060", "beneficiaryName": "NICEPAY", "beneficiaryBankCode": "CENA", "amount": { "value": "10000.00", "currency": "IDR" } } ``` ::: [title] Cancel Transaction - API Payout (Disbursement) SNAP [path] NICEPAY API/API SNAP/Payout API (Disbursement) - SNAP/ # Tentang Request Cancel Transaction - API Payout (Disbursement) SNAP *** API ini digunakan untuk melakukan pengajuan pembatalan proses Disbursement setelah tahap *approval *dan sebelum waktu eksekusi berjalan. # Request Cancel Transaction - API Payout (Disbursement) SNAP *** :::hint{type="warning"} Silakan mengajukan akses token terlebih dahulu untuk melakukan autentikasi melalui bagian [Request Access Token API - SNAP](docId\:GcGqBIYXG1Etcd0Ji9cHX). ::: | **API Endpoint** | [`/nicepay/api/v1.0/transfer/cancel`](https://www.nicepay.co.id/nicepay/api/v1.0/transfer/cancel) | | ---------------- | ------------------------------------------------------------------------------------------------- | | **HTTP Method** | **POST** | | **Description** | Cancel Payout Transaction | | **Content-type** | `application/json` | ## Request Cancel Disbursement Header Parameter | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | **Contoh** | | ----------------------- | -------- | ---------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | | `Content-Type` | String | 127 | Mandatory | Content type, value always `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 | Signature will be generated by Merchant.
[Panduan X-Signature - Symmetric](docId\:UZex33ReLyENKOgbJJnYp) | | | `X-PARTNER-ID` | String | 20 | Mandatory | Unique Partner ID, Partner ID = Client ID | | | `X-EXTERNAL-`
`ID` | String | 40 | Mandatory | Unique messaging Reference ID generated by
Merchant. Numeric String. Reference number that
should be unique in every transaction. | | | `CHANNEL-ID` | String | 20 | Mandatory | Unique Channel Merchant Credential ID Number.
Client ID + "01" = Channel ID
`"IONPAYTEST" + "01" = "IONPAYTEST01"` | IONPAYTEST01 | ## Request Cancel Disbursement Body Parameter | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | ---------------------------- | -------- | ---------- | ------------- | ---------------------------------------------------------- | | `merchantId` | String | 10 | Mandatory | Merchant identifier that is unique per
each Merchant | | `originalReferenceNo` | String | 40 | Mandatory | Original transaction identifier on service provider system | | `originalPartnerReferenceNo` | String | 40 | Mandatory | Original transaction identifier on consumer system | ## Response Cancel Disbursement Parameter | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | | ------------------------------------ | ------------------------- | ---------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------ | | `responseCode` | String | 7 | Mandatory | Refer to [General Response Code and Message - API SNAP](docId\:lKqJXSl5CMKdXYXxHYYSs) list | | `responseMessage` | String | 150 | Mandatory | Refer to [General Response Code and Message - API SNAP](docId\:lKqJXSl5CMKdXYXxHYYSs) list | | `originalRefere`
`nceNo` | String | 40 | Mandatory | Original transaction identifier on service provider
system | | `originalPartner`
`ReferenceNo` | String | 40 | Mandatory | Original transaction identifier on service provider
system. Must be filled upon successful
transaction. | | `beneficiaryAccountNo` | String | 25 | Mandatory | Beneficiary Account Number | | `beneficiaryName` | String | 100 | Mandatory | Beneficiary Name | | `beneficiaryBankCode` | String | 4 | Mandatory | Beneficiary [Bank Code - API SNAP](docId:9WOQy5-1hlf_uCwshSDHO) | | `amount` | Array of
JSON Object | Variable | Mandatory | Amount Information
`"amount": {...}` | | `value` | String | 12 | Mandatory | Transaction amount, If it’s IDR then value includes
2 decimal digits.
e.g. IDR 10.000,- will be placed with 10000.00 | | `currency` | String | 3 | Mandatory | Currency code based on ISO | ## Sample Parameter :::CodeblockTabs Request Body ```json //HEADER SECTION Content-Type: application/json Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJJT05QQVlURVNUIiwiaXNzIjoiTklDRVBBWSIsIm5hbWUiOiJCUklOIiwiZXhwIjoiMjAyNC0wMi0xMVQwODowOTozNVoifQ==.aIybLX36dYwfFvW7dcoenXkOe2EAwIYq84ZtPuIf3K8= X-TIMESTAMP: 2024-12-31T10:11:40+07:00 X-SIGNATURE: ufBw7R8RhW79IOiV/Hlv607M60qzAYBv8uZmbSrYb6/Thlo/FhQVP4xRyelUehoSS9o+QS6vWTKb/ygtucC+tQ== X-PARTNER-ID :IONPAYTEST X-EXTERNAL-ID: eXid202402111402271707638106 CHANNEL-ID: IONPAYTEST { "merchantId": "IONPAYTEST", "originalPartnerReferenceNo": "order1677048512514", "originalReferenceNo": "IONPAYTEST07202302221348332909" } ``` Sample Response ```json { "responseCode": "2000000", "responseMessage": "Successful", "originalPartnerReferenceNo": "order1677048512514", "originalReferenceNo": "IONPAYTEST07202302221348332909", "beneficiaryAccountNo": "5345000060", "beneficiaryName": "NICEPAY", "beneficiaryBankCode": "CENA", "amount": { "value": "10000.00", "currency": "IDR" } } ``` ::: [title] Paylater - API Checkout [path] NICEPAY API/API Checkout/Payment - API Checkout/ # Tentang Paylater - API Checkout *** ini digunakan oleh untuk melakukan pengajuan kepada untuk menggunakan . # Alur Proses *** ![Alur Pembayaran Paylater](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/c66dRPvoO-86raFpkx5ty_diagram-nicepay-paylater-payment-flow.jpg "Alur Pembayaran Paylater") Deskripsi langkah dengan : 1. *request checkout* kepada . 2. mengirimkan Registration kepada . 3. Pada bagian *Registration;* - Jika menggunakan Akulaku: - akan *request *pesanan kepada Akulaku selaku . - Akulaku akan *generate *pesanan. - Akulaku mengirimkan *response *data kepada . - akan mengirimkan *capture response * Regist kepada . - Jika menggunakan Kredivo/Indodana: - akan menyimpan regist*.* - akan mengirimkan *response * regist. 4. mengirimkan kepada . 5. Kemudian pada bagian *Payment;* - Jika menggunakan Akulaku: - mengarahkan kepada Akulaku. - melakukan *login *akun. - melakukan konfirmasi kepada Akulaku selaku . - Akulaku melakukan validasi . - Akulaku mengalihkan dengan *callbackUrl.* - Jika menggunakan Kredivo/Indodana: - *request checkout* kepada . - melakukan . - mengirim *response *dan mengalihkan ke milik . - melakukan konfirmasi kepada . - mengirimkan OTP kepada . - memasukkan OTP kepada . - melakukan validasi OTP. - melakukan konfirmasi hasil pesanan kepada . 6. Pada bagian *Notification;* - Jika menggunakan Akulaku: - Akulaku selaku mengirimkan *push capture notif *kepada . - menyimpan . - mengirimkan *capture update notification *kepada . - menampilkan *response *kepada . - Jika menggunakan Kredivo/Indodana: - mengirimkan *push notification *kepada . - melakukan validasi terhadap diterima. - mengajukan konfirmasi pesanan. - melakukan konfirmasi pesanan. - mengirim data konfirmasi pesanan kepada . - mengirimkan hasil konfirmasi pesanan. 7. Jika digunakan adalah Akulaku, dapat melakukan konfirmasi bukti : - mengirimkan konfirmasi bukti kepada . - mengajukan konfirmasi bukti kepada . - mengajukan konfirmasi bukti kepada Akulaku. - Akulaku melakukan konfirmasi bukti . - Akulaku mengirim *response *data kepada . - mengirim *response *data kepada . - menampilkan hasil data kepada . 8. mengajukan pemeriksaan menggunakan Status kepada . 9. mengirimkan *response *pemeriksaan . 10. menerima terakhir. 11. mengirimkan konfirmasi kepada . # NICEPAY Secure Payment Page *** ![Secure Payment Page](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/ohh_r6otn4iPQSs_4RfL1_image-id-nicepay-secure-payment-page-main-dashboard.jpg "Secure Payment Page") Gambar di bawah adalah contoh dengan metode menggunakan Secure Page. ![Paylater - Secure Payment Page](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/3zbli6FMTRrqIUHbHqA_j_image-id-paylater.jpg "Paylater - Secure Payment Page") Setelah *request* registrasi selesai, dapat melanjutkan sampai dengan penyelesaian dengan mengikuti panduan pada [Panduan Bayar Paylater](docId\:P8AvV0TcLlEVuI80Pc7Rc). ![Success - Secure Payment Page](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/ZqTpB8sFdAlnDvZtXMtAE_image-id-paylater-success.jpg "Success - Secure Payment Page") # API Checkout Transaction Payment *** | **API URL** | `/nicepay/redirect/v2/payment` | | ------------------- | ------------------------------------------- | | **Request Method** | `Redirect-GET` | | **Header** | `Content-Type: application/Form-UrlEncoded` | ## Request Parameter for Paylater - API Checkout (CallbackUrl) *** Berikut adalah daftar Request Parameter untuk pada . :::hint{type="warning"} Catatan untuk , silakan berikan pesan peringatan kepada untuk membuka melalui perangkat ponsel demi memberikan pengalaman lebih baik kepada . ::: | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | --------------------------------------------------------- | -------- | ---------- | --------------------- | ----------------------------------------------------------- | | `paymentURL`
Required | ANS | 14 | URL
| https\://dev.nicepay.co.id/nicepay/redirect/v2/payment | | `tXid`
Required | AN | 30 | Transaction ID
| PAYLOANTES00202212201645434449 | ## Response Parameter for Paylater - API Checkout (CallbackUrl) *** :::hint{type="info"} Catatan: Response akan dikirimkan melalui `callBackurl` dengan Content-type: `application/json` dan metode: `POST Parameter`. ::: | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | --------------------------------------------------------------------------------------------------------- | -------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------ | | `resultCd` | N | 4 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | 0000 | | `resultMsg` | AN | 255 | Result Message: [Error Code](docId\:yEh1VA9k2y6sL1kQF2aWD) | SUCCESS | | `tXid` | AN | 30 | Transaction ID | PAYLOANTES00202212201645434449

When Success | | `referenceNo` | ANS | 40 | Order Number | ORD20221220161200

When Success | | `payMethod`
E-Wallet, Paylater | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | 06

When Success | | `amt` | N | 12 | Transaction Amount | 10000

When Success | | `currency`
E-Wallet, Paylater | A | 3 | Currency | IDR

When Success | | `goodsNm`
E-Wallet, Paylater | AN | 100 | Goods Name | John+Doe

When Success | | `billingNm`
E-Wallet, Paylater | A | 100 | Billing Name | John+Doe

When Success | | `transDt` | N | 8 | Transaction Date (`YYYYMMDD`) | 20221220

When Success | | `transTm` | N | 6 | Transaction Time (`HH24MISS`) | 164543

When Success | | `description ` | AN | 100 | Transaction Description | Test+Transaction+Nicepay

When Success | | `authNo`
Only CC | N | 10 | Approval Number | When Success | | `issuBankCd`
Only CC | A | 4 | [Issuing Bank Code](docId:1U7QOax_wrzXMoCG-Mqad)
| When Success | | `acquBankCd`
Only CC | A | 4 | [Acquiring Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | When Success | | `issuBankNm`
Only CC | A | 255 | Issuing Name | When Success | | `acquBankNm`
Only CC | A | 255 | Acquiring Name | When Success | | `cardNo`
Only CC | ANS | 20 | Card Number with Masking | When Success | | `recurringToken`
Only CC (Additional) | AN | 255 | Recurring Token | When Success | | `preauthToken` | AN | 255 | Pre-Auth Token | null

When Success | | `ccTransType` | AN | 2 | Credit Card Transaction Type:
`1`: Normal
`2`: Recurring
`3`: Pre-Auth
`4`: Capture | When Success | | `mitraCd`
Direct Debit, E-Wallet, Paylater | A | 4 | [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8) | KDVI

When Success | | `receiptCode` | ANS | 20 | Authorization Number | When Success | | `mRefNo` | AN | 18 | Reference Number | When Success | | `cardExpYymm` | N | 4 | Card Expiry (`YYMM`) | When Success | | `instmntType` | N | 2 | [Installment Type Code](docId:7CIX-U_4z295XgtNVEsbO) | When Success | | `instmntMon` | N | 2 | Installment Month
`1`: 1 Month/Full , jika `instmntType`*:* *null/1*
`3`: 3 Months
`6`: 6 Months
`12`: 12 Months | When Success | | `timeStamp` | N | 14 | Request Timestamp | When Success | | `merchantToken` | AN | 255 | Token | When Success | Sample Parameter for Paylater - API Checkout (CallbackUrl) ---------------------------------------------------------- *** :::hint{type="success"} Pada saat *Checkout*, *response* dari *request* di-*hit* adalah Callback URL. ::: ### Request Parameter :::CodeblockTabs cURL ```curl curl -X GET "https://www.merchant.com/callbackUrl?resultCd=0000&resultMsg=SUCCESS&tXid=PAYLOANTES00202212201645434449&referenceNo=ORD20221220161200&payMethod=06&amt=10000&transDt=20221220&transTm=164543&description=Test+Transaction+Nicepay&authNo=&issuBankCd=&acquBankCd=&cardNo=&receiptCode=&mitraCd=KDVI&recurringToken=&preauthToken=¤cy=IDR&goodsNm=John+Doe&billingNm=John+Doe&ccTransType=&mRefNo=&instmntType=&instmntMon=&cardExpYymm=&issuBankNm=&acquBankNm=&timeStamp=&merchantToken=" ``` ::: ### Callback Parameter :::CodeblockTabs Response Callback ```curl resultCd=0000 resultMsg=SUCCESS tXid=PAYLOANTES00202212201645434449 referenceNo=ORD20221220161200 payMethod=06 amt=10000 transDt=20221220 transTm=164543 description=Test+Transaction+Nicepay authNo= issuBankCd= acquBankCd= cardNo= receiptCode= mitraCd=KDVI recurringToken= preauthToken= currency=IDR goodsNm=John+Doe billingNm=John+Doe ccTransType= mRefNo= instmntType= instmntMon= cardExpYymm= issuBankNm= acquBankNm= timeStamp= merchantToken= ``` ::: ## Callback Handling API Checkout Payment *** :::hint{type="success"} Saat *Callback* diterima `callbackUrl` , kami merekomendasikan untuk melakukan verifikasi Status dengan menggunakan [Status Inquiry - API Checkout](docId\:K9vBS87ev9_w5oJAU0et3). ::: :::hint{type="warning"} `Callback Handling` sangat penting untuk membantu meminimalisir tindakan *Fraud*. Kami sangat merekomendasikan untuk melakukan verifikasi menggunakan `Callback parameter`. ::: ::Image[]{src="https://app.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/hB3AyDaMVCRKhlIgcs-V4_nicepay-api-checkout-api-callback-handling-flow-1.png" size="50" width="370" height="361" position="center" caption="Alur Callback Handling" alt="Alur Callback Handling" darkWidth="370" darkHeight="361" showCaption="true"} :::CodeblockTabs URL Callback ```json https://merchant.com/api/callBackUrl ``` Response Callback ```json resultCd=0000 resultMsg=SUCCESS tXid=PAYLOANTES00202212201645434449 referenceNo=ORD20221220161200 payMethod=06 amt=10000 transDt=20221220 transTm=164543 description=Test+Transaction+Nicepay authNo= issuBankCd= acquBankCd= cardNo= receiptCode= mitraCd=KDVI recurringToken= preauthToken= currency=IDR goodsNm=John+Doe billingNm=John+Doe ccTransType= mRefNo= instmntType= instmntMon= cardExpYymm= issuBankNm= acquBankNm= timeStamp= merchantToken= ``` ::: [title] Field Type Code [path] NICEPAY API/API Non-SNAP/NICEPAY Code/ Tiap *field *pada memiliki tipe data berbeda. IT Developer dapat mengisi *value *dari *key * sesuai dengan *field type* sudah ditentukan pada tabel di bawah ini. | **Key** | **Deskripsi** | | ------- | ---------------------------- | | `A` | Alphabet | | `AN` | Alphanumeric | | `N` | Number | | `ANS` | Alphanumeric, Number, Symbol | | `AOO` | Array of Object | [title] FAQ Kartu Kredit [path] Payment/Kartu Kredit/ ### Jenis kartu apa saja yang bisa digunakan pada metode pembayaran Kartu Kredit? Semua kartu berlogo Visa, Mastercard, JCB, dan Amex. *** ### Apa perbedaan pembayaran dengan kartu berlogo GPN dan Kartu Kredit lain? lain bekerja sama dengan American Express, Mastercard, VISA, dan JCB sehingga dapat digunakan untuk dalam dan luar negeri. Sedangkan kartu berlogo hanya dapat digunakan untuk dalam negeri saja. kunjungi [GPN](docId\:qmes8DhJjO6aHaW2DlLBy) untuk lebih lanjut terkait . *** ### Apakah ada proses autentikasi menggunakan OTP? Ada, tersebut akan diatur sesuai pada MID . *** ### Apa yang dimaksud dengan kode ECI dalam Kartu Kredit? Kode ECI merupakan kode yang terdapat pada 3Ds Authentication digunakan oleh untuk dapat mengetahui keberhasilan hasil autentikasi . | **Kode ECI **(VISA & Principal lain) | **Kode ECI** (Mastercard) | **Deskripsi** | | ----------------------------------------- | ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 05 | 02 | Autentikasi berhasil dan keamanan kartu dijamin dengan 3D Secure. | | 06 | 01 | Autentikasi sudah dicoba, namun tidak berhasil karena Issuer atau kartu tidak terintegrasi dengan 3D Secure. | | 07 | 00 | Autentikasi tidak berhasil dilakukan karena berbagai faktor seperti kartu atau penerbit kartu dinilai tidak aman, kendala di Directory Server, kartu tidak terintegrasi dengan 3Ds atau kartu sudah terintegrasi dengan 3Ds tetapi gagal pada autentikasi. | *** ### Bagaimana proses pembayaran dengan Kartu Kredit? kunjungi [Alur Pembayaran Kartu Kredit](docId\:i33-9_tZc9P783QJAsX-d) untuk lebih lanjut. *** ### Mengapa transaksi menggunakan Kartu Kredit dapat gagal? 1. Kartu tidak aktif. 2. Kartu kedaluwarsa. 3. Nomor kartu tidak valid. 4. Tanggal kedaluwarsa tidak valid. 5. CVV tidak valid. 6. Jaringan *Issuer* tidak mendukung. 7. Limit penggunaan kartu harian sudah mencapai batas. 8. Visa 3Ds. *** ### Bagaimana cara Merchant mengecek transaksi yang sudah berhasil dibayarkan dengan Kartu Kredit? dapat melihat riwayat dalam jangka waktu tertentu melalui [Merchant Back Office](docId\:VMD8YtiiJqku6H8dRhcS6) pada: - Menu [Transaction Data](docId\:iZwosih8r9HIc0UurgYMa) untuk memeriksa seluruh data , atau - Menu [Fail Transaction](docId\:Kw36Cm_cK3RzRNUHfzavQ) untuk memeriksa data gagal. *** ### Apakah bisa tampilan OTP di Kartu Kredit diperbesar tampilan/teksnya? Untuk *view page* OTP , tidak dapat diperbesar. *** ### Apa yang dimaksud dengan Settlement? adalah pembukuan suatu & pemindahan dana dari lembaga finansial ( atau ) ke perorangan atau perusahaan akan disebut sebagai . mengecek [Proses Settlement](docId\:l04EuP_s604Oi2Ib3x_y6) untuk informasi lebih lanjut. *** ### Bisakan Merchant melakukan pengaturan agar Pelanggan tidak perlu memasukkan kembali informasi rincian kartu untuk transaksi selanjutnya? Bisa, fitur Recurring menjadi solusi untuk mendukung kebutuhan tersebut. *** ### Apakah transaksi Kartu Kredit dapat dilakukan dari luar negeri? Bisa, apabila sesuai dengan *tagline* *support *: Visa, Mastercard, JCB, Amex 3D Secured, dan . *** ### Apakah terdapat proses *refund* pada Merchant Back Office untuk pembayaran dengan Kartu Kredit? [Merchant Back Office](docId\:VMD8YtiiJqku6H8dRhcS6) menyediakan *refund *untuk dengan . kunjungi [Transaction Data](docId\:iZwosih8r9HIc0UurgYMa) untuk lebih lanjut. *** ### Bagaimana cara melakukan proses ***refund ***pada Kartu Kredit? ** ** kunjungi [Penyelesaian Transaksi Pada Kartu Kredit](docId:4rCLEHp5GhD71y_aARfnQ) untuk lebih lanjut. *** ### Berapa lama waktu yang dibutuhkan untuk melakukan proses Settlement Kartu Kredit? H+3 pada hari kerja. *** ### Apakah Merchant bisa ***request*** ***blacklist card bin*** tertentu? bisa mengajukan *blacklist card bin* tertentu. *** ### Apakah Merchant bisa menggunakan Kartu Kredit Recurring Non-CVV? Tidak bisa. Karena untuk mencegah penipuan, *Recurring* harus menggunakan CVV. *** ### Apakah ada batas maksimal Merchant bisa melakukan ***refund payment*** Kartu Kredit? Maksimal untuk melakukan *Refund* *Credit Card* adalah 90 hari/3 bulan. :::Iframe{iframeHeight="0" code="Silakan menghubungi tim NICEPAY Customer Service untuk mendapatkan informasi lebih lanjut terkait refund pada metode pembayaran Kartu Kredit."} ::: [title] Change Log [path] NICEPAY API/API Non-SNAP/Payment API/ :::Changelog{title="20230620 - Migrate to New Website"} ::ChangelogItem{type="improved" description="Update to Latest Content"} ::: :::Changelog{title="2.75 - x Agustus 2022"} ::ChangelogItem{type="improved" description="General info RecurringToken & PreauthToken Live integration check"} ::: :::Changelog{title="2.74 "} ::ChangelogItem{type="improved" description="General info RecurringToken & PreauthToken Live integration check"} ::: :::Changelog{title="2.73"} ::ChangelogItem{type="added" description="add Handler Flow"} ::: :::Changelog{title="2.72 - 06 Juni 2022"} ::ChangelogItem{type="added" description="Add bankCd DKI"} ::: :::Changelog{title="2.71 - 26 April 2022"} ::ChangelogItem{type="improved" description="Update Guide Flow V1 Prof & CC Ent"} ::ChangelogItem{type="improved" description="Update Guide Flow CC V2 Prof & Ent"} ::: :::Changelog{title="2.70 - 23 Maret 2022"} ::ChangelogItem{type="added" description="New Page for API V2 Professional"} ::ChangelogItem{type="fixed" description="Fix : Remove mitraCd sample POST for Notification"} ::ChangelogItem{type="fixed" description="Fix : Remove Scroll bar in Page API V1 Professional and Enterprise"} ::: :::Changelog{title="2.69 - 15 Maret 2022"} ::ChangelogItem{type="added" description="Add GPN payment method (09)"} ::: :::Changelog{title="2.68 - 21 Januari 2022"} ::ChangelogItem{type="improved" description="Update sample response Credit Card to callBackurl with parameter on V2 direct"} ::: :::Changelog{title="2.67 - 20 Januari 2022"} ::ChangelogItem{type="added" description="add bank code BNC"} ::ChangelogItem{type="added" description="add parameter sellersUrl"} ::ChangelogItem{type="added" description="add flow ShopeePay and flow Indodana v2 direct"} ::: :::Changelog{title="2.66 - 7 April 2021"} ::ChangelogItem{type="added" description="Add response parameter cancelReferenceNo Optional For CC, on V2 Cancel"} ::ChangelogItem{type="fixed" description="Fix Parameter returnJsonFormat Optional For Shopeepay to get URL redirect Shopeepay"} ::ChangelogItem{type="fixed" description="Fix Sample JSON Request and Response for QRIS Registration, on V1 direct"} ::: :::Changelog{title="2.65 - 30 Maret 2021"} ::ChangelogItem{type="added" description="Add Request Parameters Required For Indodana, on V2 direct"} ::ChangelogItem{type="added" description="Add Indodana Mitra Code"} ::ChangelogItem{type="fixed" description="Fix Sample JSON Request and Response for Payloan Registration, on V2 direct"} ::ChangelogItem{type="fixed" description="Fix E-Wallet Status Code"} ::: :::Changelog{title="2.64 - 19 Maret 2021"} ::ChangelogItem{type="added" description="Add Request Parameters Required For E-Wallet Shopeepay, on V1"} ::ChangelogItem{type="added" description="Add Request Parameters Required For E-Wallet Shopeepay, on V2 direct"} ::ChangelogItem{type="fixed" description="Fix Sample JSON Request and Response for E-Wallet Registration, on V2 direct"} ::: :::Changelog{title="2.63 - 10 Maret 2021"} ::ChangelogItem{type="added" description="Add Request Parameters Required For Jenius Pay, on V1"} ::ChangelogItem{type="added" description="Add Jenius option on payment page, on V1 Professional"} ::: :::Changelog{title="2.62 - 3 Maret 2021"} ::ChangelogItem{type="added" description="Add Request Parameters Required For Jenius Pay, on V2"} ::ChangelogItem{type="added" description="Add Jenius Pay Mitra Code"} ::ChangelogItem{type="fixed" description="Fix Sample JSON Request and Response for ClickPay Registration, on V2"} ::: :::Changelog{title="2.61 - 2 December 2020"} ::ChangelogItem{type="fixed" description="Fix typo on payloan data V2."} ::ChangelogItem{type="fixed" description="Fix Request and Response type on Ewallet V1 Enterprise, from JSON to POST Parameter."} ::ChangelogItem{type="fixed" description="Fix typo on ewallet data V2"} ::: :::Changelog{title="2.60 - 5 November 2020"} ::ChangelogItem{type="fixed" description="Fix Permata Syariah Bank Code"} ::ChangelogItem{type="added" description="Add E-Wallet Status Code"} ::ChangelogItem{type="added" description="Add Payloan Status Code"} ::ChangelogItem{type="fixed" description="Fix QRIS Status Code"} ::ChangelogItem{type="added" description="Add Payment Response/Callback Parameter to V1 Professional"} ::: :::Changelog{title="2.57 - 26 October 2020"} ::ChangelogItem{type="fixed" description="Fix Sample POST Parameter Request for Payloan"} ::ChangelogItem{type="fixed" description="Fix Request Method for Payloan"} ::: :::Changelog{title="2.56 - 7 October 2020"} ::ChangelogItem{type="added" description="Add QRIS Documentation"} ::ChangelogItem{type="improved" description="Update response parameter Registration"} ::ChangelogItem{type="added" description="Add parameter required for QRIS"} ::: :::Changelog{title="2.55 - 18 September 2020"} ::ChangelogItem{type="added" description="Added Permata Syariah as Supported Bank"} ::ChangelogItem{type="added" description="Added ShopeePay as Supported Mitra"} ::ChangelogItem{type="added" description="Added DANA as Supported Mitra"} ::ChangelogItem{type="added" description="Added Details: LinkAja does not support special characters on cartData"} ::ChangelogItem{type="improved" description="Update Sample Payload for V2 APIs"} ::ChangelogItem{type="improved" description="Changed wording JSON OBJECT to JSON STRING for cartData"} ::ChangelogItem{type="improved" description="Update New Parameters for API V2 Register for QRIS"} ::ChangelogItem{type="fixed" description="Fix API URL for Akulaku Confirm Receipt"} ::ChangelogItem{type="fixed" description="Fix wrong VA API V2 Diagram Flow"} ::ChangelogItem{type="fixed" description="Fix Details: API V2 Payment callBack does not use String Query but POST Parameter"} ::: :::Changelog{title="2.51 - 4 June 2020"} ::ChangelogItem{type="fixed" description="Fix userAgent Requirement for CC"} ::ChangelogItem{type="fixed" description="Fix Seller and cartData for E-Wallet"} ::ChangelogItem{type="improved" description="Remove Unused JSON Button"} ::: :::Changelog{title="2.50 - 4 June 2020"} ::ChangelogItem{type="improved" description="Online Docs UI and UX Update"} ::ChangelogItem{type="improved" description="Update E-Wallet Documentation"} ::ChangelogItem{type="improved" description="Update Payloan Documentation"} ::ChangelogItem{type="fixed" description="Minor Fixes on Parameter Length and Type"} ::ChangelogItem{type="added" description="Add Git Link for Plugins and Libraries"} ::ChangelogItem{type="improved" description="Update New POSTMAN Collection"} ::: :::Changelog{title="2.15 - 17 May 2018"} ::ChangelogItem{type="improved" description="Update card error code"} ::: :::Changelog{title="2.13 - 14 May 2018"} ::ChangelogItem{type="added" description="Add parameter payment API timeStamp, merchantToken"} ::: :::Changelog{title="2.12 - 18 April 2018"} ::ChangelogItem{type="improved" description="Update Error Code"} ::: :::Changelog{title="2.07 - 01 February 2018"} ::ChangelogItem{type="added" description="Add parameter CardHolderNm on Payment API"} ::: :::Changelog{title="2.06 - 01 january 2018"} ::ChangelogItem{type="added" description="Add parameter fee on Payment, Notification, and Inquiry"} ::: :::Changelog{title="2.05 - 15 December 2017"} ::ChangelogItem{type="improved" description="Update Error Code"} ::: :::Changelog{title="2.04 - 14 November 2017"} ::ChangelogItem{type="improved" description="Change url from WWW to API"} ::: :::Changelog{title="2.03 - 10 October 2017"} ::ChangelogItem{type="added" description="Add parameter cardExpYymm on Payment, Notification, and Inquiry API"} ::: :::Changelog{title="2.02 - 10 July 2017"} ::ChangelogItem{type="improved" description="Update Registration API"} ::ChangelogItem{type="improved" description="Update Notification API"} ::ChangelogItem{type="improved" description="Update Inquiry API"} ::ChangelogItem{type="improved" description="Update Credit Card Installation information API"} ::: :::Changelog{title="2.01 - 10 July 2017"} ::ChangelogItem{type="added" description="Add parameter Timestamp"} ::: :::Changelog{title="2.00 - 06 July 2017"} ::ChangelogItem{type="added" description="Initial Release API Version 2"} ::: :::Changelog{title="1.18.9 - 18 April 2018"} ::ChangelogItem{type="improved" description="Update Error Code"} ::: :::Changelog{title="1.18.5 - 1 February 2018"} ::ChangelogItem{type="added" description="Add parameter cardHolderNm on Payment API"} ::: :::Changelog{title="1.17.2 - 29 Mar 2017"} ::ChangelogItem{type="added" description="Add ClickPay Payment"} ::: :::Changelog{title="1.17.1 - 24 Mar 2017"} ::ChangelogItem{type="added" description="Add card installment API"} ::ChangelogItem{type="added" description="Add notification parameter"} ::: [title] Notification - API Paylater [path] NICEPAY API/API Non-SNAP/Payment API/API Paylater/ # Tentang API Paylater Notification *** mengirimkan *push notification* dikirim melalui `dbProcessUrl` . harus memastikan tidak melakukan Blacklist IP dan melakukan Whitelist IP untuk mendapatkan *push notification* hanya dikirim dari server . | **Request Method** | **POST****** | | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Merchant Token** | SHA256 ( `iMid`+ `tXid` + `amt`+ `merchantKey`) | | **IP** | IP Public environtment Production:
`103.20.51.34`
`103.20.51.33`
`18.98.96.50`

IP Public environtment Dev:
`103.20.51.39`
`103.20.51.40`
`18.98.96.54` | | **User-Agent** | `User-Agent: Jakarta Commons-HttpClient/3.1` | # Notification Parameter Paylater Notification *** :::hint{type="info"} Ketika diterima pada `dbProcessUrl` , kami sangat menyarankan untuk melakukan verifikasi kembali dengan menggunakan [Status Inquiry - API Paylater](docId\:r6YyG1qEKKLzWnVhazxCV). ::: | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ----------------------------------------------------------------------- | -------- | ---------- | ---------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- | | `tXid ` | N | 30 | Transaction ID | PAYLOANTES06202212141610281704 | | `merchantToken ` | AN | 255 | Token | 0716e8cbb7bac584efa98df5021543e11fab1a520415f1382572eadcca81107f | | `referenceNo ` | ANS | 40 | Order Number | ord20221214161263 | | `payMethod ` | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | 06 | | `amt ` | N | 12 | Amount | 25145 | | `goodsNm` | AN | 100 | Goods Name | Testing | | `matchCl` | N | 1 | Flag: [Notification Match Amount Indicator](docId\:WdoGjBeqc1VmRdFJqG1ZE) | Null | | `status` | A | 1 | Deposit Status:
[Notification Status Code](docId\:CdRwf99UxER6PH64ADA2C)
`0` : Deposit
`1` : Reversal | 0 | | `mitraCd` | A | 4 | [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8) | KDVI | | `transTm` | N | 6 | Transaction Time (`HH24MISS`) | 155852 | | `clientUserKey`
Mandatory if tokenize | AN | 100 | User Key, Must be Unique for Each | 1134431 | | `billingNm` | A | 100 | Buyer Name | John-Doe | | `transDt` | N | 8 | Transaction Date | 20221214 | | `currency` | A | 3 | Currency | IDR | | `tokenizeUser` | N | 1 | Transaction Tokenize Type | 1 | | `userToken` | ANS | 255 | User Token | 12345eea9-6234-6789-12r3-123re3456tt5 | # Additional Parameter for Others Payment Method Notification *** | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | | ------------- | -------- | ---------- | ------------------------------------------- | | `mitraCd` | A | 4 | [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8) | | `payNo` | N | 12 | Number | | `payValidDt` | N | 8 | Expiry Date (`YYYYMMDD`) | | `payValidTm` | N | 6 | Expiry Time (`HH24MISS`) | | `receiptCode` | ANS | 20 | Authorization Number | | `mRefNo` | AN | 18 | Reference Number | | `depositDt` | N | 8 | Deposit Date (`YYYYMMDD`) | | `depositTm` | N | 6 | Deposit Time (`HH24MISS`) | :::hint{type="warning"} *Merchant Token* diterima dari *Notification*, harus melakukan perbandingan kembali secara internal untuk mencegah palsu/tidak berlaku. **💡Contoh Kasus:** Misalnya, memiliki `merchantKey` digunakan untuk melakukan *generate *token, yaitu 1234**. **Ketika `merchantToken` di-*generate * diketahui adalah `abcd`, sementara `merchantToken` didapatkan pada adalah `abdd`, maka tersebut dianggap **palsu/tidak berlaku.** ::: ## Sample for Paylater Notification *** :::CodeblockTabs Sample POST for Paylater Notification ```none merchantToken=0716e8cbb7bac584efa98df5021543e11fab1a520415f1382572eadcca81107f goodsNm=Testing referenceNo=ord20221214161263 mitraCd=KDVI transTm=155852 tXid=PAYLOANTES06202212141610281704 amt=25145 clientUserKey=1134431 billingNm=John-Doe matchCl=null userToken=12345eea9-6234-6789-12r3-123re3456tt5 payMethod=06 tokenizeUser=1 currency=IDR transDt=20221214 status=0 ``` ::: [title] Bank BNI [path] Payment/Virtual Account (VA)/Panduan Bayar VA/ ::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/puJZgeTsd45onx60GYmx0_bni.jpg" size="50" width="500" height="500" caption="Bank BNI" position="center" darkWidth="500" darkHeight="500" showCaption="true"} :::hint{type="info"} Pastikan melakukan transfer dana sebelum masa berlaku habis dan dengan nominal tepat. ::: | **Nomor Virtual Account** | `88480XXXXXXXXXXX` | | ------------------------- | --------------------------- | | **Bank** | BNI | | **Nominal** | Rp10.000 | | **Nama Penerima** | `Merchant Name - billingNm` | | **Nomor Order** | Invoice-1234 | | **Masa Berlaku** | 16-06-2016 / 17:15:00 | file format JSON Panduan Bayar Bank BNI untuk operasi . ::File{src="https://archbee-doc-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/cgYuNrjb7XmLUAVgvcJkF_va-ind-bni.json" label="VA_IND_BNI.json"} # ATM *** 1. kartu ATM . 2. `Bahasa` ingin digunakan. 3. `PIN` ATM . 4. `Menu Lainnya`. 5. `Transfer`. 6. `Jenis Rekening` akan gunakan (contoh: Dari Rekening Tabungan). 7. `Virtual Account Billing`. 8. `Nomor Virtual Account`, misal `88480XXXXXXXXXXX` sebagai kode bayar. 9. Tagihan harus dibayarkan akan muncul pada layar konfirmasi. - Apabila tagihan sudah sesuai, silakan lanjutkan . 10. Transaksi sudah selesai. # Mobile Banking BNI *** 1. Akses `BNI Mobile Banking` dari ponsel . 2. `User ID` dan `Password` ke dalam aplikasi tersebut. 3. `Transfer`. 4. `Virtual Account Billing`. 5. `Nomor Virtual Account`, misal `88480XXXXXXXXXXX` sebagai kode bayar. 6. Tagihan harus dibayarkan akan muncul pada layar konfirmasi. - Apabila tagihan sudah sesuai, silakan lanjutkan . 7. Transaksi sudah selesai. # iBank Personal BNI *** 1. Akses *website* `https://ibank.bni.co.id` . 2. `User ID` dan `Password` ke dalam aplikasi tersebut. 3. `Transfer`. 4. `Virtual Account Billing.` 5. `Nomor Virtual Account`, misal `88480XXXXXXXXXXX` sebagai kode bayar. 6. rekening debit akan digunakan. 7. `Lanjut.` 8. Tagihan harus dibayarkan akan muncul pada layar konfirmasi. - Apabila tagihan sudah sesuai, silakan lanjutkan . 9. `Kode Autentikasi Token`. 10. Transaksi sudah selesai. # BNI SMS Banking *** 1. Buka aplikasi `SMS Banking BNI`. 2. `Transfer`. 3. `Transfer rekening BNI`. 4. `Nomor Virtual Account`, misal `88480XXXXXXXXXXX` sebagai kode bayar. 5. `Nominal` transfer sesuai tagihan. - **Nominal yang berbeda tidak dapat melanjutkan proses pembayaran.** 6. `Proses`, kemudian pilih `Setuju`. 7. Balas SMS dengan memasukkan PIN sesuai arahan. 8. Transaksi berhasil. :::hint{type="info"} Layanan ini juga dapat digunakan dengan menggunakan format SMS `TRF[SPASI]NomorVA[SPASI]NOMINAL` kemudian kirim ke `3346`. Contoh: TRF 123456789012XXXX 44000 ::: # ATM Bersama *** 1. kartu ke mesin ATM Bersama. 2. `Transaksi Lainnya`. 3. `Transfer`. 4. `Transfer ke Bank Lain`. 5. `Nomor Virtual Account`, misal `88480XXXXXXXXXXX` sebagai kode bayar. 6. `Nominal` transfer sesuai tagihan. - **Nominal yang berbeda tidak dapat melanjutkan proses pembayaran.** 7. Konfirmasi rincian akan tampil di layar. - Apabila sesuai setelah diperiksa, silakan pilih `Ya` untuk melanjutkan . 8. Transaksi berhasil. # Non-BNI *** :::hint{type="info"} Panduan bayar ini **berlaku untuk metode transfer selain BI-FAST** ::: 1. `Transfer antar Bank` atau `Transfer online antar Bank`. 2. `Nomor Virtual Account`, misal `88480XXXXXXXXXXX` sebagai kode bayar. 3. `Nominal` transfer sesuai tagihan. - **Nominal yang berbeda tidak dapat melanjutkan proses pembayaran.** 4. `jumlah pembayaran` (contoh: 44000). 5. Konfirmasi rincian akan tampil di layar. - Apabila sesuai setelah diperiksa, silakan pilih `Ya` untuk melanjutkan . 6. Transaksi berhasil. # OVO *** 1. Buka aplikasi OVO pada ponsel . 2. `Transfer`. 3. `Rekening Bank`. 4. `Nomor Virtual Account`, misal `88480XXXXXXXXXXX` sebagai kode bayar. 5. `Nominal` transfer sesuai tagihan. 6. `Transfer`. 7. Konfirmasi rincian akan tampil di layar. - Apabila sesuai setelah diperiksa, silakan pilih `Konfirmasi` untuk melanjutkan . 8. Transaksi berhasil. [title] Penyelesaian Transaksi Pada VA [path] Payment/Virtual Account (VA)/ :::hint{type="info"} Pelajari selengkapnya mengenai penyelesaian () pada [Operasi Bisnis](docId:8r87f_pn_ZI8LtKK3kq-K) > [Proses Settlement](docId\:l04EuP_s604Oi2Ib3x_y6). ::: # Settlement VA *** Proses pada VA berbeda bergantung dari model dipilih. Terdapat dua model untuk VA, yaitu *Aggregator *dan *Facilitator*. ## Facilitator Settlement VA untuk model *Facilitator *akan diselesaikan (*settle*) dari (sebagai ) kepada akun milik . ## Aggregator VA untuk model akan masuk ke akun milik (sebagai ), lalu akan menyelesaikan (*settle*) tersebut ke akun milik . # Pembatalan Transaksi VA *** Transaksi lewat metode VA tidak dapat dibatalkan dengan cara seperti pada umumnya. Untuk membatalkan dalam VA, perlu membuat kedaluwarsa (*expired*) nomor VA ingin dibatalkan. Sehingga, nomor VA tersebut tidak aktif dan tidak bisa dipakai untuk . ## Kegagalan Transaksi VA Dalam VA, terdapat dua skenario membuat gagal untuk dilakukan, antara lain: ### Nomor VA yang Kedaluwarsa Namun Terbayar Ketika nomor VA sudah kedaluwarsa akan tetapi pihak tetap menerima dana dari . Dana tersebut akan kami serahkan kepada sebagai . Kemudian, perkara ini akan diselesaikan antara dan . Untuk sendiri tidak ada berubah, yaitu **unpaid** (tidak terbayar). Hal ini terjadi pada saat melakukan rekonsiliasi data VA dari . ### Reversal VA Transaksi sudah terbayar dan tercatat di , , maupun di sisi sebagai . Akan tetapi, tiba-tiba membatalkan transaksinya karena terdapat kesalahan pada atau *timeout. *Maka dana sudah terbayar akan dikembalikan ke dan transaksinya dari sudah **paid** menjadi **reversal**. Skenario ini terjadi jika mendapatkan dari mengenai adanya *reversal* di dalam suatu . # See also ::::VerticalSplit :::VerticalSplitItem [Daftar Istilah VA](docId:2xrW5DVjK-076w2JsQvI8) untuk mengetahui istilah khusus digunakan oleh . ::: :::VerticalSplitItem [FAQ VA](docId\:n5d3A27rcZ6_ZxBN-sIIs) jika ingin mengetahui pertanyaan sering diajukan terkait . ::: :::: [title] Encryption - Payment API Credit Card [path] NICEPAY API/API Non-SNAP/Payment API/API Credit Card/Payment - API Credit Card/ # Tentang Encryption - Payment API Credit Card *** Encryption - Payment API Credit Card adalah data transaksi pembayaran Kartu Kredit yang wajib melalui proses enkripsi terlebih dahulu dari sisi Merchant. ::::hint{type="warning"} :::Iframe{iframeHeight="0" code="ℹ️ Merchant wajib menghubungi tim IT NICEPAY terlebih dahulu untuk mendapatkan Public Key agar dapat melakukan pengiriman data request melalui proses enkripsi."} ::: :::: | **API Endpoint** | `/nicepay/direct/v2/payment` | | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Request Method** | Popup, Redirect, Submit, Etc(Not Server to Server API)
Only support **POST****** | | **Description** | - The Page redirected to authentication Page(in bank side), If 3DS authentication is required. The page will be redirected to the card issuer authentication page. - Verification(in bank side) - Making the payment. - The page will be forwarded to the Callback URL. | | **Merchant Token** | SHA256(`timeStamp`+`iMid`+`referenceNo`+`amt`+`merchantKey`) | | **Request Format** | SHA256 `(publicKey)` | :::hint{type="info"} API Payment - Credit Card yang digunakan dalam metode enkripsi ini merupakan API Payment yang sama dengan fitur Kartu Kredit Full Payment & Installment, Recurring dan Preauth & Capture. Perbedaan terdapat pada parameter Data Kartu (`cardNo`,`cardExpYymm`,`cardCvv` dan `cardHolderNm`) saat Merchant perlu memberikan parameter tersebut melalui proses enkripsi terlebih dahulu ketika melakukan request payment kepada NICEPAY. ::: ## Request Parameter for Encryption - Payment API Credit Card | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ---------------------------------------------------------------------------------------- | -------- | ---------- | -------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `timeStamp`
Required | N | 14 | API Request Timestamp (`YYYYMMDDHH24MISS`) | 20221202141217 | | `tXid`
Required | AN | 30 | Transaction ID | IONPAYTEST01202212021455054652 | | `cardNo `
Required
| N | 200 | Full card number using
encrypted format & base64 url encode | n9AuywVp0Cgk7M9sJaJbWf43%2F6m
FI6xzLnqZljsimVdNAEq56p6m6Ckhyrd
cL14e5tCZlrwQzso6pVCpn%2FwgpPm
WwK%2BR0ByoPuYh%2FFwnJy%2BO
BWWLroefE7lPoXaWoSUzXw%2BQPw
MaT7VQxZnDeIs19dQ%2FE28pcgfTeD
0xDqaBdtQ%3D | | `cardExpYymm `
Required | A | 200 | Card Expiry (`YYMM`) using encrypted format & base64 url encode | q6Ye2qcjxrjUq%2B3KyCTErSf1nPu58%2FMaS4rP7qThLLEfx9FdFDYp3snj%2F
QKRzATATQBdsM3tcY5itH29yGPGn9y
MB1k19zTUGtiU9n9NflqUIW%2BCTtv
4Z0ykWFxZntBJ3YMGChmanGIADI9%
2FDUrl5pLNPvAL9Ags5xn3FfOY8RU%3
D | | `cardCvv`
Required` ` | N | 200 | Card CVV using encrypted format & base64 url encode | fPXQ8fdw1Y0tbFmDtaolUxQteh7I3RZ
qYY6%2B0g%2BWOPyKTHm5cRTq%2
BD7CYEsvlIRsVcJbzm4LgTNbFWP5rva
HkoPqIQmAZRf0CQl1UUQUYwFa%2B
NGWObg3depYbXWDpifMtwoVE7Jd3
zFp4B0Ik23Ha46B0bDvRi1zQiz%2Bx7
NwZkE%3D | | `cardHolderNm`
Required | AN | 200 | Card Holder Name using
encrypted format & base64 url encode | jY6lRWSw%2Bo9815Dx8jacPVvIjX1wi0
QiovNbIEoGwEwmKzzD92n8vVDI3Rw
XFlu2hQTFk0w6iBGlNAPROvl5uPR3%
2Fo4Gy0p3U8RJKIeUnH1qGjP7fO69N
dvV6gTwo1Ehjs0cMsIbVNyUBlBQ72b
TTkVkQzpAUGQhVQuwbwaw6hs%3D | | `recurringToken`
Only | AN | 64 | Recurring Token | 9338d54573688ae18e175240b0257d
e48d89c6ef1c9c7b5c094dc4beed9e4
35f | | `preauthToken`
nly | AN | 64 | Pre-Auth Token | 9338d54573688ae18e175240b0257d
e48d89c6ef1c9c7b5c094dc4beed9e4
35f | | `iMid`
Required | AN | 10 | Merchant ID | IONPAYTEST | | `merchantToken`
Required | AN | 255 | Token | c91e6531f6c84869439bc5ebe5389bd71e7752c054fc9dbfe193d087a1b797ae | | `callBackUrl`
Required | ANS | 255 | Result URL | https\://merchant.com/callBackUrl | | `encrypted`
Required | N | 1 | Flagging for payment
transaction use encryption or not | 1 = Using Encrypt Method
0 = Not Using | | `publicKey`
Required | AN | 64 | publicKey Hashing of your public key (SHA256) | a5f3445e7dd166b8c6cfef685047098f1a03755aeedb97a06002d7a754081338 | ## Response Parameter for Encryption - Payment API Credit Card | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ---------------- | -------- | ---------- | ----------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | | `resultCd` | N | 14 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | code of responses | | `resultMsg` | AN | 255 | Result message: [Error Code](docId\:yEh1VA9k2y6sL1kQF2aWD) | Responses message | | `tXid` | AN | 30 | Transaction ID | When success | | `referenceNo` | ANS | 40 | Order Number | When success | | `payMethod` | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | When success | | `amt ` | N | 12 | Amount | When success | | `currency` | AN | 3 | Currency | When success | | `goodsNm` | A | 100 | Goods Name | When success | | `billingNm` | A | 100 | Buyer Name | When success | | `transDt` | N | 8 | Transaction Date (`YYYYMMDD`) | When success | | `transTm` | N | 6 | Transaction Time (`HH24MISS`) | When success | | `description` | AN | 100 | Transaction Description | When success | | `authNo` | N | 10 | Approval Number | When success, CC | | `issuBankCd` | A | 4 | [Issuing Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | When success, CC | | `acquBankCd` | A | 4 | [Acquiring Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | When success, CC | | `cardNo` | ANS | 20 | Card Number with Masking | When success, CC | | `cardExpYymm` | N | 4 | Card Expiry (`YYMM`) | When success, CC | | `instmntMon` | N | 2 | Installment Month | When success, CC | | `instmntType` | N | 2 | [Installment Type Code](docId:7CIX-U_4z295XgtNVEsbO) | When success, CC | | `recurringToken` | AN | 64 | Recurring Payment Token | When Success CC Recurring | | `preauthToken` | AN | 64 | Pre-Auth Payment Token | When Success CC Pre-Auth | | `ccTransType` | N | 2 | [Credit Card Transaction Type](docId:8m3-7Smhm_jhdrE5pCRzp)
| When Success, CC

`1`: Normal
`2`: Recurring
`3`: Pre-Auth
`4`: Capture | | `Vat` | N | 12 | Vat | When Success, CC | | `Fee` | N | 12 | Service Fee | When Success, CC | | `noTaxAmt` | N | 12 | Tax-free Amount | When Success, CC | | `mitraCd` | A | 4 | Mitra Code | When success ClickPay, E-Wallet, Payloan | | `receiptCode` | ANS | 20 | Authorization Number | When success ClickPay | | `mRefNo` | AN | 18 | Bank Reference Number | When success ClickPay | | `cardBrand` | N | 2 | Card brand name | `1` = Visa
`2` = Mastercard
`3` = JCB
`4` = Amex
`5` = Others | ## Sample Parameter for Encryption - Payment API Credit Card *** ### Request Parameter :::CodeblockTabs cURL ```curl curl --location 'https://dev.nicepay.co.id/nicepay/direct/v2/payment' \ --header 'X-FORWARDED-FOR: 1.2.3.4' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --data-urlencode 'timeStamp=20210103123456' \ --data-urlencode 'tXid=BMRITEST0102201607291027025291' \ --data-urlencode 'merchantToken=b4171e8228be7a75d19ad29b509e76d5fc70a4c000ef87bc55cf0cda72767e72' \ --data-urlencode 'cardNo=n9AuywVp0Cgk7M9sJaJbWf43/6mFI6xzLnqZljsimVdNAEq56p6m6CkhyrdcL14e5tCZlrwQzso6pVCpn/wgpPmWwK+R0ByoPuYh/FwnJy+OBWWLroefE7lPoXaWoSUzXw+QPwMaT7VQxZnDeIs19dQ/E28pcgfTeD0xDqaBdtQ=' \ --data-urlencode 'cardExpYymm=q6Ye2qcjxrjUq+3KyCTErSf1nPu58/MaS4rP7qThLLEfx9FdFDYp3snj/QKRzATATQBdsM3tcY5itH29yGPGn9yMB1k19zTUGtiU9n9NflqUIW+CTtv4Z0ykWFxZntBJ3YMGChmanGIADI9/DUrl5pLNPvAL9Ags5xn3FfOY8RU=' \ --data-urlencode 'cardCvv=fPXQ8fdw1Y0tbFmDtaolUxQteh7I3RZqYY6+0g+WOPyKTHm5cRTq+D7CYEsvlIRsVcJbzm4LgTNbFWP5rvaHkoPqIQmAZRf0CQl1UUQUYwFa+NGWObg3depYbXWDpifMtwoVE7Jd3zFp4B0Ik23Ha46B0bDvRi1zQiz+x7NwZkE=' \ --data-urlencode 'cardHolderNm=jY6lRWSw+o9815Dx8jacPVvIjX1wi0QiovNbIEoGwEwmKzzD92n8vVDI3RwXFlu2hQTFk0w6iBGlNAPROvl5uPR3/o4Gy0p3U8RJKIeUnH1qGjP7fO69NdvV6gTwo1Ehjs0cMsIbVNyUBlBQ72bTTkVkQzpAUGQhVQuwbwaw6hs=' \ --data-urlencode 'recurringToken=' \ --data-urlencode 'publicKey=0caa334154789c7b07eda32db6e450acce722dde2c3cb0582eba2fe855e67a4d' \ --data-urlencode 'encrypted=1' \ --data-urlencode 'preauthToken=' \ --data-urlencode 'clickPayNo=' \ --data-urlencode 'dataField3=' \ --data-urlencode 'clickPayToken=' \ --data-urlencode 'callBackUrl=https://dev.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp?order_id=BMRITEST0102201607291027025291' ``` ::: ### Response Parameter :::CodeblockTabs Sample Response ```html
``` ::: [title] Registration - API Direct Debit [path] NICEPAY API/API Non-SNAP/Payment API/API Direct Debit/ # Tentang API Direct Debit Registration *** menyediakan sebagai fitur . didukung : 1. Jenius Pay. :::hint{type="info"} Namun, terdapat perbedaan khusus untuk Jenius, yaitu terletak pada tambahan di Parameter *Request *dan untuk *request staging* di Jenius dilakukan melalui HTTPS. ::: API for Direct Debit Registration *** | **API Endpoint** | `/nicepay/direct/v2/registration ` | | ------------------ | ------------------------------------------------------------ | | **Request Method** | ******POST****** | | **Description** | Performs Transaction Regist to NICEPAY | | **Merchant Token** | SHA256(`timeStamp`+`iMid`+`referenceNo`+`amt`+`merchantKey`) | | **Request Format** | `application/json` | ## Request Parameter for Direct Debit Registration *** Berikut ini adalah daftar untuk melakukan *request *registrasi . Parameter ini digunakan melalui platform pengujian sebagai salah satu tahapan supaya milik dapat terhubung dengan dari . | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ------------------------------------------------------------------------------------ | ------------------ | ---------- | ---------------------------------------------------------------------------------------- | --------------------------------------------------------------------- | | `timeStamp `
Required | N | 14 | Request Timestamp (`YYYYMMDDHH24MISS`) | 20221212155200 | | `iMid `
Required | AN | 10 | ID
| IONPAYTEST | | `payMethod `
Required | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok)
| 04 | | `currency `
Required | A | 3 | Currency
| IDR | | `amt `
Required | N | 12 | Amount
| 5000 | | `referenceNo`
Required | ANS | 40 | 's Reference Number
| order20221212155200 | | `goodsNm`
Required | AN | 100 | Goods Name
| Test Transaction | | `billingNm `
Required | A | 100 | Buyer Name
| John Doe | | `billingPhone`
Required | N | 15 | Buyer Phone Number
| 081214714045 | | `billingEmail`
Required | ANS | 40 | Buyer E-Mail
| email\@merchant.com | | `billingAddr`
Required | AN | 100 | Buyer Address
| Jalan Bukit Berbunga 22 | | `billingCity`
Required | A | 50 | Buyer City
| Jakarta | | `billingState`
Required | A | 50 | Billing State
| DKI Jakarta | | `billingPostCd`
Required | N | 10 | Billing Post Number
| 12345 | | `billingCountry`
Required | A | 10 | Billing Country
| | | `cartData`
Required | `JSONstring`
| 4000 | Cart Data
| \{} | | `sellers` | `JSON String` | 4000 | Seller Data | | | `instmntType` | N | 2 | [Installment Type Code](docId:7CIX-U_4z295XgtNVEsbO) | 2 | | `instmntMon`
Required for CC | N | 2 | Installment Month | 1 | | `recurrOpt` | N | 2 | `0`: Automatic Cancel
`1`: Do Not Cancel
`2`: Do Not Make Token | 0 | | `bankCd` | A | 4 | [Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | - | | `vacctValidDt` | N | 8 | VA Expiry Date (`YYYYMMDD`) | 20200303 | | `vacctValidTm` | N | 6 | VA Expiry Time (`HH24MISS`) | - | | `merFixAcctId` | AN | 40 | Reserved VA ID | - | | `mitraCd` | A | 4 | [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8) | JENC | | `userIP` | AN | 15 | User IP | 127.0.0.1 | | `dbProcessUrl`
Required | ANS | 255 | Notification URL
| https\://merchant.com/dbProcessUrl | | `merchantToken`
Required | AN | 255 | Token | 6cfccfc0046773c1b589d8e98f8b596c284f3c70a4ecf86eba14c18944b74bcd | | `deliveryNm` | A | 30 | Delivery Name | dobleh\@merchant.com | | `deliveryPhone` | N | 15 | Delivery Phone | 081214714045 | | `deliveryAddr` | AN | 100 | Delviery Address | Jalan Bukit Berbunga 22 | | `deliveryCity` | A | 50 | Delivery City | Jakarta | | `deliveryState` | A | 50 | Delivery State | DKI Jakarta | | `deliveryPostCd` | N | 10 | Delivery Post Code | 12345 | | `deliveryCountry` | A | 10 | Delivery Country | | | `vat` | N | 12 | Vat | 0 | | `fee` | N | 12 | Service Fee | 0 | |  `notaxAmt` | N | 12 | Tax Free Amount | - | | `description` | AN | 100 | Transaction Description | Testing | | `merchantToken` | AN | 255 | Token | 0dd1393f41bccbc33ed82cb514138aa5a46c24a6e55730868d264f3d80fb4fc1 | | `reqDt` | N | 8 | Request Date (`YYYYMMDD`) | - | | `reqTm` | N | 6 | Request Time (`HH24MISS`) | - | | `reqDomain` | ANS | 100 | Request Domain | merchant.com
| | `reqServerIP` | ANS | 15 | Request Server IP | 127.0.0.1 | | `userIP`
Required | AN | 15 | User IP Address | 127.0.0.1 | | `reqClientVer` | ANS | 50 | Client Version | 1.0
| | `userSessionID` | AN | 100 | User Session ID | userSessionID | | `userAgent` | ANS | 100 | User Agent | Mozilla | | `userLanguage` | A | 2 | User Language | en-US
| | `shopId` | AN | 32 | Shop ID | NICEPAY | | `userAgent`
Required | ANS | 100 | User Agent Information | Mozilla | | `recurrOpt`
| N | 2 | `0`: Automatic Cancel
`1`: Do Not Cancel
`2`: Do Not Make Token | 2 | :::hint{type="info"} kunjungi [Direct Debit](docId\:uNFXkAwzKTCzlss__2PUt) untuk mempelajari umum mengenai . ::: Additional Information Request for Direct Debit Registration *** Parameter di bawah berisi tambahan mengenai Registrasi . | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ------------------------------------------------------ | -------- | ---------- | ---------------------------------------------------------- | -------------------- | | `payMethod`
Required | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok)
| 04 | | `mitraCd`
Required | A | 4 | [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8)
| JENC | | `mRefNo`
Required | AN | 18 | Jenius Reference Number | | ## Response Parameter for Direct Debit Registration *** Berikut ini adalah daftar *response * dari request *registrasi *pada . | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | --------------------------------------- | -------- | ---------- | ----------------------------------------------------------- | ------------------------------ | | `resultCd` | N | 14 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | 0000 | | `resultMsg`
| AN | 255 | Result Message: [Error Code](docId\:yEh1VA9k2y6sL1kQF2aWD) | SUCCESS | | `tXid`
| AN | 30 | Transaction ID | IONPAYTEST04202212121554299694 | | `referenceNo` | ANS | 40 | Reference Number | order20221212155200 | | `payMethod` | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | 04 | | `amt` | N | 12 | Amount | 5000 | | `transDt` | N | 8 | Transaction Date (`YYYYMMDD`) | 20221212 | | `transTm` | N | 6 | Transaction Time (`HH24MISS`) | 155431 | | `description` | AN | 100 | Description | Testing | | `bankCd` | AN | 4 | [Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | null | | `vacctNo` | N | 20 | VA Number | null | | `mitraCd` | AN | 4 | [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8) | JENC | | `payNo` | N | 12 | Number | null | | `currency` | A | 3 | Currency | null | | `goodsNm` | AN | 100 | Goods Name | null | | `billingNm` | A | 100 | Buyer Name | null | | `vacctValidDt` | N | 8 | VA Expiry Date (`YYYYMMDD`) | null | | `vacctValidTm` | N | 6 | VA Expiry Time (`HH24MISS`) | null | | `payValidDt` | N | 8 | Expiry Date (`YYYYMMDD`) | null | | `payValidTm ` | N | 6 | Expiry Time (`HH24MISS`) | null | | `requestURL` | ANS | 360 | Request URL | null | | `paymentExpDt` | N | 8 | QR Expiry Date (`YYYYMMDD`) | null | | `paymentExpTm` | N | 6 | QR Expiry Time (`HH24MISS`) | null | | `qrContent` | ANS | 360 | QR String in Plain Text | null | | `qrUrl` | ANS | 360 | URL for QR Image, Valid for 5 minutes | null | ## Sample JSON for Direct Debit Registration *** :::CodeblockTabs JSON Request ```json { "timeStamp":"20221212155200", "iMid":"IONPAYTEST", "payMethod":"04", "currency":"IDR", "amt":"5000", "referenceNo":"order20221212155200", "goodsNm":"Test Transaction Nicepay", "billingNm":"John Doe", "billingPhone":"081214714045", "billingEmail":"email@merchant.com", "billingAddr":"Jalan Bukit Berbunga 22", "billingCity":"Jakarta", "billingState":"DKI Jakarta", "billingPostCd":"12345", "billingCountry":"Indonesia", "deliveryNm":"Jhon D", "deliveryPhone":"081214714045", "deliveryAddr":"Jalan Bukit Berbunga 22", "deliveryCity":"Jakarta", "deliveryState":"DKI Jakarta", "deliveryPostCd":"12345", "deliveryCountry":"Indonesia", "dbProcessUrl":"https://ptsv2.com/t/test-nicepay-v2", "vat":"", "fee":"", "notaxAmt":"", "description":"Testing", "merchantToken":"0dd1393f41bccbc33ed82cb514138aa5a46c24a6e55730868d264f3d80fb4fc1", "reqDt":"", "reqTm":"", "reqDomain":"merchant.com", "reqServerIP":"127.0.0.1", "reqClientVer":"", "userIP":"127.0.0.1", "userSessionID":"697D6922C961070967D3BA1BA5699C2C", "userAgent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML,like Gecko) Chrome/60.0.3112.101 Safari/537.36", "userLanguage":"ko-KR,en-US;q=0.8,ko;q=0.6,en;q=0.4", "cartData":"{\"count\":\"1\",\"item\":[{\"img_url\":\"http://img.aaa.com/ima1.jpg\",\"goods_name\":\"Sepatu\",\"goods_detail\":\"Item 1 Detail\",\"goods_amt\":\"10000\",\"goods_quantity\":\"2\"}]}", "sellers": "[{\"sellersId\":\"NICEPAY-NamaMerchant\",\"sellersNm\":\"NICEPAYSHOP\",\"sellersUrl\":\"http://nicestore.store/product/beanie/\",\"sellersEmail\":\"Nicepay@nicepay.co.id\",\"sellersAddress\":{\"sellerNm\":\"NICEPAYSHOP\",\"sellerLastNm\":\"NICEPAYSHOP\",\"sellerAddr\":\"Jln. Kasablanka Kav 88\",\"sellerCity\":\"Jakarta\",\"sellerPostCd\":\"14350\",\"sellerPhone\":\"082111111111\",\"sellerCountry\":\"ID\"}}]", "instmntType":"2", "instmntMon":"1", "recurrOpt":"0", "bankCd":"", "vacctValidDt":"", "vacctValidTm":"", "merFixAcctId":"", "mitraCd":"JENC" } ``` JSON Response ```json { "resultCd": "0000", "resultMsg": "SUCCESS", "tXid": "IONPAYTEST04202212121554299694", "referenceNo": "order20221212155200", "payMethod": "04", "amt": "5000", "transDt": "20221212", "transTm": "155431", "description": "Testing", "bankCd": null, "vacctNo": null, "mitraCd": "JENC", "payNo": null, "currency": null, "goodsNm": null, "billingNm": null, "vacctValidDt": null, "vacctValidTm": null, "payValidDt": null, "payValidTm": null, "requestURL": null, "paymentExpDt": null, "paymentExpTm": null, "qrContent": null, "qrUrl": null } ``` Java Request ```java //Clickpay Registration// nicePay.setTimeStamp("20180123100505"); nicePay.setiMid("IONPAYTEST"); nicePay.setPayMethod("04"); nicePay.setCurrency("IDR"); nicePay.setAmt("5000"); nicePay.setReferenceNo("ORD54321"); nicePay.setMerchantToken(nicePay.makeToken(nicePay.getMerchantToken()); nicePay.setGoodsNm("Test Transaction Nicepay"); nicePay.setBillingNm("John Doe"); nicePay.setBillingPhone("081234567890"); nicePay.setBillingEmail("email@merchant.com"); nicePay.setBillingAddr("Jln. Raya Kasablanka Kav.88"); nicePay.setBillingCity("South Jakarta"); nicePay.setBillingState("DKI Jakarta"); nicePay.setBillingCountry("Indonesia"); nicePay.setBillingPostCd("12800"); nicePay.setDbProcessUrl("https://ptsv2.com/t/rizal/post"); nicePay.setMirtaCd("JENC"); nicePay.setCardData("{\"count\":1,\"item\":[{\"img_url\":\"http:\\\/\\\/www.jamgora.com\\\/media\\\/avatar\\\/noimage.png\",\"goods_name\":\"Hoodie\",\"goods_detail\":\"Hoodie\",\"goods_amt\":\"5\"}]}"); nicePay.setPayValidDt("20231101"); nicePay.setPayValidTm("190000"); // Request Clickpay Registration nicePay.qrisRegist(); // Response String // System.out.println("Final Response String : " + nicePay.getResponseString()); String resultCd = nicePay.Get("resultCd"); String resultMsg = nicePay.Get("resultMsg"); String tXid = nicePay.Get("tXid"); String referenceNo = nicePay.Get("referenceNo"); String payMethod = nicePay.Get("payMethod"); String amt = nicePay.Get("amt"); String transDt = nicePay.Get("transDt"); String transTm = nicePay.Get("transTm"); ``` ::: [title] Inquiry SMS [path] NICEPAY API/API Messaging/SMS API/ # Tentang Inquiry SMS *** ini digunakan untuk memeriksa transmisi menggunakan `InquiryMms` (hanya untuk transmisi berhasil). # Specification for Inquiry SMS *** | **API url** | `/nicepay/direct/v2/sms-check-status` | | ------------------- | --------------------------------------------------------------------------------- | | **Request Method** | **POST** , **JSON****** | | **Merchant Token** | SHA256 (`timestamp`+ `iMid`+ `tXid`+ `merchantKey`) | ## Request Parameter for Inquiry SMS *** | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ---------------------------------------------------------- | -------- | ---------- | -------------- | ---------------------------------------------------------------- | | `timeStamp`
Required | N | 14 | Request Date | 20221219110059 | | `tXid`
Required | AN | 30 | Transaction ID | IONPAYTEST10202212191102221919 | | `iMid`
Required | AN | 10 | ID | IONPAYTEST | | `msgRefno`
Required | ANS | 40 | Order Number | MSG-20221219110053 | | `merchantToken`
Required | AN | 255 | Token | e14233565538732e4273338e8b9ac36618028ffce810747913cd5e39b3fee4f9 | ## Response Parameter for Inquiry SMS *** :::hint{type="warning"} *Response Objects* dapat ditambahkan tanpa pemberitahuan terlebih dahulu. ::: | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ------------- | -------- | ---------- | ------------------------------------------------------------- | ------------------------------------------------------ | | `resultCd` | N | 4 | Result Code:
[Error Code](docId\:JKO_1O-kS-XzfZAqPwNIN) | 0000 | | `resultMsg` | AN | 255 | Result Message: [Error Code](docId\:JKO_1O-kS-XzfZAqPwNIN) | SUCCESS | | `tXid` | AN | 30 | Transaction ID (Key from ) | IONPAYTEST10202212191102221919

When Success | | `transDt` | N | 8 | Transmission Date | 20221219 | | `transTm` | N | 6 | Transmission Time | 110222 | | `msgRefno` | ANS | 40 | Order Number (Key from ) | MSG-20221219110059 | | `recipientNo` | N | 16 | Receiver Phone Number | 081294529025 or 6281294529025

When Success | | `msgStatus` | N | 2 | [Transmission Status Code](docId:0dccdS0W5z7yNa0JULSsu) | 00 | ## Sample JSON for Inquiry SMS *** :::CodeblockTabs Java Request ```java requestMap.put("timeStamp", "20221219110059"); requestMap.put("tXid", "IONPAYTEST10202212191102221919"); requestMap.put("iMid", "IONPAYTEST"); requestMap.put("msgRefno", "MSG-20221219110053"); requestMap.put("merchantToken", "e14233565538732e4273338e8b9ac36618028ffce810747913cd5e39b3fee4f9"); ``` JSON Request ```json { "timeStamp":"20221219110059", "msgRefno":"MSG-20221219110059", "iMid":"IONPAYTEST", "tXid":"IONPAYTEST10202212191102221919", "merchantToken":"e14233565538732e4273338e8b9ac36618028ffce810747913cd5e39b3fee4f9" } ``` JSON Response ```json { "resultCd": "0000", "resultMsg": "SUCCESS", "tXid": "IONPAYTEST10202212191102221919", "transDt": "20221219", "transTm": "110222", "msgRefno": "MSG-20221219110059", "recipientNo": "081294529025", "msgStatus": "00" } ``` ::: # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [SMS Transmit](docId:0GwdGdsFm3-FGBHjsK7PO) untuk mengetahui rincian digunakan saat mengirim pesan. ::: :::VerticalSplitItem [Notification SMS](docId\:hcRdbFh-9v_6do48MShRg) untuk mengetahui rincian digunakan saat mengirimkan . ::: :::: [title] NICEPAY Service Status API - Advance API [path] NICEPAY API/API Non-SNAP/Advance API/ # Tentang NICEPAY Service Status API - Advance API *** Service Status Request digunakan oleh untuk memeriksa dari . ini membantu dan tim untuk memantau setiap dan mengetahui rincian *incident * pada . harus mendaftarkan terlebih dahulu sebelum menggunakan ini. ::::hint{type="info"} :::Iframe{iframeHeight="0" code=" Silakan menghubungi Marketing NICEPAY untuk informasi dan bantuan lebih lanjut."} ::: :::: # NICEPAY Service Status Request API *** | **API Endpoint** | `/nicepay/api/serviceStatus.do` | | ------------------ | -------------------------------------- | | **Request Method** | **POST** | | **Description** | Check Service Status | | **Merchant Token** | SHA256(`iMid`+`merchantKey`) | | **Request Format** | `application/json` | ## Request Parameter for NICEPAY Service Status Request *** | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh/Catatan** | | ----------------------------------------------------------- | -------- | ---------- | ------------- | ---------------------------------------------------------------- | | `merchantToken`
Required | AN | 255 | Token | 141fd2368aa80ea0e600b1b4d7a42c1e731e74a27a03521e8e28150cc00bc05b | | `iMid`
Required | AN | 10 | ID | IONPAYTEST
| ## Response Parameter for NICEPAY Service Status Request *** | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh/Catatan** | | ------------------ | -------- | ---------- | -------------------- | ---------------------------------------------------------------------- | | `payMethod`
| Array | - | Method | \{}

and are still on maintenance, other s are available | | `message` | A | 255 | Status message | not fully operational
| | `Date` | N | 30 | Date Time check | 20180703170410 | | `incidentDetail` | Array | - | If service have down | \[\{}] | ## Sample Parameter for NICEPAY Service Status Request *** :::CodeblockTabs Sample Source ```java HashMap < String,Object > requestMap = new HashMap < String, Object > (); requestMap.put(“iMid”, ”nicePay.get(iMid)”); requestMap.put(“merchantToken”, nicePay, makeToken(nicePay.get(iMid)) try { //Make json ObjectMapper mapper = new ObjectMapper(); String contents = mapper.writeValueAsString(requestMap); URL url = new URL(myDomain + "/nicepay/serviceStatus.do"); URLConnection conn = url.openConnection(); conn.setDoOutput(true); conn.setUseCaches(false); conn.setRequestProperty("Content-Type", "application/json"); DataOutputStream os = null; try { os = new DataOutputStream(conn.getOutputStream()); os.writeBytes(contents); os.flush(); } finally { if (out != null) os.close(); } InputStreamReader isr = new InputStreamReader(conn.getInputStream(), "UTF-8"); BufferedReader br = new BufferedReader(isr); String str = ""; resultData = ""; while ((str = br.readLine()) != null) { resultData += str; } br.close(); } catch(MalformedURLException e) { System.out.println("The URL address is incorrect."); e.printStackTrace(); } catch(Exception e) { System.out.println("It can't connect to the web page."); e.printStackTrace(); } ``` Request Parameter ```json { "iMid": "IONPAYTEST", "merchantToken": "d7d5f4873a588bf7199dfd570ce82818e5981df2f5bab9637a943743fc999e9d" } ``` Response Parameter - Positive Case ```json { "payMethod": { "01": [ { "bankCd": "BMRI", "status": "UP" }, { "bankCd": "IBBK", "status": "UP" }, { "bankCd": "BNIN", "status": "UP" }, { "bankCd": "BRIN", "status": "UP" } ], "02": [ { "bankCd": "BMRI", "status": "UP" }, { "bankCd": "IBBK", "status": "UP" }, { "bankCd": "BBBA", "status": "UP" }, { "bankCd": "CENA", "status": "UP" }, { "bankCd": "BNIN", "status": "UP" }, { "bankCd": "HNBN", "status": "UP" }, { "bankCd": "BNIA", "status": "UP" }, { "bankCd": "BRIN", "status": "UP" }, { "bankCd": "BDIN", "status": "UP" } ], "03": [ { "mitraCd": "ALMA", "status": "UP" }, { "mitraCd": "INDO", "status": "UP" }, { "mitraCd": "LOSN", "status": "UP" }, { "mitraCd": "ALMI", "status": "UP" }, { "mitraCd": "DNDN", "status": "UP" } ], "04": [ { "mitraCd": "CMIC", "status": "UP" }, { "mitraCd": "BCAC", "status": "UP" }, { "mitraCd": "MDRC", "status": "UP" } ], "05": [ { "mitraCd": "BMRE", "status": "UP" } ], "06": [ { "mitraCd": "KDV", "status": "UP" } ] }, "message": "NICEPay full operational", "Date": "20180703163639" } ``` Response Parameter - Negative Case ```json { "incidentDetail": [ { "incidentTitle": "Ini hanya testing", "incidentId": "MNT20180706001", "incidentDesc": "masih testing" }, { "incidentTitle": "Test Maintenance", "incidentId": "MNT20180925001", "incidentDesc": "Sorry For Disturb, We are testing For Our new Fiture" }, { "incidentTitle": "BNI already UP", "incidentId": "INC20180628001", "incidentDesc": "BNI host is UP, but others still intermittence" }, { "incidentTitle": "[IGNORE] - This is just for testing", "incidentId": "INC20190325001", "incidentDesc": "[IGNORE] - This is just for testing" }, { "incidentTitle": "[IGNORE] - This is just for testing2", "incidentId": "MNT20190325001", "incidentDesc": "[IGNORE] - This is just for testing2" } ], "payMethod": { "01": [ { "bankCd": "BMRI", "incidentId": "MNT20180925001", "status": "DOWN" }, { "bankCd": "IBBK", "status": "UP" }, { "bankCd": "BNIN", "incidentId": "MNT20180925001", "status": "DOWN" }, { "bankCd": "BRIN", "status": "UP" } ], "02": [ { "bankCd": "BMRI", "incidentId": "MNT20180925001", "status": "DOWN" }, { "bankCd": "IBBK", "status": "UP" }, { "bankCd": "BBBA", "status": "UP" }, { "bankCd": "CENA", "incidentId": "INC20180628001", "status": "DOWN" }, { "bankCd": "BNIN", "status": "UP" }, { "bankCd": "HNBN", "status": "UP" }, { "bankCd": "BNIA", "status": "UP" }, { "bankCd": "BRIN", "status": "UP" }, { "bankCd": "BDIN", "status": "UP" } ], "03": [ { "mitraCd": "ALMA", "status": "UP" }, { "mitraCd": "INDO", "status": "UP" }, { "mitraCd": "LOSN", "status": "UP" }, { "mitraCd": "ALMI", "status": "UP" }, { "mitraCd": "DNDN", "status": "UP" } ], "04": [ { "mitraCd": "CMIC", "status": "UP" }, { "mitraCd": "BCAC", "status": "UP" }, { "mitraCd": "MDRC", "status": "UP" } ], "05": [ { "mitraCd": "BMRE", "status": "UP" } ], "06": [ { "mitraCd": "KDV", "status": "UP" } ] }, "message": "NICEPay not fully operational", "Date": "20250516145427" } ``` ::: [title] Registration - API Convenience Store [path] NICEPAY API/API Non-SNAP/Payment API/API Convenience Store/ # Tentang API Convenience Store Registration *** menyediakan Toserba (Indomaret dan Alfamart Group) sebagai sehingga dapat melakukan melalui gerai-gerai Toserba di Seluruh . Notifikasi *real-time* secara langsung akan dikirimkan ketika berhasil. Toserba : 1. Alfamart 2. Indomaret 3. Lawson 4. Alfamidi 5. Dan+Dan Store # API Convenience Store Registration *** ini digunakan untuk mengaktifkan pada , sehingga dapat melakukan menggunakan dengan . Tahapan ini digunakan untuk mengintegrasikan dari dengan dari . | **API Endpoint** | `/nicepay/direct/v2/registration` | | ------------------ | ------------------------------------------------------------ | | **Request Method** | ******POST****** | | **Description** | Performs Transaction Regist to | | **Merchant Token** | SHA256(`timeStamp`+`iMid`+`referenceNo`+`amt`+`merchantKey`) | | **Request Format** | `application/json ` | :::hint{type="info"} kunjungi [NICEPAY Code](docId\:kYd45uYYIjwzVs3dt8_rk) untuk mengetahui daftar istilah kode berhubungan dengan . ::: ## Request Parameter for Convenience Store Registration *** Berikut ini adalah daftar untuk melakukan *request* registrasi . Parameter ini digunakan melalui platform pengujian sebagai salah satu tahapan supaya milik dapat terhubung dengan dari . | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ----------------------------------------------------------------------------------- | ------------ | ---------- | ---------------------------------------------------- | --------------------------------------------------------------------- | | `timeStamp`
Required | N | 14 | Request Timestamp (`YYYYMMDDHH24MISS`) | 20221202152801 | | `iMid`
Required | AN | 10 | ID
| IONPAYTEST | | `payMethod`
Required | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | 03 | | `currency`
Required | A | 3 | Currency
| IDR | | `amt`
Required | N | 12 | Amount
| 5000 | | `referenceNo`
Required | ANS | 40 | 's Reference Number
| Order12345 | | `goodsNm `
Required | AN | 100 | Goods Name | Test Transaction | | `billingNm`
Required | A | 100 | Buyer Name
| John Doe | | `billingPhone `
Required | N | 15 | Buyer Phone Number
| 081214714045 | | `billingEmail `
Required | ANS | 40 | Buyer E-Mail
| email\@merchant.com | | `billingAddr `
Required | AN | 100 | Buyer Address
| Jalan Bukit Berbunga 22 | | `billingCity `
Required | A | 50 | Buyer City
| Jakarta | | `billingState `
Required | A | 50 | Billing State
| DKI Jakarta | | `billingPostCd `
Required | N | 10 | Billing Post Number
| 12345 | | `billingCountry `
Required | A | 10 | Billing Country
| | | `cartData` | `JSONstring` | 4000 | Cart Data | | | `mitraCd`
Required | A | 4 | [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8)
| ALMA | | `userIP ` | AN | 15 | User IP | 127.0.0.1 | | `dbProcessUrl`
Required | ANS | 255 | Notification URL | https\://ptsv2.com/t/test-nicepay-v2 | | `merchantToken`
Required
| AN | 255 | Token
| fa79a58a73bf9f6d07ce84daaabb8f23da6ca61d478d4e917d2e259d5c7e1106 | | `deliveryNm` | A | 30 | Delivery Name | @merchant.com | | `deliveryPhone` | N | 15 | Delivery Phone | 12345678 | | `deliveryAddr` | AN | 100 | Delivery Address | Jalan Bukit Berbunga 22 | | `deliveryCity` | A | 50 | Delivery City | Jakarta | | `deliveryState` | A | 50 | Delivery State | DKI Jakarta | | `deliveryPostCd` | N | 10 | Delivery Post Code | 12345 | | `deliveryCountry` | A | 10 | Delivery Country | | | `description` | AN | 100 | Transaction Description | - | | `reqDomain` | ANS | 100 | Request Domain | merchant.com | | `reqServerIP` | ANS | 15 | Request Server IP | 127.0.0.1 | | `reqClientVer` | ANS | 50 | Client Version | - | | `userSessionID` | AN | 100 | User Session ID | 697D6922C961070967D3BA1BA5699C2C | :::hint{type="info"} kunjungi [Convenience Store (CVS)](docId\:lyQ0ppG9p7aGo6vQwvTp5) untuk mempelajari umum mengenai . ::: ## Additional Information Request for Convenience Store Registration *** Parameter di bawah berisi tambahan mengenai Registrasi . | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ------------------------------------------------------- | -------- | ---------- | --------------------------------------------------- | -------------------- | | `payMethod`
Required | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | 03 | | `mitraCd`
Required | A | 4 | ID
| IONPAYTEST | | `payValidDt`
Required | N | 8 | CVS Expiry Date (`YYYYMMDD`) | 20221212 | | `payValidTm`
Required | N | 6 | CVS Expiry Time (`HH24MISS`) | 201012 | ## Response Parameter for Convenience Store Registration *** Berikut ini adalah daftar *response* dari *request* inquiry pada . | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | --------------------------------------- | -------- | ---------- | ----------------------------------------------------------- | ------------------------------ | | `resultCd ` | N | 14 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | 0000 | | `resultMsg `
| AN | 255 | Result Message: [Error Code](docId\:yEh1VA9k2y6sL1kQF2aWD) | SUCCESS | | `tXid` | AN | 30 | Transaction ID | IONPAYTEST03202212021529034686 | | `referenceNo` | ANS | 40 | Reference Number | Order12345 | | `payMethod` | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | 03 | | `amt` | N | 12 | Amount | 5000 | | `transDt` | N | 8 | Transaction Date (`YYYYMMDD`) | 20221202 | | `transTm` | N | 6 | Transaction Time (`HH24MISS`) | 152903 | | `description` | AN | 100 | Description | null | | `bankCd` | AN | 4 | [Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | null | | `vacctNo` | N | 20 | VA Number | null | | `mitraCd` | AN | 4 | [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8) | ALMA | | `payNo` | N | 12 | Number | 9041021529034686 | | `currency` | AN | 3 | Currency | null | | `goodsNm` | AN | 100 | Goods Name | null | | `billingNm` | A | 100 | Buyer Name | null | | `vacctValidDt` | N | 8 | VA Expiry Date (`YYYYMMDD`) | null | | `vacctValidTm` | N | 6 | VA Expiry Time (`HH24MISS`) | null | | `payValidDt` | N | 8 | Expiry Date (`YYYYMMDD`) | null | | `payValidTm ` | N | 6 | Expiry Time (`HH24MISS`) | null | | `requestURL` | ANS | 360 | Request URL | null | | `paymentExpDt` | N | 8 | QR Expiry Date (`YYYYMMDD`) | null | | `paymentExpTm` | N | 6 | QR Expiry Time (`HH24MISS`) | null | | `qrContent` | ANS | 360 | QR String in Plain Text | null | | `qrUrl` | ANS | 360 | URL for QR Image, Valid for 5 minutes | null | ## Sample JSON for Convenience Store Registration *** :::CodeblockTabs JSON Request ```json { "timeStamp":"20221202152801", "iMid":"IONPAYTEST", "payMethod":"03", "currency":"IDR", "amt":"5000", "referenceNo":"Order12345", "goodsNm":"Test Transaction Nicepay", "billingNm":"John Doe", "billingPhone":"081214714045", "billingEmail":"email@merchant.com", "billingAddr":"Jalan Bukit Berbunga 22", "billingCity":"Jakarta", "billingState":"DKI Jakarta", "billingPostCd":"12345", "billingCountry":"Indonesia", "deliveryNm":"Customer@merchant.com", "deliveryPhone":"12345678", "deliveryAddr":"Jalan Bukit Berbunga 22", "deliveryCity":"Jakarta", "deliveryState":"DKI Jakarta", "deliveryPostCd":"12345", "deliveryCountry":"Indonesia", "dbProcessUrl":"https://ptsv2.com/t/test-nicepay-v2", "description":"", "merchantToken":"fa79a58a73bf9f6d07ce84daaabb8f23da6ca61d478d4e917d2e259d5c7e1106", "reqDt":"", "reqTm":"", "reqDomain":"merchant.com", "reqServerIP":"127.0.0.1", "reqClientVer":"", "userIP":"127.0.0.1", "userSessionID":"697D6922C961070967D3BA1BA5699C2C", "mitraCd":"ALMA" } ``` JSON Response ```json { "resultCd": "0000", "resultMsg": "SUCCESS", "tXid": "IONPAYTEST03202212021529034686", "referenceNo": "Order12345", "payMethod": "03", "amt": "5000", "transDt": "20221202", "transTm": "152903", "description": null, "bankCd": null, "vacctNo": null, "mitraCd": "ALMA", "payNo": "9041021529034686", "currency": null, "goodsNm": null, "billingNm": null, "vacctValidDt": null, "vacctValidTm": null, "payValidDt": "20221209", "payValidTm": "235959", "requestURL": null, "paymentExpDt": null, "paymentExpTm": null, "qrContent": null, "qrUrl": null } ``` Java Request ```java //CSV Registration// nicePay.setTimeStamp("20180123100505"); nicePay.setiMid("IONPAYTEST"); nicePay.setPayMethod("03"); nicePay.setCurrency("IDR"); nicePay.setAmt("5"); nicePay.setReferenceNo("ORD54321"); nicePay.setMerchantToken(nicePay.makeToken(nicePay.getMerchantToken()); nicePay.setGoodsNm("Test Transaction Nicepay"); nicePay.setBillingNm("Andi pamungkas"); nicePay.setBillingPhone("081234567890"); nicePay.setBillingEmail("email@merchant.com"); nicePay.setBillingAddr("Jln. Raya Kasablanka Kav.88"); nicePay.setBillingCity("South Jakarta"); nicePay.setBillingState("DKI Jakarta"); nicePay.setBillingCountry("Indonesia"); nicePay.setBillingPostCd("12800"); nicePay.setDbProcessUrl("https://ptsv2.com/t/rizal/post"); nicePay.setMirtaCd("ALMA"); nicePay.setCardData("{\"count\":1,\"item\":[{\"img_url\":\"http:\\\/\\\/www.jamgora.com\\\/media\\\/avatar\\\/noimage.png\",\"goods_name\":\"Hoodie\",\"goods_detail\":\"Hoodie\",\"goods_amt\":\"5\"}]}"); nicePay.setPayValidDt("20231101"); nicePay.setPayValidTm("190000"); // Request CSV Registration nicePay.qrisRegist(); // Response String // System.out.println("Final Response String : " + nicePay.getResponseString()); String resultCd = nicePay.Get("resultCd"); String resultMsg = nicePay.Get("resultMsg"); String tXid = nicePay.Get("tXid"); String referenceNo = nicePay.Get("referenceNo"); String payMethod = nicePay.Get("payMethod"); String amt = nicePay.Get("amt"); String transDt = nicePay.Get("transDt"); String transTm = nicePay.Get("transTm"); ``` ::: [title] Payment - API Paylater [path] NICEPAY API/API Non-SNAP/Payment API/API Paylater/ # Tentang API Paylater Payment *** Melalui , menawarkan kemudahan lintas aplikasi (*Jump App*) untuk . Notifikasi akan dikirimkan ke secara *real-time* sesaat setelah menyelesaikan . akan mendapatkan secara berkala terkait pengajuan pinjaman melalui . # API Paylater Payment *** API Pembayaran bertujuan agar Anda dapat menyelesaikan . Tahapan ini digunakan untuk melakukan dengan . | **API End Point** | `/nicepay/direct/v2/payment` | | ------------------ | ------------------------------------------------------------ | | **Request Method** | **POST****** | | **Description** | Performs Transaction Regist to | | **Merchant Token** | SHA256(`timeStamp`+`iMid`+`referenceNo`+`amt`+`merchantKey`) | | **Request Format** | `application/x-www-form-urlencoded` | Request Parameter for Paylater Payment *** Berikut ini adalah daftar untuk melakukan *payment* untuk . Parameter ini digunakan melalui platform pengujian sebagai salah satu tahapan supaya milik dapat terhubung dengan dari . | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ------------------------------------------------------------ | -------- | ---------- | -------------------------------------- | ---------------------------------------------------------------- | | `timeStamp`
Required | N | 14 | Request Timestamp (`YYYYMMDDHH24MISS`) | 20200910170911 | | `tXid`
Required | AN | 30 | Transaction ID | IONPAYTEST01201804191202084760 | | `merchantToken `
Required | AN | 255 | Token | d27544e13fd9937be9fc5d99ba39a75344b0e6dd1c6c358c9858a94606a74c4e | | `callBackUrl `
Required | ANS | 255 | Result URL | http\://merchant.com/callbackUrl
| ## Sample JSON for Paylater Payment *** :::CodeblockTabs FormUrlencoded ```json callBackUrl=http://merchant.com/callbackUrl tXid=PAYLOANTES06202010221238593706 timeStamp=20200910170911 merchantToken=d27544e13fd9937be9fc5d99ba39a75344b0e6dd1c6c358c9858a94606a74c4e ``` Java Request ```java nicePay.setTimeStamp("20200910170911"); nicePay.settXid("PAYLOANTES06202010221238593706"); nicePay.setMerchantToken(nicePay.getMerchantToken()); nicePay.setCallBackUrl("http://merchant.com/callbackUrl"); // Payment Request nicePay.payment(); ``` ::: # CallBack Handling Paylater *** `Callback Handling` didapat pada menggunakan URL. Setelah melakukan pemanggilan di , maka akan langsung dialihkan menuju pada aplikasi . :::hint{type="success"} Ketika Callback diterima `callbackurl` , merekomendasikan untuk melakukan verifikasi dengan menggunakan [Status Inquiry - API Paylater](docId\:r6YyG1qEKKLzWnVhazxCV). ::: :::hint{type="warning"} `CallBack Handling` sangat penting untuk membantu meminimalisir tindakan *Fraud*. sangat merekomendasikan untuk melakukan verifikasi menggunakan `CallBack Handling`. ::: :::CodeblockTabs URL CallBack ```json https://merchant.co.id/nicepay-callback?resultCd=0000&resultMsg=SUCCESS&tXid=PAYLOANTES06202212141336161529&referenceNo=815123412341&payMethod=06&amt=20000&transDt=20221214&transTm=133616&description=&authNo=&issuBankCd=&acquBankCd=&cardNo=&receiptCode=&mitraCd=KDVI&recurringToken=&preauthToken=¤cy=IDR&goodsNm=Test+Transaction+Nicepay&billingNm=Customer +Name&ccTransType=&mRefNo=&instmntType=&instmntMon=&cardExpYymm=&issuBankNm=&acquBankNm=&timeStamp=&merchantToken= ``` Response CallBack ```none { "resultCd": "0000", "resultMsg": "SUCCESS", "tXid": "PAYLOANTES06202212141336161529", "referenceNo": "815123412341", "payMethod": "06", "amt": "20000", "transDt": "20221214", "transTm": "133616", "description": "", "authNo": "", "issuBankCd": "", "acquBankCd": "", "cardNo": "", "receiptCode": "", "mitraCd": "KDVI", "recurringToken": "", "preauthToken": "", "currency": "IDR", "goodsNm": "Test Transaction Nicepay", "billingNm": "Customer Name", "ccTransType": "", "mRefNo": "", "instmntType": "", "instmntMon": "", "cardExpYymm": "", "issuBankNm": "", "acquBankNm": "", "timeStamp": "", "merchantToken": "" } ``` ::: # Confirm Receipt (Hanya Akulaku) *** :::hint{type="warning"} Hanya lakukan ini setelah telah menerima barang. wajib melakukan ini untuk mendapatkan dana settlement dari sudah dilakukan. ::: | **API End Point** | `/nicepay/api/direct/v2/confirmAkulaku` | | ------------------ | --------------------------------------------------------------------- | | **Request Method** | **POST****** | | **Description** | Melakukan konfirmasi *receipt *untuk dana *settlement* | | **Merchant Token** | SHA256(`timeStamp`+`tXid`+`iMid`+`merchantKey`) | ## Request Parameter | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ------------------------------------------------------------ | -------- | ---------- | -------------------------------------- | ------------------------------ | | `timeStamp `
Required | N | 14 | Request Timestamp (`YYYYMMDDHH24MISS`) | 20170708123456 | | `tXid `
Required | AN | 30 | Transaction ID | IONPAYTEST02201607291027025291 | | `iMid`
Required | AN | 10 | ID | IONPAYTEST | | `merchantToken `
Required | AN | 255 | Token | 6cfccfc0046773c1b589d8e98f8 | ## Response Parameter | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ----------------------------------------------------------- | -------- | ---------- | ---------------------------------------------- | -------------------- | | `resultCd`
Required | N | 4 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | | | `resultMsg`
Required | AN | 30 | [Result Message](docId\:gvAdBBr0SQ92N1zHplSFM) | | | `ResponseData `
Required | AN | 255 | Token | | [title] API Paylater [path] NICEPAY API/API Non-SNAP/Payment API/ # Proses Pada API Paylater :::hint{type="info"} Silakan kunjungi bagian [Paylater - Advance API](docId:4x6QM_ewhHnwU3uYmnr6D) untuk mendapatkan info lebih lanjut terkait Account Binding. ::: ::::LinkArray{contentSource="CUSTOM"} :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/TNvnXwJsXSrpcLqAJqJbm-20260608-073315.jpg"} [Registration - API Paylater](docId\:J65eZ7xTGGxvLYhQANT6D) digunakan untuk mendaftarkan saat pertama kali dibuat. ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/r_KBw1M3Ykr_UC8RvYHlz-20260608-073433.jpg"} [Payment - API Paylater](docId:1jAr45oEk0lYZuXjyZb5c) digunakan untuk melakukan . ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/ZYjc88SPWYbNzZRwJr_46-20260608-073507.jpg"} [Status Inquiry - API Paylater](docId\:r6YyG1qEKKLzWnVhazxCV) digunakan untuk memeriksa sudah berhasil. ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/5BuXoGMhHZ4DZj_c3F7yd-20260608-073606.jpg"} [Notification - API Paylater](docId\:tLx6S6yonkvOMuyhJMQ8Z) digunakan untuk memeriksa sedang berjalan. ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/F3yW9VPVipNZxfUaLAllT-20260608-073637.jpg"} [Cancel - API Paylater](docId\:GxDH-yDgXbTZTVLdJykDL) digunakan untuk membatalkan sedang berjalan. ::: :::: [title] API Laporan Bisnis [path] NICEPAY API/ # Tentang API Laporan Bisnis *** menyediakan Laporan Bisnis dapat dipergunakan oleh dalam memeriksa laporan data Transaksi dan laporan data dengan tanpa perlu mengakses portal . ini diharapkan dapat memudahkan dalam menarik laporan secara otomatis dan berkala untuk memenuhi kebutuhan pelaporan seperti rekonsiliasi. :::Iframe{iframeHeight="0" code="Apabila Anda menemukan kesulitan dalam integrasi API ini, silahkan hubungi tim Customer Support dan tim IT Integrasi."} ::: ## Jenis API Laporan Bisnis NICEPAY *** ::::LinkArray{contentSource="CUSTOM" customOrder="Tb3iOqtOIziSocj_CodtZ,d-JdxXGnC0NS-2ns7B1Ft,zU6Ju1fXFn8RB46F5w8Kl,qr6pnmFdKCgjRJSIVE8mu"} :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-t8BrMMDPLF3DJ_T5QkkFl-20240731-032601.jpg"} [Transaction History API](docId\:sghkmjYcxSPFRd0q8K5Ze) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-HV77KIyazZLItHGeTaU9q-20240731-032655.jpg"} [Settlement History API](docId\:WQFs5ntC8991oxeHr1kio) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/lA18wp8XjMuTt1xMPjmvU_header-api-business-report-fail-transaction-api.jpg"} [Fail Transaction API](docId:7T0jLRX6ot4zst9rgRGzH) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-ScpWj0rzv_R1CVpTlehjI-20240731-032709.jpg"} [NICEPAY Code API Laporan Bisnis](docId\:CrGE1s9poBnuAdENJUkb8) ::: :::: [title] Settlement History API [path] NICEPAY API/API Laporan Bisnis/ # Tentang Settlement History API *** History dapat digunakan untuk rekonsiliasi laporan dana dengan . Dengan ini, akan mendapatkan daftar data hingga 5.000 data per *request* sesuai dari tanggal diminta. :::Iframe{iframeHeight="0" code="Merchant harus menghubungi NICEPAY Customer Service dengan mengirimkan IP Merchant untuk proses Whitelist pada NICEPAY terlebih dahulu dan melakukan pengajuan kredensial API untuk menggunakan Settlement History API."} ::: # Settlement History API *** | **API End Point** | [`https://bo.nicepay.co.id/settlmntdt.do`](https://bo.nicepay.co.id/settlmntdt.do) | | --------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | | **Request Method **application/json | ******POST** | | **Description** | To check History with via | | **Header** | `Content-Type: application/json` | | **Request Format** | `application/json` | :::hint{type="info"} Nilai dan nilai dana tersedia dalam laporan ini menggunakan mata uang Rupiah. ::: ## Request Parameter | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ------------------------------------------------------- | -------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- | | `mid`
Required | VARCHAR2 | 10 | iMid | IONPAYTEST | | `passwd`
Required | VARCHAR2 | 100 | *Password* setelah Whitelist IP telah berhasil di-*register* di sisi
(Mohon untuk menghubungi **tim NICEPAY Customer Service** untuk asistensi) | 123456 | | `settlmntdt`
Required | VARCHAR2 | 8 | Tanggal data mau dilihat
Format: `YYYYMMDD` | 20200113 | | `startno`
Required | NUMBER | 10 | Awal dari data akan mau dilihat | 1
Default: 1 | | `endno`
Required | NUMBER | 10 | Akhir dari data mau dilihat
Maksimal 5000 | 100
Default: 100 | ## Response Parameter | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | --------------------------------------------------------- | -------- | ---------- | -------------------------------------------------------------------------- | ------------------------------ | | `HEADER`
Required | Object | - | - | `"HEADER": { ... } ` | | `CODE`
Required | NUMBER | 4 | Code Response | 00 | | `MID`
Required | VARCHAR2 | 10 | iMid | IONPAYTEST | | `SETTLMNT_DT`
Required | VARCHAR2 | 8 | Tanggal data di-*request*
Format: `YYYYMMDD` | 20200113 | | `DATA`
Required | Object | - | - | `"DATA": [ { ... } ] ` | | `CODE`
Required | NUMBER | 2 | Code Response | 10 | | `TXID`
Required | VARCHAR2 | 30 | ID Transaksi | IONPAYTEST02202001100933358310 | | `SETTLMNT_DT`
Required | VARCHAR2 | 8 | Tanggal data di-*request*
Format: `YYYYMMDD` | 20200113 | | `TRANS_STATUS`
Required | NUMBER | 2 | Status Transaksi: [Transaction Status Code](docId\:CrGE1s9poBnuAdENJUkb8) | 0 | | `PAY_METHOD`
Required | VARCHAR2 | 2 | Method | 02 | | `TRANS_DT`
Required | VARCHAR2 | 8 | Tanggal data di-*request*
Format: `YYYYMMDD` | 20200110 | | `TRANS_AMT`
Required | NUMBER | 19,2 | Amount Transaksi | 1000 | | `SETTLMNT_AMT`
Required | NUMBER | 19,2 | Amount | 800 | | `FDS_FEE`
Required | NUMBER | 19,2 | Biaya FDS (hanya dikenakan untuk metode ) | 0 | | `NICEPAY_FEE`
Required | NUMBER | 19,2 | Biaya dikenakan pada setiap berhasil terbayar | 545 | | `BANK_FEE`
Required | NUMBER | 19,2 | Biaya atau (akan dikenakan untuk tipe Fasilitator) | 0 | | `VAT`
Required | NUMBER | 19,2 | Biaya PPN atau (Value Added Tax) | 55 | | `ORDER_NO`
Required | NUMBER | 10 | Nomor Referensi | OrdNo20200933270 | | `BANK_CD`
Required | VARCHAR2 | 4 | Code atau | BMRI | | `CUSTOMER_NO`
Required | VARCHAR2 | 40 | Account Transaction Number | 79150000090933358310 | | `TAIL`
Required | Object | - | - | `"TAIL": { ... }` | | `CODE`
Required | NUMBER | 4 | Code Response | 99 | | `MID`
Required | VARCHAR2 | 10 | iMid | IONPAYTEST | | `SETTLMNT_DT`
Required | VARCHAR2 | 8 | Tanggal data di-*request*
Format: `YYYYMMDD` | 20200113 | | `APP_CNT`
Required | NUMBER | 10 | Jumlah total volume | 5 | | `APP_AMT`
Required | NUMBER | 19,2 | Jumlah total amount | 14000 | | `CC_CNT`
Required | NUMBER | 10 | Jumlah total volume refund | 0 | | `CC_AMT`
Required | NUMBER | 19,2 | Jumlah total amount refund | 0 | | `NICEPAY_FEE`
Required | NUMBER | 19,2 | Jumlah total biaya dikenakan pada setiap berhasil terbayar | 2725 | | `BANK_FEE`
Required | NUMBER | 19,2 | Jumlah total biaya atau (akan dikenakan hanya untuk tipe ) | 0 | | `VAT`
Required | NUMBER | 19,2 | Jumlah total biaya PPN atau (Value Added Tax) | 275 | | `SETTLMNT_AMT`
Required | NUMBER | 19,2 | Jumlah total amount | 11000 | ## Sample Parameter :::CodeblockTabs Request ```json { "mid":"IONPAYTEST", "passwd":"123456", "settlmntdt":"20200113", "startno":"1", "endno":"5000" } ``` Response ```json { "HEADER": { "CODE": "00", "MID": "IONPAYTEST", "SETTLMNT_DT": "20200113" }, "DATA": [ { "CODE": "10", "TXID": "IONPAYTEST02202001100933358310", "SETTLMNT_DT": "20200113", "TRANS_STATUS": "0", "PAY_METHOD": "02", "TRANS_DT": "20200110", "TRANS_AMT": 1000, "SETTLMNT_AMT": 400, "FDS_FEE": 0, "NICEPAY_FEE": 545, "BANK_FEE": 0, "VAT": 55, "ORDER_NO": "OrdNo20200933270", "BANK_CD": "BDIN", "CUSTOMER_NO": "79150000090933358310" }, { "CODE": "10", "TXID": "IONPAYTEST02202001100941229936", "SETTLMNT_DT": "20200113", "TRANS_STATUS": "0", "PAY_METHOD": "02", "TRANS_DT": "20200110", "TRANS_AMT": 1000, "SETTLMNT_AMT": 400, "FDS_FEE": 0, "NICEPAY_FEE": 545, "BANK_FEE": 0, "VAT": 55, "ORDER_NO": "OrdNo2020094119264", "BANK_CD": "BMRI", "CUSTOMER_NO": "70014000090941229936" }, { "CODE": "10", "TXID": "IONPAYTEST02202001102359040783", "SETTLMNT_DT": "20200113", "TRANS_STATUS": "0", "PAY_METHOD": "02", "TRANS_DT": "20200111", "TRANS_AMT": 10000, "SETTLMNT_AMT": 9400, "FDS_FEE": 0, "NICEPAY_FEE": 545, "BANK_FEE": 0, "VAT": 55, "ORDER_NO": "OrdNo20200235841270", "BANK_CD": "CENA", "CUSTOMER_NO": "44779000092359040783" }, { "CODE": "10", "TXID": "IONPAYTEST02202001110258241837", "SETTLMNT_DT": "20200113", "TRANS_STATUS": "0", "PAY_METHOD": "02", "TRANS_DT": "20200111", "TRANS_AMT": 1000, "SETTLMNT_AMT": 400, "FDS_FEE": 0, "NICEPAY_FEE": 545, "BANK_FEE": 0, "VAT": 55, "ORDER_NO": "OrdNo2020025819224", "BANK_CD": "BRIN", "CUSTOMER_NO": "88788000090258241837" }, { "CODE": "10", "TXID": "IONPAYTEST02202001110323543251", "SETTLMNT_DT": "20200113", "TRANS_STATUS": "0", "PAY_METHOD": "02", "TRANS_DT": "20200111", "TRANS_AMT": 1000, "SETTLMNT_AMT": 400, "FDS_FEE": 0, "NICEPAY_FEE": 545, "BANK_FEE": 0, "VAT": 55, "ORDER_NO": "OrdNo2020032349682", "BANK_CD": "BMRI", "CUSTOMER_NO": "70014000090323543251" } ], "TAIL": { "CODE": "99", "MID": "IONPAYTEST", "SETTLMNT_DT": "20200113", "APP_CNT": 5, "APP_AMT": 14000, "CC_CNT": 0, "CC_AMT": 0, "NICEPAY_FEE": 2725, "BANK_FEE": 0, "VAT": 275, "SETTLMNT_AMT": 11000 } } ``` ::: [title] Cancel Type Code [path] NICEPAY API/API Non-SNAP/NICEPAY Code/ *Cancel Type* adalah tipe pembatalan sebuah sudah berlanjut namun belum melalui . Kemudian, dibatalkan dengan kondisi di bawah ini akan diklasifikasikan sebagai pembatalan tipe Refund kepada . Lalu, akan mengembalikan dana kepada . Berikut adalah tabel *cancel refund-type * tersedia pada : | **Nilai Kode (*****Value Code*****)** | **Deskripsi** | | ------------------------------------- | -------------------- | | `1` | Full Cancellation | | `2` | Partial Cancellation | :::hint{type="info"} - *Full Cancellation* berarti bahwa pembatalan akan terjadi setelah melakukan dan dana akan dikembalikan dalam ***full amount***. Proses tersebut akan mengambil waktu selama 14 hari kerja. - *Partial Cancellation *berarti bahwa pembatalan akan terjadi setelah melakukan dan dana akan dikembalikan dalam ***partial amount ***bergantung pada kebijakan terkait. Proses tersebut akan mengambil waktu selama 14 hari kerja. ::: [title] Cancel - API Paylater [path] NICEPAY API/API Non-SNAP/Payment API/API Paylater/ # Tentang API Paylater Cancel *** ini digunakan untuk membatalkan sudah dibayarkan. Jika dibatalkan sebelum selesai, maka tersebut dianggap *void *dan dana tersebut akan dikembalikan kepada . :::hint{type="info"} Untuk melakukan *Cancel *pada Kredivo, langsung menggunakan *dashboard* milik Kredivo telah disediakan. ::: # API Paylater Cancel *** Cancel digunakan untuk pembatalan pada melalui . | **API End Point** | `/nicepay/direct/v2/cancel` | | ------------------ | ----------------------------------------------------- | | **Request Method** | **POST****** | | **Header** | `Content-Type: application/json` | | **Merchant Token** | SHA256(`timeStamp`+`iMid`+`tXid`+`amt`+`merchantKey`) | # Payment Methods Available for Cancel *** **Code PayMethod** *** `01` *** `02` *** `03` *** `04` *** `05` *** `06` **Paylater****** *** `08` *** `09` *** ## Request Parameters for Paylater Cancel *** Berikut ini adalah daftar untuk melakukan *request* *cancel payment* pada . Parameter ini digunakan pada platform pengujian . | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ---------------------------------------------------------- | -------- | ---------- | ------------------------------------------------------------------------------------------ | ---------------------------------------------------------------- | | `timeStamp`
Required | N | 14 | Request Timestamp | 20221213141266 | | `tXid`
Required | AN | 30 | Transaction ID
| PAYLOANTES00202212131410560896 | | `iMid`
Required | AN | 10 | ID
| PAYLOANTES | | `payMethod`
Required | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | 06 | | `cancelType`
Required | N | 2 | [Cancel Type Code](docId\:Mq9xE7wdOPR8OkZ3v-pVc)
| 1 | | `cancelMsg` | AN | 255 | Cancel Message | Request Cancel | | `merchantToken`
Required | AN | 255 | Token
| 9d1835e8bf87b51b44de9b2455fa37e733a87b12644b9cd4546e2ec2de651863 | | `amt`
Required | N | 12 | Amount
| 12000 | | `cancelUserId` | AN | 30 | User ID
| Admin | ## Response Parameter for Paylater Cancel *** Berikut adalah *response parameter* dari hasil *request parameter* untuk *cancel handling* . | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan ** | | ------------- | -------- | ---------- | ---------------------------------------------------------- | -------------------------- | | `tXid` | AN | 30 | Transaction ID | 20221213141266 | | `referenceNo` | ANS | 40 | Order Number | ord20200910170911 | | `transDt` | N | 8 | Transaction Date | 20221213 | | `transTm` | N | 6 | Transaction Time | 141056 | | `amt` | N | 12 | Amount | 12000 | | `resultCd` | N | 4 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | 0000 | | `resultMsg` | AN | 255 | Result Message: [Error Code](docId\:yEh1VA9k2y6sL1kQF2aWD) | SUCCESS | ## Sample JSON for Paylater Cancel *** :::CodeblockTabs JSON Request ```json { "timeStamp":"20221213141266", "tXid":"PAYLOANTES00202212131410560896", "iMid":"PAYLOANTES", "payMethod":"06", "cancelType":"1", "cancelMsg":"Request Cancel", "merchantToken":"9d1835e8bf87b51b44de9b2455fa37e733a87b12644b9cd4546e2ec2de651863", "amt":"12000", "cancelUserId":"admin" } ``` JSON Response ```json { "tXid": "PAYLOANTES00202212131410560896", "referenceNo": "ord20200910170911", "resultCd": "0000", "resultMsg": "SUCCESS", "transDt": "20221213", "transTm": "141056", "amt": "12000" } ``` Java Request ```json //Cancel Registration// nicePay.setTimeStamp("20221213141266"); nicePay.setiMid("PAYLOANTES"); nicePay.setAmt("12000"); nicePay.setMerchantToken(nicePay.makeToken(nicePay.getMerchantToken()); nicePay.settXid("PAYLOANTES00202212131410560896"); nicePay.setPayMethod("06"); nicePay.setCancelType("1"); nicePay.setCancelMsg("Request Cancel"); nicePay.setCancalUserId("admin"); // Request Cancel nicePay.cancel(); // Response String // System.out.println("Final Response String : " + nicePay.getResponseString()); String resultCd = nicePay.Get("resultCd"); String resultMsg = nicePay.Get("resultMsg"); String tXid = nicePay.Get("tXid"); String referenceNo = nicePay.Get("referenceNo"); String amt = nicePay.Get("amt"); String cancelReferenceNo = nicePay.Get("cancelReferenceNo"); ``` ::: [title] User Detail - Account Binding Paylater API [path] NICEPAY API/API Non-SNAP/Advance API/Untitled/Untitled/ # Tentang User Detail - Account Binding Paylater API *** ini digunakan untuk mendapatkan detail terkait akun milik sudah terhubung. :::hint{type="info"} User Detail (Account Binding ) saat ini hanya dapat digunakan pada khusus Kredivo. ::: # Alur Proses User Detail - Account Binding Paylater API ![Account Binding - User Detail](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/39WOV4JdZ2OYS63WjfP0e_diagram-user-detail-account-binding-paylater-api.jpg "Account Binding - User Detail") Deskripsi alur: 1. mengajukan pengambilan pengguna kepada . 2. mengajukan pengambilan pengguna kepada . 3. melakukan validasi. 4. mengirimkan *response* kepada . 5. mengirimkan data pengguna kepada . User Detail - Account Binding Paylater API ========================================== *** | **API Endpoint** | [`https://www.nicepay.co.id/nicepay/direct/v2/user-details`](https://www.nicepay.co.id/nicepay/direct/v2/user-details)`` | | ------------------ | ------------------------------------------------------------------------------------------------------------------------ | | **Request Method** | **POST****** | | **Merchant Token** | **SHA256 **(`iMid` + `userToken` + `merchantKey`) | | **Request Format** | `application/JSON` | ## Request Parameter for User Detail - Account Binding Paylater API | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ---------------------------------------------------------- | -------- | ---------- | ------------------------------- | -------------------- | | `iMid`
Required | AN | 10 | ID | | | `timeStamp`
Required | N | 14 | Request Timestamp | | | `merchantToken`
Required | AN | 255 | token | | | `userToken`
Required | AN | 100 | User Token from Binding Account | | ## Response Parameter for User Detail - Account Binding Paylater API | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ---------------------- | ------------ | ---------- | -------------------- | ------------------------------------ | | `billingPhone` | AN | 15 | Billing Phone | Format:
+62-`user phone number` | | `accountStatus` | N | 1 | Account Status | | | `accountType` | N | 1 | Account Type | | | `limitDetails` | Array Object | | | | | - `paymentType` | AN | 10 | Installment Month | | | * `remainingUserLimit` | AN | 50 | Remaining User Limit | | | - `totalUserLimut` | AN | 50 | Total User Limit | | ## Sample Parameter for User Detail - Account Binding Paylater API :::CodeblockTabs Request Parameter ```json { "timeStamp":"{{timestampTrx}}", "userToken":"{{userToken}}", "iMid":"{{iMid}}", "merchantToken":"{{merTok}}" } ``` Response Parameter ```json { "resultCd": "0000", "resultMsg": "SUCCESS", "billingNm": "Jajang Basirudin", "billingPhone": "+62-883****7325", "accountStatus": "1", "accountType": "2", "limitDetails": [ { "paymentType": "9_months", "remainingUserLimit": "15265763.00", "totalUserLimit": "15200000.00" }, { "paymentType": "3_months", "remainingUserLimit": "5661939.00", "totalUserLimit": "5600000.00" }, { "paymentType": "12_months", "remainingUserLimit": "19373196.00", "totalUserLimit": "19300000.00" }, { "paymentType": "6_months", "remainingUserLimit": "10720111.00", "totalUserLimit": "10700000.00" }, { "paymentType": "30_days", "remainingUserLimit": "2000000.00", "totalUserLimit": "2000000.00" } ] } ``` ::: [title] Virtual Account (VA) [path] Payment/ ![Virtual Account](https://api.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/AlZBm6eb_IntjAyglLKGA_asset-illustration-7.png "Virtual Account") # Tentang Virtual Account *** **Virtual Account (VA)** merupakan nomor rekening virtual untuk melakukan secara *online *dengan fitur *Real-Time Notification *agar dapat memeriksa . bekerja sama dengan berbagai untuk melakukan VA pada , seperti e-Commerce, Marketplace, dan tipe perusahaan lain dengan mudah, aman, dan efisien. Dengan VA, dapat melakukan melalui ATM, SMS Banking, Internet Banking, maupun Mobile Banking. Pembayaran dengan nomor VA akan diproses secara otomatis dan *real-time* tanpa perlu mengirimkan bukti bayar secara manual, sehingga akan merasa nyaman untuk melakukan dengan . Apabila memilih menggunakan *Settlement Model Acquirer* yang disediakan pada VA, tidak perlu lagi membuka rekening pada setiap . Karena telah bekerja sama dengan 12 *Acquirer Bank* terpercaya untuk mendukung lebih dari 100 terdaftar di . :::hint{type="info"} kunjungi [Proses Settlement](docId\:l04EuP_s604Oi2Ib3x_y6) untuk mengetahui lebih dalam mengenai model beserta prosesnya di . ::: ![Virtual Account Bank](https://api.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/ONLl6w35WrKCmSPdjiBZz-20260310-091514.jpg "Virtual Account Bank") # Daftar Bank Acquiring VA di NICEPAY *** Berikut daftar &#xNAN;* Acquiring* sudah bekerja sama dengan beserta modelnya: | **No** | **Nama Bank** | **Settlement Model** | | ------ | ----------------------------------------------- | -------------------- | | 1 | Central Asia (BCA) | , | | 2 | Mandiri | , | | 3 | Rakyat (BRI) | , | | 4 | Permata | , | | 5 | Permata Syariah | , | | 6 | KEB Hana | , | | 7 | Nasional (BNI) | , | | 8 | Danamon | , | | 9 | Maybank | , | | 10 | Jakarta | ** | | 11 | Jabar Banten (BJB) | , | | 12 | Neo Commerce (BNC) | ** | | 13 | Commerce International Merchant Bankers (CIMB) | , | | 14 | Syariah Indonesia (BSI) | | :::hint{type="info"} Untuk model pada BCA akan dikelola oleh kami, yaitu ALTO. ::: # Keuntungan menggunakan VA di NICEPAY *** - tidak harus menyerahkan bukti . - tidak harus memiliki rekening sama dengan . - Lebih cepat mengidentifikasi kiriman dana dari . - Rekonsiliasi penerimaan lebih mudah. - Luasnya jaringan . # Struktur Virtual Account *** ![Struktur VA](https://api.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/kktFcSn_KsHHMveS73QL9-20260520-104230.jpg "Struktur VA") Struktur pada memiliki arti dan tujuan berbeda bergantung kepada tipe dan fitur digunakan. Berikut adalah penjelasan terkait struktur VA dari gambar di atas. | **Nama Bagian Struktur** | **Deskripsi** | | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | + Prefix | Kode khusus milik dan | | ID | - Jika tipe VA adalah tipe *Normal*, maka deret angka dengan panjang maksimal 8 digit akan dihasilkan oleh . - Jika tipe VA adalah tipe *Fixed*, maka deret angka paling belakang dibuat statik berdasarkan ID Pengguna atau angka lainnya sesuai dari kebutuhan . | :::hint{type="warning"} Perlu diingat bahwa masing-masing memiliki aturan panjang nomor berbeda-beda. ::: # NICEPAY Virtual Account *** menyediakan nomor VA (*prefix*) bagi menggunakan model untuk memudahkan operasi . Berikut adalah daftar nomor VA dimiliki oleh . | **No** | **Nama Bank** | **Nomor Akun VA NICEPAY** | | ------ | --------------- | ---------------------------------------------- | | 1 | BCA | 44777 \| 44778 \| 44779 \| 7007016 \| 7007216 | | 2 | Mandiri | 70014 | | 3 | BRI, BNI | 78789 \| 88788 | | 4 | Danamon | 79150 \| 7917 \| 845062 \| 8051 \| 8052 | | 5 | Permata | 86232 \| 86250 \| 86252 | | 6 | Permata Syariah | 8624 | | 7 | Hana | 9772 | | 8 | Maybank | 78120 \| 78277 \| 78278 | | 9 | CIMB | 5919 | | 10 | BJB | 1887 \| 1889 \| 1890 | | 11 | Bank Jakarta | 995014 | | 12 | BNC | 90120973 | | 13 | BSI | 1749 \| 1750 \| 1751 | ::::hint{type="info"} :::Iframe{code="ℹ️ Apabila Anda mendapatkan nomor VA yang diklaim dimiliki oleh NICEPAY namun tidak tercantum pada tabel di atas, mohon hubungi NICEPAY Customer Service untuk menghindari hal-hal yang bersifat penipuan." iframeHeight="0"} ::: :::: # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [API Virtual Account SNAP](docId:2XCcJFVmwY9jDmD6w09oN) untuk mengetahui rincian digunakan pada . ::: :::VerticalSplitItem [API NICEPAY Inquiry Virtual Account SNAP](docId\:W-Zwlzxm-p6FyqA3tqaDD) untuk mengetahui rincian khusus. ::: :::: ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Advance API](docId\:qyS-Qyem-hUj6iKk-tAu7) untuk mengetahui rincian lebih spesifik dari Advance Versi Non-. ::: :::VerticalSplitItem ::: :::: [title] Transaction History API [path] NICEPAY API/API Laporan Bisnis/ # Tentang Transaction History API *** Transaction History digunakan untuk rekonsiliasi dan *amount* dengan . Dengan ini, akan mendapatkan daftar data hingga 5.000 data per *request* sesuai dari tanggal diminta. :::Iframe{iframeHeight="0" code="Merchant harus menghubungi NICEPAY Customer Service dengan mengirimkan IP Merchant untuk proses Whitelist pada NICEPAY terlebih dahulu dan melakukan pengajuan kredensial API untuk menggunakan Transaction History API."} ::: # Transaction History API *** | **API End Point** | [](https://bo.nicepay.co.id/transdt.do) | | ------------------------ | ----------------------------------------- | | **Request Method ** | **POST****** | | **Description** | To check history with via | | **Header** | `Content-Type: application/json` | | **Request Format** | `application/json` | :::hint{type="info"} Nilai tersedia dalam laporan ini menggunakan mata uang Rupiah. ::: ## Request Parameter | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ---------------------------------------------------- | -------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- | | `mid`
Required | VARCHAR2 | 10 | iMid | IONPAYTEST | | `passwd`
Required | VARCHAR2 | 100 | *Password* setelah Whitelist IP telah berhasil di-*register* di sisi
(Mohon untuk menghubungi **tim NICEPAY Customer Service** untuk asistensi) | 123456 | | `transdt`
Required | VARCHAR2 | 8 | Tanggal data mau dilihat
Format: `YYYYMMDD` | 20200101 | | `startno`
Required | NUMBER | 10 | Awal dari data hendak dilihat | 1
Default: 1 | | `endno`
Required | NUMBER | 10 | Akhir dari data mau dilihat maksimal 5000 | 100
Default: 100 | ## Response Parameter | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ---------------------------------------------------------- | -------- | ---------- | ---------------------------------------------------------------------------- | ------------------------------ | | `HEADER`
Required | Object | - | - | `"HEADER": {...}` | | `CODE`
Required | NUMBER | 4 | Code Response | 00 | | `MID`
Required | VARCHAR2 | 10 | iMid | IONPAYTEST | | `TRANS_DT`
Required | VARCHAR2 | 8 | Tanggal data di-*request*
Format: `YYYYMMDD` | 20200101 | | `DATA`
Required | Object | - | - | `"DATA": [ { ... } ]` | | `CODE`
Required | NUMBER | 4 | Code Response | 10 | | `TXID`
Required | VARCHAR2 | 30 | ID Transaksi | IONPAYTEST01202001010010379759 | | `ORDER_NO`
Required | NUMBER | 10 | Nomor Referensi | 99999 | | `TRANS_STATUS`
Required | NUMBER | 2 | Status Transaksi: [Transaction Status Code](docId\:CrGE1s9poBnuAdENJUkb8) | 0 | | `TRANS_DT`
Required | VARCHAR2 | 8 | Tanggal data di-*request*
Format : `YYYYMMDD` | 20200101 | | `TRANS_TM`
Required | VARCHAR2 | 8 | Waktu jam dari data direquest
Format:
`HHmmss` | 001037 | | `CANCEL_DT`
Required | VARCHAR2 | 8 | Tanggal pembatalan
Format: `YYYYMMDD` | - | | `CANCEL_TM`
Required | VARCHAR2 | 8 | Waktu pembatalan
Format: `HHmmss` | - | | `PAY_METHOD`
Required | VARCHAR2 | 2 | Method | 01 | | `TRANS_AMT`
Required | NUMBER | 19,2 | Amount Transaksi | 10000 | | `CUSTOMER_NO`
Required | VARCHAR2 | 40 | Account Transaction Number | 123412\*\*12341234 | | `SETTLMNT_DT`
Required | VARCHAR2 | 8 | Tanggal apabila sudah tersedia akan muncul | - | | `TAIL`
Required | Object | - | - | `"TAIL": { ... }` | | `CODE`
Required | NUMBER | 4 | Code Response | 99 | | `MID`
Required | VARCHAR2 | 10 | iMid | IONPAYTEST | | `TRANS_DT`
Required | VARCHAR2 | 8 | Tanggal data di-*request*
Format: `YYYYMMDD` | 20200101 | | `APP_TRANS_CNT`
Required | NUMBER | 10 | Jumlah total volume | 6 | | `APP_TRANS_AMT`
Required | NUMBER | 19,2 | Jumlah total amount | 290087 | | `CC_TRANS_CNT`
Required | NUMBER | 10 | Jumlah total volume refund | 0 | | `CC_TRANS_AMT`
Required | NUMBER | 19,2 | Jumlah total amount refund | 0 | ## Sample Parameter :::CodeblockTabs Request ```json { "mid":"IONPAYTEST", "passwd":"123456", "transdt":"20200101", "startno":"1", "endno":"5000" } ``` Response ```json { "HEADER": { "CODE": "00", "MID": "IONPAYTEST", "TRANS_DT": "20200101" }, "DATA": [ { "CODE": "10", "TXID": "IONPAYTEST01202001010010379759", "ORDER_NO": "99999", "TRANS_STATUS": "0", "TRANS_DT": "20200101", "TRANS_TM": "001037", "CANCEL_DT": "-", "CANCEL_TM": "-", "PAY_METHOD": "01", "TRANS_AMT": 10000, "CUSTOMER_NO": "123412******12341234", "SETTLMNT_DT": "-" }, { "CODE": "10", "TXID": "IONPAYTEST01202001010015131172", "ORDER_NO": "99999", "TRANS_STATUS": "0", "TRANS_DT": "20200101", "TRANS_TM": "001513", "CANCEL_DT": "-", "CANCEL_TM": "-", "PAY_METHOD": "01", "TRANS_AMT": 10000, "CUSTOMER_NO": "123412******12341234", "SETTLMNT_DT": "-" }, { "CODE": "10", "TXID": "IONPAYTEST01202001010950206003", "ORDER_NO": "T2148P7ZU8GXADB", "TRANS_STATUS": "0", "TRANS_DT": "20200101", "TRANS_TM": "095019", "CANCEL_DT": "-", "CANCEL_TM": "-", "PAY_METHOD": "01", "TRANS_AMT": 65018, "CUSTOMER_NO": "111133******5555", "SETTLMNT_DT": "-" }, { "CODE": "10", "TXID": "IONPAYTEST01202001010950256020", "ORDER_NO": "T210LX4NZ3F7N35", "TRANS_STATUS": "0", "TRANS_DT": "20200101", "TRANS_TM": "095025", "CANCEL_DT": "-", "CANCEL_TM": "-", "PAY_METHOD": "01", "TRANS_AMT": 29018, "CUSTOMER_NO": "111112******12222111", "SETTLMNT_DT": "-" }, { "CODE": "10", "TXID": "IONPAYTEST05202001011020342509", "ORDER_NO": "T21FZF8IBZAE1OM", "TRANS_STATUS": "0", "TRANS_DT": "20200101", "TRANS_TM": "102034", "CANCEL_DT": "-", "CANCEL_theTM": "-", "PAY_METHOD": "05", "TRANS_AMT": 29018, "CUSTOMER_NO": "-", "SETTLMNT_DT": "-" }, { "CODE": "10", "TXID": "IONPAYTEST02202001011041357152", "ORDER_NO": "T21VQB05AP8KS7O", "TRANS_STATUS": "0", "TRANS_DT": "20200101", "TRANS_TM": "104306", "CANCEL_DT": "-", "CANCEL_TM": "-", "PAY_METHOD": "02", "TRANS_AMT": 147033, "CUSTOMER_NO": "70014000091041357152", "SETTLMNT_DT": "-" } ], "TAIL": { "CODE": "99", "MID": "IONPAYTEST", "TRANS_DT": "20200101", "APP_TRANS_CNT": 6, "APP_TRANS_AMT": 290087, "CC_TRANS_CNT": 0, "CC_TRANS_AMT": 0 } } ``` ::: [title] Notification SMS [path] NICEPAY API/API Messaging/SMS API/ # Tentang Notification SMS *** Notifikasi *status* *request* digunakan untuk mengetahui berhasil atau gagal suatu pengiriman . akan mendapatkan melalui `dbProcessUrl` terdapat pada saat *request *dengan menggunakan Transmit. # Specification - Notification SMS *** | **Notification url** | URL Bisnis | | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Request Method** | **POST** | | **Description** | Jika mendapatkan kode tipe respon HTTP 200, maka mengganggap *request* tersebut sukses.
Jika menggunakan *firewall*, silakan untuk mengizinkan akses IP supaya dapat terhubung.

IP Public environtment Production:
`103.20.51.34`
`103.20.51.33`
`18.98.96.50`

IP Public environtment Dev:
`103.20.51.39`
`103.20.51.40`
`18.98.96.54` | | **Merchant Token** | SHA256 (`timestamp`+ `iMid`+ `tXid`+ `Merchant Key`) | ## Response Parameter for Notification SMS *** | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | --------------- | -------- | ---------- | ------------------------------------------------------------- | ---------------------------------------------------------------- | | `resultCd` | N | 14 | Result Code:
[Error Code](docId\:JKO_1O-kS-XzfZAqPwNIN) | | | `tXid` | AN | 30 | Transaction ID (Key from ) | IONPAYTEST10202212161518411526 | | `msgRefno` | ANS | 40 | Order Number (Key from ) | MSG-20201101201193 | | `transDt` | N | 8 | Transmission Date | 20221216 | | `transTm` | N | 6 | Transmission Time | 151841 | | `msgStatus` | N | 1 | [Transmission Status Code](docId:0dccdS0W5z7yNa0JULSsu) | 01
| | `merchantToken` | AN | 255 | Token | cde741f6d3dec64ac1efc00adb21b3b04302ba26f05474c38ff1d8db70afd8a8 | ## Sample for Notification SMS *** :::CodeblockTabs Sample Notification for SMS ```json timeStamp=20221216151841 msgRefno=MSG-20201101201193 merchantToken=cde741f6d3dec64ac1efc00adb21b3b04302ba26f05474c38ff1d8db70afd8a8 transTm=151841 tXid=IONPAYTEST10202212161518411526 transDt=20221216 msgStatus=01 ``` ::: # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [SMS Transmit](docId:0GwdGdsFm3-FGBHjsK7PO) untuk mengetahui rincian digunakan saat mengirim pesan. ::: :::VerticalSplitItem [Inquiry SMS](docId:0bfa4LFEowD2edz37yLWh) untuk mengetahui rincian API digunakan untuk melakukan inquiry. ::: :::: [title] Aturan dan Limitasi Kartu Kredit [path] Payment/Kartu Kredit/ # Overview *** | **Jenis Aturan & Limitasi** | **Deskripsi** | **Informasi Tambahan** | | --------------------------- | ------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Kartu didukung | - Visa
- Mastercard
- JCB
- AMEX | | | Mata uang didukung | Rupiah (IDR) | Dalam prosesnya, dapat menerima berasal dari negara lain selain , terlepas dari mata uangnya. Hanya saja, nanti kartu transaksinya akan di-*charged* dengan nominal Rupiah dan akan di-*settle* dengan Rupiah juga kepada | | Nominal | Minimal: Rp5.000
Maksimal: Rp999.999.999 | | ::::hint{type="info"} :::Iframe{code="Anda perlu mengirimkan e-mail kepada kami untuk dapat mengaktifkan tipe fitur Installment. Silakan hubungi tim NICEPAY Merchant Support kami." iframeHeight="0"} ::: :::: # Transaksi dari Luar Negeri & Mata Uang yang Didukung *** dapat menerima berasal dari luar negara dengan menggunakan mata uang apapun dipakai saat melalui metode . Hanya saja, &#xNAN;* Acquirer* akan melakukan *convert* nilai dari mata uang asing tersebut ke mata uang (Rupiah) secara otomatis kepada saat melakukan atau *charged* . Dalam -nya pun, hasil akhir mata uangnya akan menjadi Rupiah. [title] Error Code [path] NICEPAY API/API Non-SNAP/NICEPAY Code/ *Error Code *adalah sebuah daftar kode *error * muncul dalam `resultCd` sebagai bentuk tulisan atau indeks dengan berbagai arti. Halaman ini berisi daftar kode *error *dan artinya: # General *** | **Nilai** | **Deskripsi** | | --------- | ---------------------------------------------------- | | `0000` | Success | | `1001` | Connection error | | `1002` | Socket error | | `1003` | Server error | | `1004` | Timeout error | | `9501` | Invalid number | | `9502` | Transaction not allowed | | `9503` | It has been stopped or terminated in its stores | | `9504` | No offus | | `9505` | No | | `9506` | No `Paymethod` | | `9507` | HTTP timeout exception | # Order *** | **Nilai** | **Deskripsi** | | --------- | ------------------------------------------------------------------------------------------------------------------------------- | | `8001` | Order registration error. | | `8002` | Order inquiry error. | | `8003` | Order registration data error. | | `8004` | The `tXid` error during inquiry. | | `8005` | `OrderAuthType` Response data null. | | `9001` | Failed to register your . check your HTTP Message. | | `9002` | Server is busy. kindly try again in few minutes. | | `9003` | Invalid Order. | | `9004` | Error on inquiry of confirmation. | | `9005` | Failed to check . contact for further . | | `9006` | Transaction number generated error. | | `9007` | Undefined: Amount. check your request and make sure \[`amt`] is defined. | | `9008` | Invalid Request Amount. Amount should only number and do not includes decimal. | | `9009` | Reference Number already exist. generate unique \[`referenceNo`]. | | `9010` | Invalid Token. Contact for further . | | `9011` | Invalid MID, is not registered. Contact for further . | | `9012` | This method is currently not activated. Contact for further . | | `9013` | Undefined: Currency Code. check your request and make sure \[`currencyCode`] is defined. | | `9014` | Undefined: Reference Number. check your request and make sure \[`referenceNo`] is defined. | | `9015` | Undefined: Goods Name. check your request and make sure \[`goodsNm`] is defined. | | `9016` | Undefined: Buyer Name. check your request and make sure \[`billingNm`] is defined. | | `9017` | Undefined: Buyer Phone Number. check your request and make sure \[`billingPhone`] is defined. | | `9018` | Undefined: Buyer E-mail Address. check your request and make sure \[`billingEmail`] is defined. | | `9019` | Undefined: Callback URL. check your request and make sure \[`callbackUrl`] is defined. | | `9020` | Undefined: Debit Process URL. check your request and make sure \[`dbProcessUrl`] is defined. | | `9021` | Failed in inquiring the criterion (`BO_MER_MGNT` `ORD_NO_DUP_CHK_FLG`). | | `9022` | Invalid Card Data. check \[`cartData`] , and make sure you send valid JSON format. | | `9023` | Invalid Cart Data. Amount is different with Cart Data total amount. make sure \[`amt`] = sum of \[`amt`] in \[`cartData`] | | `9024` | Undefined: IP Address. check your request and make sure \[`userIP`] is defined. | | `9025` | Undefined: Buyer City. check your request and make sure \[`billingCity`] is defined. | | `9026` | Undefined: Buyer State. check your request and make sure \[`billingState`] is defined. | | `9027` | Undefined: Buyer Postal Code. check your request and make sure \[`billingPostCd`] is defined. | | `9028` | Undefined: Buyer Country. check your request and make sure \[`billingCountry`] is defined. | | `9029` | Installment is not available for defined month | | `9030` | Transaction Fail. check . | | `9031` | Date/Time check. | # One Pass *** | **Nilai** | **Deskripsi** | | --------- | ---------------------------- | | `8200` | OnePass Inquiry Error | | `8201` | OnePass Token Duplicate | | `8202` | OnePass Invalid Amount | # Cancel *** | **Nilai** | **Deskripsi** | | --------- | --------------------------------------------------------------------------- | | `8061` | Full canceled error. | | `8062` | Partial canceled error. | | `8063` | The MID error during full cancel. | | `8064` | The `tXID` error during full cancel. | | `8065` | The MID error during partial cancel. | | `8066` | The `tXID` error during partial cancel. | | `8067` | The amount error during partial cancel. | | `8090` | Net canceled error. | | `9301` | Invalid Cancel Type. | | `9302` | Server is busy. kindly try again in few minutes. | | `9303` | Server is busy. kindly try again in few minutes. | | `9304` | `TB_TRANS_HISTORY` update error. | | `9305` | Ledger card registration error. | | `9306` | Ledger partial cancel registration error. | | `9307` | Cards query error. | | `9308` | Database connection error. | | `9309` | connection error. | | `9310` | `TB_TRANS HISTORY` registration error. | | `9311` | Transaction number generated error. | | `9312` | No cancellation amount or cancellation amount includes letter. | | `9313` | Partial cancellation is only possible Mandiri. | | `9314` | Can not cancel your request number. | | `9315` | Cancel Ledger duplicate registration error. | | `9316` | code duplication errors. | | `9317` | Mandiri is available once a partial canceled. | | `9318` | can not request to cancel. | | `9319` | The amount you entered is larger than amount you want to cancel. | | `9320` | Can not cancel entire data already partially canceled. | | `9321` | fill in requested amount greater than zero. | | `9322` | (`CARD_BIN`) query fail. | | `9323` | (`Merchant_INFO`) query fail. | | `9324` | `MERCHANT_CARDINFO` query error. | | `9325` | `B_MID`, `B_TID` query error. | | `9326` | It can not be canceled after purchase. | | `9327` | It can not be partial cancelation before purchase. | | `9328` | The can not be canceled (Void Risk Check). | | `9329` | The can not be partial cancelation (Void Risk Check). | | `9330` | deposit has been completed can not be canceled. | | `9331` | The can not be canceled. | | `9332` | The can not be partial cancellation. | | `9333` | The can not be cancellation. (Debt cancellation prevent restrictions) | | `9334` | Cancellation period exceeds (limit 90 days). | # Credit Card *** | **Nilai** | **Deskripsi** | | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `8021` | Card authorization error. | | `8022` | The `tXid` error during card authorization. | | `8023` | The `tXid` error during card net cancel. | | `8024` | The MID error during card net cancel. | | `8026` | Failed card VISA 3D. | | `8027` | Invalid Parameter (PAN or expiry or `country_code`) | | `8028` | Invalid Parameter (`callbackUrl`) | | `8029` | Invalid Parameter (`onePassToken`) | | `8030` | Not Support Keyin . | | `8032` | Bin card numbers \[`cardbin`] are not yet supported for payments. Please contact us for more information. | | `9101` | Server is busy. kindly try again in few minutes. | | `9102` | Server is busy. kindly try again in few minutes. | | `9103` | Error in inquiring card ledger. | | `9104` | Server is busy. kindly try again in few minutes. | | `9105` | Server is busy. kindly try again in few minutes. | | `9106` | Transaction failed. | | `9107` | Server is busy. kindly try again in few minutes. | | `9108` | This method is currently not activated. Contact for further . | | `9109` | Reference Number Maximum Length Exceed. \[`referenceNo`] should have maximum 40 characters length. | | `9110` | Transaction failed. check card and try again. | | `9111` | Transaction failed. check card and try again. | | `9112` | Transaction failed. check card and try again. | | `9113` | Transaction failed. check card and try again. | | `9114` | `MERCHANT_CARDINFO` query error. | | `9115` | Invalid Amount: too low. increase amount. | | `9116` | Transaction already exist. make new transaction. | | `9117` | 3D Secure Failed. kindly check your card data and try again. | | `9118` | Invalid Installment Type. | | `9119` | Transaction failed: Invalid Terminal ID or ID | | `9120` | Transaction failed: Invalid Terminal ID or ID | | `9121` | This method is currently not activated. Contact for further . | | `9122` | Transaction failed. check interval. | | `9123` | Transaction failed. Transaction limit reached. | | `9124` | Invalid Amount: too low. increase amount. | | `9125` | Transaction failed. check card and try again. | | `9126` | Transaction already approved. | | `9127` | Transaction already exist. make new . | | `9128` | Transaction failed. check card and try again. | | `9129` | Transaction failed: Expired . make new . | | `9130` | Forbidden. You do not have permission to access this resource. | | `9131` | Invalid Token. check \[`onePassToken`] . | | `9132` | Transaction failed. check Risk Management. | | `9133` | E-mail not sent. | | `9134` | Card Recurring Token Failed. | | `9135` | Card Recurring Auto Void Failed. | | `9136` | Card Recurring Token Unregistration Failed. | | `9137` | Card MIGS Transaction Number not found. (`queryDR`, `vpc_DRExists `: N) | | `9138` | Card MIGS `SecureHash` not match. | | `9139` | Card MIGS Amount not match. | | `9140` | Recurring Parameter CVV code is mandatary. | | `9141` | Recurring `AuthType` is '`1`' or '`2`'. | | `9142` | Cards issued overseas can not be ed. | | `9143` | Card PreAuth Token Failed. | | `9144` | Card PreAuth Token Unregistration Failed. | | `9145` | Capture amount must be less than pre-authorised amount. | | `9146` | Failed to card token inquiry. | | `9147` | Invalid s. | | `9148` | Recurring Token is only available for 3Ds. | | `9149` | Recurring Use Check : Fail. | | `9150` | Recurring CVV Check : Fail. | | `9151` | `cardBin` exist in `blackList`. | | `9152` | FDS Check : high risk score. | | `9153` | FDS Check : `binCountry` is not local card. | | `9154` | Card daily limit count over. | | `9155` | Card daily limit amount over. | | `9156` | FDS Check : server communication error. | | `9157` | There is no valid authentication data. make new . | | `9158` | Card Holder Name is Mandatory. | | `9159` | Transaction failed. contact . | | `9160` | Invalid expired date format `YYMM`. | | `9161` | Token not found. | | `9162` | FDS Check : `binCountry` is not permit to . | | `00` | Successful approval/completion or that V.I.P. PIN verification is valid. | | `01` | Refer to card issuer. | | `02` | Refer to card issuer, special condition. | | `03` | Invalid or provider. | | `04` | Pickup card. | | `05` | Do not honor. | | `06` | General Error. | | `07` | Pickup card, special condition (other than lost/stolen card). | | `08` | Honor with identification. | | `09` | Request in progress. | | `10` | Partial Approval. | | `11` | V.I.P. approval. | | `12` | Invalid . | | `13` | Invalid amount (currency conversion field overflow) or amount exceeds maximum for card program. | | `14` | Invalid account number (no such number). | | `15` | No such issuer. | | `16` | Insufficient funds. | | `17` | cancellation. | | `19` | Re-enter . | | `20` | Invalid response. | | `21` | No action taken (unable to back out prior ). | | `22` | Suspected Malfunction. | | `25` | Unable to locate record in file, or account number is missing from inquiry. | | `28` | File is temporarily unavailable. | | `30` | Format Error. | | `41` | Pickup card (lost card). | | `43` | Pickup card (stolen card). | | `51` | Insufficient funds. | | `52` | No checking account. | | `53` | No savings account. | | `54` | Expired card. | | `55` | Incorrect PIN. | | `57` | Transaction not permitted to cardholder. | | `58` | Transaction not allowed at terminal. | | `59` | Suspected fraud. | | `61` | Activity amount limit exceeded. | | `62` | Restricted card (for example, in Country Exclusion table). | | `63` | Security violation. | | `65` | Activity count limit exceeded. | | `68` | Response received too late. | | `75` | Allowable number of PIN - entry tries exceeded. | | `76` | Unable to locate previous message (no match on Retrieval Reference number). | | `77` | Previous message located for a repeat or reversal, but repeat or reversal data are inconsistent with original message. | | `78` | ’Blocked, first used’ - The is from a new cardholder, and card has not been properly unblocked. | | `80` | Visa s: credit issuer unavailable. Private label and check acceptance: Invalid date. | | `81` | PIN cryptographic error found (error found by VIC security module during PIN decryption). | | `82` | Negative CAM, dCVV, iCVV, or CVV results. | | `83` | Unable to verify PIN. | | `85` | No reason to decline a request for account number verification, address verification, CVV2 verification, or a credit voucher or merchandise return. | | `91` | Issuer unavailable or switch inoperative (STIP not applicable or available for this ). | | `92` | Destination cannot be found for routing. | | `93` | Transaction cannot be completed, violation of law. | | `94` | Duplicate Transmission. | | `95` | Reconcile error. | | `96` | System malfunction, System malfunction or certain field error conditions. | | `B1` | Surcharge amount not permitted on Visa cards (U.S. acquirers only). | | `N0` | Force STIP. | | `N3` | Cash not available. | | `N4` | Cashback request exceeds issuer limit. | | `N7` | Decline for CVV2 failure. | | `P2` | Invalid biller . | | `P5` | PIN Change/Unblock request declined. | | `P6` | Unsafe PIN. | | `Q1` | Stop Order. | | `R0` | Stop Order. | | `R1` | Revocation of Authorization Order. | | `R3` | Revocation of All Authorizations Order. | | `XA` | Forward to issuer . | | `XD` | Forward to issuer. | | `Z3` | Unable to go online. | | `C101` | Error setting mandatory fields, `TRANSACTION_TYPE` is empty! | | `C102` | Invalid value for `TRANSACTION_TYPE`! Acceptable Value : `QUERY`=`1`, `SALES`=`2`, `AUTHORIZED`=`3`, `CAPTURE`=`4` | | `C103` | This is not authorized, cannot to be captured. | | `C104` | Error setting mandatory fields, `MERCHANT_ACC_NO` is empty! | | `C105` | Invalid `MERCHANT_ACC_NO`! Unable to find with provided `MERCHANT_ACC_NO`. | | `C106` | The of this `MERCHANT_ACC_NO` is suspended! All s are not allowed temporary. check with administrator for . | | `C107` | The of this `MERCHANT_ACC_NO` is still pending and not yet activated. check with administrator for . | | `C108` | The of this `MERCHANT_ACC_NO` is invalid! check setting. | | `C109` | The setting of this `MERCHANT_ACC_NO` does not allow requested type. check setting. | | `C110` | The setting of this `MERCHANT_ACC_NO` do not allow request from this IP address. checks allow IP setting. | | `C111` | Error setting mandatory fields, `AMOUNT` is empty! | | `C112` | Invalid value for `AMOUNT` | | `C113` | Error setting mandatory fields, `CARD_NO` is empty! | | `C114` | Error setting mandatory fields, `CARD_EXP_MM` is empty! | | `C115` | Error setting mandatory fields, `CARD_EXP_YY` is empty! | | `C116` | Error setting mandatory fields, `CARD_CVC` is empty! | | `C117` | Invalid value for `CARD_NO`. `CARD_NO` must be numeric and with valid length! | | `C118` | Invalid value for `CARD_EXP_MM`. `CARD_EXP_MM` must be numeric and with valid length! | | `C119` | Invalid value for `CARD_EXP_YY`. `CARD_EXP_YY` must be numeric and with valid length! | | `C120` | Invalid value for `CARD_CVC`. `CARD_CVC` must be numeric and with valid length! | | `C121` | Invalid . call to check Settings. | | `C122` | Amount has been over limit for today. call to check Settings. | | `C123` | Transaction not permitted through this type. call to check Settings. | | `C124` | Undefined Error. Error Code:`1024`.` ` | | `C301` | Error setting mandatory fields, `TRANSACTION_ID` is empty! `TRANSACTION_ID` is required for `CAPTURE` type. | | `C302` | Error setting mandatory fields, `RETURN_URL` is empty! | | `C303` | Error setting mandatory fields, `RESPONSE_TYPE` is empty! | | `C304` | Error setting mandatory fields, `TXN_URL` is Null for `RESPONSE_TYPE` using HTTP! | | `C305` | Invalid value for `RESPONSE_TYPE` for non-3D ! Acceptable Value : HTTP, XML, PLAIN | | `C306` | Error setting mandatory fields, `TXN_SIGNATURE` is empty! | | `C307` | Invalid value for `TXN_SIGNATURE`! Computed signature does not match one included in request. | | `C308` | Invalid format for `TXN_SIGNATURE`! `TXN_SIGNATURE` must be length of 32, and in hexadecimal format. | | `C309` | Unable to find record! | | `C310` | `MERCHANT_ACC_NO` not matched with previous submitted request! To capture/query previous , please ensure `MERCHANT_ACC_NO` is same `MERCHANT_ACC_NO `submitted during previous . | | `C311` | `AMOUNT` not matched with previous submitted request! To capture/query previous , please ensure `AMOUNT` is same `AMOUNT` submitted during previous . | | `C312` | `CUSTOMER_ID` not matched with previous submitted request! To capture/query previous , if this field is being used, please ensure `CUSTOMER_ID` is same `CUSTOMER_ID` submitted during previous . | | `C313` | `MERCHANT_TRANID` not matched with previous submitted request! To capture/query previous , please ensure `MERCHANT_TRANID` is same `MERCHANT_TRANID` submitted during previous . | | `C314` | Insecure mode for `RETURN_URL`. specify an URL which uses HTTPS protocol! | | `C315` | Insecure mode for `TXN_URL`. specify an URL which uses HTTPS protocol! | | `C401` | Error setting mandatory fields, `CARD_HOLDER_NAME `is empty! | | `C402` | Error setting mandatory fields, `MERCHANT_TRANID` is empty! | | `C403` | Duplicate `MERCHANT_TRANID` detected! ensure the `MERCHANT_TRANID` is always unique. | | `C404` | Error setting mandatory fields, `TXN_DESC` is empty! | | `C405` | Error setting mandatory fields for 3D , `MPI_CODE` is empty! | | `C406` | Error setting mandatory fields for 3D , `MPI_CAVV` is empty! | | `C407` | Error setting mandatory fields for 3D , `MPI_CAVV_ALG` is empty! | | `C408` | Error setting mandatory fields for 3D , `MPI_ECI` is empty! | | `C409` | Error setting mandatory fields for 3D , `MPI_MSG` is empty! | | `C501` | Error setting mandatory fields for fraud risk detection, `FR_HIGHRISK_EMAIL` is empty! | | `C502` | Error setting mandatory fields for fraud risk detection, `FR_HIGHRISK_COUNTRY` is empty! | | `C503` | Error setting mandatory fields for fraud risk detection, `FR_BILLING_ADDRESS` is empty! | | `C504` | Error setting mandatory fields for fraud risk detection, `FR_SHIPPING_ADDRESS` is empty! | | `C505` | Error setting mandatory fields for fraud risk detection, `FR_SHIPPING_COST` is empty! | | `C506` | Error setting mandatory fields for fraud risk detection, `CUSTOMER_IP` is empty! | | `C507` | Error setting mandatory fields for fraud risk detection, `FR_PURCHASE_HOUR` is empty! | | `C508` | Transaction was blocked due to fraud level exceeded threshold limit. | | `C509` | Transaction was blocked due to blacklisted card detected. | | `C601` | Unable to get connection to MPI Server! | | `C602` | Time out occurred during communication with MPI Server! | | `C603` | Unable to update MPI Ref. Number in . try again. | | `C604` | There was an error occurred during 3D authentication with MPI. check logs for details. | | `C605` | Invalid message or response received from MPI. try again. | | `C606` | MPI Settings are not configured correctly. check `MPI_HOST` and `MPI_PORT` in configuration. | | `C607` | Error occurred when trying to display ACS Form in web browser for 3D authentication. try again. | | `C608` | Problem occurred on MPI side, cannot to display ACS Form. check MPI message or try again. | | `C609` | Unable to locate back to update after 3-D authentication . try again. | | `C610` | Empty response received from MPI, please try again. | | `C611` | MPI Code received is not allowed to to the . | | `C612` | Transaction was aborted because 3-D authentication is not completed. | | `C613` | Attempted duplicate submission of 3-D authentication result. try with new . | | `C614` | MALL NAME is required for 3-D . call to check Settings. | | `C615` | MALL URL is required for 3-D . call to check Settings. | | `C616` | Invalid value for `RESPONSE_TYPE` for 3D ! Acceptable Value : HTTP only | | `C801` | This `MERCHANT_ACC_NO` is not authorized to with this via website! check setting. | | `C802` | This `MERCHANT_ACC_NO` is not authorized to with this via batch upload! check setting. | | `C803` | Exception while query Server! | | `C804` | Exception while checking for fraud risk! | | `C999` | Internal Exception. call to report. | | `C988` | Server Time Out Exception. | | `C977` | Connection Error! | | `C966` | Reply from is empty/incorrect! | | `C967` | Bank rejected ! | | `C955` | Error when trying to insert table. Transaction ID is empty! | | `C933` | Server interruption occurred during ing. Manual checking required. inform Administrator. | | `C935` | Cancel by . | | `C937` | Insufficient point to redeem in cardholder's account. enter another card number. | | `1` | Transaction could not be ed. | | `2` | Transaction Declined - Contact Issuing . | | `3` | Transaction Declined - No reply from . | | `4` | Transaction Declined - Expired Card. | | `5` | Transaction Declined - Insufficient credit. | | `6` | Transaction Declined - error. | | `7` | Server Processing Error - Typically caused by invalid input data such as an invalid number. Processing errors can also occur. (This is only relevant for Servers that enforce uniqueness of this field) Processing errors can also occur. | | `8` | Transaction Declined - Transaction Type Not Supported. | | `9` | Declined Transaction (Do not contact ). | | `A` | Transaction Aborted. | | `B` | Transaction Blocked - Returned. | | `C` | Transaction Cancelled. | | `D` | Deferred Transaction. | | `E` | Transaction Declined - Refer to card issuer. | | `F` | 3D Secure Authentication Failed. | | `I` | Card Security Code Failed. | | `L` | Shopping Transaction Locked (This indicates that there is another taking place using same shopping number). | | `N` | Cardholder is not enrolled in 3D Secure (Authentication Only). | | `P` | Transaction is Pending. | | `R` | Retry Limits Exceeded, Transaction Not Processed. | | `T` | Address Verification Failed. | | `U` | Card Security Code Failed. | | `V` | Address Verification and Card Security Code Failed. | # Virtual Account *** | **Nilai** | **Deskripsi** | | --------- | ------------------------------------------------------------------------------------------------------- | | `8041` | registration error | | `8042` | The `tXid` error during registration. | | `8045` | `requestVacctCustomerInquiryAPI` is null. | | `9201` | Server is busy. kindly try again in few minutes. | | `9202` | Server is busy. kindly try again in few minutes. | | `9203` | Failed to generate . Pool is empty or reached maximum. | | `9204` | Server is busy. kindly try again in few minutes. | | `9205` | Failed to generate . Invalid . | | `9206` | Server is busy. kindly try again in few minutes. | | `9207` | Reference Number Maximum Length Exceed. \[`referenceNo`] should have maximum 40 characters length. | | `9208` | Error in non-usage of criterion . | | `9209` | The amount is too small. | | `9210` | Error in expiration date of deposit, expiration time for deposit, and inclusion of letters. | | `9211` | Expiration date and time for deposit length is not valid. | | `9212` | Error of check for ID, . | | `9213` | `TB_TRANS_HISTORY` registration error. | | `9214` | Failed in inquiring interval. | | `9215` | Order number redundancy check (`TB_MOID_VERIFY`) updates error. | | `9216` | failure ledger (`TB_VACCT_FAIL`) registration error. | | `9217` | Order number redundancy check (`TB_MOID_VERIFY`) delete error. | | `9218` | ledger inquiry failure. | | `9219` | Server is busy. kindly try again in few minutes. | | `9220` | Server is busy. kindly try again in few minutes. | | `9221` | Error in non-usage of criterion (`VACCT_SET`). | | `9222` | Error in non-usage of criterion (`VACCT_CONT`). | | `9223` | Invalid ID. | | `9224` | Error of check for `customerId`. | | `9225` | Invalid Token. Contact for further . | | `9226` | `VacctNo` is exceeded limit digit. | | `9227` | DB insert error. | | `9228` | Transaction not found. | | `9229` | Fix account `accountType` error. | | `9230` | Not exist `customerId`. | | `9231` | Data is null error. | | `9232` | `iMid` is exist. | | `9233` | `vacctNo` is duplicate. | | `9234` | `customerId` already exist. | | `9235` | Invalid name. | | `9236` | Try check date. | | `9237` | Invalid `BankCd`. | # CVS *** | **Nilai** | **Deskripsi** | | --------- | ------------------------------------------------------------------------------------------------------- | | `9501` | Server is busy. kindly try again in few minutes. | | `9502` | Server is busy. kindly try again in few minutes. | | `9503` | Failed to generate CVS Number. Pool is empty or reached maximum. | | `9504` | Server is busy. kindly try again in few minutes. | | `9505` | Failed to generate . Invalid CVS. | | `9506` | Server is busy. kindly try again in few minutes. | | `9507` | Reference Number Maximum Length Exceed. \[`referenceNo`] should have maximum 40 characters length. | | `9508` | Error in non-usage of criterion . | | `9509` | The amount is too small. | | `9510` | Error in expiration date of deposit, expiration time for deposit, and inclusion of letters. | | `9511` | Expiration date and time for deposit length is not valid. | | `9512` | Error of check for ID, . | | `9513` | `TB_TRANS_HISTORY` registration error. | | `9514` | Failed in inquiring interval. | | `9515` | Order number redundancy check (`TB_MOID_VERIFY`) updates error. | | `9516` | CVS Number failure ledger (`TB_CVS_FAIL`) registration error. | | `9517` | Order number redundancy check (`TB_MOID_VERIFY`) delete error. | | `9518` | CVS ledger inquiry failure. | | `9519` | Server is busy. kindly try again in few minutes. | | `9520` | Server is busy. kindly try again in few minutes. | | `9521` | Error in non-usage of criterion (`CVS_SET`). | | `9522` | Error in non-usage of criterion (`MITRA_CONT`). | | `9523` | Invalid ID. | | `9524` | Error of check for `customerId`. | | `9525` | Invalid Token. Contact for further . | | `9526` | CVS Number is exceeded limit digit. | | `9527` | DB insert error. | | `9528` | Transaction not found. | | `9529` | Fix account `accountType` error. | | `9530` | Not exist `customerId`. | | `9531` | Data is null error. | | `9532` | `iMid` is exist. | | `9533` | CVS Number is duplicate. | | `9534` | `customerId` already exist. | | `9535` | Invalid name. | | `9536` | Try check date. | # Direct Debit *** | **Nilai** | **Deskripsi** | | --------- | ----------------------------------- | | `9801` | Generate ID Fail. | | `9802` | Invalid Parameter. | | `9803` | Fail.
| | `9804` | Invalid Token. | | `9805` | Invalid Card Number. | | `9806` | Transaction Fail. | | `9807` | Transaction Reversal Fail. | | `9808` | `TXID` is duplicate. | | `9809` | Failed in inquiring interval. | | `9810` | Other error. | # E-Wallet *** | **Nilai** | **Deskripsi** | | --------- | ----------------------- | | `9750` | Generate ID Fail. | | `9751` | Invalid Parameter. | | `9752` | Fail.
| [title] API Messaging [path] NICEPAY API/ :::hint{type="warning"} Bagian ini memuat informasi terkait Messaging . ::: ::::LinkArray{contentSource="CUSTOM"} :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/cycgQWWWccf5V0MG4Nft5_header-messaging-sms-api.jpg"} [SMS API](docId\:uyse9n3k63OOMugIq7Ieh) ::: :::: # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [API SNAP](docId\:Rz9KHBT6vz0PGg0jszAgn) untuk mengetahui terkait dengan standar . ::: :::VerticalSplitItem Kunjungi bagian [API Non-SNAP](docId\:kXzqsXIH06f-mIhtUQ7GN) untuk mengetahui informasi terkait API NICEPAY versi Non-SNAP. ::: :::: [title] Result Code [path] NICEPAY API/API Non-SNAP/NICEPAY Code/ *Result Code* adalah kode digunakan untuk memeriksa apakah berhasil atau gagal. Kode ini berlaku untuk semua dalam . | **Kode Hasil** | **Deskripsi** | | -------------- | ------------- | | `0000` | Success | | `9612` | Expired | | `9613` | Other Error | [title] Recurring - Payment API Credit Card [path] NICEPAY API/API Non-SNAP/Payment API/API Credit Card/Payment - API Credit Card/ # Tentang Recurring - Payment API Credit Card *** Pembayaran tipe Recurring adalah fitur lain dari dapat melakukan suatu tagihan dari secara berkala dengan nominal sama seperti ditagihkan pada awal . digunakan pada tahap ini sama dengan untuk tipe Full & Installment dan Pre-Auth & Capture. Namun, terdapat perbedaan pada *request* dikirimkan. akan memberikan sebuah `recurringToken` sebagai *response* disebut sebagai `recurring token making`. dapat menggunakan `recurringToken` pada request selanjutnya tanpa menggunakan `cardNo` dan `cardExpYymm`. # Recurring - Payment API Credit Card (First Payment) *** Untuk dapat mengaktifkan dengan jenis Recurring*,* wajib membayarkan sudah dibuat untuk mendapatkan `recurringToken` terlebih dahulu. | **API Endpoint** | `/nicepay/direct/v2/payment` | | ------------------------------------------------------------------------------ | ------------------------------------------------------------ | | **Method**
application/x-www-form-urlencoded | **POST****** | | **Description** | Recurring | | **Merchant Token** | SHA256(`timeStamp`+`iMid`+`referenceNo`+`amt`+`merchantKey`) | :::hint{type="info"} Spesifikasi digunakan sama dengan [API Recurring Token Credit Card](docId\:SjreJJRgOns-SDo4dqNE2). ::: ## Request Parameter for Recurring - Payment API Credit Card (First Payment) *** Berikut adalah *request payment* pada Recurring untuk mendapatkan `recurringToken` di mana diperlukan untuk menyelesaikan [Recurring - Registration API Credit Card](docId\:SjreJJRgOns-SDo4dqNE2) terlebih dahulu. masih membutuhkan `cardNo`, `cardExpYymm`, `cardCvv`, `cardHolderNm`& `cardHolderEmail` dari pada pertama dalam skema Recurring ini. | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ------------------------------------------------------------ | -------- | ---------- | -------------------------------------- | ---------------------------------------------------------------- | | `timeStamp`
Required | N | 14 | Request Timestamp (`YYYYMMDDHH24MISS`) | 20230522080502 | | `tXid`
Required | AN | 30 | Transaction ID | IONPAYTEST01202305220041509298 | | `referenceNo`
Required | ANS | 40 | Order Number | MerchantReferenceNumber001 | | `merchantToken`
Required | AN | 255 | Token | ff139e49606387091cd9baeadff3161aff6afd9406e1f481e0fdb8b46d1ae5ae | | `cardNo`
Required | N | 20 | Number | 51234500\*\*\*\*0000 | | `cardExpYymm`
Required | A | 4 | Card Expiry (`YYMM`) | 3901 | | `cardCvv`
Required | N | 4 | Card CVV | 100 | | `cardHolderNm`
Required | AN | 45 | Card Holder Name | John Doe

**Only alphabet allowed** | | `cardHolderEmail`
Required | ANS | 100 | Card Holder Email | johndoe\@gmail.com | | `callBackUrl`
Required | ANS | 255 | Result URL | https\://www\.nicepay.co.id/IONPAY\_CLIENT/paymentResult.jsp | ## Response Parameter for Recurring - Payment API Credit Card (First Payment) *** Berikut adalah rincian *response* dapatkan. Mohon untuk melakukan *save & store *`recurringToken` sudah didapat demi menjalankan fitur Recurring pada selanjutnya dengan sama. | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ---------------- | -------- | ---------- | --------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- | | `timeStamp` | N | 14 | Response Date
(`YYYYMMDDHH24MISS`) | 20230520135959 | | `resultCd` | N | 4 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | 0000 | | `resultMsg` | AN | 255 | [Result Message](docId\:yEh1VA9k2y6sL1kQF2aWD) | SUCCESS | | `tXid` | AN | 30 | Transaction ID | IONPAYTEST01202305161007570327 | | `referenceNo` | ANS | 40 | Order Number | MerchantReferenceNumber001 | | `payMethod` | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | 01

When Success | | `amount` | N | 12 | Amount | 10000

When Success | | `currency` | AN | 3 | Currency | IDR

When Success | | `goodsNm` | AN | 100 | Goods Name | Goods 1

When Success | | `billingNm` | AN | 100 | Buyer Name | John Doe

When Success | | `transDt` | N | 8 | Transaction Date
(`YYYYMMDD`) | 20230516

When Success | | `transTm` | N | 6 | Transaction Time
(`HH24MISS`) | 135959

When Success | | `description` | AN | 100 | Transaction Description | This Is The Description Of The

When Success | | `authNo` | N | 10 | Approval Number | 123456

When Success | | `issuBankCd` | A | 4 | [Issuing Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | CENA (Refer Code)

When Success | | `acquBankCd` | A | 4 | [Acquiring Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | BNIA (Refer Code)

When Success | | `cardNo` | AN | 20 | Card Number (Masked) | 51234500\*\*\*\*0008

When Success | | `cardExpYymm` | N | 4 | Card Expiry
(`YYMM`) | 3901

When Success | | `instmntMon` | N | 1 | Installment Month | 1

When Success | | `instmntType` | N | 2 | [Installment Type Code](docId:7CIX-U_4z295XgtNVEsbO)
| 1

When Success | | `ccTransType` | AN | 2 | [Credit Card Transaction Type](docId:8m3-7Smhm_jhdrE5pCRzp)
`1` Normal
`2` Recurring
`3` Pre-Auth
`4` Capture | 2

When Success | | `vat` | N | 12 | Value Added Tax ( ) | 0

When Success | | `fee` | N | 12 | Service Fee | 0

When Success | | `notaxAmt` | N | 12 | Tax Free Amount | 0

When Success | | `recurringToken` | AN | 64 | Token That Using Recurring | f19e3128784d0b33c189d5df21321c781b5bd107b185587fd8a54781aa845c84 | | `acquBankNm` | A | 255 | Acquiring Name | CIMB | | `issuBankNm` | A | 255 | Issuing Name | BCA | ## Sample Parameter for Recurring - Payment API Credit Card (First Payment) *** ### Request Parameter :::CodeblockTabs cURL ```curl curl --location 'https://dev.nicepay.co.id/nicepay/direct/v2/payment' \ --header 'X-FORWARDED-FOR: 1.2.3' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --data-urlencode 'timeStamp=20250930150955' \ --data-urlencode 'tXid=RECURRTEST01202509301555563979' \ --data-urlencode 'referenceNo=ordNo20250930150915' \ --data-urlencode 'merchantToken=bc2ee7790486a7ee4a5313d4c1d4088a38456b89204e308ae38e0beee3849d0b' \ --data-urlencode 'cardNo=5123450000000008' \ --data-urlencode 'cardExpYymm=3106' \ --data-urlencode 'cardCvv=100' \ --data-urlencode 'cardHolderNm=Nicepay Test' \ --data-urlencode 'callBackUrl=https://dev.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp?order_id=RECURRTEST01202509301555563979' ``` Node.js ```nodejs let secondVersion = new SecondApiVersion(config); let parameterPayment = { amt: "1000", referenceNo: "ordNo20250930150915", tXid: "RECURRTEST01202509301555563979", cardNo: "5123450000000008", callBackUrl: "https://dev.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp?order_id=RECURRTEST01202509301555563979", cardExpYymm: "3106", cardCvv: "100", recurringToken: "", // Leave empty for first payment cardHolderNm: "Nicepay Test", preauthToken: "", cardHolderEmail: "test@email.com", }; let response = secondVersion.requestPayment(parameterPayment); ``` ```java NICEPay config = NICEPay.builder() .isProduction(false) // Set to true for production .build(); Card requestData = Card.builder() .timeStamp("20250922143200") // Current timestamp (yyyyMMddHHmmss) .tXid("RECURRTEST01202509301555563979") // Transaction ID from registration .iMid("RECURRTEST") // Your NICEPay iMid .referenceNo("ordNo20250930150915") // Unique order reference .amt("1000") // Payment amount .merchantToken(timeStamp, iMid, reffNo, amount, MERCHANT_KEY) // Secure token generation .cardNo("5123450000000008") // Test card number .cardExpYymm("3601") // Card expiry date (YYMM) .cardCvv("100") // 3-digit CVV .cardHolderNm("NICEPAY TEST") // Cardholder name .callBackUrl("https://www.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp") // Callback URL .recurringToken("") // Leave empty for first payment .preauthToken("") // Leave empty if not pre-auth .build(); String responseHtml = V2CardService.callV2CardPaymentRequest(requestData, config); ``` ```python bodyPayment = ( builderPayment.BuildPayment() .setTimestamp(datetime.now().strftime("%Y%m%d%H%M%S")) # Current timestamp (yyyyMMddHHmmss) .setTxid("TESTMPGS0501202510011026450166") # Transaction ID from registration .setReferenceNo("ordNo20250930150915") # Unique order reference .setCashtag("") # Leave empty if not using cashtag .setCardNo("5123450000000008") # Test card number .setCardExpYymm("3901") # Card expiry date (YYMM) .setCardCvv("100") # 3-digit CVV .setRecurringToken("") # Leave empty if not recurring .setPreAuthToken("") # Leave empty for hold fund request .setAmt("1000") # Payment amount .build() ) environment = ( builderEnvironment.BuildEnvironment() .isCloud(False) # Set to True if using NICEPay Cloud .isProduction(False) # Set to True for production .build() ) response = ServiceNicepay.servicePayment( DataGenerator.getPaymentBody(bodyPayment.dataPayment()), environment ) ``` Vanilla JS ```javascript const paymentData = { cardNo: "5123450000000008", // Test card number cardExpYymm: "3601", // Card expiry in YYMM format cardCvv: "100", // 3-digit CVV cardHolderEmail: "customer@example.com", // Cardholder email cardHolderNm: "Nicepay Test", // Cardholder name callBackUrl: "https://your-domain.com/callback", // Callback URL after payment tXid: "RECURRTEST01202509301555563979", // Transaction ID from registration merchantToken: "bc2ee7790486a7ee4a5313d4c1d4088a38456b89204e308ae38e0beee3849d0b", // Secure token recurringToken: "", // Leave empty for first payment }; const response = await Nicepay.paymentTransaction(paymentData); ``` Laravel ```php $url = HttpUtil::getNicepayDomain($this->useProd, $this->useCloud) . $this->payment_endpoint; // Request body parameters $txid = "RECURRTEST01202509301555563979"; $timestamp = Carbon::now()->format("YmdHis"); // Current timestamp (yyyyMMddHHmmss) $reference_no = "ordNo20250930150915"; $amt = "1000"; // Generate secure merchant token $merchant_token = $this->generateMerchantToken( $timestamp, $this->imid, $reference_no, $amt, $this->mer_key ); $param = [ "timeStamp" => $timestamp, // Current timestamp "tXid" => $txid, // Transaction ID from registration "merchantToken" => $merchant_token, // Secure hash token "cardNo" => "5123450000000008", // Test card number "cardExpYymm" => "3901", // Card expiry date (YYMM) "cardCvv" => "100", // 3-digit CVV "callBackUrl" => "https://www.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp", // Callback URL "returnJsonFormat"=> "1", // Force JSON response format "recurringToken" => "", ]; $response = HttpUtil::redirectWithQueryParams($url, $param); ``` PHP Native ```php $config = NICEPay::builder() ->setIsProduction(true) // Set to false for sandbox/testing ->build(); $parameter = Card::builder() ->timeStamp($timestamp) // Current timestamp (yyyyMMddHHmmss) ->iMid("TESTMPGS05") // Your NICEPay iMid ->tXid("TESTMPGS0501202510011026450166") // Transaction ID from registration ->referenceNo("ordNo20251001101069") // Unique order reference ->merchantToken( $timestamp, $iMid, $referenceNO, $amt, $this->merchantKey ) // Generate secure token ->cardNo(TestConst::$CARD_NO) // Test card number from constants ->cardExpYymm(TestConst::$CARD_EXP_YYMM) // Card expiry date (YYMM) ->cardCvv(TestConst::$CARD_CVV) // 3-digit CVV ->cardHolderNm("Nicepay test") // Cardholder name ->callBackUrl("https://dev.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp?") // Callback URL after payment ->recurringToken("") ->build(); $cardService = new V2CardService($config); $response = $cardService->payment($parameter); ``` ```kotlin var config: NICEPay? = NICEPay.Builder() .isProduction(true) // Set to false for sandbox/testing .build() val request: DirectV2RequestPaymentCard = DirectV2RequestPaymentCard.Builder() .timeStamp("20250922143200") // Current timestamp (yyyyMMddHHmmss) .tXid("RECURRTEST01202509301555563979") // Transaction ID from registration .iMid("RECURRTEST") // Your NICEPay iMid .merchantKey(MERCHANT_KEY) // Secret merchant key .referenceNo("ordNo20250930150915") // Unique order reference number .amt("1000") // Payment amount .callBakUrl("https://www.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp") // Callback URL after payment .cardNo("5123450000000008") // Test card number .cardCvv("123") // 3-digit CVV (sample) .cardExpYymm("3601") // Card expiry date (YYMM) .recurringToken("") // Left empty for first payment .build() val response = paymentService.registration(request, config)!! ``` ::: ### Response Parameter :::CodeblockTabs Sample Response ```html
``` ::: # Continual Recurring - Payment API Credit Card *** Setelah melakukan pertama dan telah mendapatkan `recurringToken` pada [Recurring - Payment API Credit Card (First Payment)](docId\:E8D2ke74fVQIhMJ2zifJu)**. ** dapat menggunakan `recurringToken` tersebut untuk melakukan tagihan lain menggunakan kredensial sama demi menerapkan mekanisme secara berkala atau Recurring* (subscription)*. Namun, untuk menjalankan *payment continual recurring* ini, tetap diperlukan untuk melakukan registrasi terlebih dahulu pada [Recurring - Registration API Credit Card](docId\:SjreJJRgOns-SDo4dqNE2). Berikut adalah rincian *request *dan *response * digunakan pada berikutnya menggunakan recurring token sama. | **API Endpoint** | `/nicepay/direct/v2/payment` | | ------------------------------------------------------------------------------ | ------------------------------------------------------------ | | **Method**
application/x-www-form-urlencoded | **POST****** | | **Description** | Recurring Continual | | **Merchant Token** | SHA256(`timeStamp`+`iMid`+`referenceNo`+`amt`+`merchantKey`) | :::hint{type="info"} Spesifikasi digunakan sama dengan [API Recurring Token Credit Card](docId\:SjreJJRgOns-SDo4dqNE2). ::: ## Request Payment for Continual Recurring - Payment API Credit Card *** hanya perlu menggunakan `recurringToken` pada Recurring untuk *request* selanjutnya ini tanpa menggunakan `cardNo` dan `cardExpYymm`. | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ------------------------------------------------------------ | -------- | ---------- | -------------------------------------- | ---------------------------------------------------------------------------------------- | | `timeStamp`
Required | N | 14 | Request Timestamp (`YYYYMMDDHH24MISS`) | 20230522080502 | | `tXid`
Required | AN | 30 | Transaction ID | IONPAYTEST01202305220041509298 | | `referenceNo`
Required | ANS | 40 | Order Number | MerchantReferenceNumber001 | | `merchantToken`
Required | AN | 255 | Token | ff139e49606387091cd9baeadff3161aff6afd9406e1f481e0fdb8b46d1ae5ae | | `recurringToken`
Required | AN | 64 | Token That Using Recurring Payment | When Success

f19e3128784d0b33c189d5df21321c781b5bd107b185587fd8a54781aa845c84 | | `cardCvv`
Required | N | 4 | Card CVV | 100 | | `cardHolderNm`
Required | AN | 45 | Card Holder Name | John Doe

**Only alphabet allowed** | | `cardHolderEmail`
Required | ANS | 100 | Card Holder Email | johndoe\@gmail.com | | `callBackUrl`
Required | ANS | 255 | Result URL | https\://www\.nicepay.co.id/IONPAY\_CLIENT/paymentResult.jsp | :::hint{type="warning"} Mencantumkan `cardCVV` pada setiap bergantung dari MID tipe *CVV* atau *Non-CVV*. ::: ## Response Payment for Continual Recurring - Payment API Credit Card *** | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ------------- | -------- | ---------- | --------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- | | `timeStamp` | N | 14 | Response Date
(`YYYYMMDDHH24MISS`) | 20230520135959 | | `resultCd` | N | 4 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | 0000 | | `resultMsg` | AN | 255 | [Result Message](docId\:yEh1VA9k2y6sL1kQF2aWD) | SUCCESS | | `tXid` | AN | 30 | Transaction ID | IONPAYTEST202206230959067259 | | `referenceNo` | ANS | 40 | Order Number | MerchantReferenceNumber001 | | `payMethod` | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | 01

When Success | | `amt` | N | 12 | Payment Amount | 10000

When Success | | `currency` | AN | 3 | Currency | IDR

When Success | | `goodsNm` | AN | 100 | Goods Name | Merchant Goods 1

When Success | | `billingNm` | AN | 100 | Buyer Name | John Doe

When Success | | `transDt` | N | 8 | Transaction Date
(`YYYYMMDD`) | 20230516

When Success | | `transTm` | N | 6 | Transaction Time
(`HH24MISS`) | 135959

When Success | | `description` | AN | 100 | Transaction Description | This Is The Description Of The

When Success | | `authNo` | N | 10 | Approval Number | 123456

When Success | | `issuBankCd` | A | 4 | [Issuing Bank Code](docId\:QBEQ29LJ53Z-VbvXTvB7L) | CENA (Refer Code)

When Success | | `acquBankCd` | A | 4 | [Acquiring Bank Code](docId\:QBEQ29LJ53Z-VbvXTvB7L) | CENA (Refer Code)

When Success | | `cardNo` | AN | 20 | Card Number (Masked) | 51234500\*\*\*\*0008

When Success | | `cardExpYymm` | N | 4 | Card Expiry
(`YYMM`) | 3901

When Success | | `instmntMon` | N | 1 | Installment Month | 1

When Success | | `instmntType` | N | 2 | [Installment Type Code](docId:7CIX-U_4z295XgtNVEsbO) | 1

When Success | | `ccTransType` | AN | 2 | [Credit Card Transaction Type](docId:8m3-7Smhm_jhdrE5pCRzp)
`1` Normal
`2` Recurring
`3` Pre-Auth
`4` Capture | 2

When Success | | `vat` | N | 12 | Value Added Tax () | 0

When Success | | `fee` | N | 12 | Service Fee | 0

When Success | | `notaxAmt` | N | 12 | Tax Free Amount | 0

When Success | | `acquBankNm` | A | 255 | Acquiring Name | CIMB | | `issuBankNm` | A | 255 | Issuing Name | BCA | ## Sample Parameter for Continual Recurring - Payment API Credit Card *** ### Request Parameter :::CodeblockTabs cURL ```curl curl --location 'https://dev.nicepay.co.id/nicepay/direct/v2/payment' \ --header 'X-FORWARDED-FOR: 1.2.3' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --header 'Cookie: JSESSIONID=95539D2A218BD0BA1EA20D10878B53E2.pg_was1' \ --data-urlencode 'timeStamp=20250930170957' \ --data-urlencode 'tXid=RECURRTEST01202509301729488790' \ --data-urlencode 'referenceNo=ordNo20250930170928' \ --data-urlencode 'merchantToken=7c60ad0bfb38e1599bbcee61e3bba438bf9f6ffbbaa0d1cfc561c9fdcd24f89d' \ --data-urlencode 'cardHolderNm=Nicepay Test' \ --data-urlencode 'recurringToken=20b50427bc05cba305b0d580bf403e3c8487db29454459a920b6af358e435035' \ --data-urlencode 'callBackUrl=https://dev.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp?order_id=RECURRTEST01202509301729488790' ``` Node.js ```nodejs let secondVersion = new SecondApiVersion(config); let parameterPayment = { amt: "1000", referenceNo: "ordNo20250930170928", tXid: "RECURRTEST01202509301729488790", callBackUrl: "https://dev.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp?order_id=RECURRTEST01202509301555563979", cardHolderNm: "Nicepay Test", recurringToken: "20b50427bc05cba305b0d580bf403e3c8487db29454459a920b6af358e435035", cardHolderEmail: "test@email.com", }; let response = secondVersion.requestPayment(parameterPayment); ``` ```java NICEPay config = NICEPay.builder() .isProduction(false) // Set to true for production .build(); Card requestData = Card.builder() .timeStamp("20250922143200") // Current timestamp (yyyyMMddHHmmss) .tXid("RECURRTEST01202509301729488790") // Transaction ID from registration .iMid("RECURRTEST") // Your NICEPay iMid .referenceNo("ordNo20250930170928") // Unique order reference .amt("1000") // Payment amount .merchantToken(timeStamp, iMid, reffNo, amount, MERCHANT_KEY) // Secure token generation .cardHolderNm("NICEPAY TEST") // Cardholder name .callBackUrl("https://www.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp") // Callback URL .recurringToken("20b50427bc05cba305b0d580bf403e3c8487db29454459a920b6af358e435035") // Leave empty for first payment .preauthToken("") // Leave empty if not pre-auth .build(); String responseHtml = V2CardService.callV2CardPaymentRequest(requestData, config); ``` ```python bodyPayment = ( builderPayment.BuildPayment() .setTimestamp(datetime.now().strftime("%Y%m%d%H%M%S")) # Current timestamp (yyyyMMddHHmmss) .setTxid("RECURRTEST01202509301729488790") # Transaction ID from registration .setReferenceNo("ordNo20250930170928") # Unique order reference .setCashtag("") .setRecurringToken("20b50427bc05cba305b0d580bf403e3c8487db29454459a920b6af358e435035") # Leave empty if not recurring .setPreAuthToken("") # Leave empty if not pre-auth .setAmt("1000") # Payment amount .build() ) environment = ( builderEnvironment.BuildEnvironment() .isCloud(False) # Set to True if using NICEPay Cloud .isProduction(False) # Set to True for production .build() ) response = ServiceNicepay.servicePayment( DataGenerator.getPaymentBody(bodyPayment.dataPayment()), environment ) ``` Vanilla JS ```javascript const paymentData = { cardHolderEmail: "customer@example.com", // Cardholder email cardHolderNm: "Nicepay Test", // Cardholder name callBackUrl: "https://your-domain.com/callback", // Callback URL after payment tXid: "RECURRTEST01202509301729488790", // Transaction ID from registration merchantToken: "bc2ee7790486a7ee4a5313d4c1d4088a38456b89204e308ae38e0beee3849d0b", // Secure token recurringToken: "20b50427bc05cba305b0d580bf403e3c8487db29454459a920b6af358e435035", // Leave empty for first payment }; const response = await Nicepay.paymentTransaction(paymentData); ``` Laravel ```php $url = HttpUtil::getNicepayDomain($this->useProd, $this->useCloud) . $this->payment_endpoint; // Request body parameters $txid = "RECURRTEST01202509301729488790"; $timestamp = Carbon::now()->format("YmdHis"); // Current timestamp (yyyyMMddHHmmss) $reference_no = "ordNo20250930170928"; $amt = "1000"; // Generate secure merchant token $merchant_token = $this->generateMerchantToken( $timestamp, $this->imid, $reference_no, $amt, $this->mer_key ); $param = [ "timeStamp" => $timestamp, // Current timestamp "tXid" => $txid, // Transaction ID from registration "merchantToken" => $merchant_token, // Secure hash token "callBackUrl" => "https://www.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp", // Callback URL "returnJsonFormat"=> "1", // Force JSON response format "recurringToken" => "20b50427bc05cba305b0d580bf403e3c8487db29454459a920b6af358e435035", ]; $response = HttpUtil::redirectWithQueryParams($url, $param); ``` PHP Native ```php $config = NICEPay::builder() ->setIsProduction(true) // Set to false for sandbox/testing ->build(); $parameter = Card::builder() ->timeStamp($timestamp) // Current timestamp (yyyyMMddHHmmss) ->iMid("IONPAYTEST") // Your NICEPay iMid ->tXid("RECURRTEST01202509301729488790") // Transaction ID from registration ->referenceNo("ordNo20250930170928") // Unique order reference ->merchantToken( $timestamp, $iMid, $newCCTrx->getReferenceNo(), $newCCTrx->getAmt(), $this->merchantKey ) // Generate secure token ->cardHolderNm("Nicepay test") // Cardholder name ->callBackUrl("https://dev.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp?") // Callback URL after payment ->recurringToken("20b50427bc05cba305b0d580bf403e3c8487db29454459a920b6af358e435035") ->build(); $cardService = new V2CardService($config); $response = $cardService->payment($parameter); ``` ```kotlin var config: NICEPay? = NICEPay.Builder() .isProduction(true) // Set to false for sandbox/testing .build() val request: DirectV2RequestPaymentCard = DirectV2RequestPaymentCard.Builder() .timeStamp("20250922143200") // Current timestamp (yyyyMMddHHmmss) .tXid("RECURRTEST01202509301555563979") // Transaction ID from registration .iMid("RECURRTEST") // Your NICEPay iMid .merchantKey(MERCHANT_KEY) // Secret merchant key .referenceNo("ordNo20250930150915") // Unique order reference number .amt("1000") // Payment amount .callBakUrl("https://dev.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp") // Callback URL after payment .recurringToken("20b50427bc05cba305b0d580bf403e3c8487db29454459a920b6af358e435035") // Left empty for first payment .build() val response = paymentService.registration(request, config)!! ``` ::: ### Response Parameter :::CodeblockTabs Sample Response ```html
``` ::: # CallBack Handling for Full Payment & Installment - Payment API Credit Card *** :::hint{type="info"} `tXid` tidak akan sama dengan *request hold. *Proses Capture akan memastikan bahwa nilai `amount` di-*capture* tidak melebihi dana dimiliki ::: :::hint{type="success"} Saat *Callback *telah diterima `callbackUrl` , kami sangat menganjurkan untuk melakukan verifikasi menggunakan [Status Inquiry - API Credit Card](docId\:voJ9rhAQRLcF-_74cYrFi). ::: :::hint{type="warning"} `CallBack Handling` dapat sangat membantu untuk meminimalisir terjadinya *Fraud*, kami sangat merekomendasikan untuk melakukan verifikasi `CallBack Handling`. ::: :::CodeblockTabs URL CallBack ```json "callbackUrl" : "https://www.merchant.com/callbackUrl/" ``` Response CallBack ```json { "resultCd":"0000", "resultMsg":"SUCCESS", "tXid":"IONPAYTEST01202212141112221428", "referenceNo":"", "payMethod":"01", "amt":"10000", "transDt":"20221212", "transTm":"121212", "description":"Testing Credit Card Transaction", "authNo":"080623", "issuBankCd":"OTHR" "acquBankCd":"BMRI", "cardNo":"453211*****1111", "goodsNm":"Test Transaction Nicepay" "billingNm":"John Doe", "currency":"IDR", "timeStamp":"20221212121212", "merchantToken":"2035d2295d9578fffb40137186f0203474142ae3e57992d4847826c5fcaffce6", "cardExpYymm":"2712", "instmntMon":"1", "instmntType":"1", "ccTransType":"1" } ``` ::: [title] SMS API [path] NICEPAY API/API Messaging/ Untuk dapat menggunakan , perlu mengintegrasikan ini dengan pada . **SMS API** merupakan koleksi dapat gunakan dalam pengiriman kepada atau penerima pesan lainnya. # Alur Proses *** ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/LKe96W66EWXEIjA-OFZVt_nicepay-archbee-payment-sms.png "Alur SMS API") 1. melakukan pendaftaran data. 2. mengirim data menggunakan Registration kepada . 3. mendaftarkan data. 4. mengirimkan info data kepada *service* NICE . 5. NICE mengirimkan *response *data kepada . 6. mengirimkan info data kepada . 7. NICE SMS akan mengirimkan info kepada . 8. melakukan info data dan menyimpannya ke dalam DB. 9. mengirim data kepada . 10. mengirim pengajuan kepada . 11. mengirimkan *response *info 200 - OK kepada . # Spesifikasi Integrasi *** | **Istilah** | **Deskripsi** | **Spesifikasi** | | --------------- | ------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `Merchant` | Perusahaan e-Commerce atau toko menggunakan Layanan | | | `Merchant Key` | Kunci autentikasi disediakan oleh | Harus aman | | `MerchantToken` | Token dari sisi | Jangan membuat Token dari sisi Klien | | `iMid` | ID | | | `tXid` | ID | | | `smsMsg` | Isi pesan | **Panjang Pesan**
akan menyediakan pengiriman pesan dalam satu hingga 640 karakter atau 4 Message , dengan detail sebagai berikut:
* 160 karakter = 1 pesan * Jika lebih dari 160 karakter, akan dihitung sebagai berikut: - Semua Telecom Operator (Non XL). - 161 - 320 karakter = 2 pesan. - 321 - 459 karakter = 3 pesan. - 481 - 640 karakter = 4 pesan. - XL Telecom Operator. - 161 - 306 karakter = 2 pesan. - 307 - 459 karakter = 3 pesan. - 460 - 612 karakter = 4 pesan.

**Karakter yang Berlaku**
* *Alphabets* (*lowercase*, *uppercase*) * *Number* * *Special Characters* `! @ $ * ( ) - + & _ = . , : ; / \ ? { } " %` (*space*) (*enter*) | | `smsType` | Untuk mendefinisikan tipe dikirimkan | `0` : Normal
`1` : Alert
`2` : OTP

Untuk OTP, menjamin waktu pengiriman dari perusahaan ke Telco di bawah 300 detik dan OTP akan diturunkan ketika waktu pengiriman lebih dari 300 detik. | :::hint{type="info"} Untuk *Special Character* % harus diikuti oleh spasi. ::: # Macam-macam SMS API *** ::::LinkArray{contentSource="CUSTOM"} :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/SoKMtx5pTVqRtyb3DMynw_header-messaging-sms-api-sms-transmit.jpg"} [SMS Transmit](docId:0GwdGdsFm3-FGBHjsK7PO) digunakan untuk mengirimkan . ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/tZ8yq84MbbF95ZOeIA1Vl_header-messaging-sms-api-notification-sms.jpg"} [Notification SMS](docId\:hcRdbFh-9v_6do48MShRg) digunakan untuk memeriksa pengiriman . ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/l445nK6Kcm2z5EhFrmzWw_header-messaging-sms-api-inquiry-sms.jpg"} [Inquiry SMS](docId:0bfa4LFEowD2edz37yLWh) digunakan untuk memeriksa pengiriman berhasil. ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/CaSCeI1QRijZSsMGp1H28_header-messaging-sms-api-nicepay-code.jpg"} [NICEPAY Code - SMS API](docId\:N2oxXgoG4B2X3YNWn7r7A) adalah daftar kode digunakan dalam . ::: :::: # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem bagian [API SNAP](docId\:Rz9KHBT6vz0PGg0jszAgn) untuk mengetahui informasi terkait dengan standar . ::: :::VerticalSplitItem [FAQ NICEPAY API](docId\:ySpUrGl213ZdsUebbLSaG) jika ingin mengetahui pertanyaan sering diajukan terkait . ::: :::: [title] Payment Method Code [path] NICEPAY API/API Non-SNAP/NICEPAY Code/ Kode ini digunakan sebagai sarana dalam . Saat ini, telah memiliki 8 tersedia, yaitu (CC), , , , , , , dan . Berikut ini adalah *value* dapat digunakan untuk mengisi `paymentMehod` pada . # General *** | **Value** | **Deskripsi** | **Kanal Pembayaran** | | --------- | --------------------------------------- | ---------------------------------------------------------------------------------------------------------- | | `00` | Seluruh aktif, dapat memilih di | Seluruh kanal aktif | | `01` | | *Acquiring*: Mandiri, BNI, BCA, CIMB, BRI | | `02` | | | | `03` | CVS () / Retail | Alfamart, Indomaret | | `04` | | Jenius | | `05` | | OVO, DANA, LinkAja, ShopeePay, AstraPay | | `06` | | Akulaku, Kredivo, Indodana | | `07` |
1) Disbursement 2) Cashout | 1. Disbursement: Mengirimkan dana dengan tujuan lebih dari 140 terdaftar di 2. Cashout: Indomaret | | `08` | | ShopeePay, NOBU | | `09` | Card | Artajasa | # Checkout API & Payment API *** ## Transaction Registration | **Kode** | **Metode Pembayaran** | **Deskripsi** | | -------- | --------------------- | ------------------------------------ | | `01` | | Order will be created | | `02` | | (`vacctNo`) will be created | | `03` | | Pay Number (`payNo`) will be created | | `04` | | Order will be created | | `05` | | Order will be created | | `06` | | Order will be created | | `08` | | Order and will be created | | `09` | Card | Order will be created | ## Cancel | **Kode** | **Metode Pembayaran** | | -------- | --------------------- | | `01` | | | `02` | | | `03` | | | `04` | | | `05` | | | `06` | | | `08` | | # Payout API *** | **Value** | **Deskripsi** | **Kanal Pembayaran** | | --------- | --------------------------------- | ---------------------------------------------------------------------------------------------------------- | | `07` |
1) Disbursement 2) Cashout | 1. Disbursement: Mengirimkan dana dengan tujuan lebih dari 140 yang terdaftar di . 2. Cashout: Indomaret | # Advance API *** ## Inquiry Detail | **Nilai** | **Deskripsi** | | --------- | --------------- | | `01` | | | `02` | | | `03` | CVS () / Retail | | `04` | | | `05` | | | `06` | | | `07` | | | `08` | | [title] Mitra Code [path] NICEPAY API/API Non-SNAP/NICEPAY Code/ *Code *digunakan sebagai *value *(Nilai) `mitraCd` pada , , , , dan . # General *** | **Nilai** | **Deskripsi** | **Metode Pembayaran** | | --------- | ----------------------------------- | --------------------- | | `ALMA` | Alfamart, Lawson, Dan+Dan, Alfamidi | | | `INDO` | Indomaret | | | `JENC` | Jenius Pay | | | `AKLP` | Akulaku | | | `KDVI` | Kredivo | | | `IDNA` | Indodana | | | `OVOE` | OVO | | | `LINK` | LinkAja | | | `DANA` | DANA | | | `ESHP` | ShopeePay | | | `ASTR` | Astrapay | | | `QSHP` | ShopeePay | | | `NOBU` | NOBU | | [title] Status Inquiry - API Convenience Store [path] NICEPAY API/API Non-SNAP/Payment API/API Convenience Store/ # Tentang API Convenience Store Status Inquiry *** Status Inquiry untuk diperlukan untuk untuk memeriksa kembali dilakukan , baik ber *success*, *fail*, dan lainnya. Sehingga, mendapatkan laporan mengenai atau tersebut. # API Convenience Store Status Inquiry *** Status Inquiry pada bertujuan untuk dapat terhubung dengan digunakan untuk melakukan pemeriksaan secara berkala. | **API Endpoint** | `/nicepay/direct/v2/inquiry ` | | ------------------ | ------------------------------------------------------------ | | **Request Method** | **POST****** | | **Description** | Performs Inquiry Request to for Status Checking | | **Merchant Token** | SHA256(`timeStamp`+`iMid`+`referenceNo`+`amt`+`merchantKey`) | | **Request Format** | `application/json` | :::hint{type="info"} Ketika diterima `dbProcessUrl` , kami sangat menganjurkan untuk melakukan verifikasi tersebut dengan menggunakan [Status Inquiry - API Convenience Store](docId\:WMITrWcw3j9ChajRg-o1D). ::: :::hint{type="info"} `Notification Handling` sangat berguna untuk meminimalisir terjadinya *Fraud*. Kami sangat menganjurkan untuk melakukan verifikasi `Notification Handling` melalui [Notification - API Convenience Store](docId\:XXDlG7Jk1xcLWxz6PSnp0). ::: ## Request Parameter for Convenience Store Status Inquiry *** Berikut ini adalah daftar untuk melakukan *request * inquiry pada . | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ------------------------------------------------------------ | -------- | ---------- | -------------------------------------- | ---------------------------------------------------------------- | | `timeStamp`
Required | N | 14 | Request Timestamp (`YYYYMMDDHH24MISS`) | 20170708123456 | | `tXid `
Required | AN | 30 | Transaction ID | IONPAYTEST00202212091011228108 | | `iMid`
Required | AN | 10 | ID | IONPAYTEST | | `referenceNo `
Required | ANS | 40 | Order Number | ORDER20221012080918 | | `amt `
Required | N | 12 | Transaction Amount | 1 | | `merchantToken `
Required | AN | 255 | Token | 666b397e7bce1d65e2cc553205ebab7330f9b2da8293b02c342279c1b6999ceb | ## Response Parameter for Convenience Store Status Inquiry *** Berikut ini adalah daftar *response *dari *request * inquiry pada . | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ------------- | -------- | ---------- | ----------------------------------------------------------- | ------------------------------ | | `resultCd` | N | 4 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | 0000 | | `resultMsg ` | AN | 255 | Result Message: [Error Code](docId\:yEh1VA9k2y6sL1kQF2aWD) | unpaid | | `tXid` | AN | 30 | Transaction ID | IONPAYTEST00202212091011228108 | | `iMid` | AN | 10 | ID | IONPAYTEST | | `referenceNo` | ANS | 40 | Reference Number | ORDER20221012080918 | | `payMethod` | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | 03 | | `amt` | N | 12 | Amount | 1 | | `CancelAmt` | N | 12 | Cancel Amount | | | `reqDt` | N | 8 | Transaction Request Date (`YYYYMMDD`) | 20221209 | | `reqTm` | N | 6 | Transaction Request Time (`HH24MISS`) | 101122 | | `transDt` | N | 8 | Transaction Date (`YYYYMMDD`) | | | `transTm` | N | 6 | Transaction Time (`HH24MISS`) | | | `depositDt ` | N | 8 | Transaction Deposit Date (`YYYYMMDD`) | | | `depositTm ` | N | 6 | Transaction Deposit Time (`HH24MISS`) | | | `currency` | A | 3 | Currency | IDR | | `goodsNm ` | AN | 100 | Goods Name | Test Transaction | | `billingNm` | A | 100 | Buyer Name | John Doe | | `status ` | N | 1 | [Payment Status Code](docId:8m3-7Smhm_jhdrE5pCRzp) | 3 | ## Additional Response Parameter for Others Status Inquiry *** Berikut ini adalah daftar respon tambahan dari request inquiry pada lainnya. | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ------------- | -------- | ---------- | ----------------------------------------------------------- | -------------------- | | `mitraCd` | A | 4 | [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8) (CVS, , , ) | ALMA | | `payNo` | N | 12 | CVS Number (CVS)
| 9041091011228108 | | `payValidDt` | N | 8 | CVS Expiry Date (`YYYYMMDD`) (CVS) | 20221216 | | `payValidTm` | N | 6 | CVS Expiry Time (`HH24MISS`) (CVS) | 235959 | | `receiptCode` | ANS | 20 | Authorization Code (CVS)
| | | `mRefNo` | AN | 20 | Reference Number () | | ## Sample JSON for Convenience Store Status Inquiry *** :::CodeblockTabs JSON Request ```json { "timeStamp":"20221012080918", "tXid":"IONPAYTEST00202212091011228108", "referenceNo":"ORDER20221012080918", "iMid":"IONPAYTEST", "amt":"1", "merchantToken":"666b397e7bce1d65e2cc553205ebab7330f9b2da8293b02c342279c1b6999ceb" } ``` JSON Response ```json { "tXid": "IONPAYTEST00202212091011228108", "iMid": "IONPAYTEST", "currency": "IDR", "amt": "1", "instmntMon": null, "instmntType": "1", "referenceNo": "ORDER20221012080918", "goodsNm": "Test Transaction Nicepay", "payMethod": "03", "billingNm": "John Doe", "reqDt": "20221209", "reqTm": "101122", "status": "3", "resultCd": "0000", "resultMsg": "unpaid", "cardNo": null, "preauthToken": null, "acquBankCd": null, "issuBankCd": null, "vacctValidDt": null, "vacctValidTm": null, "vacctNo": null, "bankCd": null, "payNo": "9041091011228108", "mitraCd": "ALMA", "receiptCode": null, "cancelAmt": null, "transDt": "20221209", "transTm": "101122", "recurringToken": null, "ccTransType": null, "payValidDt": "20221216", "payValidTm": "235959", "mRefNo": null, "acquStatus": null, "cardExpYymm": null, "acquBankNm": null, "issuBankNm": null, "depositDt": null, "depositTm": null, "paymentExpDt": null, "paymentExpTm": null, "paymentTrxSn": null, "cancelTrxSn": null, "userId": null, "shopId": null } ``` Java Request ```java //Inquiry Registration// nicePay.setTimeStamp("20221208091279"); nicePay.setiMid("IONPAYTEST"); nicePay.setAmt("10000"); nicePay.setReferenceNo("ordNo20221202141217"); nicePay.setMerchantToken(nicePay.makeToken(nicePay.getMerchantToken()); nicePay.settXid("IONPAYTEST08202212080918308275"); // Request Inquiry nicePay.inquiry(); // Response String // System.out.println("Final Response String : " + nicePay.getResponseString()); String resultCd = nicePay.Get("resultCd"); String resultMsg = nicePay.Get("resultMsg"); String tXid = nicePay.Get("tXid"); String referenceNo = nicePay.Get("referenceNo"); String payMethod = nicePay.Get("payMethod"); String status = nicePay.Get("status") String amt = nicePay.Get("amt"); String transDt = nicePay.Get("transDt"); String transTm = nicePay.Get("transTm"); ``` ::: [title] Inquiry - DANA Recurring API [path] NICEPAY API/API Non-SNAP/Advance API/E-Wallet - Advance API/DANA Recurring - E-Wallet API Advance/ # Tentang Inquiry - DANA Recurring API *** Integrasi Inquiry pada DANA Recurring diperlukan supaya dapat memeriksa berlangsung pada dilakukan oleh , baik *success*, *fail*, dan lainnya. Sehingga, dapat memiliki laporan mengenai tersebut. # Inquiry - DANA Recurring API *** | **API Endpoint** | `/nicepay/direct/v2/inquiry` | | ------------------ | -------------------------------------------------------------------------------------------------------------- | | **Request Method** | ******POST ,**** JSON** | | **Description** | can check using Inquiry .
If receive , strongly recommend that check again using Inquiry . | | **Merchant Token** | SHA256(`timeStamp`+`iMid`+`referenceNo`+`amt`+`merchantKey`) | ## Request Parameter Inquiry - DANA Recurring API *** Berikut ini adalah daftar untuk melakukan *request * inquiry pada DANA Recurring . | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ---------------------------------------------------------- | -------- | ---------- | ------------------ | ---------------------------------------------------------------- | | `timeStamp`
Required | N | 14 | Request Date | 20170708123456 | | `tXid`
Required | AN | 30 | Transaction ID | IONPAYTEST05202108231310459282 | | `iMid`
Required | AN | 10 | ID | IONPAYTEST | | `referenceNo`
Required | ANS | 40 | Order Number | OrdNo20217131024122 | | `amt`
Required | N | 12 | Transaction Amount | 100 | | `merchantToken`
Required | AN | 255 | Token | be5ac4d19e833d3488dfa48bf388d7510100c2fbc215c9b19c1ae644fd861919 | ## Response Parameter Inquiry - DANA Recurring API *** Berikut ini adalah daftar *response* dari inquiry pada DANA Recurring. | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ------------- | -------- | ---------- | ---------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `resultCd` | N | 4 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | 0000 | | `resultMsg` | AN | 255 | Result Message | SUCCESS | | `tXid` | AN | 30 | Transaction ID (Key from ) | IONPAYTEST05202108231310459282 | | `iMid` | AN | 10 | ID | IONPAYTEST | | `referenceNo` | ANS | 40 | Order Number (Key from ) | OrdNo20217131024122 | | `payMethod` | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | `05`: | | `amt` | N | 12 | Amount | 100 | | `cancelAmt` | N | 12 | Cancel Amount | 100 | | `reqDt` | N | 8 | Transaction Request Date (`YYYYMMDD`) | 20160301 | | `reqTm` | N | 6 | Transaction Request Time (`YYYYMMDD`) | 135959 | | `transDt` | N | 8 | Transaction Date (`YYYYMMDD`) | 20160303 | | `transTm` | N | 6 | Transaction Time (`YYYYMMDD`) | 135959 | | `mitraCd` | A | 4 | [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8) | DANA | | `currency` | AN | 3 | Currency | IDR | | `goodsNm` | AN | 100 | Goods Name |  Goods 1 | | `billingNm` | AN | 30 | Buyer Name | Buyer Name | | `payValidDt` | N | 8 | CVS Expiry Date (`YYYYMMDD`) | 20170313 | | `payValidTm` | N | 6 | CVS Expiry Time (`YYYYMMDD`) | 135959 | | `status` | N | 1 | Transaction Status | `0`: Paid
`1`: Void
`2`: Refund
`3`: Unpaid
`4`: Expired (VA, CVS, ClickPay-Cancel)
`5`: Preauthed
`8`: Fail
`9`: Init (Reversal) | ## Sample Parameter Inquiry - DANA Recurring API *** :::CodeblockTabs Sample Request ```json { "timeStamp": "20211015101074", "tXid": "IONPAYTEST05202108231310459282", "iMid": "IONPAYTEST", "referenceNo": "OrdNo20217131024122", "amt": "100", "merchantToken": "91a1abeb40603a1301d3dfba044d14d0d70b907d8f4e485bcf71394415c5feca" } ``` Sample Response ```json { "tXid": "IONPAYTEST05202108231310459282", "iMid": "IONPAYTEST", "currency": "IDR", "amt": "100", "instmntMon": null, "instmntType": "1", "referenceNo": "OrdNo20217131024122", "goodsNm": "Nicepay Subscription", "payMethod": "05", "billingNm": "HongGilDong", "reqDt": "20210823", "reqTm": "131045", "status": "0", "resultCd": "0000", "resultMsg": "paid", "cardNo": null, "preauthToken": null, "acquBankCd": null, "issuBankCd": null, "vacctValidDt": null, "vacctValidTm": null, "vacctNo": null, "bankCd": null, "payNo": null, "mitraCd": "DANA", "receiptCode": null, "cancelAmt": null, "transDt": "20210823", "transTm": "131250", "recurringToken": null, "ccTransType": null, "payValidDt": null, "payValidTm": null, "mRefNo": null, "acquStatus": null, "cardExpYymm": null, "acquBankNm": null, "issuBankNm": null, "depositDt": null, "depositTm": null, "paymentExpDt": null, "paymentExpTm": null, "paymentTrxSn": null, "cancelTrxSn": null, "userId": null, "shopId": null } ``` ::: [title] DANA Recurring - E-Wallet API Advance [path] NICEPAY API/API Non-SNAP/Advance API/E-Wallet - Advance API/ # Tentang API DANA Recurring *** DANA Recurring digunakan oleh agar dapat melakukan secara berkala dengan menggunakan khusus DANA. # Proses Pada API DANA Recurring *** ::::LinkArray{contentSource="CUSTOM"} :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/ZzCCSZjUTXxf4WI8jrlsq-20260324-083727.jpg"} [Registration & First Payment - DANA Recurring API](docId\:QngCkmF9xhd6PS8sjxzED) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/B1Byy1gINnfOLhqabj2EZ-20260324-084155.jpg"} [Notification - DANA Recurring API](docId\:RqJL301xruHjLAAxYUJkc) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/7lDT1ME5tasTtqy_Be4yh-20260324-084626.jpg"} [Inquiry - DANA Recurring API](docId\:gxO4Xfjn_js-RXy0WFVBy) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/XBEBeoRRNSW11IFbchkFp-20260324-084645.jpg"} [Cancel & Remove - DANA Recurring API](docId\:f7fJvyopZY6UqIip_-jFJ) ::: :::: # Alur API DANA Recurring *** ![](https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-4Ugd6q0Tf6-Q0glULGQ1w-20250619-094215.jpg "API DANA Recurring Flow") Deskripsi langkah: 1. Pelanggan mengajukan *checkout* pada halaman Merchant dan Post-Form API kepada Merchant untuk memulai Recurring Issue. 2. Merchant mengajukan Post-Form API kepada NICEPAY. 3. NICEPAY mengarahkan Pelanggan menuju halaman OAuth DANA. 4. Pelanggan melakukan konfirmasi OAuth kepada DANA. 5. DANA mengirimkan perjanjian pengguna *(user agreement)* kepada NICEPAY. 6. NICEPAY mengajukan pembayaran pertama kepada DANA. 7. DANA mengirimkan *response *pembayaran pertama kepada NICEPAY. 8. DANA mengarahkan Pelanggan ke halaman DANA untuk melakukan *recurring (subscription)*. 9. Pelanggan melakukan konfirmasi *recurring (subscription) *kepada DANA. 10. DANA mengirimkan *callback *pembayaran pertama kepada NICEPAY. 11. NICEPAY menerima *callback *pembayaran pertama. 12. NICEPAY mengirimkan *callback *pembayaran pertama kepada Merchant. 13. DANA mengirimkan *push notification *kepada NICEPAY. 14. NICEPAY menerima *push notification*. 15. NICEPAY mengirimkan *callback push notification *kepada Merchant. 16. DANA mengirimkan *push notification *kepada NICEPAY pada fase Recurring Payment. 17. NICEPAY mengirimkan *push notification *(dengan `tXid` yang berbeda dan `referenceNo` yang sama dari Recurring Issue) kepada Merchant. 18. Apabila Merchant mengajukan Cancel/Remove Recurring kepada NICEPAY, maka: 1. Pada proses *Cancel Transaction*, NICEPAY mengajukan pembatalan transaksi kepada DANA menggunakan *value *`cancelType`; `1` pembatalan secara penuh *(Full Cancellation)* atau `2` pembatalan sebagian *(Partial Cancellation)*. 2. Pada proses *Remove Recurring*, NICEPAY mengajukan penghapusan *recurring *kepada DANA menggunakan *value *`cancelType`; `3` *Remove Subscription* / *Stop Recurring *dan `tXid` pada saat pembayaran pertama. 19. DANA mengirimkan *response data* kepada NICEPAY. 20. NICEPAY mengirimkan *response data *kepada Merchant. 21. Merchant mengajukan pengecekan status transaksi menggunakan Check Status API kepada NICEPAY. 22. NICEPAY mengirimkan *response* pengecekan status transaksi kepada Merchant. 23. Merchant menerima status akhir transaksi. 24. Merchant mengirimkan konfirmasi status transaksi kepada Pelanggan. :::hint{type="info"} Catatan untuk fase *Recurring Issue:* - Mohon simpan `tXid`*recurring issue* setelah menerima *callback* atau . `tXid` *recurring issue* digunakan untuk menghapus *recurring (unsubscription)*. - `referenceNo` adalah ID *recurring.* Catatan untuk fase Recurring : - akan mengirimkan `tXid` berbeda dari *recurring issue.* - akan mengirimkan `referenceNo` sama dengan *recurring issue.* ::: # Alur DANA Recurring dari Sisi Pengguna *** Berikut ini merupakan alur dilalui Pengguna untuk melakukan *account binding* dengan menggunakan DANA Recurring. 1\. Pengguna melakukan login pada akun DANA untuk memulai *account binding*. ![Login DANA Account](https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-yyL36a_DuASGSoi31HO4I-20250626-031152.png "Login DANA Account") 2\. Pengguna melakukan autentikasi dengan memasukkan PIN untuk menyetujui akses *binding *pada akun DANA. ![](https://archbee-image-uploads.s3.amazonaws.com/ho7Cq0xJG60lzOZLT7xI3-B6WX_Y8GtHcC2Pn0FY5G8-20250528-034738.png "DANA Recurring Access Binding Authentication") 3\. Setelah Account Binding selesai. Pengguna akan diarahkan menuju DANA yang akan menampilkan detail *subscription *kepada Pengguna. ![DANA Agreement Subscription](https://archbee-image-uploads.s3.amazonaws.com/ho7Cq0xJG60lzOZLT7xI3-pldzcV7ezentowyRMGGtZ-20250528-034801.png "DANA Recurring Subscription Detail") 4\. Pengguna diminta untuk melakukan konfirmasi pertama dengan *recurring issue.* ![](https://archbee-image-uploads.s3.amazonaws.com/ho7Cq0xJG60lzOZLT7xI3-8LkqT-5pPlEUUBqsPmx6W-20250528-034822.png "DANA First Payment with Recurring Issue Confirmation") 5\. DANA menampilkan hasil dari *recurring issue* kepada . ::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/ho7Cq0xJG60lzOZLT7xI3-PPiT-2fSnk0tsOOTjtYqF-20250528-034906.png" size="48" width="440" height="665" position="center" caption="Status Payment Result on DANA Page" alt="Payment Result with DANA Recurring Issue" showCaption="true"} 6\. menampilkan kepada melalui *payment page*. ![](https://archbee-image-uploads.s3.amazonaws.com/ho7Cq0xJG60lzOZLT7xI3-9x17Vu7dXzgmujGRaQzfl-20250528-034922.png "Status Payment Result on NICEPAY Payment Page") [title] Installment Type Code [path] NICEPAY API/API Non-SNAP/NICEPAY Code/ *Installment Type* adalah jenis cicilan akan dilakukan oleh . Bagian ini diimplementasi oleh Developer pada menggunakan `instmntType`. Parameter ini digunakan pada dan untuk menentukan apakah dilakukan secara penuh atau cicilan. Dengan menggunakan `instmntType`, penggunaan *value code index, *antara lain: | **Nilai Kode (*****Value Code)*** | **Deskripsi** | | --------------------------------- | ------------- | | `1` | Full | | `2` | Installment | [title] Payment - API Credit Card [path] NICEPAY API/API Non-SNAP/Payment API/API Credit Card/ # Tentang Payment - API Credit Card *** pada digunakan untuk melakukan menggunakan . ::::LinkArray{contentSource="CUSTOM"} :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/y8t8NkncZTX6Bc9QE3ONz-20260316-094026.jpg"} [Full Payment & Installment - Payment API Credit Card](docId\:tTVBh3tqLIm0LBPpqY2GP) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/PM-iCDLZL_arbW-q-gc-K-20260316-094125.jpg"} [Recurring - Payment API Credit Card](docId\:E8D2ke74fVQIhMJ2zifJu) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/ZaAl6eK6ABEjuy2C1Ofmi-20260316-094157.jpg"} [Pre-Auth & Capture - Payment API Credit Card](docId\:zFDKm9bwMDI5FRoKfInDK) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/-JHAo457T8ZnbqegkfMSv-20260316-094426.jpg"} [Encryption - Payment API Credit Card](docId\:PRpJ3hCdq-9PYlKKDk5MF) ::: :::: :::hint{type="info"} mengunjungi [Kartu Kredit](docId:1pHQ_XU3Dpep4hzX41lqg) untuk mengetahui penjelasan umum tentang . ::: [title] NICEPAY Code API Laporan Bisnis [path] NICEPAY API/API Laporan Bisnis/ # Code *** ## Header | **Nilai Kode** | **Arti** | | -------------- | ------------- | | `00` | Success Hit | | `9999` | Failed Hit | ## Data | **Nilai Kode** | **Arti** | | -------------- | --------------------- | | `10` | List transaction data | ## Tail | **Nilai Kode** | **Arti** | | -------------- | ------------------------ | | `99` | Summary transaction data | # Transaction Status *** ## Transaction | **Nilai Kode** | **Arti** | | -------------- | ----------- | | `0` | Success | | `1` | Cancel/Void | | `2` | Refund | ## Settlement | **Nilai Kode** | **Arti** | | -------------- | -------- | | `0` | Success | | `2` | Cancel | # Payment Method *** | **Nilai Kode** | **Arti** | | -------------- | ------------------ | | `00` | All Method Active | | `01` | | | `02` | | | `03` | | | `04` | | | `05` | | | `06` | | | `07` | | # Customer Number *** | **Nilai Kode** | **Arti** | | -------------- | -------------------------- | | `01` | Hash Number | | `02` | Number | | `03` | Number | | `04` | Phone Number | | `05` | Account Phone Number | | `06` | Account Phone Number | | `07` | Beneficiary Account Number | # Bank Code *** | **Value** | **Description** | | --------- | ------------------------- | | `ABAL` | BPD BALI | | `ABNA` | ROYAL BANK SCOTLAND | | `AGSS` | BANK AGRIS | | `AGTB` | BRI AGRONIAGA | | `AKTB` | BARCLAYS INDO | | `ANTD` | BANK ANTARDAERAH | | `ANZB` | BANK ANZ INDO | | `ARFA` | PANIN SYARIAH | | `ARTG` | BANK ARTHA GRAHA | | `ATOS` | BANK ARTOS INDO | | `AWAN` | BANK QNB INDO | | `BBAI` | BANK BUMI ARTA | | `BBBA` | PT BANK PERMATA, TBK | | `BBIJ` | BANK UOB INDO | | `BBUK` | BANK BUKOPIN | | `BCIA` | BANK CAPITAL INDO | | `BDIN` | BANK DANAMON | | `BDIP` | SAHABAT SAMPOERNA | | `BDKI` | BANK DKI | | `BDPC` | BANK DANPAC | | `BDSY` | DANAMON SYARIAH | | `BHTL` | BANK HARMONI INTL | | `BICN` | COMMONWEALTH | | `BIDX` | BANK INDEX SELINDO | | `BJTM` | BANK JATIM | | `BKCH` | BANK OF CHINA | | `BKKB` | BANGKOK BANK | | `BMDM` | BANK MESTIKA DHARMA | | `BMRI` | MANDIRI | | `BMSE` | MULTI ARTA SENTOSA | | `BNIA` | CIMB NIAGA | | `BNIN` | BNI | | `BNPA` | BNP PARIBAS INDO | | `BOFA` | BANK OF AMERICA | | `BOTK` | MUFG BANK, LTD | | `BPIA` | RESONA PERDANIA | | `BPKO` | BANK PIKKO | | `BRIN` | BRI | | `BSYI` | BANK SYARIAH INDONESIA | | `BSSP` | BPD SUMSELBABEL | | `BTAN` | BTN | | `BUMI` | BANK MNC INTL | | `BUST` | BANK BISNIS INTL | | `BUTG` | BANK MEGA SYARIAH | | `BVIC` | VICTORIA INTL | | `BWKI` | CHINA CONSTRUCTION | | `CENA` | BCA | | `CICT` | BANK MUTIARA | | `CITI` | CITIBANK | | `CNBA` | BANK CENTRATAMA | | `CTCB` | BANK CTBC INDO | | `DBSB` | DBS INDO | | `DEUT` | DEUTSCHE AG | | `EKON` | BANK HSBC INDO | | `EKST` | BANK PUNDI INDONESIA(KPO) | | `FAMA` | BANK FAMA | | `GNES` | BANK GANESHA | | `HNBN` | BANK KEB HANA | | `HRDA` | BANK HARDA INTL | | `HVBK` | WOORI SAUDARA INDO | | `IBBK` | MAYBANK INDO | | `ICBK` | BANK ICBC INDO | | `INDO` | BANK INDONESIA(KPO) | | `INPB` | BANK INA PERDANA | | `JSAB` | BANK JASA JAKARTA | | `KSEB` | BANK KESEJAHTERAAN | | `LFIB` | NOBU NATIONAL BANK | | `LMAN` | BANK DINAR INDO | | `LOMA` | BANK AMAR INDO | | `MASD` | BANK MASPION INDO | | `MAYA` | BANK MAYAPADA | | `MAYO` | BANK MAYORA | | `MBBE` | MAYBANK SYARIAH | | `MEEK` | BANK METRO EXPRESS | | `MEGA` | BANK MEGA TBK. | | `MGAB` | BANK MITRANIAGA | | `MHCC` | BANK MIZUHO INDO | | `MUAB` | BANK MUAMALAT | | `NISP` | OCBC NISP | | `NUPA` | BANK NUSANTARA | | `PDAC` | BANK ACEH | | `PDBK` | BPD BENGKULU | | `PDIJ` | BPD PAPUA | | `PDJB` | BANK JABAR | | `PDJG` | BPD JAWA TENGAH | | `PDJM` | BPD JAMBI | | `PDJT` | BANK JATIM SYARIAH | | `PDKB` | BPD KALBAR | | `PDKG` | BPD KALTENG | | `PDKS` | BPD KALSEL | | `PDKT` | BPD KALTIM | | `PDLP` | BPD LAMPUNG | | `PDML` | BPD MALUKU | | `PDNB` | BPD NTB | | `PDNT` | BPD NTT | | `PDRI` | BPD RIAU KEPRI | | `PDSB` | BPD SUMBAR | | `PDSU` | BPD SUMUT | | `PDWG` | BPD SULAWESITENGAH | | `PDWR` | BPD SULAWESITENGGARA | | `PDWS` | BANK SULSELBAR | | `PDWU` | BPD SULAWESIUTARA | | `PDYK` | BPD YOGYA SYARIAH | | `PINB` | PANIN | | `PMAS` | BANK PRIMA MASTER | | `PUBA` | BANK BTPN SYARIAH | | `RABO` | RABO BANK | | `RIPA` | BANK OKE INDO | | `ROYB` | BANK ROYAL INDO | | `SBID` | BANK SBI INDO | | `SBJK` | BANK SINARMAS | | `SCBL` | STANDARD CHARTERED | | `SDOB` | BUKOPIN SYARIAH | | `SIHB` | BANK SINAR HARAPAN | | `SUNI` | SUMITOMO MITSUI(KPO) | | `SWAG` | VICTORIA SYARIAH | | `SWBA` | BANK OF INDIA INDO | | `SYAC` | BPD ACEH SYARIAH | | `SYBK` | MAYBANK INDO UUS | | `SYBT` | BTN SYARIAH | | `SYCA` | BCA SYARIAH | | `SYDK` | BANK DKI SYARIAH | | `SYJB` | BANK JABAR SYARIAH | | `SYKB` | BPD KALBAR SYARIAH | | `SYKS` | BPD KALSEL SYARIAH | | `SYKT` | BPD KALTIM SYARIAH | | `SYNA` | CIMB NIAGA SYARIAH | | `SYNI` | BNI SYARIAH | | `SYON` | OCBC NISP SYARIAH | | `SYSB` | BPD SUMBAR SYARIAH | | `SYSS` | BPD SUMSEL SYARIAH | | `SYSU` | BPD SUMUT SYARIAH | | `SYYK` | BPD YOGYA | | `TAPE` | BTPN | | `YUDB` | BANK YUDHA BAKTI | [title] E-Wallet - Advance API [path] NICEPAY API/API Non-SNAP/Advance API/ # Tentang E-Wallet - Advance API *** Informasi berikut ditujukan untuk dengan fitur Recurring saat ini hanya tersedia pada DANA. ::::LinkArray{contentSource="CUSTOM"} :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/w0cgj2vYIlDlO3pnSaaeb-20260324-083228.jpg"} [DANA Recurring - E-Wallet API Advance](docId:6rtapPdMYKvpNg5jdrlkO) ::: :::: [title] Merchant Code [path] NICEPAY API/API Non-SNAP/NICEPAY Code/ *Merchant Code* adalah kode digunakan dalam untuk menentukan tipe . | **Kode Merchant** | **Deskripsi** | | ----------------- | ---------------------- | | `01` | Airlines | | `02` | Automotive | | `03` | Billers | | `04` | Charity & Donation | | `05` | Digital Content | | `06` | Education | | `07` | Electronic & Gadget | | `08` | Entertainment | | `09` | Fitness Club | | `10` | Financing | | `11` | Florist | | `12` | Food & Beverages | | `13` | Furniture | | `14` | Groceries | | `15` | Health & Beauty | | `16` | Hospitality | | `17` | Information Technology | | `18` | Insurance | | `19` | Logistic | | `20` | Marketplace | | `21` | Others | | `22` | P2P Lending | | `23` | Pharmacy | | `24` | Printing | | `25` | Retail | | `26` | Sport | | `27` | Telecommunication | | `28` | Ticketing | | `29` | Tour & Travel | | `30` | Transportation | | `31` | Accessories & Fashion | | `33` | Ecommerce Platform | | `34` | Services | [title] Panduan Bayar Kartu Kredit [path] Payment/Kartu Kredit/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/uZojLwDaLhaXdRSTiUCOp_header-14.png "Mitra Kartu Kredit") # General *** 1. melalui . 2. Dialihkan menuju Halaman Pembayaran , silakan pilih akun diinginkan. 3. berupa nomor kartu, *expired date *(MM/YY), dan CVV (3 digit angka terakhir terletak di belakang ) di kolom tersedia. 4. `Konfirmasi`.* * 5. `kode OTP` dirimkan kepada . 6. pilihan `Konfirmasi`. 7. akan memberikan bukti kepada . file format JSON Panduan Bayar Kartu Kredit untuk operasi . ::File{src="https://archbee-doc-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/9t_jdm8Wek20LXQVYADUz_ccindgeneral.json" label="CC_IND_GENERAL.json"} # See also ::::VerticalSplit :::VerticalSplitItem [Panduan Bayar VA](docId\:bSNUZMHNlj9h0wRndsQYj) untuk mengetahui cara membayar menggunakan . ::: :::VerticalSplitItem [Panduan Bayar Direct Debit](docId\:eJ49bFx8eJVfBsoGQORTO) untuk mengetahui cara membayar menggunakan . ::: :::: ::::VerticalSplit :::VerticalSplitItem [Panduan Bayar GPN](docId\:aVzjzuByPtCcIq5feYQvh) untuk mengetahui cara membayar menggunakan . ::: :::VerticalSplitItem Daftar pembaharuan *log* panduan bayar dapat dilihat pada [Release Information - Panduan Bayar](docId\:oBJOho15Y6-A0JVj4JODP). ::: :::: [title] Alur Pembayaran Kartu Kredit [path] Payment/Kartu Kredit/ Terdapat 4 jenis alur pada , yaitu *Direct 3Ds*, *Redirect 3Ds*, *Direct Non-3Ds*, dan *Redirect Non-3Ds*. :::hint{type="warning"} - Alur hanya terdapat pada **Payment **adalah *Direct 3Ds* dan *Direct Non-3Ds*. - Alur hanya terdapat pada **Checkout **adalah *Redirect 3Ds* dan *Redirect Non-3Ds*. ::: :::hint{type="info"} **Apa itu 3Ds?** **3 Domain Secure (3Ds) **merupakan standar keamanan untuk meningkatkan keamanan *cardholder* secara daring dengan melakukan verifikasi identitas berupa OTP (*One Time Password*) ke nomor *handphone *terdaftar saat dilakukan. Proses 3Ds melibatkan tiga pihak, yaitu *cardholder*, Penerbit , dan , atau *Payment Gateway*. Hal ini dilakukan untuk mencegah adanya upaya pencurian dan tindakan penipuan saat bertransaksi dengan . ::: :::hint{type="info"} **Perbedaan antara 3Ds dan Non-3Ds** - Pada Alur **3Ds**, akan melalui protokol keamanan 3Ds dengan adanya verifikasi identitas berupa OTP serta ada keamanan tambahan, yaitu FDS (*Fraud Detection System*) . - Pada Alur **Non-3Ds**, hanya melakukan melalui keamanan FDS (*Fraud Detection System*) tanpa melalui autentifikasi OTP dari 3Ds terlebih dahulu setelah memasukkan data . ::: # Direct 3Ds *** Pada Direct 3Ds, akan melanjutkan pendaftaran pada tampilan milik setelah melewati kalkulasi FDS dan pemeriksaan *authentication* OTP. Perbedaan dengan Redirect adalah pada digunakan. Proses Redirect menggunakan tampilan laman milik setelah melewati pengecekan *authentication* OTP. ![](https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-DsJKlhNSSCgeTF8Iq-WAD-20240821-024747.jpg "Alur Pembayaran CC - Direct 3Ds") Deskripsi langkah alur Direct dengan 3Ds: 1. melakukan *checkout.* 2. mengajukan *checkout *kepada Merchant. 3. melakukan pendaftaran data *checkout.* 4. mengirim *response *berupa formulir data kartu kepada . 5. memasukkan data kartu. 6. mengirimkan data kartu kepada . 7. mengirimkan pengajuan menggunakan Registration kepada . 8. menyimpan pesanan. 9. mengirimkan *response *kepada . 10. \{} mengajukan menggunakan kepada . 11. mengajukan 3Ds kepada . 12. melakukan verifikasi pengajuan. 13. mengirimkan *response *3Ds URL kepada . 14. mengirimkan *authentication page *kepada . 15. mengirimkan OTP kepada . 16. mengirimkan OTP dimasukkan kepada . 17. melakukan validasi OTP. 18. mengirimkan hasil 3Ds kepada . 19. melakukan kalkulasi FDS. 20. mengajukan /*charge *kepada . 21. melakukan . 22. mengirim *response * kepada . 23. mengirim menggunakan `callBackUrl` dan `dbProcessUrl` kepada . 24. menerima . 25. mengajukan pemeriksaan kepada . 26. mengirimkan *response *pemeriksaan kepada . 27. menerima terakhir. 28. mengirimkan hasil pesanan kepada . # Redirect 3Ds *** :::hint{type="warning"} Alur ini hanya terdapat pada **Checkout**. ::: Pada Redirect 3Ds, akan melanjutkan pendaftaran pada tampilan laman telah disediakan setelah melewati kalkulasi FDS dan pemeriksaan *authentication* OTP. Redirect akan sangat berguna ketika tidak membutuhkan pengembangan tampilan *website* sendiri, karena telah menyediakan fasilitas khusus untuk memudahkan . Proses Redirect 3Ds menggunakan [API Checkout](docId\:Djp90D-rlCNeDCzKwGC-d). ![](https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-SP0ELo5L25srBTg1gAbja-20240821-024827.jpg "Alur Pembayaran CC - Redirect 3Ds") Deskripsi langkah alur Redirect dengan 3Ds: 1. melakukan *checkout.* 2. mengirim data *checkout *kepada . 3. mengajukan *checkout *menggunakan Registration kepada . 4. mendaftarkan data *checkout.* 5. mengalihkan kepada milik kepada . 6. mengirimkan kepada . 7. memilih . 8. memasukkan data kartu. 9. mengirimkan data kartu kepada . 10. memproses kalkulasi FDS. 11. mengajukan 3Ds kepada . 12. melakukan validasi 3Ds. 13. mengirimkan *response *URL 3Ds kepada . 14. menerima *response *verifikasi. 15. mengalihkan kepada autentikasi ACS. 16. membuat *response *OTP. 17. mengirimkan OTP kepada . 18. menerima OTP. 19. memasukkan OTP. 20. mengirimkan OTP kepada . 21. melakukan verifikasi OTP. 22. mengirimkan hasil 3Ds kepada . 23. menerima hasil pemeriksaan. 24. mengajukan kepada . 25. melakukan . 26. mengirimkan kepada . 27. melakukan *redirect* `callbackUrl` kepada . 28. menampilkan hasil `callbackUrl` kepada . 29. mengirim kepada . 30. menerima . 31. melakukan pengajuan inquiry ke . 32. menerima pengajuan. 33. secara otomatis mengirimkan *response *inquiry kepada . 34. menerima terakhir. 35. mengirim hasil kepada . # Direct Non-3Ds *** Pada Direct Non-3Ds, akan melanjutkan pendaftaran pada tampilan laman milik setelah melakukan kalkulasi FDS (*Fraud Detection System) *tanpa menggunakan OTP. Perbedaan dengan Redirect adalah pada laman digunakan. Proses Redirect menggunakan tampilan laman milik setelah melakukan kalkulasi FDS (*Fraud Detection System*)*.* ![](https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-kZ9RIG6n7e_vITHOKmR3r-20240821-025030.jpg "Alur Pembayaran CC - Direct non-3Ds") Deskripsi langkah alur Direct dengan Non-3Ds: 1. melakukan *checkout.* 2. mengajukan *checkout *kepada . 3. mengajukan *checkout *kepada . 4. mendaftarkan data *checkout.* 5. mengirim *response* berisi formulir data kartu kepada . 6. memasukkan data kartu. 7. akan mengirimkan data kartu kepada . 8. akan mengirimkan pengajuan menggunakan Registration kepada . 9. menyimpan pesanan. 10. mengirimkan *response* kepada . 11. mengajukan menggunakan kepada . 12. memproses kalkulasi FDS. 13. melakukan permintaan *charge* ke . 14. melakukan verifikasi pengajuan. 15. mengajukan konfirmasi . 16. mengajukan . 17. melakukan . 18. mengirimkan kepada . 19. mengirim `callBackUrl` dan `dbProcessUrl` kepada . 20. menerima . 21. melakukan pengajuan ke . 22. mengirimkan hasil pemeriksaan . 23. menerima terakhir. 24. mengirim hasil pesanan ke . # Redirect Non-3Ds *** :::hint{type="warning"} Alur ini hanya terdapat pada **Checkout.** ::: Pada Redirect Non-3Ds, akan melanjutkan pendaftaran pada tampilan laman telah disediakan setelah melakukan kalkulasi FDS (*Fraud Detection System) *tanpa menggunakan OTP. Redirect akan sangat berguna ketika tidak membutuhkan pengembangan tampilan *website* sendiri, karena telah menyediakan fasilitas khusus untuk memudahkan . ![](https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-C5K8qw_wUk_S_lOLAf_z1-20240821-025059.jpg "Alur Pembayaran CC - Redirect non-3Ds") Deskripsi langkah alur Redirect dengan Non-3Ds: 1. melakukan *checkout.* 2. mengajukan *checkout *kepada . 3. mendaftarkan data *checkout.* 4. mengirimkan *response *berupa formulir data kartu. 5. mengajukan *checkout *kepada . 6. mendaftarkan pesanan dengan menggunakan Registration kepada . 7. menyimpan *order registration.* 8. mengalihkan kepada . 9. mengirim kepada . 10. memilih . 11. memasukkan rincian kartu. 12. mengajukan menggunakan kepada . 13. melakukan kalkulasi FDS. 14. mengajukan kepada . 15. melakukan verifikasi pengajuan. 16. mengirimkan pengajuan konfirmasi kepada . 17. mengajukan /*charge *kepada . 18. melakukan . 19. mengirim *response * kepada . 20. mengirim menggunakan `callBackUrl` dan `dbProcessUrl` kepada . 21. menerima . 22. mengajukan pemeriksaan kepada . 23. mengirimkan *response *pemeriksaan . 24. menerima terakhir. 25. mengirimkan hasil pesanan kepada . # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Fitur Kartu Kredit](docId\:cgLxG10p9zmVtuX_-b7ga) untuk mengetahui fitur pada . ::: :::VerticalSplitItem [Integrasi & Testing Kartu Kredit](docId\:ZA5d5J-5w_gT44qGTxB5n) untuk mengetahui cara dan uji coba . ::: :::: ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Daftar Istilah Kartu Kredit](docId\:BBKv4-thEkBPrsCzI6QRe) untuk mengetahui istilah khusus digunakan oleh . ::: :::VerticalSplitItem [FAQ Kartu Kredit](docId\:k9Fux2-dg-nCUDyI38UgF) jika ingin mengetahui pertanyaan sering diajukan terkait . ::: :::: [title] Bank Mandiri [path] Payment/Virtual Account (VA)/Panduan Bayar VA/ ::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/HlAeAk1FdVdHmcolKncL5_mandiri.jpg" size="50" width="500" height="500" caption="Bank Mandiri" position="center" darkWidth="500" darkHeight="500" showCaption="true"} :::hint{type="info"} Pastikan melakukan transfer dana sebelum masa berlaku habis dan dengan nominal tepat. ::: | **Nomor Virtual Account** | `70014XXXXXXXXXXX` \| `88049XXXXXXXXXXX` | | ------------------------- | ---------------------------------------- | | **Bank** | Mandiri | | **Nominal** | Rp10.000 | | **Nama Penerima** | `Merchant Name - billingNm` | | **Nomor Order** | Invoice-1234 | | **Masa Berlaku** | 16-06-2016 / 17:15:00 | file format JSON Panduan Bayar Bank Mandiri untuk operasi . ::File{src="https://archbee-doc-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/grtRvrZ6st7ds4z8Xu_8-_va-ind-mandiri.json" label="VA_IND_MANDIRI.json"} # Close Amount Transfer Melalui TRANSFERPAY *** ## ATM 1. kartu `ATM` dan `PIN` . 2. `Bayar/Beli`. 3. `Multi Payment`. 4. kode *biller* `70014`. 5. `Nomor Virtual Account`, misal `70014XXXXXXXXXXX` sebagai kode bayar. 6. `Benar`. 7. Jika data telah sesuai, layar akan menampilkan `Kode Bayar` dan `Data Pembayaran`, kemudian tekan `1`. 8. `Ya` untuk melakukan . 9. Selesai. ## ATM Non-Mandiri 1. kartu `ATM` dan `PIN` Anda. 2. `Transfer Antar Bank Online`. 3. kode Mandiri: `008` atau pilih `Bank Mandiri` dari daftar . 4. `Nomor Virtual Account`, misal `70014XXXXXXXXXXX` sebagai kode bayar. 5. `Nominal` transfer. 6. Jika data telah sesuai, layar akan menampilkan `Kode Bayar dan Data Pembayaran` kemudian tekan `1`. 7. `Ya` untuk melakukan . 8. Selesai. ## New Livin by Mandiri 1. Akses aplikasi `New Livin by Mandiri`. 2. `Bayar`. 3. `E-Commerce`. 4. Cari penyedia jasa `Transferpay`. 5. `Nomor Virtual Account`, misal `70014XXXXXXXXXXX` sebagai kode bayar. 6. `Lanjut`. 7. Jika data telah sesuai, layar akan menampilkan `Kode Bayar dan Data Pembayaran`. 8. `MPIN New Livin`. 9. Selesai. ## Transfer Bank Non-Mandiri :::hint{type="info"} Panduan bayar ini **berlaku untuk metode transfer selain BI-FAST.** ::: 1. transfer dari `Bank Non-Mandiri` (Internet Banking, Kantor Cabang, maupun Sarana Cek/BG Tersebut). 2. Transfer menggunakan slip `Setoran Kliring/RTGS` atau `Internet Banking Bank Lain` dengan sebagai berikut: - tujuan `Bank Mandiri`. - `Nomor Virtual Account`, misal `70014XXXXXXXXXXX` sebagai kode bayar. - `Nama`. 3. Selesai. ## Kantor Cabang Mandiri 1. kantor cabang Mandiri terdekat, kemudian meminta arahan kepada petugas Mandiri terkait melakukan `Transferpay` (`70014`). 2. Nasabah perlu mengisi form dengan sebagai berikut: - Tipe `Transferpay`. - `Nomor Virtual Account`, misal `70014XXXXXXXXXXX` sebagai kode bayar. - `Nama`. - Memilih cara antara `uang tunai atau Cek Mandiri`. 3. Menyerahkan slip dan menginformasikan kepada Teller untuk `Mandiri Virtual Account Transferpay` dengan kode `70014`. 4. Teller akan menginformasikan `Kode Bayar` dan `Data Pembayaran`. 5. Simpan bukti diberikan oleh Teller. 6. Selesai. ## Mandiri Internet Banking (MIB) atau Mandiri Cash Management (MCM) 1. Pengguna harus sudah terdaftar sebagai User `MIB/MCM`. 2. Akses *website* `MIB/MCM` Bank Mandiri. 3. Bill Payment. - `Bill Payment` untuk *single*, sedangkan `Bill Payment Upload` untuk secara *bulk* (jumlah banyak) dalam format *upload.* 4. rekening . 5. `New Entry`. 6. `Institusi Kategori Service` atau cari kode *biller* `88049 TransferPay`. 7. `Nomor Virtual Account`, misal `88049XXXXXXXXXXX` sebagai kode bayar. 8. Lanjutkan. 9. Layar akan menampilkan `Data Pembayar`. - Jika sesuai, pilih `Continue` sampai `Submit` hingga terkirim ke *approval*. 10. Masuk sebagai approval, kemudian lakukan *approval* seperti biasa. 11. Simpan dan cetak hasil sebagai bukti sah. 12. Selesai. # Open Amount Transfer Melalui NICEPAY *** ## ATM 1. kartu `ATM` dan `PIN` . 2. `Bayar/Beli`. 3. `Multi Payment`. 4. kode *biller* `88049`. 5. `Nomor Virtual Account`, misal `88049XXXXXXXXXXX` sebagai kode bayar. 6. `Benar`. 7. `Nominal`. 8. `Benar`. 9. Jika data telah sesuai, layar akan menampilkan `Kode Bayar dan Data Pembayaran` kemudian tekan `1`. 10. `Ya` untuk melakukan . 11. Selesai. ## ATM Non-Mandiri 1. kartu `ATM` dan `PIN` Anda. 2. `Transfer Antar Bank Online`. 3. kode Mandiri: `008` atau pilih Mandiri dari daftar . 4. `Nomor Virtual Account`, misal `88049XXXXXXXXXXX` sebagai kode bayar. 5. `Nominal` transfer. 6. Jika data telah sesuai, layar akan menampilkan `Kode Bayar dan Data Pembayaran` kemudian tekan `1`. 7. `Ya` untuk melakukan . 8. Selesai. ## New Livin by Mandiri 1. Akses aplikasi `New Livin by Mandiri`. 2. `Bayar`. 3. `E-Commerce`. 4. Cari penyedia jasa `NICEPAY`. 5. `Nomor Virtual Account`, misal `88049XXXXXXXXXXX` sebagai kode bayar. 6. `Nominal`. 7. `Lanjut`. 8. Jika data telah sesuai, layar akan menampilkan `Kode Bayar dan Data Pembayaran`. 9. `MPIN New Livin`. 10. Selesai. ## Transfer Bank Non-Mandiri 1. Akses Aplikasi selain Mandiri 2. `Transfer Antar Bank Online`. 3. `Bank Mandiri` dari daftar . 4. Nomor Virtual Account, misal `88049XXXXXXXXXXX` sebagai kode bayar. 5. `Nominal` transfer. 6. Metode Transfer: `BI Fast`/`Realtime Online`/`LLG`/`RTGS` . 7. `Lanjutkan`. 8. Jika data telah sesuai, layar akan menampilkan `Kode Bayar dan Data Pembayaran`. 9. `Lanjutkan`. 10. `MPIN`. 11. Selesai. ## Kantor Cabang Mandiri 1. kantor cabang Mandiri terdekat, kemudian meminta arahan kepada Petugas \{} Mandiri terkait melakukan `NICEPAY`(`88049`). 2. Nasabah perlu mengisi *form* dengan sebagai berikut: - Tipe `NICEPAY`. - `Nomor Virtual Account`, misal `88049XXXXXXXXXXX` sebagai kode bayar. - `Nama`. - Memilih cara antara `uang tunai atau Cek Mandiri`. 3. Menyerahkan slip dan menginformasikan kepada Teller untuk `Mandiri Virtual Account NICEPAY`dengan kode `88049`. 4. Teller akan menginformasikan `Kode Bayar` dan `Data Pembayaran`. 5. Simpan bukti yang diberikan oleh Teller. 6. Selesai. ## Mandiri Internet Banking (MIB) atau Mandiri Cash Management (MCM) 1. Pengguna harus sudah terdaftar sebagai User `MIB/MCM`. 2. Akses *website* `MIB/MCM` Mandiri. 3. *Bill Payment*: - `Bill Payment` untuk *single*, sedangkan `Bill Payment Upload` untuk secara *bulk* (jumlah banyak) dalam format *upload.* 4. rekening . 5. `New Entry`. 6. Institusi Kategori *Service* atau cari kode *biller* `88049 NICEPAY`. 7. `Nomor Virtual Account`, misal `88049XXXXXXXXXXX` sebagai kode bayar. 8. `Nominal`. 9. Lanjutkan. 10. Layar akan menampilkan `Data Pembayar`. - Jika sesuai, pilih `Continue` sampai `Submit` hingga terkirim ke *approval*. 11. Masuk sebagai *approval*, kemudian lakukan *approval* seperti biasa. 12. Simpan dan cetak hasil sebagai bukti sah. 13. Selesai. [title] Alur Pembayaran VA [path] Payment/Virtual Account (VA)/ Terdapat 3 jenis alur melalui , yaitu: 1. (Direct). 2. (Redirect). 3. . ::::hint{type="info"} :::Iframe{code="Silakan menghubungi NICEPAY Customer Service untuk menggunakan alur pembayaran NICEPAY Inquiry Virtual Account." iframeHeight="0"} ::: :::: # Payment API *** Pada jenis VA tipe ini, setelah meminta untuk dibuatkan nomor VA pada transaksinya, perlu meminta untuk dibuatkan nomor VA tersebut kepada . Lalu, setelah mendapatkan nomor tersebut dari , berikan nomor VA-nya kepada untuk dibayarkan pada *payment page* disediakan. Notifikasi keberhasilan pun dapat terima setelah sukses membayarkan tagihannya. ![](https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-2JRLV2nD5JMzl8kJeUpFL-20240821-031405.jpg "Alur Pembayaran VA dengan Payment API") Deskripsi langkah: 1. mengirim data *checkout* kepada . 2. melakukan pengajuan pendaftaran menggunakan Registration kepada . 3. memberikan *response *berupa nomor VA dan TXID kepada . 4. menyimpan nomor VA. 5. mengirimkan informasi VA kepada . 6. memasukkan dan mengirimkan VA kepada . 7. melakukan validasi . 8. mengirimkan hasil kepada . 9. mengirimkan kepada . 10. memperbarui . 11. mengirimkan `dbProcessUrl` kepada . 12. menerima . 13. memeriksa menggunakan Inquiry kepada . 14. mengirimkan *response *kepada . 15. memperbarui . 16. mengirim konfirmasi pesanan kepada . # Checkout API *** Perbedaan terbesar di antara dengan adalah tampilan atau c*heckout* akan disediakan oleh agar dapat menerima nomor VA dari tagihan dimiliki secara langsung. Fitur ini sangat berguna ketika mempunyai atau tidak ingin mengembangkan sendiri, sehingga dapat menggunakan telah disediakan . ![](https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-yUDvoVg0l50sRQ9VX3HEQ-20240821-031430.jpg "Alur Pembayaran VA dengan Checkout API") Deskripsi langkah: 1. melakukan *checkout*. 2. mengirimkan data *checkout* kepada . 3. melakukan pengajuan *checkout* menggunakan Registration kepada . 4. mengalihkan kepada . 5. mengirimkan kepada . 6. memilih . 7. membayar menggunakan VA kepada . 8. melakukan . 9. mengirimkan hasil kepada . 10. mengirim kepada . 11. memperbarui . 12. mengirim `dbProcessUrl` kepada . 13. menerima . 14. mengajukan inquiry kepada . 15. menerima pengajuan. 16. mengirimkan *response* inquiry kepada . 17. menerima akhir. 18. mengirim hasil kepada . # NICEPAY Inquiry Virtual Account API *** Perbedaan antara dengan jenis VA lain adalah akan membuat nomor VA dan menyimpan nomor VA tersebut di dalam sistemnya. Lalu, akan melakukan validasi terlebih dahulu kepada mengenai nomor VA tersebut untuk memproses yang diajukan oleh . ![](https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-XcQUGoWvM2Cl7ylY4RXN2-20240821-031500.jpg "Alur Pembayaran VA dengan NICEPAY Inquiry Virtual Account API") Deskripsi langkah: 1. mendaftarkan `Customer ID` kepada . 2. melakukan pada `Customer ID` dan menyimpan `vacctList`. 3. mengirim *response *berupa `Customer ID` dan `vacctList`. 4. mengirim pembuatan inquiry kepada . 5. mengajukan rincian data inquiry kepada . 6. mengajukan inquiry Service kepada . 7. mencari data. 8. mengirimkan *response *inquiry kepada . 9. mengirimkan *response *berupa rincian data inquiry kepada . 10. menampilkan VA kepada . 11. melakukan konfirmasi data VA. 12. melakukan kepada . 13. melakukan . 14. mengajukan konfirmasi kepada . 15. mengajukan konfirmasi kepada . 16. melakukan validasi . 17. mengirim *response *konfirmasi kepada . 18. mengirimkan *response *konfirmasi kepada . 19. melakukan hasil validasi . 20. menampilkan hasil kepada . # See also ::::VerticalSplit :::VerticalSplitItem [Fitur VA](docId\:GnUAAyq81JNJ8UNRanWUZ) untuk mengetahui fitur pada . ::: :::VerticalSplitItem [Integrasi & Testing VA](docId\:sts64cm0VYN3Q8_quNq23) untuk mengetahui cara dan uji coba . ::: :::: ::::VerticalSplit :::VerticalSplitItem [Daftar Istilah VA](docId:2xrW5DVjK-076w2JsQvI8) untuk mengetahui istilah khusus digunakan oleh . ::: :::VerticalSplitItem [FAQ VA](docId\:n5d3A27rcZ6_ZxBN-sIIs) jika ingin mengetahui pertanyaan sering diajukan terkait . ::: :::: [title] Transmission Status Code [path] NICEPAY API/API Messaging/SMS API/Untitled/ *Transmission Status Code* digunakan untuk memeriksa [Notification Status](docId\:hcRdbFh-9v_6do48MShRg) ketika mengirimkan pesan dengan [SMS API](docId\:uyse9n3k63OOMugIq7Ieh). | **Nilai** | **Deskripsi** | | --------- | --------------------- | | `00`      | Sent | | `01` | Sent, Delivered | | `02` | Sent, Undelivered | | `03` | Sent, Unknown Number | | `44` | Failed | | `05` | Balance Not Available | | `77` | Waiting for Status | | `99` | Attempt | [title] Status Inquiry - API Paylater [path] NICEPAY API/API Non-SNAP/Payment API/API Paylater/ # Tentang API Paylater Status Inquiry *** Integrasi Status Inquiry pada digunakan oleh untuk memeriksa berlangsung pada dilakukan oleh baik ber *success*, *fail*, dan lainnya. Sehingga dapat memiliki laporan mengenai informasi tersebut. API Paylater Status Inquiry *** Integrasi inquiry pada bertujuan supaya dapat terhubung dengan untuk melakukan pemeriksaan pada secara berkala. | **API Endpoint** | `/nicepay/direct/v2/inquiry ` | | ------------------ | ------------------------------------------------------------ | | **Request Method** | **POST****** | | **Description** | Performs Inquiry Request to for Status Checking | | **Merchant Token** | SHA256(`timeStamp`+`iMid`+`referenceNo`+`amt`+`merchantKey`) | | **Request Format** | `application/json` | :::hint{type="info"} Ketika diterima `dbProcessUrl` , sangat menganjurkan untuk melakukan verifikasi tersebut dengan menggunakan [Status Inquiry - API Paylater](docId\:r6YyG1qEKKLzWnVhazxCV). ::: :::hint{type="info"} `Notification Handling` sangat berguna untuk meminimalisir terjadinya *Fraud*. Kami sangat menganjurkan untuk melakukan verifikasi `Notification Handling`. dapat membaca lebih rinci mengenai `Notification Handling` pada [Notification - API Paylater](docId\:tLx6S6yonkvOMuyhJMQ8Z). ::: Request Parameter for Paylater Status Inquiry *** Berikut ini adalah daftar untuk melakukan *request* inquiry pada . | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ------------------------------------------------------------ | -------- | ---------- | -------------------------------------- | ---------------------------------------------------------------- | | `timeStamp`
Required | N | 14 | Request Timestamp (`YYYYMMDDHH24MISS`) | 20221114114338 | | `tXid `
Required | AN | 30 | Transaction ID | PAYLOANTES06202212051018325178 | | `iMid`
Required | AN | 10 | ID | PAYLOANTES | | `referenceNo `
Required | ANS | 40 | Order Number | ORD12345 | | `amt `
Required | N | 12 | Transaction Amount | 10000 | | `merchantToken `
Required | AN | 255 | Token | 3a04d0c8581ae37727f87130a0b32f2fe9fe39c66b88347352e7b90aeb5cb6e6 | ## Response Parameter for Paylater Status Inquiry *** Berikut ini adalah daftar *response* dari pengajuan inquiry pada . | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ---------------- | -------- | ---------- | ------------------------------------------------------------------------------------------------------------- | ------------------------------ | | `resultCd` | N | 4 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | 0000 | | `resultMsg ` | AN | 255 | Result Message: [Error Code](docId\:yEh1VA9k2y6sL1kQF2aWD) | init | | `tXid` | AN | 30 | Transaction ID | PAYLOANTES06202212051018325178 | | `iMid ` | AN | 10 | ID | PAYLOANTES | | `referenceNo` | ANS | 40 | Reference Number | ORD12345 | | `payMethod` | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | 06 | | `amt` | N | 12 | Amount | 10000 | | `CancelAmt` | N | 12 | Cancel Amount | Null | | `reqDt` | N | 8 | Transaction Request Date (`YYYYMMDD`)** ** | 20221205 | | `reqTm` | N | 6 | Transaction Request Time (`HH24MISS`) | 101832 | | `transDt` | N | 8 | Transaction Date (`YYYYMMDD`) | Null | | `transTm` | N | 6 | Transaction Time (`HH24MISS`) | Null | | `depositDt ` | N | 8 | Transaction Deposit Date (`YYYYMMDD`) | Null | | `depositTm ` | N | 6 | Transaction Deposit Time (`HH24MISS`) | Null | | `currency ` | A | 3 | Currency | IDR | | `goodsNm ` | AN | 100 | Goods Name | Test Transaction | | `billingNm ` | A | 100 | Buyer Name | John Doe | | `status ` | N | 1 | [Payment Status Code](docId:8m3-7Smhm_jhdrE5pCRzp) | 9 | | `instmntMon` | N | 2 | Installment Month | 1 | | `instmntType` | N | 2 | [Installment Type Code](docId:7CIX-U_4z295XgtNVEsbO) | 2 | | `cardNo` | N | 20 | Number | Null | | `preauthToken` | AN | 64 | Pre-Auth Token | Null | | `acquBankCd` | A | 4 | [Acquiring Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | Null | | `issuBankCd` | A | 4 | [Issuing Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | Null | | `vacctValidDt` | N | 8 | VA Expiry Date (`YYYYMMDD`) | Null | | `vacctValidTm` | N | 6 | VA Expiry Time (`HH24MISS`) | Null | | `vacctNo` | N | 20 | VA Number | Null | | `bankCd` | A | 4 | [Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | Null | | `payNo` | N | 12 | Number | Null | | `mitraCd` | A | 4 | [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8) | KDVI | | `receiptCode` | ANS | 20 | Authorization Number | Null | | `cancelAmt` | N | 12 | Cancel Amount | Null | | `recurringToken` | AN | 255 | Recurring Token (Needed for Recurring ) | | | `ccTransType` | N | 2 | [Credit Card Transaction Type](docId:8m3-7Smhm_jhdrE5pCRzp) | Null | | `payValidDt` | N | 8 | CVS Expiry Date (`YYYYMMDD`) (CVS) | Null | | `payValidTm` | N | 6 | CVS Expiry Time (`HH24MISS`) (CVS) | Null | | `mRefNo` | AN | 20 | Reference Number () | Null | | `acquStatus` | N | 2 | Purchase Status
`1`: Normal
`2`: Recurring
`3`: Pre-Auth
`4`: Capture | Null | | `cardExpYymm` | N | 4 | Card Expiry (`YYMM`) | Null | | `acquBankNm` | A | 255 | Acquiring Name | Null | | `issuBankNm` | A | 255 | Issuing Name | Null | | `paymentExpDt` | N | 6 | QR Expiry Date (`YYYYMMDD`) | Null | | `paymentExpTm` | N | 6 | QR Expiry Time (`HH24MISS`) | Null | | `cancelTrxSn` | AN | 32 | Cancel Transaction Number | Null | | `userId` | AN | 128 | User ID Hash | Null | | `shopId` | AN | 32 | Shop ID | Null | ## Additional Response Parameter for Paylater Status Inquiry *** Berikut ini adalah daftar *response *tambahan dari *request * inquiry pada lainnya. | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | | ------------- | -------- | ---------- | ------------------------------------------------------- | | `mitraCd` | A | 4 | [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8) (CVS, , , ) | | `payNo` | N | 12 | CVS Number (CVS)
| | `payValidDt` | N | 8 | CVS Expiry Date (`YYYYMMDD`) (CVS) | | `payValidTm` | N | 6 | CVS Expiry Time (`HH24MISS`) (CVS) | | `receiptCode` | ANS | 20 | Authorization Code (CVS) | | `mRefNo` | AN | 20 | Reference Number () | Sample JSON for Paylater Status Inquiry --------------------------------------------- *** :::CodeblockTabs JSON Request ```json { "timeStamp":"20221114114338", "tXid":"PAYLOANTES06202212051018325178", "iMid":"PAYLOANTES", "referenceNo":"ORD12345", "amt":"10000", "merchantToken":"3a04d0c8581ae37727f87130a0b32f2fe9fe39c66b88347352e7b90aeb5cb6e6" } ``` JSON Response ```json { "tXid": "PAYLOANTES06202212051018325178", "iMid": "PAYLOANTES", "currency": "IDR", "amt": "10000", "instmntMon": "1", "instmntType": "2", "referenceNo": "ORD12345", "goodsNm": "Test Transaction Nicepay", "payMethod": "06", "billingNm": "John Doe", "reqDt": "20221205", "reqTm": "101832", "status": "9", "resultCd": "0000", "resultMsg": "init", "cardNo": null, "preauthToken": null, "acquBankCd": null, "issuBankCd": null, "vacctValidDt": null, "vacctValidTm": null, "vacctNo": null, "bankCd": null, "payNo": null, "mitraCd": "KDVI", "receiptCode": null, "cancelAmt": null, "transDt": null, "transTm": null, "recurringToken": null, "ccTransType": null, "payValidDt": null, "payValidTm": null, "mRefNo": null, "acquStatus": null, "cardExpYymm": null, "acquBankNm": null, "issuBankNm": null, "depositDt": null, "depositTm": null, "paymentExpDt": null, "paymentExpTm": null, "paymentTrxSn": null, "cancelTrxSn": null, "userId": null, "shopId": null } ``` Java Request ```java //Inquiry Registration// nicePay.setTimeStamp("20221208091279"); nicePay.setiMid("IONPAYTEST"); nicePay.setAmt("10000"); nicePay.setReferenceNo("ordNo20221202141217"); nicePay.setMerchantToken(nicePay.makeToken(nicePay.getMerchantToken()); nicePay.settXid("IONPAYTEST08202212080918308275"); // Request Inquiry nicePay.inquiry(); // Response String // System.out.println("Final Response String : " + nicePay.getResponseString()); String resultCd = nicePay.Get("resultCd"); String resultMsg = nicePay.Get("resultMsg"); String tXid = nicePay.Get("tXid"); String referenceNo = nicePay.Get("referenceNo"); String payMethod = nicePay.Get("payMethod"); String status = nicePay.Get("status") String amt = nicePay.Get("amt"); String transDt = nicePay.Get("transDt"); String transTm = nicePay.Get("transTm"); String shopId = nicePay.Get("shopId"); ``` ::: [title] Registration - API Paylater [path] NICEPAY API/API Non-SNAP/Payment API/API Paylater/ Tentang API for Paylater Registration *** ini digunakan oleh untuk mendaftarkan kepada agar dapat melakukan pendaftaran . API for Paylater Registration *** Registration digunakan supaya dapat terhubung dengan dari . Sehingga sudah disediakan dan di-*host* dari sisi dapat ter dengan dari . berikut dapat digunakan untuk registrasi Indodana, Akulaku, dan Kredivo. | **API Endpoint** | `/nicepay/direct/v2/registration` | | ------------------ | ------------------------------------------------------------ | | **Request Method** | **POST****** | | **Description** | Performs Transaction Regist to | | **Merchant Token** | SHA256(`timeStamp`+`iMid`+`referenceNo`+`amt`+`merchantKey`) | | **Request Format** | `application/json` | Request Parameter for Paylater Registration *** Berikut ini adalah daftar untuk melakukan *request *registrasi . Parameter ini digunakan melalui platform pengujian sebagai salah satu tahapan supaya milik dapat terhubung dengan dari . | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ------------------------------------------------------------------------------------ | ------------------ | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `timeStamp `
Required | N | 14 | Request Timestamp (`YYYYMMDDHH24MISS`) | 20220131125959 | | `iMid `
Required | AN | 10 | ID
| PAYLOANTES | | `payMethod`
Required | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok)
| 06 | | `currency`
Required | A | 3 | Currency
| IDR | | `amt`
Required | N | 12 | Amount
| 10000 | | `referenceNo`
Required | ANS | 40 | 's Reference Number
| ORD12345 | | `callBackUrl` | ANS | 255 | Result URL | | | `goodsNm `
Required | AN | 100 | Goods Name
| Test Transaction | | `billingNm `
Required | A | 100 | Buyer Name
| John Doe | | `billingPhone`
Required | N | 15 | Buyer Phone Number
| 08123456789 | | `billingEmail`
Required | ANS | 40 | Buyer E-Mail
| email\@merchant.com | | `billingAddr`
Required | AN | 100 | Buyer Address
| Jalan Bukit Berbunga 22 | | `billingCity`
Required | A | 50 | Buyer City
| Jakarta | | `billingState`
Required | A | 50 | Billing State
| DKI Jakarta | | `billingPostCd `
Required | N | 10 | Billing Post Number
| 12345 | | `billingCountry `
Required | A | 10 | Billing Country
| | | `cartData `
Required | `JSONstring`
| 4000 | Cart Data
| \{"count":3,"item":\[\{"goods\_id":30,"goods\_name":"Beanie","goods\_type":"Accessories","goods\_amt":5000,"goods\_sellers\_id":"NICEPAY-NamaMerchant","goods\_sellers\_name":"NICEPAYSHOP","goods\_quantity":1,"goods\_url":"[http://www.nicestore.com/product/beanie/](http://www.nicestore.com/product/beanie/)"},..]} | | `userIP `
Required for CC, E-Wallet, Paylater,QRIS | AN | 15 | User IP
| 127.0.0.1
| | `dbProcessUrl`
Required | ANS | 255 | Notification URL
| https\://merchant.com/dbProcessUrl | | `merchantToken`
Required | AN | 255 | Token
| 9b38b12e83b6ee124d4b549238f232c6179b168effc4ffb7f64d00c15f08e230 | | `deliveryNm`
Required | A | 30 | Delivery Name | email\@merhchant.com | | `deliveryPhone`
Required | N | 15 | Delivery Phone | 08123456789 | | `deliveryAddr`
Required | AN | 100 | Delviery Address | Jalan Bukit Berbunga 22 | | `deliveryCity`
Required | A | 50 | Delivery City | Jakarta | | `deliveryState`
Required | A | 50 | Delivery State | DKI Jakarta | | `deliveryPostCd`
Required | N | 10 | Delivery Post Code | 12345 | | `deliveryCountry`
Required | A | 10 | Delivery Country | | | `mitraCd`
Required | N | 2 | [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8) | KDVI | | `instmntType`
Required | N | 8 | [Installment Type Code](docId:7CIX-U_4z295XgtNVEsbO) | 2 | | `instmntMon`
Required | N | 6 | - `1`: 1 Month/Full , *jika* *instmntType:* *null/1* - `3`: 3 Months - `6`: 6 Months - `12`: 12 Months - [Aturan dan Limitasi Paylater](docId\:AssO3UWjtG3j_pyf7l2Et) | 3 | | `userSessionID` | AN | 255 | ID User Session | 697D6922C961070967D3BA1BA5699C2C | | `userAgent` | ANS | 255 | User Agent | Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML,like Gecko) Chrome/60.0.3112.101 Safari/537.36 | | `userLanguage` | ANS | 255 | User Language | ko-KR,en-US;q=0.8,ko;q=0.6,en;q=0.4 | | `sellers`
Required | `JSON String` | 4000 | Seller Data | \[\{\\"sellersId\\":\\"NICEPAY-NamaMerchant\\",\\"sellersNm\\":\\"NICEPAYSHOP\\",\\"sellersUrl\\":\\"http\://nicestore.store/product/beanie/\\",\\"sellersEmail\\":\\"Nicepay\@nicepay.co.id\\",\\"sellersAddress\\":\{\\"sellerNm\\":\\"NICEPAYSHOP\\",\\"sellerLastNm\\":\\"NICEPAYSHOP\\",\\"sellerAddr\\":\\"Jln. Kasablanka Kav 88\\",\\"sellerCity\\":\\"Jakarta\\",\\"sellerPostCd\\":\\"14350\\",\\"sellerPhone\\":\\"082111111111\\",\\"sellerCountry\\":\\"ID\\"}}] | :::hint{type="info"} kunjungi [Paylater](docId\:a7Zm1Frn9z7QiG0lc-Sr2) untuk mempelajari umum mengenai . ::: ## Response Parameter for Paylater Registration *** Berikut adalah *response parameter* dari hasil *request parameter* untuk mendaftarkan . | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | -------------- | -------- | ---------- | ----------------------------------------------------------- | ------------------------------ | | `resultCd` | N | 4 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | 0000 | | `resultMsg ` | AN | 255 | Result Message: [Error Code](docId\:yEh1VA9k2y6sL1kQF2aWD) | SUCCESS | | `tXid` | AN | 30 | Transaction ID | PAYLOANTES06202212051018325178 | | `referenceNo` | ANS | 40 | Reference Number | ORD12345 | | `payMethod` | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | 06 | | `amt` | N | 12 | Amount | 10000 | | `transDt` | N | 8 | Transaction Date (`YYYYMMDD`) | null | | `transTm` | N | 6 | Transaction Time (`HH24MISS`) | null | | `description` | AN | 100 | Transaction Description | null | | `bankCd` | A | 4 | [Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | null | | `vacctNo` | N | 20 | Number | null | | `mitraCd` | A | 4 | [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8) | KDVI | | `payNo` | N | 12 | CVS Number | null | | `currency ` | A | 3 | Currency | null | | `goodsNm` | AN | 100 | Goods Name | null | | `billingNm` | A | 100 | Buyer Name | null | | `payValidDt ` | N | 8 | Expiry Date (`YYYYMMDD`) | null | | `payValidTm` | N | 6 | Expiry Time (`HH24MISS`) | null | | `requestURL` | ANS | 360 | Request URL | null | | `paymentExpDt` | N | 6 | QR Expiry Date (`YYYYMMDD`) | null | | `paymentExpTm` | N | 6 | QR Expiry Time (`HH24MISS`) | null | | `qrContent` | ANS | 360 | QR String in Plain Text | null | | `qrUrl` | ANS | 360 | URL for QR Image, Valid for 5 Minutes | null | Sample JSON for Paylater Registration -------------------------------------------- *** :::CodeblockTabs JSON Request ```json { "timeStamp": "20220131125959", "iMid": "PAYLOANTES", "payMethod": "06", "currency": "IDR", "amt": "10000", "referenceNo": "ORD12345", "goodsNm": "Test Transaction Nicepay", "billingNm": "John Doe", "billingPhone": "08123456789", "billingEmail": "email@merchant.com", "billingAddr": "Jalan Bukit Berbunga 22", "billingCity": "Jakarta", "billingState": "DKI Jakarta", "billingPostCd": "12345", "billingCountry": "Indonesia", "deliveryNm": "email@merchant.com", "deliveryPhone": "08123456789", "deliveryAddr": "Jalan Bukit Berbunga 22", "deliveryCity": "Jakarta", "deliveryState": "DKI Jakarta", "deliveryPostCd": "12345", "deliveryCountry": "Indonesia", "dbProcessUrl": "https://merchant.com/api/dbProcessUrl/Notif", "description": "", "merchantToken":"9b38b12e83b6ee124d4b549238f232c6179b168effc4ffb7f64d00c15f08e230", "reqDomain": "merchant.com", "reqServerIP": "127.0.0.1", "reqClientVer": "", "userIP": "127.0.0.1", "userSessionID": "697D6922C961070967D3BA1BA5699C2C", "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML,like Gecko) Chrome/60.0.3112.101 Safari/537.36", "userLanguage": "ko-KR,en-US;q=0.8,ko;q=0.6,en;q=0.4", "cartData": "{\"count\":3,\"item\":[{\"goods_id\":30,\"goods_name\":\"Beanie\",\"goods_type\":\"Accessories\",\"goods_amt\":5000,\"goods_sellers_id\":\"NICEPAY-NamaMerchant\",\"goods_sellers_name\":\"NICEPAYSHOP\",\"goods_quantity\":1,\"goods_url\":\"http://www.nicestore.com/product/beanie/\"},{\"goods_id\":31,\"goods_name\":\"Belt\",\"goods_type\":\"Accessories\",\"goods_amt\":4500,\"goods_sellers_id\":\"NICEPAY-NamaMerchant\",\"goods_sellers_name\":\"NICEPAYSHOP\",\"goods_quantity\":1,\"goods_url\":\"http://www.nicestore.store/product/belt/\"},{\"img_url\":\"http://www.jamgora.com/media/avatar/noimage.png\",\"goods_name\":\"Shipping Fee\",\"goods_id\":\"Shipping for Ref. No. 278\",\"goods_detail\":\"Flat rate\",\"goods_type\":\"Shipping with Flat rate\",\"goods_amt\":\"500\",\"goods_sellers_id\":\"NICEPAY-NamaMerchant\",\"goods_sellers_name\":\"NICEPAYSHOP\",\"goods_quantity\":\"1\",\"goods_url\":\"https://wwww.nicestore.store\"}]}", "sellers": "[{\"sellersId\":\"NICEPAY-NamaMerchant\",\"sellersNm\":\"NICEPAYSHOP\",\"sellersUrl\":\"http://nicestore.store/product/beanie/\",\"sellersEmail\":\"Nicepay@nicepay.co.id\",\"sellersAddress\":{\"sellerNm\":\"NICEPAYSHOP\",\"sellerLastNm\":\"NICEPAYSHOP\",\"sellerAddr\":\"Jln. Kasablanka Kav 88\",\"sellerCity\":\"Jakarta\",\"sellerPostCd\":\"14350\",\"sellerPhone\":\"082111111111\",\"sellerCountry\":\"ID\"}}]", "instmntType": "2", "instmntMon": "1", "mitraCd": "KDVI" } ``` JSON Response ```json { "resultCd": "0000", "resultMsg": "SUCCESS", "tXid": "PAYLOANTES06202212051018325178", "referenceNo": "ORD12345", "payMethod": "06", "amt": "10000", "transDt": null, "transTm": null, "description": null, "bankCd": null, "vacctNo": null, "mitraCd": "KDVI", "payNo": null, "currency": null, "goodsNm": null, "billingNm": null, "vacctValidDt": null, "vacctValidTm": null, "payValidDt": null, "payValidTm": null, "requestURL": null, "paymentExpDt": null, "paymentExpTm": null, "qrContent": null, "qrUrl": null } ``` Java Request ```java // Payloan Registration // // Payloan Registration Mandatory Field nicePay.settimeStamp("20220101123456"); nicePay.setiMid("TestEwallet"); nicePay.setpayMethod("0"); nicePay.setcurrency("IDR"); nicePay.setamt("10000"); nicePay.setreferenceNo("ORD12345"); nicePay.setgoodsNm("John Doe"); nicePay.setbillingNm("John Doe"); nicePay.setbillingPhone("08123456789"); nicePay.setbillingEmail("email@merchant.com"); nicePay.setbillingAddr("Jalan Bukit Berbunga 22"); nicePay.setbillingCity("Jakarta"); nicePay.setbillingState("DKI Jakarta"); nicePay.setbillingPostCd("12345"); nicePay.setbillingCountry("Indonesia"); nicePay.setdescription("Test Transaction"); nicePay.setdbProcessUrl("https://merchant.com/api/dbProcessUrl/Notif"); nicePay.setdeliveryNm("Test Transaction"); nicePay.setdeliveryPhone("Test Transaction"); nicePay.setdeliveryAddr("Test Transaction"); nicePay.setdeliveryCity("Test Transaction"); nicePay.setdeliveryState("Test Transaction"); nicePay.setdeliveryPostCd("Test Transaction"); nicePay.setdeliveryCountry("Test Transaction"); nicePay.setcartData("{\"count\":3,\"item\":[{\"goods_id\":30,\"goods_name\":\"Beanie\",\"goods_type\":\"Accessories\",\"goods_amt\":5000,\"goods_sellers_id\":\"NICEPAY-NamaMerchant\",\"goods_sellers_name\":\"NICEPAYSHOP\",\"goods_quantity\":1,\"goods_url\":\"http://www.nicestore.com/product/beanie/\"},{\"goods_id\":31,\"goods_name\":\"Belt\",\"goods_type\":\"Accessories\",\"goods_amt\":4500,\"goods_sellers_id\":\"NICEPAY-NamaMerchant\",\"goods_sellers_name\":\"NICEPAYSHOP\",\"goods_quantity\":1,\"goods_url\":\"http://www.nicestore.store/product/belt/\"},{\"img_url\":\"http://www.jamgora.com/media/avatar/noimage.png\",\"goods_name\":\"Shipping Fee\",\"goods_id\":\"Shipping for Ref. No. 278\",\"goods_detail\":\"Flat rate\",\"goods_type\":\"Shipping with Flat rate\",\"goods_amt\":\"500\",\"goods_sellers_id\":\"NICEPAY-NamaMerchant\",\"goods_sellers_name\":\"NICEPAYSHOP\",\"goods_quantity\":\"1\",\"goods_url\":\"https://wwww.nicestore.store\"}]}"); nicePay.setsellers("[{\"sellersId\":\"NICEPAY-NamaMerchant\",\"sellersNm\":\"NICEPAYSHOP\",\"sellersUrl\":\"http://nicestore.store/product/beanie/\",\"sellersEmail\":\"Nicepay@nicepay.co.id\",\"sellersAddress\":{\"sellerNm\":\"NICEPAYSHOP\",\"sellerLastNm\":\"NICEPAYSHOP\",\"sellerAddr\":\"Jln. Kasablanka Kav 88\",\"sellerCity\":\"Jakarta\",\"sellerPostCd\":\"14350\",\"sellerPhone\":\"082111111111\",\"sellerCountry\":\"ID\"}}]"); nicePay.setinstmntType("2"); nicePay.setinstmntMon("1"); nicePay.setmitraCd("KDVI"); nicePay.setMerchantToken(nicePay.makeToken(nicePay.getMerchantToken())); // Request Payloan Registration nicePay.payloanRegist(); // Response String // System.out.println("Final Response String : " + nicePay.getResponseString()); String resultCd = nicePay.Get("resultCd"); String resultMsg = nicePay.Get("resultMsg"); String tXid = nicePay.Get("tXid"); String referenceNo = nicePay.Get("referenceNo"); String payMethod = nicePay.Get("payMethod"); String amt = nicePay.Get("amt"); String transDt = nicePay.Get("transDt"); String transTm = nicePay.Get("transTm"); String description = nicePay.Get("description"); String mitraCd = nicePay.Get("mitraCd"); ``` ::: ## Cart Data Paylater *** Masing-masing bekerja sama dengan memiliki ketentuan berbeda-beda. Berikut adalah rincian ketentuan dari masing-masing . ### Indodana `CartData` pada Registrasi berguna untuk mendeklarasikan *item * akan di- berserta rincian *item* dan harga per *item-*nya. | **Parameter** | **Deskripsi** | **Contoh** | | ------------- | --------------------------------------------------------------------------------------- | ---------- | | `Count` | Total jumlah dari keseluruhan cart data | 2 | | `Item` | Terbagi menjadi 4 macam , yaitu `img_url`, `goods_name`, `goods_detail` dan `goods_amt` | - | *** Penjelasan rincian pada **Item.** | **Parameter** | **Deskripsi** | **Contoh / Catatan** | | -------------------- | ------------------- | -------------------------------------------------------------------------- | | `goods_id` | ID Barang | AA12345 | | `goods_name` | Nama Barang | Beanie | | `goods_amt` | Harga Barang | 5000 | | `goods_type` | Tipe Barang | others | | `goods_quantity` | Jumlah Barang | 1 | | `goods_url` | Tautan Barang | [http://nicestore.go/product/beanie/](http://nicestore.go/product/beanie/) | | `goods_sellers_id` | ID Penjual Barang | -Nama | | `goods_sellers_name` | Nama Penjual Barang | SHOP | *** :::CodeblockTabs cartData Paylater Indodana Registration ```json { "count":2, "item":[ { "goods_id":"AA12345", "goods_name":"Beanie", "goods_amt":"5000", "goods_type":"others", "goods_quantity":1, "goods_url":"http://nicestore.go/product/beanie/" "goods_sellers_id":"NICEPAY-NamaMerchant", "goods_sellers_name":"NICEPAYSHOP" }, { "goods_id":"BB12345", "goods_name":"Belt", "goods_amt":"5000", "goods_type":"others", "goods_quantity":"1", "goods_url":"http://nicestore.go/product/belt/", "goods_sellers_id":"NICEPAY-NamaMerchant", "goods_sellers_name":"NICEPAYSHOP" } ] } ``` ::: ### Akulaku `CartData` pada Registrasi berguna untuk mendeklarasikan *item *apa saja akan di-*checkout *berserta rincian dan harga per *item*. | **Parameter** | **Deskripsi** | **Contoh** | | ------------- | ----------------------------------------------------------------------------------------------------------- | ---------- | | `Count` | Total jumlah keseluruhan cart data | 2 | | `Item` | Parameter berisi rincian cart data, seperti
`img_url`, `goods_name`, `goods_detail` , dan `goods_amt` | - | *** Penjelasan rinci pada **Item.** | **Parameter** | **Deskripsi** | **Contoh / Catatan** | | -------------------- | ------------------- | ------------------------------------ | | `goods_id` | ID Barang | AA12345 | | `goods_name` | Nama Barang | Beanie | | `goods_amt` | Harga Barang | 5000 | | `goods_type` | Tipe Barang | others | | `goods_detail` | Rincian Barang | AA1345678 | | `goods_quantity` | Jumlah Barang | 1 | | `goods_url` | Tautan Barang | http\://nicestore.go/product/beanie/ | | `goods_sellers_id` | ID Penjual Barang | -Nama | | `goods_sellers_name` | Nama Penjual Barang | SHOP | *** :::CodeblockTabs cartData Paylater Akulaku Registration ```json { "count":"2", "item":[ { "goods_id":"AA12345", "goods_name":"Beanie", "goods_amt":"5000", "goods_type":"others", "goods_detail":"AA1345678", "goods_quantity":"1", "goods_url":"http://nicestore.go/product/beanie/", "goods_sellers_id":"NICEPAY-NamaMerchant", "goods_sellers_name":"NICEPAYSHOP" }, { "goods_id":"BB12345", "goods_name":"Belt", "goods_amt":"5000", "goods_type":"others", "goods_detail":"BB12345678", "goods_quantity":"1", "goods_url":"http://nicestore.go/product/belt/", "goods_sellers_id":"NICEPAY-NamaMerchant", "goods_sellers_name":"NICEPAYSHOP" } ] } ``` ::: ### Kredivo *** `CartData` pada Registrasi berguna untuk mendeklarasikan *item *apa saja akan di-*checkout *berserta rincian dan harga per *item*. | **Parameter** | **Deskripsi** | **Contoh** | | ------------- | ----------------------------------------------------------------------------------------------------------- | ---------- | | `Count` | Total jumlah keseluruhan cart data | 3 | | `Item` | Parameter berisi rincian cart data, seperti
`img_url`, `goods_name`, `goods_detail` , dan `goods_amt` | - | *** Penjelasan rinci pada **Item.** | **Parameter** | **Deskripsi** | **Contoh / Catatan** | | -------------------- | ------------------- | ------------------------------------------------------------------------------------------------------- | | `goods_id` | ID Barang | AA12345

Dapat berisi kode yang berasal dari , `taxfee`, `shippingfee`
atau `discount` | | `goods_name` | Nama Barang | Ant Life | | `goods_amt` | Harga Barang | 200000 | | `goods_type` | Tipe Barang | others | | `goods_detail` | Rincian Barang | AA1345678 | | `goods_quantity` | Jumlah Barang | 1 | | `goods_url` | Tautan Barang | http\://nicestore.go/product/book/ | | `goods_sellers_id` | ID Penjual Barang | -Nama | | `goods_sellers_name` | Nama Penjual Barang | SHOP | *** :::CodeblockTabs cartData Paylater Kredivo Registration ```json { "count": "3", "item": [ { "goods_id": "AA12345", "goods_detail": "AA1345678", "goods_name": "Ant Life", "goods_amt": 200000, "goods_type": "Book", "goods_url": "http://nicestore.go/product/book/", "goods_quantity": 1, "goods_sellers_id": "NICEPAY-NamaMerchant", "goods_sellers_name": "NICEPAYSHOP" }, { "goods_id": "taxfee", "goods_detail": "", "goods_name": "", "goods_amt": 5000, "goods_type": "", "goods_url": "", "goods_quantity": 1, "goods_sellers_id": "NICEPAY-NamaMerchant", "goods_sellers_name": "NICEPAYSHOP" }, { "goods_id": "discount", "goods_detail": "", "goods_name": "Discount", "goods_amt": 20000, "goods_type": "", "goods_url": "", "goods_quantity": 1, "goods_sellers_id": "NICEPAY-NamaMerchant", "goods_sellers_name": "NICEPAYSHOP" }, { "goods_id": "shippingfee", "goods_detail": "Biaya Pengiriman", "goods_name": "Biaya Pengiriman", "goods_amt": 10000, "goods_type": "Book", "goods_url": "http://nicestore.go/product/book/", "goods_quantity": 1, "goods_sellers_id": "NICEPAY-NamaMerchant", "goods_sellers_name": "NICEPAYSHOP" } ] } ``` ::: :::hint{type="warning"} Parameter `goods_id` pada `CartData` mempengaruhi perhitungan `amt` dengan rumus seperti berikut: `amt`** = (**`shipmentfee`** + **`taxfee`** + **`goods_amt`** + ... ) - **`discount` Contoh: Berikut perhitungan berdasarkan data dari cartData Kredivo Registration. `shipmentfee` = 10000 `taxfee` = 5000 `goods_amt` = 200000 `discount` = 20000 `amt` = (10000 + 5000 + 200000) - 20000 = 215000 - 20000 = *195000* ::: ## Paylater Seller Data *** Seller Data berisi data Seller dikirimkan oleh Seller kepada untuk digunakan sebagai validasi Seller saat ber menggunakan . | **Parameter** | **Deskripsi** | **Contoh** | | ------------------------------------ | -------------------- | ------------------------------------------------ | | `sellersId` | ID Seller | SEL123 | | `sellersNm` | Nama Seller | Sellers 1 | | `sellersEmail` | Email Seller | sellers\@test.com | | `sellersUrl` | Tautan Seller | [http://nicestore.store](http://nicestore.store) | | `sellersAddress` -> `sellerNm` | Nama Seller | Sellers | | `sellersAddress` -> `sellerLastNm` | Nama Belakang Seller | 1 | | `sellersAddress` -> `sellerAddr` | Alamat Seller | jalan berbangsa 1 | | `sellersAddress` -> `sellerCity` | Kota Asal Seller | Jakarta Barat | | `sellersAddress` -> `sellerPostCd` | Kode Pos Seller | 12344 | | `sellersAddress` -> `sellerPhone` | Telepon Seller | 08123456789 | | `sellersAddress` -> `sellerCountry ` | Negara Asal Seller | ID | *** :::CodeblockTabs Paylater Seller Data ```json [ { "sellersId": "SEL123", "sellersNm": "Sellers 1", "sellersEmail": "sellers@test.com", "sellersUrl": "http://nicestore.store", "sellersAddress": { "sellerNm": "Sellers", "sellerLastNm": "1", "sellerAddr": "jalan berbangsa 1", "sellerCity": "Jakarta Barat", "sellerPostCd": "12344", "sellerPhone": "08123456789", "sellerCountry": "ID" } }, { "sellersId": "SEL124", "sellersNm": "Sellers 2", "sellersEmail": "sellers2@test.com", "sellersUrl": "http://nicestore.store", "sellersAddress": { "sellerNm": "Sellers", "sellerLastNm": "2", "sellerAddr": "jalan berkelok 3", "sellerCity": "Jakarta Utara", "sellerPostCd": "12222", "sellerPhone": "081255556789", "sellerCountry": "ID" } } ] ``` ::: [title] Registration & Notification - Account Binding Paylater API [path] NICEPAY API/API Non-SNAP/Advance API/Untitled/Untitled/ # Tentang Registration & Notification - Account Binding Paylater API *** ini digunakan oleh untuk menghubungkan akun pengguna guna mempermudah saat melakukan pemeriksaan detail akun serta mempercepat . :::hint{type="info"} Account Binding saat ini hanya dapat digunakan pada khusus Kredivo. ::: # Alur Proses Registration & Notification - Account Binding Paylater API *** ![Registration & Notification - Account Binding Paylater API](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/l8UDhrC12AHMaddXNdn-i_diagram-seamless-payment-api-paylater-tokenize-without-transaction.jpg "Registration & Notification - Account Binding Paylater API") Deskripsi alur: 1. mendaftarkan nomor telepon kepada . 2. mengajukan penghubungan akun kepada . 3. mengajukan penghubungan akun kepada . 4. melakukan validasi. 5. mengirimkan *response *kepada . 6. melakukan return redirect URL terhadap . 7. melakukan *redirect* ke terhadap . 8. melakukan login melalui login . 9. mengirimkan kredensial kepada . 10. melakukan validasi login. 11. melakukan *return *OTP terhadap . 12. memasukkan OTP kepada . 13. melakukan *generate *User Token (Account Bound). 14. mengarahkan menuju /. 15. Pada saat pengajuan penghubungan akun: - Pada : - Halaman / ditampilkan pada . - menunggu persetujuan. - Dari Notifikasi: - mengirimkan kepada . - menerima . - mengirimkan kepada . - menerima . - menampilkan hasil penghubungan akun kepada . Registration - Account Binding Paylater API =========================================== *** | **API Endpoint** | `/nicepay/v2/userAccountBinding` | | ------------------ | ------------------------------------------------------------------------- | | **Request Method** | **POST****** | | **Merchant Token** | **SHA256 **(`iMid` + `referenceNo` + `billingPhone` + `merchantKey`) | | **Request Format** | `application/JSON` | ## Request Parameter for Registration - Account Binding Paylater API *** | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ---------------------------------------------------------- | -------- | ---------- | -------------------------------------------------- | ---------------------------------------------------------------------------------------- | | `merchantToken`
Required | AN | 255 | Token | 6cfccfc0046773c1b589d8e98f8b596c284f3c70a4ecf86eba14c18944b74bcd | | `iMid`
Required | AN | 10 | ID | IONPAYTEST | | `timestamp`
Required | N | 14 | Request Timestamp | 20190318151435 | | `referenceNo`
Required | ANS | 40 | Reference Number | MerchantReferenceNumber001 | | `payMethod`
Required | N | 2 | Method
| `06`

`06` : | | `mitraCd`
Required | A | 4 | Code | `KDVI`

`KDVI` : Kredivo | | `billingNm`
Required | A | 100 | User Name | Jhon Doe | | `billingPhone`
Required | N | 15 | Kredivo User Phone | +62-82112345678

Format:
+62-`user phone number` | | `billingEmail` | ANS | 40 | User Email | [buyer@merchant.com](mailto\:buyer@merchant.com) | | `dbProcessUrl`
Required | ANS | 255 | path URL to receive "User token" (Account Bound) | [http://www.merchant.com/notif/userHandling](http://www.merchant.com/notif/userHandling) | | `callBackUrl`
Required | ANS | 255 | result forward URL after finish tokenize | [http://www.merchant.com/callback](http://www.merchant.com/callback) | | `clientUserKey`
Required | AN | 50 | User Key | 23124532 | ## Response Parameter for Registration - Account Binding Paylater API *** | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ----------------- | -------- | ---------- | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ | | `resultCd` | N | 4 | [Result Code](docId\:lKqJXSl5CMKdXYXxHYYSs) | `0000` | | `resultMsg` | AN | 255 | Result Message | SUCCESS | | `tXid` | AN | 30 | Transaction ID | IONPAYTEST06201607291027025291 | | `referenceNo` | ANS | 40 | Reference Number | MerchantReferenceNumber001 | | `payMethod` | N | 2 | Method
`06` : | 06 | | `transDt` | N | 8 | Transaction Date | 20160303 | | `transTm` | N | 6 | Transaction Time | 135959 | | `mitraCd` | A | 4 | [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8) | `KDVI`

`KDVI` : Kredivo | | `redirectUrlHttp` | ANS | 255 | URL to open linking | [https://pay.kredivo.com/kredivo/v2/connecting?tk=xxxxxx](https://pay.kredivo.com/kredivo/v2/connecting?tk=xxxxxx) | ## Sample Parameter for Registration - Account Binding Paylater API *** :::CodeblockTabs Request Parameter ```json { "merchantToken": "6cfccfc0046773c1b589d8e98f8b596c284f3c70a4ecf86eba14c18944b74bcd", "iMid": "IONPAYTEST", "timestamp": "20190318151435", "referenceNo": "MerchantReferenceNumber001", "payMethod": "06", "mitraCd": "KDVI", "billingNm": "Jhon Doe", "billingPhone": "+62-82112345678", "billingEmail": "buyer@merchant.com", "dbProcessUrl": "http://www.merchant.com/notif/userHandling", "callBackUrl": "http://www.merchant.com/callback", "clientUserKey": "23124532" } ``` Response Parameter ```json { "resultCd": "0000", "resultMsg": "SUCCESS", "tXid": "IONPAYTEST06201607291027025291" "referenceNo": "MerchantReferenceNumber001", "payMethod": "06", "transDt": "20160303", "transTm": "135959", "mitraCd": "KDVI", "redirectUrlHttp": "https://pay.kredivo.com/kredivo/v2/connecting?tk=xxxxxx" } ``` ::: Notification - Account Binding Paylater API =========================================== *** akan mengirimkan *user token *dengan *push notification* dikirim melalui `dbProcessUrl` pada saat Registration - Account Binding. harus memastikan tidak melakukan Blacklist IP dan melakukan Whitelist IP untuk mendapatkan *push notification* hanya dikirim dari server . | **API Endpoint** | `dbProcessUrl` | | ------------------ | -------------------------------------------------------------- | | **Request Method** | **POST****** | | **Request Format** | `application/JSON` | | **Merchant Token** | SHA256 (`iMid`+ `referenceNo`+ `billingPhone` + `merchantKey`) | ## Request Parameter for Notification - Account Binding Paylater API *** | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ---------------------------------------------------------- | -------- | ---------- | ----------------------------------------------------------------- | ---------------------------------------------------------------- | | `merchantToken`
Required | AN | 255 | token | 6cfccfc0046773c1b589d8e98f8b596c284f3c70a4ecf86eba14c18944b74bcd | | `iMid`
Required | AN | 10 | ID | IONPAYTEST | | `tXid` | AN | 30 | Transaction ID | IONPAYTEST06201607291027025291 | | `referenceNo`
Required | ANS | 40 | Reference Number | MerchantReferenceNumber001 | | `mitraCd`
Required | A | 4 | [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8)
`KDVI` : Kredivo | KDVI | | `billingNm`
Required | A | 100 | User Name | Jhon Doe | | `billingPhone`
Required | N | 15 |


User phone | +62-82112345678 | | `clientUserKey`
Required | AN | 50 | User Key | 735b7080-e08f-4ed4-927f-f77d44a7 | | `userToken`
Required | AN | 100 | User Token | 23124532 | ## Sample Parameter for Notification - Account Binding Paylater API *** :::CodeblockTabs Sample Notification ```json { "merchantToken": "6cfccfc0046773c1b589d8e98f8b596c284f3c70a4ecf86eba14c18944b74bcd", "iMid": "IONPAYTEST", "tXid": "IONPAYTEST06201607291027025291", "referenceNo": "MerchantReferenceNumber001", "mitraCd": "KDVI", "billingNm": "Jhon Doe", "billingPhone": "+62-82112345678", "billingEmail": "buyer@merchant.com", "userToken": "735b7080-e08f-4ed4-927f-f77d44a7" "clientUserKey": "23124532" } ``` ::: [title] NICEPAY Inquiry Virtual Account [path] NICEPAY API/API Non-SNAP/Advance API/Virtual Account - Advance API/ # Tentang API NICEPAY Inquiry Virtual Account *** Integrasi digunakan untuk *tipe NICEPAY Inquiry Virtual Account*. Pada ini, data berada di sisi . Sehingga, pada setiap dari , membutuhkan inquiry data , konfirmasi , dan melakukan *request* ke . # Alur NICEPAY Inquiry Virtual Account *** ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/OJT2u3IojTYOzGRGOaDFd_payment-va-bulk.png "Flow NICEPAY Inquiry Virtual Account") # Inquiry Process NICEPAY to Merchant *** Proses ini bertujuan untuk mengetahui rincian tagihan. Setelah mendapatkan permintaan inquiry dari , akan menggunakan *Merchant service* untuk mendapatkan rincian data . Kemudian, data tersebut akan tersimpan dalam riwayat internal sistem dan akan dikirim ke menggunakan format *response * inquiry. | **API URL** | https\:// \< merchant URL for inquiry > | | ------------------------ | --------------------------------------------------------- | | **Request Method ** | **POST (Body Raw JSON)****** | | **Merchant Token** | - | | **Request Format** | - | ## Inquiry Request Parameter *** Berikut ini adalah daftar untuk melakukan Inquiry kepada dari dilakukan pada tipe *NICEPAY Inquiry Virtual Account*. Parameter ini digunakan melalui platform pengujian sebagai salah satu tahapan supaya milik dapat terhubung dengan dari . | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | --------------- | -------- | ---------- | ------------------------------------------------------- | ---------------------------------------------------------------- | | `customerId` | N | 9 | ID | 891011101 | | `merchantToken` | AN | 255 | SHA256 (`Merchant ID` + `Customer ID` + `Merchant Key`) | 141fd2368aa80ea0e600b1b4d7a42c1e731e74a27a03521e8e28150cc00bc05b | | `prefix` | N | 7 | Prefix Number | 7015102 | | `bankCd` | AN | 4 | [Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | CENA | ## Inquiry Response Parameter *** Berikut adalah *response * dari hasil *request * untuk Inquiry kepada . | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ---------------- | -------- | ---------- | ---------------------------------------------------------------- | --------------------------------------------- | | `billingNm` | N | 100 | Name | John Doe | | `goodsNm` | AN | 100 | Goods/Item Name | Testing Buying | | `referenceNo` | N | 40 | Reference Number for | ordNo20221130101148 | | `amt` | AN | 12 | Total Bill Amount | 5000

Normal Amount
Only | | `resultCd` | N | 4 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) of Inquiry Status | 0000 | | `resultMsg` | AN | 255 | Result Message for [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | SUCCESS | ## Sample JSON Inquiry Process NICEPAY to Merchant *** :::CodeblockTabs JSON Request ```json { "customerId" : "891011101", "merchantToken" : "141fd2368aa80ea0e600b1b4d7a42c1e731e74a27a03521e8e28150cc00bc05b", "prefix" : "7015102", "bankCd" : "CENA" } ``` JSON Response ```json { "resultCd" : "0000", "resultMsg" : "SUCCESS", "billingNm" : "John Doe", "goodsNm" : "Testing Buying", "referenceNo" : "ordNo20221130101148", "amt" : "5000" } ``` Java Request ```java //Inquiry To Merchant// nicePay.setCustomerId("123456"); nicePay.setPrefix("000001"); nicePay.setBankCd("CENA"); nicePay.setMerchantToken(nicePay.makeToken(nicePay.getCustomerID()); //Request Inquiry// nicePay.inquiry(); //Response Inquiry// String resultCd = nicePay.get("resultCd"); String resultMsg = nicepay.get("resultMsg"); String billingNm = nicePay.get("billingNm"); String referenceNo = nicePay.get("referenceNo"); String goodsNm = nicePay.get("goodsNm"); String amt = nicePay.get("amt"); ``` ::: # Payment Process NICEPAY to Merchant *** *Payment Process NICEPAY to Merchant* adalah tahap untuk melanjutkan dilakukan . Saat melakukan *payment request* ke menggunakan nomor , akan memanggil *Merchant payment URL service* untuk . menentukan *response payment *untuk menerima atau menolak dari . | **API End Point** | https\:// \< URL for > | | ----------------- | --------------------------------------------------------- | | **Method ** | **POST (Body Raw JSON)****** | ## Payment Request Parameter *** Berikut ini adalah daftar untuk melakukan *Payment Process NICEPAY to Merchant* dari dilakukan pada *tipe NICEPAY Inquiry Virtual Account*. Parameter ini digunakan melalui platform pengujian sebagai salah satu tahapan supaya milik dapat terhubung dengan dari . | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | --------------- | -------- | ---------- | --------------------------------------------------------------- | ---------------------------------------------------------------- | | `customerId` | N | 9 | ID | 110000001 | | `merchantToken` | AN | 255 | SHA256 (`Merchant ID` + `Customer ID` + `amt` + `Merchant Key`) | 141fd2368aa80ea0e600b1b4d7a42c1e731e74a27a03521e8e28150cc00bc05b | | `referenceNo` | AN | 40 | Reference Number from Inquiry | OrdNo202210102323223 | | `prefix` | N | 7 | Prefix Number | 7015102 | | `bankCd` | AN | 4 | [Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | CENA | | `amt` | N | 12 | Total Bill Amount | 10000 | | `tXid` | AN | 30 | Transaction ID from | NORMALTEST02202211301010513135 | ## Payment Response Parameter *** Berikut adalah *response *parameter dari hasil *request * untuk *Payment Process NICEPAY to Merchant*. | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ---------------- | -------- | ---------- | --------------------------------------------------------------- | ----------------------------- | | `billingNm` | N | 100 | Name | John Doe | | `goodsNm` | AN | 255 | Goods/Item Name | Testing Buying | | `referenceNo` | N | 7 | Reference Number for | ordNo2022113010114 | | `amt` | AN | 4 | Total Bill Amount | Normal amount
only | | `resultCd` | | 4 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) of Inquiry Status | 0000 | | `resultMsg` | AN | 255 | Result Message for [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | SUCCESS | ## Sample JSON Payment Process NICEPAY to Merchant *** :::CodeblockTabs JSON Request ```json { "customerId" : "110000001", "merchantToken" : "141fd2368aa80ea0e600b1b4d7a42c1e731e74a27a03521e8e28150cc00bc05b", "referenceNo" : "OrdNo202210102323223", "prefix" : "7015102", "bankCd" : "CENA", "amt" : "10000", "tXid" : "NORMALTEST02202211301010513135" } ``` JSON Response ```json { "resultCd" : "0000", "resultMsg" : "SUCCESS", "billingNm" : "John Doe", "goodsNm" : "Testing Buying", "referenceNo" : "ordNo20221130101148", "amt" : "10000" } ``` Java Request ```java { merchantToken=b360a7dfd4e004e63a161d7298a006ac7900add126b8e19375c4a594ab2e806e, vacctType=1, referenceNo=2211JD1X7TX5, prefix=70015267, proxyUrl=http://172.30.51.31:8080/nicepay_proxy/api/bulkPayment.do, customerId=60028392, bankCd=BMRI, tXid=OYINDON00402202211160002385044, amt=150000, targetUrl=https://payfeedback.oyindonesia.com/nicepay/va/bulk/payment } ``` ::: # Reversal Process NICEPAY to Merchant *** *Reversal Process NICEPAY to Merchant* adalah pengembalian dana terjadi akibat terjadi isu di dalam internal . Pada ini, akan melanjutkan didapat dari kepada . | **API End Point** | https\:// \< URL for reversal > | | ----------------- | --------------------------------------------------------- | | **Method ** | **POST (Body Raw JSON)****** | ## Process Flow ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/Szs-r5qOWImlRGewe9dRb_nicepay-archbee-payment-va-reversaldrawio-4.png "Proses Reversal VA ") ## Reversal Request Parameter *** Berikut ini adalah daftar untuk melakukan *Reversal Process NICEPAY to Merchant* dari dilakukan pada *tipe NICEPAY Inquiry Virtual Account*. Parameter ini digunakan melalui platform pengujian sebagai salah satu tahapan supaya milik dapat terhubung dengan dari . | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | --------------- | -------- | ---------- | --------------------------------------------------------------- | ---------------------------------------------------------------- | | `customerId` | N | 9 | ID | 110000001 | | `merchantToken` | AN | 255 | SHA256 (`Merchant ID` + `Customer ID` + `amt` + `Merchant Key`) | 141fd2368aa80ea0e600b1b4d7a42c1e731e74a27a03521e8e28150cc00bc05b | | `referenceNo` | AN | 40 | Reference Number from Inquiry | OrdNo202210102323223 | | `prefix` | N | 7 | Prefix Number | 7015102 | | `bankCd` | AN | 4 | [Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | CENA | | `amt` | N | 12 | Total Bill Amount | 10000 | | `tXid` | AN | 30 | Transaction ID from | NORMALTEST02202211301010513135 | ## Reversal Response Parameter *** Berikut adalah *response * dari hasil *request * untuk *Reversal Process NICEPAY to Merchant*. | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ---------------- | -------- | ---------- | -------------------------------------------------------------------------- | -------------------------------------------------------------------------- | | `billingNm` | N | 100 | Name | John Doe

Top-Up Amount
Only | | `goodsNm` | AN | 100 | Goods/Item Name | Testing Reversal Transaction

Top-Up Amount
Only | | `referenceNo` | N | 40 | Reference Number for | OrdNo202210102323223 | | `amt` | AN | 12 | Total Bill Amount | 50000 | | `resultCd` | | 34 | Result Code of Inquiry Status [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | 0000 | | `resultMsg` | | 255 | Result Message for [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | SUCCESS | ## Sample JSON Reversal Process NICEPAY to Merchant *** :::CodeblockTabs JSON Request ```json { "customerId" : "110000001", "merchantToken" : "141fd2368aa80ea0e600b1b4d7a42c1e731e74a27a03521e8e28150cc00bc05b", "referenceNo" : "OrdNo202210102323223", "prefix" : "7015102", "bankCd" : "CENA", "amt" : "10000", "tXid" : "NORMALTEST02202211301010513135" } ``` JSON Response ```json { "resultCd" : "0000", "resultMsg" : "SUCCESS", "billingNm" : "John Doe", "referenceNo" : "OrdNo202210102323223", "goodsNm" : "Testing Reversal Transaction", "amt" : "50000" } ``` Java Request ```java //Reversal To Merchant// nicePay.setCustomerId("123456"); nicePay.settXid("NORMALTEST02202211301010513135"); nicePay.setBankCd("CENA"); nicePay.setPrefix("7015102"); nicePay.setAmt("10000"); nicePay.setReferenceNo("OrdNo202210102323223"); nicePay.setMerchantToken(nicePay.makeToken(nicePay.getCustomerID()); //Request Reversal// nicePay.reversal(); //Response Reversal// String resultCd = nicePay.get("resultCd"); String resultMsg = nicePay.get("resultMsg"); String billingNm = nicePay.get("billingNm"); String goodsNm = nicePay.get("goodsNm"); String referenceNo = nicePay.get("referenceNo"); String amt = nicePay.get("amt"); ``` ::: # See also ::::VerticalSplit :::VerticalSplitItem [Status Inquiry - API Checkout](docId\:K9vBS87ev9_w5oJAU0et3) untuk mengetahui untuk memeriksa inquiry khusus . ::: :::VerticalSplitItem [Cancel - API Checkout](docId\:MMmlusWDkyUsJxF421yKn) untuk mengetahui untuk membatalkan khusus . ::: :::: ::::VerticalSplit :::VerticalSplitItem [Status Inquiry - API Virtual Account](docId\:hqHww3quoVreZVG1Zp5ds) untuk mengetahui untuk memeriksa inquiry pada khusus . ::: :::VerticalSplitItem [Cancel - API Virtual Account](docId\:XnIHmWqi1kWBP9mYS4VQv) untuk mengetahui untuk membatalkan pada khusus . ::: :::: [title] API Convenience Store [path] NICEPAY API/API Non-SNAP/Payment API/ # Proses Pada API Convenience Store ::::LinkArray{contentSource="CUSTOM"} :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/WeE9iYey4j8wIvipUljuE-20260317-034634.jpg"} [Registration - API Convenience Store](docId\:p4bRL6dsnS-wppv5hFuLU) digunakan untuk mendaftarkan CVS saat pertama kali dibuat. ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/H_Xx0UPWSL9IqerbG0h4--20260317-034708.jpg"} [Status Inquiry - API Convenience Store](docId\:WMITrWcw3j9ChajRg-o1D) digunakan untuk memeriksa CVS sudah berhasil. ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/UorA4jTGHIoB7zqyFFlZc-20260317-034733.jpg"} [Notification - API Convenience Store](docId\:XXDlG7Jk1xcLWxz6PSnp0) digunakan untuk memeriksa CVS sedang berjalan. ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/GaE5ZwqVsCieclLhXRV4C-20260317-034748.jpg"} [Cancel - API Convenience Store](docId\:L-DtvJzQTenDps30WbyMC)digunakan untuk membatalkan CVS sedang berjalan. ::: :::: [title] Error Code [path] NICEPAY API/API Messaging/SMS API/Untitled/ *Error Code *adalah sebuah daftar kode *error * muncul dalam `resultCd` sebagai bentuk tulisan atau indeks dengan berbagai arti. Halaman ini berisi daftar kode *error *dan artinya. # General *** | **Nilai** | **Deskripsi** | | --------- | ---------------------------------------------------- | | `0000` | Success | | `1001` | Connection error | | `1002` | Socket error | | `1003` | Server error | | `1004` | Timeout error | | `9501` | Invalid number | | `9502` | Transaction not allowed | | `9503` | It has been stopped or terminated in its stores | | `9504` | No offus | | `9505` | No | | `9506` | No `Paymethod` | | `9507` | HTTP timeout exception | # Order *** | **Nilai** | **Deskripsi** | | --------- | ------------------------------------------------------------------------------------------------------------------------------- | | `8001` | Order registration error. | | `8002` | Order inquiry error. | | `8003` | Order registration data error. | | `8004` | The `tXid` error during inquiry. | | `8005` | `OrderAuthType` Response data null. | | `9001` | Failed to register your . check your HTTP Message. | | `9002` | Server is busy. kindly try again in few minutes. | | `9003` | Invalid Order. | | `9004` | Error on inquiry of confirmation. | | `9005` | Failed to check . contact for further . | | `9006` | Transaction number generated error. | | `9007` | Undefined: Amount. check your request and make sure \[`amt`] is defined. | | `9008` | Invalid Request Amount. Amount should only number and do not includes decimal. | | `9009` | Reference Number already exist. generate unique \[`referenceNo`]. | | `9010` | Invalid Token. Contact for further . | | `9011` | Invalid MID, is not registered. Contact for further . | | `9012` | This method is currently not activated. Contact for further . | | `9013` | Undefined: Currency Code. check your request and make sure \[`currencyCode`] is defined. | | `9014` | Undefined: Reference Number. check your request and make sure \[`referenceNo`] is defined. | | `9015` | Undefined: Goods Name. check your request and make sure \[`goodsNm`] is defined. | | `9016` | Undefined: Buyer Name. check your request and make sure \[`billingNm`] is defined. | | `9017` | Undefined: Buyer Phone Number. check your request and make sure \[`billingPhone`] is defined. | | `9018` | Undefined: Buyer E-mail Address. check your request and make sure \[`billingEmail`] is defined. | | `9019` | Undefined: Callback URL. check your request and make sure \[`callbackUrl`] is defined. | | `9020` | Undefined: Debit Process URL. check your request and make sure \[`dbProcessUrl`] is defined. | | `9021` | Failed in inquiring the criterion (`BO_MER_MGNT` `ORD_NO_DUP_CHK_FLG`). | | `9022` | Invalid Card Data. check \[`cartData`] , and make sure you send valid JSON format. | | `9023` | Invalid Cart Data. Amount is different with Cart Data total amount. make sure \[`amt`] = sum of \[`amt`] in \[`cartData`] | | `9024` | Undefined: IP Address. check your request and make sure \[`userIP`] is defined. | | `9025` | Undefined: Buyer City. check your request and make sure \[`billingCity`] is defined. | | `9026` | Undefined: Buyer State. check your request and make sure \[`billingState`] is defined. | | `9027` | Undefined: Buyer Postal Code. check your request and make sure \[`billingPostCd`] is defined. | | `9028` | Undefined: Buyer Country. check your request and make sure \[`billingCountry`] is defined. | | `9029` | Installment is not available for defined month | | `9030` | Transaction Fail. check . | | `9031` | Date/Time check. | # SMS *** | **Nilai** | **Deskripsi** | | --------- | -------------------------------------------------------------------------------------------- | | `0000` | Success. | | `1001` | Connection error. | | `1002` | Socket error. | | `1003` | Server error. | | `1004` | Timeout error. | | `4001` | Transaction Failed. contact for further . | | `9507` | Http timeout exception. | | `SR01` | format error/undefined : \[`timestamp`]. check your request and try again. | | `SR02` | format error/undefined : \[`iMid`]. check your request and try again. | | `SR03` | format error/undefined : \[`smsType`]. check your request and try again. | | `SR04` | format error/undefined : \[`reservedFlag`]. check your request and try again. | | `SR05` | format error/undefined : \[`reserveDt` or `reserveTm` ]. check your request and try again. | | `SR06` | format error/undefined : \[`msgRefno`]. check your request and try again. | | `SR07` | format error/undefined : \[`recipientNo`]. check your request and try again. | | `SR08` | format error/undefined : \[`smsMsg`]. check your request and try again. | | `SR09` | format error/undefined : \[`dbProcessUrl`]. check your request and try again. | | `SR10` | format error/undefined : \[`reqNm`]. check your request and try again. | | `SR11` | format error/undefined : \[`sender`]. check your request and try again. | | `SR12` | format error/undefined : \[`merchantToken`]. check your request and try again. | | `SR13` | format error/undefined : \[`tXid`]. check your request and try again. | | `SE01` | Common Validation Regis Data. | | `SE02` | Type Not Found. | | `SE03` | Not Enough Balance, Check Balance. | | `SE04` | Reserve Flag Not Allowed When Type is OTP. | | `SE05` | Data Not Found, Check Your Request Information. | | `SE06` | `reserveDt` or `reserveTm` Must be Filled When is Reserved. | | `SE07` | `reserveFlag` Should be 0 or 1. | | `SE08` | Message Length too Long. | | `SE09` | SMS Message Character Invalid \[Alphabets (Lowercase, Uppercase), Numbers]\[!@$\*()-+&\_ | | `SE10` | Token Error. | | `SE11` | Message Character % Must Followed with Space. | | `SE12` | Cancel Only for when is Reserved. | | `SE13` | Operator Not Found, Check `recipientNo`. | | `SE14` | `ReservedDt` Expired, Must be H+1. | | `SE15` | Sender Not Found. | | `SE16` | Registration Failed, Internal Server Error. | [title] API Direct Debit [path] NICEPAY API/API Non-SNAP/Payment API/ # Proses Pada API Direct Debit ::::LinkArray{contentSource="CUSTOM" customOrder="MclYRoqDrSJZjmhoZohcy,P52dnrEE0m-mhEQKb0cP8,phknS6Fm9D3ztxrhn1TK-,Q-UjFVyR8tzP_LPEFv044,2MMuROCeHmpK8d_eCCgrP"} :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/EVlh2i1ISRONsk0Fz4i68-20260317-035954.jpg"} [Registration - API Direct Debit](docId\:VxFYMW2MFyiQVX-Rj9DRe) digunakan untuk mendaftarkan saat pertama kali dibuat. ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/8QelJnd-GgiomRse1qjqC-20260317-040411.jpg"} [Payment - API Direct Debit](docId\:DMKlVm8r9ppphPE7aDKte) digunakan untuk melakukan pembayaran . ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/X3kM8yrE9mr8372Bz81gw-20260317-040512.jpg"} [Status Inquiry - API Direct Debit](docId\:TvyS0QCC6pqcXX8NulLFr) digunakan untuk memeriksa sudah berhasil. ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/-tEP0-YMHVy3j6pVS0-NJ-20260317-040646.jpg"} [Notification - API Direct Debit](docId\:FkgudEVyTgI6wulN93-Xv) digunakan untuk memeriksa sedang berjalan. ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/hx3rkz3O8P9WiXJTec-8N-20260317-040721.jpg"} [Cancel - API Direct Debit](docId\:h3Rne0OVf6NuWMdgDpS3c) digunakan untuk membatalkan sedang berjalan. ::: :::: [title] Payment - API Direct Debit [path] NICEPAY API/API Non-SNAP/Payment API/API Direct Debit/ # Tentang API Direct Debit Payment *** Melalui , menawarkan kemudahan lintas aplikasi (*Jump App*) untuk . Notifikasi akan dikirimkan ke secara *real-time* sesaat setelah menyelesaikan . :::hint{type="info"} - kunjungi [Alur Pembayaran Direct Debit](docId\:e5Hsqs6VJRuvWqsAXCjIE) untuk mengetahui alur pembayaran melalui Jenius Pay. - kunjungi [Direct Debit](docId\:uNFXkAwzKTCzlss__2PUt) untuk mempelajari umum mengenai . ::: # API Direct Debit Payment *** bertujuan untuk mengaktifkan pada , sehingga dapat melakukan menggunakan dengan . Tahapan ini bertujuan untuk melakukan dari dengan dari . | **API URL** | `/nicepay/direct/v2/payment` | | ------------------ | ------------------------------------------------------------- | | **Request Method** | **POP UP, Redirect, Submit****** | | **Description** | Performs Request to
| | **Merchant Token** | SHA256(`timeStamp`+`iMid`+`referenceNo`+`amt`+`merchantKey`) | | **Request Format** | `application/x-www-form-urlencoded` | :::hint{type="success"} Proses hanya dapat dijalankan setelah melalui registrasi. pelajari lebih lengkap tentang registrasi pada [Registration - API Direct Debit](docId\:VxFYMW2MFyiQVX-Rj9DRe). ::: ## Request Parameter for Direct Debit Payment *** Berikut ini adalah daftar untuk melakukan pengajuan registrasi melalui Jenius Pay. Parameter ini digunakan melalui platform pengujian sebagai salah satu tahapan supaya milik dapat terhubung dengan dari . | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | -------------------------------------------------------- | -------- | ---------- | -------------------------------------- | ---------------------------------------------------------------- | | `timestamp`
Required | N | 14 | Request Timestamp (`YYYYMMDDHH24MISS`) | 20250307130363 | | `tXid`
Required | AN | 30 | Transaction ID | TNICECP04104202503071335233256 | | referenceNo
Required | ANS | 40 | 's Reference Number | ORD20250307130386 | | callBackUrl
Required | ANS | 255 | Result URL | https\://dev.nicepay.co.id/IONPAY\_CLIENT/paymentResult.jsp | | cashtag
Required | A | 100 | Cashtag ID (with $) | $johndoe | | merchantToken
Required | AN | 255 | Token | 8cff7e7cf660fee8afe26b04678b5c16ad63cd2697ede06bab4efbc9357b960a | :::hint{type="success"} dapat mengikuti panduan dan melalui Jenius Pay pada [Integrasi & Testing Direct Debit](docId\:sHrV7hpVnWLt9ipNeCfE4). ::: ## Response Parameter for Direct Debit Payment *** | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ------------- | -------- | ---------- | ---------------------------------------------------------- | ----------------------------------- | | `resultCd` | N | 4 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | 0000 | | `resultMsg` | AN | 225 | Result Message: [Error Code](docId\:yEh1VA9k2y6sL1kQF2aWD) | Success | | `tXid` | AN | 30 | Transaction ID
| TNICECP04104202503061526463653 | | `referenceNo` | ANS | 40 | 's Reference Number | OrdNo-20250306150301 | | `amt` | N | 12 | Amount | 10000 | | `transDt` | N | 8 | Transaction Date (`YYYYMMDD`) | 20250306 | | `transTm` | N | 6 | Transaction Date (`HH24MISS`) | 152646 | Sample JSON for Direct Debit Payment ------------------------------------ *** :::CodeblockTabs Request Parameter ```json { "timeStamp": "20250307130363", "tXid": "TNICECP04104202503071335233256", "referenceNo": "ORD20250307130386", "callBackUrl": "https://dev.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp", "cashtag": "$johndoe", "merchantToken": "8cff7e7cf660fee8afe26b04678b5c16ad63cd2697ede06bab4efbc9357b960a" } ``` Response Parameter ```json { "resultCd": "0000", "resultMsg": "Please do payment on jenius pay apps", "tXid": "TNICECP04104202503061526463653", "referenceNo": "OrdNo-20250306150301", "amt": "", "transDt": "20250306", "transTm": "152646" } ``` ::: [title] Registration & First Payment - DANA Recurring API [path] NICEPAY API/API Non-SNAP/Advance API/E-Wallet - Advance API/DANA Recurring - E-Wallet API Advance/ # Tentang Registration & First Payment - DANA Recurring API *** *NICEPAY API Registration & First Payment* memiliki tujuan agar dapat mendaftarkan dan terintegrasi dengan dari untuk melakukan pertama. # Registration & First Payment - DANA Recurring API *** | **API Endpoint** | `/nicepay/api/danaRecurring.do` | | ------------------ | ------------------------------------------------------------ | | **Request Method** | **POST** Form (Parameter) | | **Description** | DANA Recurring | | **Merchant Token** | SHA256(`timeStamp`+`iMid`+`referenceNo`+`amt`+`merchantKey`) | ## Request Parameter Registration & First Payment - DANA Recurring API *** Berikut ini adalah daftar untuk melakukan *request *pendaftaran dan pada DANA Recurring . | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ----------------------------------------------------------- | -------- | ---------- | ---------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | | `timeStamp`
Required | N | 14 | Request Date
(`YYYYMMDDHH24MiSS`) | 20211005123015 | | `iMid`
Required | AN | 10 | ID | IONPAYTEST | | `payMethod`
Required | AN | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | 05 | | `currency`
Required | AN | 3 | Currency | IDR | | `amt`
Required | N | 12 | Amount | 1000 | | `referenceNo`
Required | ANS | 40 | Order Number
/ Transaction ID | MerchantReferenceNumber001 | | `goodsNm`
Required | AN | 100 | Goods Name will show in DANA Page |  Goods 1 | | `billingNm`
Required | A | 30 | Buyer Name | John Doe | | `billingPhone`
Required | N | 15 | Buyer Phone Number | 081234567891 | | `billingEmail`
Required | AN | 40 | Buyer Email | buyer\@merchant.com | | `billingAddr` | AN | 100 | Buyer Address | Billing Address | | `billingCity`
Required | A | 50 | Buyer City | Jakarta | | `billingState`
Required | A | 50 | Billing State | Jakarta | | `billingPostCd`
Required | N | 10 | Billing Post Number | 12345 | | `billingCountry`
Required | A | 10 | Billing Country | Indonesia | | `deliveryNm` | A | 30 | Delivery Name | Buyer Name | | `deliveryPhone` | N | 15 | Delivery Phone Number | 081234567891 | | `deliveryAddr` | AN | 100 | Delivery Address | Billing Address | | `deliveryCity` | A | 50 | Delivery City | Jakarta  | | `deliveryState` | A | 50 | Delivery State | Jakarta  | | `deliveryPostCd` | N | 10 | Delivery Post Number | 12345 | | `deliveryCountry` | A | 10 | Delivery Country | | | `callBackUrl`
Required | AN | 255 | Callback URL | [https://www.nicepay.co.id/IONPAY\_CLIENT/paymentResult.jsp](https://www.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp) | | `dbProcessUrl`
Required | AN | 255 | Notification URL (Async Notification) | [https://ptsv2.com/t/nicepay-dbProccessUrl/post](https://ptsv2.com/t/nicepay-dbProccessUrl/post) | | `description` | AN | 100 | Transaction Description | Description | | `merchantToken`
Required | AN | 255 | Token | 6cfccfc0046773c1b589d8e98f8b596c284f3c70a4ecf86eba14c18944b74bcd | | `userIP`
Required | AN | 15 | User IP () | 127.0.0.1 | | `userSessionID` | AN | 100 | User Session ID | userSessionID | | `userAgent` | AN | 100 | User Agent Information | Mozilla | | `userLanguage` | A | 2 | User Language | en-US | | `cartData`
Required | AN | 4000 | Cart Data | \{String JSON\_Format} | | `mitraCd`
Required | A | 4 | [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8) | DANA | | `recurrType`
Required | N | 1 | [Recurring Type Code](docId:7huicmz14lpUcQs_mVmFs) | `1`: Daily
`2`: Weekly
`3`: Monthly | | `recurrIntv`
Required | N | 2 | Time Gap between Subcriptions | 1 | | `recurrPeriod`
Required | N | 2 | Total Number of Times Subcriptions will made | 2 | ## Sample Parameter Registration & First Payment - DANA Recurring API *** :::CodeblockTabs Create Recurring Issue Sample ```none POST /nicepay/api/danaRecurring.do HTTP/1.1 Host: dev.nicepay.co.id Content-Type: application/x-www-form-urlencoded timeStamp:20211005123015 iMid:IONPAYTEST payMethod:05 currency:IDR amt:1000 referenceNo:MerchantReferenceNumber001 goodsNm:Merchant Subscription billingNm:John Doe billingEmail:buyer@merchant.com billingPhone:081234567891 billingAddr:Billing Address billingCity:Jakarta billingState:Jakarta billingPostCd:12345 billingCountry:Indonesia deliveryNm:Buyer Name deliveryPhone:081234567891 deliveryAddr:Billing Address deliveryCity:Jakarta deliveryState:Jakarta deliveryPostCd:12345 deliveryCountry:Indonesia callBackUrl:https://www.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp dbProcessUrl:https://ptsv2.com/t/nicepay-dbProccessUrl/post vat: fee: notaxAmt: description:Description userIP:127.0.0.1 userSessionID:userSessionID userAgent:Mozilla userLanguage:en-US merchantToken:ab49212e792d7b50428e7b657674c188c32060870e93548dd613e8c42aa98686 cartData:{"count":1,"item":[{"img_url":"https://d3nevzfk7ii3be.cloudfront.net/igi/vOrGHXlovukA566A.medium","goods_name":"Nokia 3360","goods_detail":"Old Nokia 3360","goods_amt":"1000","goods_quantity":"1"}]} mitraCd:DANA reqDt: reqTm: reqDomain: reqServerIP: reqClientVer: worker: shopId: msId: msFee: msFeeType: escrowCl: mbFee: mbFeeType: recurrOpt: recurrType:2 recurrIntv:1 recurrPeriod:2 ``` cartData Sample ```json {"count":1,"item":[{"img_url":"https://d3nevzfk7ii3be.cloudfront.net/igi/vOrGHXlovukA566A.medium","goods_name":"Nokia 3360","goods_detail":"Old Nokia 3360","goods_amt":"1000","goods_quantity":"1"}]} ``` ::: [title] Cancel & Remove - DANA Recurring API [path] NICEPAY API/API Non-SNAP/Advance API/E-Wallet - Advance API/DANA Recurring - E-Wallet API Advance/ # Tentang Cancel & Remove - DANA Recurring API *** ini digunakan untuk membatalkan sudah dibayarkan dan menghapus data untuk selanjutnya. Jika dibatalkan sebelum selesai, maka tersebut dianggap *void *dan dana tersebut akan dikembalikan kepada . # Cancel & Remove - DANA Recurring API *** | **API Endpoint** | `/nicepay/direct/v2/cancel` | | ------------------ | ----------------------------------------------------- | | **Request Method** | ******POST****, JSON** | | **Description** | Cancel API | | **Merchant Token** | SHA256(`timeStamp`+`iMid`+`tXid`+`amt`+`merchantKey`) | ## Request Parameter Cancel & Remove - DANA Recurring *** Berikut ini adalah daftar untuk melakukan *request *pembatalan pada DANA Recurring . | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ---------------------------------------------------------- | -------- | ---------- | ---------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | | `timeStamp`
Required | N | 14 | Request Date | 20170708123456 | | `tXid`
Required | AN | 30 | Transaction ID | IONPAYTEST02201603091207051498 | | `iMid`
Required | AN | 10 | ID | IONPAYTEST | | `payMethod`
Required | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | `05`: | | `cancelType`
Required | N | 2 | [Cancel Type Code](docId\:Mq9xE7wdOPR8OkZ3v-pVc) | `1`: Full Cancellation
`2`: Partial Cancellation
`3`: Remove Subscription / Stop Recurring | | `cancelMsg`
| AN | 255 | Cancel Message | Cancel Message | | `merchantToken`
Required | AN | 255 | Token | 6cfccfc0046773c1b589d8e98f8b596c284f3c70a4ecf86eba14c18944b74bcd | | `amt`
Required | N | 12 | Amount | 100 | | `cancelServerIp` | AN | 15 | Server IP | 127.0.0.1 | | `cancelUserId` | AN | 30 | User ID | Admin | | `cancelUserIp` | AN | 15 | User IP | 127.0.0.1 | | `cancelUserInfo` | AN | 100 | User Information |  cancel  | | `cancelRetryCnt` | N | 2 | Retry Count | (Optional) | | `worker` | AN | 10 | Worker | Worker | ## Response Parameter Cancel & Remove - DANA Recurring *** Berikut ini adalah daftar *response* dari pembatalan pada DANA Recurring. | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ------------- | -------- | ---------- | -------------------------------------------- | -------------------------------------------------- | | `tXid` | AN | 30 | Transaction ID | IONPAYTEST02201603091207051498
When Success | | `referenceNo` | ANS | 40 | Order Number | OrdNo20160525000-52104
When Success | | `resultCd` | N | 4 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | 0000 | | `resultMsg` | AN | 255 | Result Message | SUCCESS | | `transDt` | N | 8 | Transaction Date | 20160303

When Success | | `transTm` | N | 6 | Transaction Time | 135959

When Success | | `description` | AN | 255 | Description | of OrdNo20160525000-52104

When Success | | `amt` | N | 12 | Amount | 100

When Success | ## Sample Parameter Cancel & Remove - DANA Recurring *** :::CodeblockTabs Sample Request Cancel ```json { "timeStamp": "20211203091223", "tXid": "IONPAYTEST05202108231310459282", "iMid": "IONPAYTEST", "payMethod": "05", "cancelType": "1", "cancelMsg": "Full Cancel", "merchantToken": "654100834b5c4174235e831941d4d2524949e4e44f1102cb45b9ccefa96c1629", "preauthToken": "", "amt": "100", "cancelServerIp": "", "cancelUserId": "", "cancelUserIp": "", "cancelUserInfo": "", "cancelRetryCnt": "", "worker": "" } ``` Sample Response Cancel ```json { "tXid": "IONPAYTEST05202108231310459282", "referenceNo": " OrdNo20217131024122", "resultCd": "0000", "resultMsg": "SUCCESS", "transDt": "20210823", "transTm": "131250", "description": " this is test transaction!!", "amt": "1000" } ``` Sample Request Remove ```json { "timeStamp": "20211203091208", "tXid": "IONPAYTEST05202108231310459282", "iMid": "IONPAYTEST", "payMethod": "05", "cancelType": "3", "cancelMsg": "Test Remove Recurring", "merchantToken": "5bb6dac991d5529745f95dfbd1b6ddc75152a0231da303b77d148d63d46011df", "preauthToken": "", "amt": "100", "cancelServerIp": "", "cancelUserId": "", "cancelUserIp": "", "cancelUserInfo": "", "cancelRetryCnt": "", "worker": "" } ``` Sample Response Remove ```json { "tXid": "IONPAYTEST05202108231310459282", "referenceNo": " OrdNo20217131024122", "resultCd": "0000", "resultMsg": "SUCCESS", "transDt": "20210823", "transTm": "131250", "description": " this is test transaction!!", "amt": "100" } ``` ::: [title] Virtual Account - Advance API [path] NICEPAY API/API Non-SNAP/Advance API/ # Tentang Advance API Virtual Account *** Informasi berikut ditujukan untuk tipe **Static (Fix Open)** dan *NICEPAY Inquiry Virtual Account*. ::::LinkArray{contentSource="CUSTOM"} :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/T0Ed9zXtQrg-gGuChfIF2-20260324-082140.jpg"} [Virtual Account Static](docId\:TlvtOb_yPO_kFiaaVTqb6) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/FwCb_K1NRESnJNu-y5XDV-20260324-082153.jpg"} [NICEPAY Inquiry Virtual Account](docId\:tA1JvQJDkIGUs3bJqkc_S) ::: :::: [title] Deactivate - Account Binding Paylater API [path] NICEPAY API/API Non-SNAP/Advance API/Untitled/Untitled/ # Tentang Deactivate - Account Binding Paylater API *** ini digunakan oleh untuk menonaktifkan *user token* melalui . Selanjutnya, akan meneruskan penonaktifan *user token* ini ke . :::hint{type="info"} Deactive (Account Binding ) saat ini hanya dapat digunakan pada khusus Kredivo. ::: # Deactivate User Token - Account Binding Paylater API *** | **API Endpoint** | `/nicepay/direct/v2/remove-token` | | ------------------ | ------------------------------------------------------------------ | | **Request Method** | **POST****** | | **Merchant Token** | **SHA256** (`timestampTrx` + `iMid` + `userToken` + `merchantKey`) | | **Request Format** | `application/JSON` | ## Request Parameter for Deactivate User Token - Account Binding Paylater API *** | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | **Contoh / Catatan** | | --------------- | -------- | ---------- | ------------- | ------------------ | ---------------------------------------------------------------- | | `timeStamp` | N | 14 | Mandatory | Request Timestamp | 20210913100917 | | `userToken` | AN | 50 | Mandatory | User Token | e0478456-6b50-460c-85e0-627a1e22d2e0 | | `merchantToken` | AN | 255 | Mandatory | Token | 1d5b53fb0fe98f32088efd04fabc93cabb0ea3e75f1f2ef75aaa0917d565abf0 | | `iMid` | AN | 10 | Mandatory | ID | PAYLOANTES | ## Response Parameter for Deactivate User Token - Account Binding Paylater API *** | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ------------- | -------- | ---------- | ------------------ | ------------------------------------ | | `resultCd` | N | 4 | Result Code | 0000 | | `resultMsg` | AN | 255 | Result Message | Success | | `userToken` | AN | 50 | User Token | e0478456-6b50-460c-85e0-627a1e22d2e0 | | `tokenStatus` | N | 1 | User Token Status | `0`: Inactive | | `description` | AN | 100 | Account Status | 12345678Deactivated by merchant | ## Sample Parameter for Deactivate User Token - Account Binding Paylater API *** :::CodeblockTabs Response Parameter ```json { "resultCd": "0000", "resultMsg": "SUCCESS", "billingNm": "non-prod", "billingPhone": "+62-821****3300", "accountStatus": "1", "accountType": "2", "limitDetails": [ { "paymentType": "12_months", "remainingUserLimit": "29949710.00", "totalUserLimit": "30000000.00" }, { "paymentType": "30_days", "remainingUserLimit": "3449710.00", "totalUserLimit": "3500000.00" }, { "paymentType": "3_months", "remainingUserLimit": "9649130.00", "totalUserLimit": "9800000.00" }, { "paymentType": "6_months", "remainingUserLimit": "18338977.60", "totalUserLimit": "18600000.00" } ] } ``` Response Parameter ```json { "resultCd": "9920", "resultMsg": "Error get User Details: Invalid user_token" } ``` ::: # Deactivate From App Notification - Account Binding Paylater API *** | **API Endpoint** | Endpoint
example: [https://merchant.com/deactivateTokenNotif](https://merchant.com/deactivateTokenNotif) | | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Request Method** | **POST****** | | **Description** | User may deactivate their tokenized account from app. Push will be sent to inform respective to invalidate user token.
 
***Please contact your NICEPAY PIC to register your push notification endpoint URL.***  | | **Merchant Token** | **SHA256 **(`iMid` + `userToken` + `clientUserKey` + `merKey`) | | **Request Format** | `application/JSON` | ## Notification Parameter for Deactivate From App Notification - Account Binding Paylater API *** | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | --------------- | -------- | ---------- | ----------------------------------- | ---------------------------------------------------------------- | | `clientUserKey` | AN | 100 | User Key, must be unique for each . | 23124532 | | `userToken` | AN | 50 | User Token | e0478456-6b50-460c-85e0-627a1e22d2e0 | | `merchantToken` | AN | 255 | Token | 1d5b53fb0fe98f32088efd04fabc93cabb0ea3e75f1f2ef75aaa0917d565abf0 | | `iMid` | AN | 10 | ID | PAYLOANTES | | `message` | AN | 50 | Message | Token Invalidated | ## Sample Notification for Deactivate From App Notification - Account Binding Paylater API *** :::CodeblockTabs Sample Notification ```json { "clientUserKey": "23124532", "userToken": "e0478456-6b50-460c-85e0-627a1e22d2e0", "merchantToken": "6cfccfc0046773c1b589d8e98f8b596c284f3c70a4ecf86eba14c18944b74bcd", "iMid": "IONPAYTEST", "message": "Token Is Deactived" } ``` ::: [title] Account Binding - Paylater API Advance [path] NICEPAY API/API Non-SNAP/Advance API/Untitled/ # Tentang Account Binding - Paylater API Advance *** Account Binding digunakan untuk menghubungkan akun pengguna milik dengan akan dilakukan. Hal ini dilakukan untuk mempermudah melakukan pemeriksaan detail akun serta mempercepat . :::hint{type="info"} Account Binding saat ini hanya dapat digunakan pada khusus Kredivo. ::: # Account Binding - Paylater API Advance *** ::::LinkArray{contentSource="CUSTOM"} :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/CK4LBf6DIUwlNnH9zqIWQ_header-non-snap-advance-api-paylater-account-binding-registration-notification.jpg"} [Registration & Notification - Account Binding Paylater API](docId\:HU_q-9UZjxF32uv9gLBGK) digunakan untuk menghubungkan akun pengguna milik dengan . ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/ujtS3QW79BIWkPPdXMi6R_header-non-snap-advance-api-paylater-account-binding-user-detail.jpg"} [User Detail - Account Binding Paylater API](docId\:XynvIUFOgg2YjxuA5R52K) digunakan untuk pemeriksaan akun pengguna milik sebelum melakukan . ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/w5oMJDerVfo8ukbCRufZP_header-non-snap-advance-api-paylater-account-binding-deactivate.jpg"} [Deactivate - Account Binding Paylater API](docId\:zZvRQbO6U_qUaiV2A0tMj) digunakan untuk penonaktifan *user token* di melalui . ::: :::: [title] Notification Status Code [path] NICEPAY API/API Non-SNAP/NICEPAY Code/ *Notification Status Code* adalah kode digunakan untuk memeriksa pengiriman dana melalui *push notification*. | **Nilai Kode** | **Deskripsi** | | -------------- | -------------------------------------------- | | `0` | Deposit / bahwa dana pada berhasil masuk. | | `1` | Reversal / bahwa dana pada gagal. | [title] Recurring Type Code [path] NICEPAY API/API Non-SNAP/NICEPAY Code/ Kode *Recurring Type* digunakan untuk menentukan tipe Recurring akan digunakan dalam [Cancel - API GPN](docId\:yif3ys7qvm1sjxvw9TfmH). | **Nilai Kode** | **Deskripsi** | | -------------- | ------------------------------------------------------------------------------------------------------------------ | | `0` | *Auto Void* atau pertama akan dibatalkan oleh . | | `1` | *Not Auto Void * pertama tetap sukses dan tidak dibatalkan* (cancel).* | | `2` | Pembayaran pertama sukses tanpa mengirimkan `recurringToken`.
Pada kedua, perlu memasukkan data kartu lagi. | [title] Callback URL - API Credit Card [path] NICEPAY API/API Non-SNAP/Payment API/API Credit Card/ # Tentang Callback URL - API Credit Card *** Callback URL merupakan berfungsi untuk mengembalikan ke setelah berlangsung oleh . Callback URL bersifat wajib diisi oleh supaya mendapatkan dari setiap ajukan kepada . Format Callback URL seperti sudah dijelaskan pada [Payment - API Credit Card](docId\:FcJslW1q-2oJhb0HWqJsj) adalah sebagai berikut. | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ---------------------------------------------------------- | -------- | ---------- | ------------- | --------------------------------- | | `callBackUrl `
Required | ANS | 255 | Result URL | https\://merchant.com/callBackUrl | # Sample JSON Callback - API URL Credit Card *** Berikut adalah contoh *request body *untuk Callback URL . :::CodeblockTabs URL CallBack ```json "callbackUrl" : "https://www.merchant.com/callbackUrl/" ``` Request Body ```json { "resultCd":"0000", "resultMsg":"SUCCESS", "tXid":"IONPAYTEST01202212141112221428", "referenceNo":"", "payMethod":"01", "amt":"10000", "transDt":"20221212", "transTm":"121212", "description":"Testing Credit Card Transaction", "authNo":"080623", "issuBankCd":"OTHR" "acquBankCd":"BMRI", "cardNo":"453211*****1111", "goodsNm":"Test Transaction Nicepay" "billingNm":"John Doe", "currency":"IDR", "timeStamp":"20221212121212", "merchantToken":"2035d2295d9578fffb40137186f0203474142ae3e57992d4847826c5fcaffce6", "cardExpYymm":"2712", "instmntMon":"1", "instmntType":"1", "ccTransType":"1" } ``` ::: [title] Response Code [path] NICEPAY API/API Non-SNAP/NICEPAY Code/ *Response Code* digunakan untuk memeriksa saat menerima *response *dari . # Payout *** | **Kode *****Response*** | **Deskripsi** | | ---------------------------- | ----------------------------------- | | `0000` | Success. | | `P020` | Invalid JSON Format. | | `P021` | Content type not supported. | | `PO01` | Validation Fail. | | `PO01_1` | IP Address Validation error. | | `PO01_2` | \[`AccountNo`] Validation error. | | `PO02` | Request amount is too small or big. | | `PO03` | Request Fail. | | `PO04` | account validation fail. | | `PO05` | Invalid `tXid`. | | `PO06` | Invalid `payoutToken`. | | `PO07` | `tXid` is duplicate. | | `PO08` | Invalid OTP. | | `PO09` | Approve Fail. | | `PO10` | Not enough . | | `PO11` | Transfer Fail. | | `PO12` | Cannot be canceled. | | `PO13` | trans Not exist. | | `PO14` | trans already fail. | | `PO15` | not yet make approve. | | `PO16` | date reserved check. | | `PO17` | transfer method not exist. | | `PO18` | Benef type should be 1 - 4. | | `PO19` | Benef should be 1 - 2. | | `PO20` | Access Token validation fail. | | `PO21` | Benef Name not exist. | [title] Cancel - API Convenience Store [path] NICEPAY API/API Non-SNAP/Payment API/API Convenience Store/ # Tentang API Convenience Store Cancel *** Cancel ini digunakan untuk mengintegrasikan *cancel *atau pembatalan pada digunakan oleh . Pembatalan dapat terjadi baik dari sisi maupun .  1. Jika berubah pikiran setelah melakukan suatu pemesanan dan mengajukan pembatalan kepada sebelum melakukan .  2. Jika pada saat melakukan pada pesanan terjadi kendala baik teknis maupun non-teknis.  dapat menggunakan ini agar nomor sudah terbit tidak bisa digunakan. :::hint{type="warning"} Nomor sudah dibuat **hanya dapat dibatalkan** sebelum berlangsung via . Apabila sudah melakukan , tagihan sudah dibayarkan tidak bisa dibatalkan atau dilakukan pengembalian dana pada melalui . ::: # API Convenience Store Cancel *** Cancel digunakan untuk *cancel* melalui metode . | **API End Point** | `/nicepay/direct/v2/cancel` | | ------------------ | ----------------------------------------------------- | | **Request Method** | **POST** | | **Header** | `Content-Type: application/json` | | **Merchant Token** | SHA256(`timeStamp`+`iMid`+`tXid`+`amt`+`merchantKey`) | | **Request Format** | `application/json` | # Payment Methods Available for Cancel *** **Code PayMethod** *** `01` *** `02` *** `03` **Convenience Store****** *** `04` *** `05` *** `06` *** `08` *** `09` *** ## Request Parameters for Convenience Store Cancel *** Berikut ini adalah daftar untuk mengaktifkan *cancel* pada . Parameter ini digunakan melalui platform pengujian . | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ----------------------------------------------------------- | -------- | ---------- | --------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- | | `timeStamp`
Required | N | 14 | Request Timestamp | 20221212101278 | | `tXid`
Required | AN | 30 | Transaction ID
| IONPAYTEST03202212121030529316 | | `iMid`
Required | AN | 10 | ID
| IONPAYTEST | | `payMethod`
Required | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok)
| 03 | | `cancelType`
Required | N | 2 | [Cancel Type Code](docId\:Mq9xE7wdOPR8OkZ3v-pVc)
| 1 | | `cancelMsg` | AN | 255 | Cancel Message | Request Cancel | | `merchantToken`
Required | AN | 255 | Token
| 49974dde3c4a311030bd2095431443ce3689d79c90caaa88f4186050abb77cf9 | | `amt`
Required | N | 12 | Amount
| 10000 | | `preauthToken` | AN | 100 | Pre-Auth Token | - | ## Response Parameters for Convenience Store Cancel *** Berikut adalah *response* dari hasil *request * untuk *cancel.* | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ------------- | -------- | ---------- | ----------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- | | `resultCd` | N | 4 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) [ ](https://app.archbee.com/docs/36sM2OxRIwwbi9iNlqMTP/wpcEMaZro_Xvnxz-1ZAiB) | 0000 | | `resultMsg` | AN | 255 | Result Message: [Error Code](docId\:yEh1VA9k2y6sL1kQF2aWD) | SUCCESS | | `tXid` | AN | 30 | Transaction ID | IONPAYTEST03202212121030529316 | | `referenceNo` | ANS | 40 | Order Number | 815123412341 | | `transDt` | N | 8 | Transaction Date | 20221212 | | `transTm` | N | 6 | Transaction Time | 103052 | | `description` | AN | 255 | Description | test cancel | | `amt` | N | 12 | Amount | 10000 | ## Response Parameter for Convenience Store Cancel *** :::CodeblockTabs JSON Request ```json { "timeStamp":"20221212101278", "tXid":"IONPAYTEST03202212121030529316", "iMid":"IONPAYTEST", "payMethod":"03", "cancelType":"1", "cancelMsg":"Request Cancel", "merchantToken":"49974dde3c4a311030bd2095431443ce3689d79c90caaa88f4186050abb77cf9", "preauthToken":"", "amt":"10000" } ``` JSON Response ```json { "tXid": "IONPAYTEST03202212121030529316", "referenceNo": "815123412341", "resultCd": "0000", "resultMsg": "SUCCESS", "transDt": "20221212", "transTm": "103052", "description": "test cancel", "amt": "10000" } ``` Java Request ```java //Cancel Registration// nicePay.setTimeStamp("20221208091279"); nicePay.setiMid("IONPAYTEST"); nicePay.setAmt("5"); nicePay.setMerchantToken(nicePay.makeToken(nicePay.getMerchantToken()); nicePay.settXid("IONPAYTEST08202212080951090538"); nicePay.setPayMethod("03"); nicePay.setCancelType("1"); nicePay.setCancelMsg("Request Cancel"); // Request Cancel nicePay.cancel(); // Response String // System.out.println("Final Response String : " + nicePay.getResponseString()); String resultCd = nicePay.Get("resultCd"); String resultMsg = nicePay.Get("resultMsg"); String tXid = nicePay.Get("tXid"); String referenceNo = nicePay.Get("referenceNo"); String amt = nicePay.Get("amt"); String cancelReferenceNo = nicePay.Get("cancelReferenceNo"); ``` ::: [title] SMS Transmit [path] NICEPAY API/API Messaging/SMS API/ # Tentang SMS Transmit *** ini digunakan untuk mengirimkan pesan kepada para suatu atau pihak-pihak terkait lainnya. memiliki *Single SMS transmit* dan didukung oleh 4 Provider populer di , yaitu Telkomsel, Indosat Ooredoo Hutchison, XL, dan Smartfren. :::hint{type="warning"} Pastikan token cukup sebelum melakukan Transmit ini. kunjungi [Deposit Saldo](docId\:VdIDXX3uGz0y1dGVucMGp) untuk mendapatkan rincian terkait. ::: # Specification - SMS Transmit *** | **API url** | `/nicepay/direct/v2/sms-transmit` | | ------------------- | ------------------------------------------------------- | | **Request Method** | **POST** | | **Merchant Token** | SHA256 (`timestamp`+ `iMid`+ `msgRefNo`+ `merchantKey`) | ## Request Parameter for SMS Transmit *** | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ---------------------------------------------------------- | -------- | ---------- | ------------------------------------------------------------------------ | ---------------------------------------------------------------- | | `timeStamp`
Required | N | 14 | Request Date | 20221219110059 | | `iMid`
Required | AN | 10 | ID | IONPAYTEST | | `msgRefNo`
Required | ANS | 40 | Order Number (Key from ) | MerchantReferenceNumber001 | | `smsType`
Required | N | 1 | Type
`0` : Normal
`1` : Alert
`2` : OTP | 2 | | `reservedFlag`
Required | N | 1 | Sending Type
`0` : Realtime Processing
`1` : Batch Processing | 0 | | `reservedDt` | N | 8 | Send Date Request (`YYYYMMDD`) | | | `reservedTm` | N | 6 | Send Time Request
(`HH24MiSS`) | | | `sender` | AN | 11 | Sender’s Number or Masking | JATI\_TSEL\_IONPAYTEST001 | | `recipientNo`
Required | N | 16 | Recipient's Mobile Number | +6281294529025 | | `smsMsg`
Required | ANS | 640 | Message Content | | | `dbProcessUrl`
Required | AN | 255 | Result Notification URL
(Async Notification) | https\://nicetest.requestcatcher.com/test | | `reqNm`
Required | AN | 30 | Requestor PIC Name | | | `merchantToken`
Required | AN | 255 | Token | 9b62af7cc5357e7071662e5bb7950a03bda2f9efb2e5801298f663001196a199 | ## Response Parameter for SMS Transmit *** | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ------------- | -------- | ---------- | ------------------------------------------------------------- | ------------------------------------------------------ | | `resultCd` | N | 14 | Result Code:
[Error Code](docId\:JKO_1O-kS-XzfZAqPwNIN) | 0000 | | `resultMsg` | AN | 255 | Result Message: [Error Code](docId\:JKO_1O-kS-XzfZAqPwNIN) | SUCCESS | | `tXid` | AN | 30 | Order Number (Key From ) | IONPAYTEST10202212191102221919

When Success | | `msgStatus` | N | 2 | [Transmission Status Code](docId:0dccdS0W5z7yNa0JULSsu) | | ## Sample JSON for SMS Transmit *** :::CodeblockTabs JSON Request ```json { "timeStamp": "20221219110059", "iMid": "IONPAYTEST", "smsType": "2", "reservedFlag": "0", "reservedDt": "", "reservedTm": "", "msgRefno": "MSG-20221219110059", "recipientNo": "+6281294529025", "smsMsg": "Testing masukkan kode 123456 dalam 30 menit.", "dbProcessUrl": "https://nicetest.requestcatcher.com/test", "reqNm": "NICEPAY", "sender": "JATI_TSEL_IONPAYTEST001", "merchantToken": "9b62af7cc5357e7071662e5bb7950a03bda2f9efb2e5801298f663001196a199" } ``` JSON Response ```json { "resultCd": "0000", "resultMsg": "SUCCESS", "tXid": "IONPAYTEST10202212191102221919", "msgStatus": "00" } ``` Java Request ```java requestMap.put("timeStamp", "20221219110059"); requestMap.put("iMid", "IONPAYTEST"); requestMap.put("merchantToken", "9b62af7cc5357e7071662e5bb7950a03bda2f9efb2e5801298f663001196a199"); requestMap.put("msgRefNo","MSG-20221219110059"); requestMap.put("smsType", "2"); requestMap.put("reservedFlag", "0"); requestMap.put("reservedDt", ""); requestMap.put("reservedTm", ""); requestMap.put("sender","JATI_TSEL_IONPAYTEST001"); requestMap.put("recipientNo","+6281294529025"); requestMap.put("smsMsg","Testing masukkan kode 123456 dalam 30 menit."); requestMap.put("dbProcessUrl", "https://nicetest.requestcatcher.com/test"); requestMap.put("reqNm", "NICEPAY") ``` ::: # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Notification SMS](docId\:hcRdbFh-9v_6do48MShRg) untuk mengetahui rincian digunakan saat mengirimkan . ::: :::VerticalSplitItem [Inquiry SMS](docId:0bfa4LFEowD2edz37yLWh) untuk mengetahui rincian digunakan untuk melakukan inquiry. ::: :::: [title] Pre-Auth & Capture - Payment API Credit Card [path] NICEPAY API/API Non-SNAP/Payment API/API Credit Card/Payment - API Credit Card/ # Tentang Pre-Auth & Capture - Payment API Credit Card *** Setelah melakukan pendaftaran dengan tipe fitur Pre-Auth & Capture pada [Pre-Auth & Capture - Registration API Credit Card](docId\:VJ5k6iZOTkdPnRfMabAJ8), dapat melanjutkan langkah selanjutnya ke pada tersebut melalui ini. :::hint{type="success"} Pelajari mengenai fitur dengan `RecurringToken` di [Fitur Kartu Kredit](docId\:cgLxG10p9zmVtuX_-b7ga) atau kunjungi penjelasan teknis mengenai Pre-Auth Capture di [Pre-Auth & Capture - Payment API Credit Card](docId\:zFDKm9bwMDI5FRoKfInDK). ::: # Pre-Auth - Payment API Credit Card (Hold Fund) *** | **API Endpoint** | `/nicepay/direct/v2/payment` | | ------------------ | ------------------------------------------------------------ | | **Request Method** | **POST****** | | **Description** | Pre-Auth (Hold Fund) | | **Merchant Token** | SHA256(`timeStamp`+`iMid`+`referenceNo`+`amt`+`merchantKey`) | | **Request Format** | `application/json` | ## Request Parameter for Pre-Auth - Payment API Credit Card (Hold Fund) *** Untuk dapat melakukan fitur Pre-Auth dari akan lakukan, diperlukan untuk mengisi `tXid` dari hasil *response *pada [Pre-Auth & Capture - Registration API Credit Card](docId\:VJ5k6iZOTkdPnRfMabAJ8) sudah lakukan sebelumnya. | **Parameter** | **Tipe** | **Ukuran ** | **Deskripsi** | **Contoh / Catatan** | | ------------------------------------------------------------ | -------- | ---------------- | -------------------------------------- | ---------------------------------------------------------------- | | `timeStamp`
Required | N | 14 | Request Timestamp (`YYYYMMDDHH24MISS`) | 20230522130518 | | `tXid`
Required | AN | 30 | Transaction ID | IONPAYTEST01202305161007570327 | | `referenceNo`
Required | ANS | 40 | Order Number | This Is The Description Of The | | `merchantToken`
Required | AN | 255 | Token | ff139e49606387091cd9baeadff3161aff6afd9406e1f481e0fdb8b46d1ae5ae | | `cardNo`
Required | N | 20 | Number | 443426\*\*\*\*\*\*0008 | | `cardExpYymm`
Required | A | 4 | Card Expiry (`YYMM`) | 3901 | | `cardHolderNm`
Required | AN | 45 | Card Holder Name | John Doe

**Only alphabet allowed** | | `cardHolderEmail`
Required | ANS | 100 | Card Holder Email | johndoe\@gmail.com | | `cardCvv`
Required | N | 6 | Card CVV | 100 | | `callBackUrl`
Required | ANS | 255 | Result URL | https\://www\.merchant.com/callbackUrl/ | juga memerlukan `cardNo`, `cardExpYymm`, `cardHolderNm`, `cardHolderEmail` & `cardCvv` bisa dapatkan dari agar tagihan nya dapat di. ## Response Parameter for Pre-Auth - Payment API Credit Card (Hold Fund) *** Berikut ini adalah *response * dari hasil *request *Pre-Auth *(Hold Fund)*. | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | -------------- | -------- | ---------- | ------------------------------------------------------------ | ---------------------------------------------------------------------------------- | | `timeStamp` | N | 14 | Response Date
(`YYYYMMDDHH24MISS`) | 20230516135959 | | `resultCd` | N | 4 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | 0000 | | `resultMsg` | AN | 255 | Result Message: [Error Code](docId\:yEh1VA9k2y6sL1kQF2aWD) | SUCCESS | | `tXid` | AN | 30 | Transaction ID | IONPAYTEST01202305161007570327 | | `referenceNo` | ANS | 40 | Order Number | MerchantReferenceNumber001 | | `payMethod` | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | 01

When Success | | `amount` | N | 12 | Amount | 10000

When Success | | `currency` | AN | 3 | Currency | IDR

When Success | | `goodsNm` | AN | 100 | Goods Name | Goods 1

When Success | | `billingNm` | AN | 100 | Buyer Name | John Doe

When Success | | `transDt` | N | 8 | Transaction Date
(`YYYYMMDD`) | 20230522

When Success | | `transTm` | N | 6 | Transaction Time
(`HH24MISS`) | 135959

When Success | | `description` | AN | 100 | Description | This Is The Description Of The

When Success | | `authNo` | N | 10 | Approval Number | 123456

When Success | | `issuBankCd` | A | 4 | [Issuing Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | CENA

When Success | | `acquBankCd` | A | 4 | [Acquiring Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | BNIA

When Success | | `cardNo` | AN | 20 | Card Number
(Masked) | 443426\*\*\*\*\*\*0008

When Success
| | `cardExpYymm` | N | 4 | Card Expiry
(`YYMM`) | 3901

When Success | | `instmntMon` | N | 2 | Installment Month | 1

When Success | | `instmnType` | N | 2 | [Installment Type Code](docId:7CIX-U_4z295XgtNVEsbO) | 1

When Success | | `preauthToken` | AN | | Pre-Auth Token | 5c6ba40e61c45d9fa37e763ea1f86b9d6ac5f1f7ed279e4d4531191c83279320
When Success | | `ccTransType` | AN | 2 | [Credit Card Transaction Type](docId:8m3-7Smhm_jhdrE5pCRzp) | 3

When Success | | `vat` | N | 12 | Value Added Tax
() | 0

When Success | | `fee` | N | 12 | Service Fee | 0

When Success | | `notaxAmt` | N | 12 | Tax Free Amount | 0

When Success | | `acquBankNm` | A | 255 | Acquiring Name | CIMB | | `issuBankNm` | A | 255 | Issuing Name | BCA | Apabila ini berhasil maka dana sudah dibayarkan akan di-*hold *secara otomatis dan pun akan mendapatkan `preauthToken` diperlukan untuk melakukan Capture nantinya. :::hint{type="warning"} Mohon untuk segera melakukan Capture setelah Pre-Auth sudah diselesaikan sebelum dana nya kedaluwarsa dan akan dianggap *void *(dana akan dikembalikan ke *cardholder*)** ** Tenggat waktu kedaluwarsa pada jenis Pre-Auth biasanya memakan waktu sampai 7 hari. ::: ## Sample Parameter for Pre-Auth - Payment API Credit Card (Hold Fund) *** ### Request Parameter :::CodeblockTabs cURL ```curl curl --location 'https://dev.nicepay.co.id/nicepay/direct/v2/payment' \ --header 'X-FORWARDED-FOR: 1.2.3' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --header 'Cookie: JSESSIONID=3FE76F9694B783056D2B7303A357C20B.pg_was1' \ --data-urlencode 'timeStamp=20251001101049' \ --data-urlencode 'tXid=TESTMPGS0501202510011026450166' \ --data-urlencode 'referenceNo=ordNo20251001101069' \ --data-urlencode 'merchantToken=de7774d7e288057b706f70317f94b3c893724222cdce9922371dca6228531816' \ --data-urlencode 'cardNo=5123450000000008' \ --data-urlencode 'cardExpYymm=3106' \ --data-urlencode 'cardCvv=100' \ --data-urlencode 'cardHolderNm=Nicepay Test' \ --data-urlencode 'callBackUrl=https://dev.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp?order_id=TESTMPGS0501202510011026450166' ``` Node.js ```nodejs let secondVersion = new SecondApiVersion(config); let parameterPayment = { amt: "10000", referenceNo: "ordNo20251001101069", tXid: "TESTMPGS0501202510011026450166", cardNo: "5123450000000008", callBackUrl: "https://dev.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp?order_id=RECURRTEST01202509301555563979", cardExpYymm: "3106", cardCvv: "100", cardHolderNm: "Nicepay Test", preauthToken: "", // Leave empty for hold fund cardHolderEmail: "test@email.com", }; let response = secondVersion.requestPayment(parameterPayment); ``` ```java NICEPay config = NICEPay.builder() .isProduction(false) // Set to true for production .build(); Card requestData = Card.builder() .timeStamp("20250922143200") // Current timestamp (yyyyMMddHHmmss) .tXid("TESTMPGS0501202510011026450166") // Transaction ID from registration .iMid("TESTMPGS05") // Your NICEPay iMid .referenceNo("ordNo20251001101069") // Unique order reference .amt("10000") // Payment amount .merchantToken(timeStamp, iMid, reffNo, amount, MERCHANT_KEY) // Secure token generation .cardNo("5123450000000008") // Test card number .cardExpYymm("3601") // Card expiry date (YYMM) .cardCvv("100") // 3-digit CVV .cardHolderNm("NICEPAY TEST") // Cardholder name .callBackUrl("https://dev.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp") // Callback URL .recurringToken("") // Leave empty if not recurring token .preauthToken("") // Leave empty for hold fund .build(); String responseHtml = V2CardService.callV2CardPaymentRequest(requestData, config); ``` ```python bodyPayment = ( builderPayment.BuildPayment() .setTimestamp(datetime.now().strftime("%Y%m%d%H%M%S")) # Current timestamp (yyyyMMddHHmmss) .setTxid("TESTMPGS0501202510011026450166") # Transaction ID from registration .setReferenceNo("ordNo20251001101069") # Unique order reference .setCashtag("") # Leave empty if not using cashtag .setCardNo("5123450000000008") # Test card number .setCardExpYymm("3901") # Card expiry date (YYMM) .setCardCvv("100") # 3-digit CVV .setRecurringToken("") # Leave empty if not recurring .setPreAuthToken("") # Leave empty for hold fund request .setAmt("10000") # Payment amount .build() ) environment = ( builderEnvironment.BuildEnvironment() .isCloud(False) # Set to True if using NICEPay Cloud .isProduction(False) # Set to True for production .build() ) response = ServiceNicepay.servicePayment( DataGenerator.getPaymentBody(bodyPayment.dataPayment()), environment ) ``` Vanilla JS ```javascript const paymentData = { cardNo: "5123450000000008", // Test card number cardExpYymm: "3601", // Card expiry in YYMM format cardCvv: "100", // 3-digit CVV cardHolderEmail: "customer@example.com", // Cardholder email cardHolderNm: "Nicepay Test", // Cardholder name callBackUrl: "https://your-domain.com/callback", // Callback URL after payment tXid: "TESTMPGS0501202510011026450166", // Transaction ID from registration merchantToken: "bc2ee7790486a7ee4a5313d4c1d4088a38456b89204e308ae38e0beee3849d0b", // Secure token preauthToken: "", // Leave empty for hold fund }; const response = await Nicepay.paymentTransaction(paymentData); ``` Laravel ```php $url = HttpUtil::getNicepayDomain($this->useProd, $this->useCloud) . $this->payment_endpoint; // Request body parameters $txid = "TESTMPGS0501202510011026450166"; $timestamp = Carbon::now()->format("YmdHis"); // Current timestamp (yyyyMMddHHmmss) $reference_no = "ordNo20251001101069"; $amt = "10000"; // Generate secure merchant token $merchant_token = $this->generateMerchantToken( $timestamp, $this->imid, $reference_no, $amt, $this->mer_key ); $param = [ "timeStamp" => $timestamp, // Current timestamp "tXid" => $txid, // Transaction ID from registration "merchantToken" => $merchant_token, // Secure hash token "cardNo" => "5123450000000008", // Test card number "cardExpYymm" => "3901", // Card expiry date (YYMM) "cardCvv" => "100", // 3-digit CVV "callBackUrl" => "https://www.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp", // Callback URL "recurringToken" => "", //Leave empty if not recurring "preauthToken" => "", // Leave empty for hold fund request ]; $response = HttpUtil::redirectWithQueryParams($url, $param); ``` PHP Native ```php $config = NICEPay::builder() ->setIsProduction(true) // Set to false for sandbox/testing ->build(); $parameter = Card::builder() ->timeStamp($timestamp) // Current timestamp (yyyyMMddHHmmss) ->iMid("TESTMPGS05") // Your NICEPay iMid ->tXid("TESTMPGS0501202510011026450166") // Transaction ID from registration ->referenceNo("ordNo20251001101069") // Unique order reference ->merchantToken( $timestamp, $iMid, $newCCTrx->getReferenceNo(), $newCCTrx->getAmt(), $this->merchantKey ) // Generate secure token ->cardNo(TestConst::$CARD_NO) // Test card number from constants ->cardExpYymm(TestConst::$CARD_EXP_YYMM) // Card expiry date (YYMM) ->cardCvv(TestConst::$CARD_CVV) // 3-digit CVV ->cardHolderNm("Nicepay test") // Cardholder name ->callBackUrl("https://dev.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp?") // Callback URL after payment ->recurringToken("") ->preauthToken("") // Leave empty for hold fund request ->build(); $cardService = new V2CardService($config); $response = $cardService->payment($parameter); ``` ```kotlin var config: NICEPay? = NICEPay.Builder() .isProduction(true) // Set to false for sandbox/testing .build() val request: DirectV2RequestPaymentCard = DirectV2RequestPaymentCard.Builder() .timeStamp("20250922143200") // Current timestamp (yyyyMMddHHmmss) .tXid("TESTMPGS0501202510011026450166") // Transaction ID from registration .iMid("TESTMPGS05") // Your NICEPay iMid .merchantKey(MERCHANT_KEY) // Secret merchant key .referenceNo("ordNo20251001101069") // Unique order reference number .amt("10000") // Payment amount .callBakUrl("https://www.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp") // Callback URL after payment .cardNo("5123450000000008") // Test card number .cardCvv("123") // 3-digit CVV (sample) .cardExpYymm("3601") // Card expiry date (YYMM) .preauthToken("") // Left empty for hold fund .build() val response = paymentService.registration(request, config)!! ``` ::: ### Response Parameter :::CodeblockTabs Sample Response ```html
``` ::: # Capture - Payment API Credit Card *** | **API URL** | `/nicepay/direct/v2/payment` | | ------------------ | ------------------------------------------------------------ | | **Request Method** | **POST****** | | **Description** | Capture Process from Pre-Auth | | **Merchant Token** | SHA256(`timeStamp`+`iMid`+`referenceNo`+`amt`+`merchantKey`) | | **Request Format** | `application/json` | ## Request Parameter for Capture - Payment API Credit Card *** Setelah mendapatkan `preauthToken` pada sudah dibayarkan oleh dan di **API Pre-Auth Payment (Hold),** Langkah selanjutnya adalah melakukan *Capture *pada dana telah di-*hold*. Namun, untuk melakukan itu, diperlukan untuk registrasi kembali dengan baru pada [Pre-Auth & Capture - Registration API Credit Card](docId\:VJ5k6iZOTkdPnRfMabAJ8) dengan *amount* *capture* harus berjumlah *kurang atau sama* dari *amount* telah di-*hold* pada *Pre-Auth* sebelumnya. Apabila sudah sukses mendaftarkan kembali, baru dapat menggunakan Capture ini*.* :::hint{type="info"} Proses Capture dapat dilakukan berulang kali selama jumlah ****amount**** sudah melalui *Pre-Auth* masih ada untuk di-*capture* beserta dengan Pre-Auth masih belum kedaluwarsa atau **belum** dianggap ***void**.* ::: Berikut ini adalah daftar untuk melakukan menggunakan **PreauthToken **tanpa `cardNo`, `cardExpYymm` maupun `cardCvv`. | **Parameter** | **Tipe** | **Ukuran ** | **Deskripsi** | **Contoh / Catatan** | | ----------------------------------------------------------------------------------------- | -------- | ---------------- | -------------------------------------- | ---------------------------------------------------------------- | | `timeStamp`
Required | N | 14 | Request Timestamp (`YYYYMMDDHH24MISS`) | 20230516135959 | | `tXid`
Required | AN | 30 | Transaction ID | IONPAYTEST01202305161007570327 | | `referenceNo`
Required | ANS | 40 | Order Number | MerchantReferenceNumber001 | | `merchantToken`
Required | AN | 255 | Token | ff139e49606387091cd9baeadff3161aff6afd9406e1f481e0fdb8b46d1ae5ae | | `cardHolderNm`
Required | AN | 45 | Card Holder Name | John Doe

**Only alphabet allowed** | | `cardCvv`
| N | 6 | Card CVV | 100 | | `callBackUrl`
Required | ANS | 255 | Result URL | https\://www\.nicepay.co.id/IONPAY\_CLIENT/paymentResult.jsp | | `preauthToken`
Required For Capture Process in Pre-Auth | AN | 64 | Pre-Auth Token | 5976c263fe6116503645057bb00be809c3a6f9c1e355efa12ef2cda2be03d5eb | :::hint{type="info"} `tXid` tidak akan sama dengan *request (pre-auth - hold). *Proses *Capture* akan memastikan bahwa nilai `amount` di-*capture* tidak melebihi dana sudah Pre-Auth. ::: ## Response Parameter for Capture - Payment API Credit Card *** | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ------------- | -------- | ---------- | ----------------------------------------------------------- | -------------------------------------------------------- | | `timeStamp` | N | 14 | Response Date
(`YYYYMMDDHH24MISS`) | 20230516135959 | | `resultCd` | N | 4 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | 0000 | | `resultMsg` | AN | 255 | Result Message: [Error Code](docId\:yEh1VA9k2y6sL1kQF2aWD) | SUCCESS | | `tXid` | AN | 30 | Transaction ID | IONPAYTEST01202305161007570327 | | `referenceNo` | ANS | 40 | Order Number | MerchantReferenceNumber001 | | `payMethod` | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | 01

When Success | | `amount` | N | 12 | Amount | 10000

When Success | | `currency` | AN | 3 | Currency | IDR

When Success | | `goodsNm` | AN | 100 | Goods Name | Goods 1

When Success | | `billingNm` | AN | 100 | Buyer Name | John Doe

When Success | | `transDt` | N | 8 | Transaction Date
(`YYYYMMDD`) | 20230522

When Success | | `transTm` | N | 6 | Transaction Time
(`HH24MISS`) | 224343

When Success | | `description` | AN | 100 | Description | This Is The Description Of The

When Success | | `authNo` | N | 10 | Approval Number | 123456

When Success | | `issuBankCd` | A | 4 | [Issuing Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | CENA

When Success | | `acquBankCd` | A | 4 | [Acquiring Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | BNIA

When Success | | `cardNo` | AN | 20 | Card Number
(Masked) | 51234500\*\*\*\*0008

When Success
| | `cardExpYymm` | N | 4 | Card Expiry
(`YYMM`) | 3901

When Success | | `instmntMon` | N | 2 | Installment Month | 1

When Success | | `instmnType` | N | 2 | [Installment Type Code](docId:7CIX-U_4z295XgtNVEsbO) | 1

When Success | | `ccTransType` | AN | 2 | [Credit Card Transaction Type](docId:8m3-7Smhm_jhdrE5pCRzp) | 3

When Success | | `vat` | N | 12 | Value Added Tax
() | 0

When Success | | `fee` | N | 12 | Service Fee | 0

When Success | | `notaxAmt` | N | 12 | Tax Free Amount | 0

When Success | | `acquBankNm` | A | 255 | Acquiring Name | CIMB | | `issuBankNm` | A | 255 | Issuing Name | BCA | :::hint{type="info"} `tXid` tidak akan sama seperti *request hold *saat *capture*, dan `amt` tidak melebihi dana ditahan. ::: ## Sample Parameter for Capture - Payment API Credit Card *** ### Request Parameter :::CodeblockTabs cURL ```curl curl --location 'https://dev.nicepay.co.id/nicepay/direct/v2/payment' \ --header 'X-FORWARDED-FOR: 1.2.3' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --data-urlencode 'timeStamp=20251001171036' \ --data-urlencode 'tXid=TESTMPGS0501202510011716431018' \ --data-urlencode 'referenceNo=ordNo20251001171009' \ --data-urlencode 'merchantToken=e9cc3a18732249cd1d51062c5377e5bddb31dae9a232f1c16249a17d376699ff' \ --data-urlencode 'cardHolderNm=Nicepay Test' \ --data-urlencode 'preauthToken=a513eff039c80a8c617fe57dbb401c52dbfd683b5d48fb3df61312f5a6665f35' \ --data-urlencode 'callBackUrl=https://dev.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp?order_id=TESTMPGS0501202510011716431018' ``` Node.js ```nodejs let secondVersion = new SecondApiVersion(config); let parameterPayment = { amt: "100", referenceNo: "ordNo20251001171009", tXid: "TESTMPGS0501202510011716431018", callBackUrl: "https://dev.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp?order_id=RECURRTEST01202509301555563979", cardHolderNm: "Nicepay Test", preauthToken: "a513eff039c80a8c617fe57dbb401c52dbfd683b5d48fb3df61312f5a6665f35", // Preauth token cardHolderEmail: "test@email.com", }; let response = secondVersion.requestPayment(parameterPayment); ``` ```java NICEPay config = NICEPay.builder() .isProduction(false) // Set to true for production .build(); Card requestData = Card.builder() .timeStamp("20250922143200") // Current timestamp (yyyyMMddHHmmss) .tXid("TESTMPGS0501202510011716431018") // Transaction ID from registration .iMid("TESTMPGS05") // Your NICEPay iMid .referenceNo("ordNo20251001171009") // Unique order reference .amt("100") // Payment amount .merchantToken(timeStamp, iMid, reffNo, amount, MERCHANT_KEY) // Secure token generation .cardHolderNm("NICEPAY TEST") // Cardholder name .callBackUrl("https://dev.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp") // Callback URL .recurringToken("") // Leave empty if not recurring token .preauthToken("a513eff039c80a8c617fe57dbb401c52dbfd683b5d48fb3df61312f5a6665f35") // Preauth TOken .build(); String responseHtml = V2CardService.callV2CardPaymentRequest(requestData, config); ``` ```python bodyPayment = ( builderPayment.BuildPayment() .setTimestamp(datetime.now().strftime("%Y%m%d%H%M%S")) # Current timestamp (yyyyMMddHHmmss) .setTxid("TESTMPGS0501202510011716431018") # Transaction ID from registration .setReferenceNo("ordNo20251001171009") # Unique order reference .setCashtag("") # Leave empty if not using cashtag .setRecurringToken("") # Leave empty if not recurring .setPreAuthToken("a513eff039c80a8c617fe57dbb401c52dbfd683b5d48fb3df61312f5a6665f35") # Preauth Token .setAmt("10000") # Payment amount .build() ) environment = ( builderEnvironment.BuildEnvironment() .isCloud(False) # Set to True if using NICEPay Cloud .isProduction(False) # Set to True for production .build() ) response = ServiceNicepay.servicePayment( DataGenerator.getPaymentBody(bodyPayment.dataPayment()), environment ) ``` Vanilla JS ```javascript const paymentData = { cardHolderEmail: "customer@example.com", // Cardholder email cardHolderNm: "Nicepay Test", // Cardholder name callBackUrl: "https://your-domain.com/callback", // Callback URL after payment tXid: "TESTMPGS0501202510011716431018", // Transaction ID from registration merchantToken: "bc2ee7790486a7ee4a5313d4c1d4088a38456b89204e308ae38e0beee3849d0b", // Secure token preauthToken: "a513eff039c80a8c617fe57dbb401c52dbfd683b5d48fb3df61312f5a6665f35", // Preauth token }; const response = await Nicepay.paymentTransaction(paymentData); ``` Laravel ```php $url = HttpUtil::getNicepayDomain($this->useProd, $this->useCloud) . $this->payment_endpoint; // Request body parameters $txid = "TESTMPGS0501202510011716431018"; $timestamp = Carbon::now()->format("YmdHis"); // Current timestamp (yyyyMMddHHmmss) $reference_no = "ordNo20251001171009"; $amt = "100"; // Generate secure merchant token $merchant_token = $this->generateMerchantToken( $timestamp, $this->imid, $reference_no, $amt, $this->mer_key ); $param = [ "timeStamp" => $timestamp, // Current timestamp "tXid" => $txid, // Transaction ID from registration "merchantToken" => $merchant_token, // Secure hash token "callBackUrl" => "https://www.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp", // Callback URL "recurringToken" => "", //Leave empty if not recurring "preauthToken" => "a513eff039c80a8c617fe57dbb401c52dbfd683b5d48fb3df61312f5a6665f35", // Preauth Token ]; $response = HttpUtil::redirectWithQueryParams($url, $param); ``` PHP Native ```php $config = NICEPay::builder() ->setIsProduction(true) // Set to false for sandbox/testing ->build(); $parameter = Card::builder() ->timeStamp($timestamp) // Current timestamp (yyyyMMddHHmmss) ->iMid("TESTMPGS05") // Your NICEPay iMid ->tXid("TESTMPGS0501202510011716431018") // Transaction ID from registration ->referenceNo("ordNo20251001171009") // Unique order reference ->merchantToken( $timestamp, $iMid, $newCCTrx->getReferenceNo(), $newCCTrx->getAmt(), $this->merchantKey ) // Generate secure token ->cardNo(TestConst::$CARD_NO) // Test card number from constants ->cardExpYymm(TestConst::$CARD_EXP_YYMM) // Card expiry date (YYMM) ->cardCvv(TestConst::$CARD_CVV) // 3-digit CVV ->cardHolderNm("Nicepay test") // Cardholder name ->callBackUrl("https://dev.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp?") // Callback URL after payment ->recurringToken("") ->preauthToken("a513eff039c80a8c617fe57dbb401c52dbfd683b5d48fb3df61312f5a6665f35") // Preauth token ->build(); $cardService = new V2CardService($config); $response = $cardService->payment($parameter); ``` ```kotlin var config: NICEPay? = NICEPay.Builder() .isProduction(true) // Set to false for sandbox/testing .build() val request: DirectV2RequestPaymentCard = DirectV2RequestPaymentCard.Builder() .timeStamp("20250922143200") // Current timestamp (yyyyMMddHHmmss) .tXid("TESTMPGS0501202510011716431018") // Transaction ID from registration .iMid("TESTMPGS05") // Your NICEPay iMid .merchantKey(MERCHANT_KEY) // Secret merchant key .referenceNo("ordNo20251001171009") // Unique order reference number .amt("10000") // Payment amount .callBakUrl("https://www.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp") // Callback URL after payment .preauthToken("a513eff039c80a8c617fe57dbb401c52dbfd683b5d48fb3df61312f5a6665f35") // Preauth token .build() val response = paymentService.registration(request, config)!! ``` ::: ### Response Parameter :::CodeblockTabs Sample Response ```html
``` ::: # CallBack Handling for Pre-Auth & Capture - Payment API Credit Card *** :::hint{type="success"} Saat *Callback *telah diterima `callbackUrl` , kami sangat menganjurkan untuk melakukan verifikasi Status menggunakan [Status Inquiry - API Credit Card](docId\:voJ9rhAQRLcF-_74cYrFi). ::: :::hint{type="warning"} `CallBack Handling` sangat penting untuk membantu meminimalisir tindakan *Fraud, *kami sangat merekomendasikan untuk melakukan verifikasi menggunakan `CallBack Handling`. ::: :::CodeblockTabs URL CallBack ```json "callbackUrl" : "https://www.merchant.com/callbackUrl/" ``` Response CallBack ```json { "resultCd":"0000", "resultMsg":"SUCCESS", "tXid":"IONPAYTEST01202212141112221428", "referenceNo":"", "payMethod":"01", "amt":"10000", "transDt":"20221212", "transTm":"121212", "description":"Testing Credit Card Transaction", "authNo":"080623", "issuBankCd":"OTHR" "acquBankCd":"BMRI", "cardNo":"453211*****1111", "goodsNm":"Test Transaction Nicepay" "billingNm":"John Doe", "currency":"IDR", "timeStamp":"20221212121212", "merchantToken":"2035d2295d9578fffb40137186f0203474142ae3e57992d4847826c5fcaffce6", "cardExpYymm":"2712", "instmntMon":"1", "instmntType":"1", "ccTransType":"1" } ``` ::: [title] Virtual Account Static [path] NICEPAY API/API Non-SNAP/Advance API/Virtual Account - Advance API/ # Tentang API Virtual Account Static (Fix Open) *** Pada Static (*fix open*), dapat menggunakan nomor sama untuk melakukan secara berulang. Integrasi VA statis digunakan untuk Fix Open VA. :::hint{type="info"} - Untuk mengetahui lebih lanjut mengenai , dapat membaca di [Virtual Account (VA)](docId:9tV3ro3_Lj1f-guZ2gark). - Untuk mempelajari penjelasan secara umum mengenai , dapat mengunjungi halaman [Panduan Bayar VA](docId\:bSNUZMHNlj9h0wRndsQYj). ::: # Merchant Registration *** ::::hint{type="info"} :::Iframe{code="Sebelum menggunakan sistem NICEPAY, Merchant harus terdaftar terlebih dahulu dengan NICEPAY service. Silakan hubungi NICEPAY tim Sales NICEPAY di Marketing NICEPAY." iframeHeight="0"} ::: :::: | **Kredensial** | **Deskripsi** | | -------------- | ------------- | | iMid | ID | | encodeKey | API Key | Untuk mendukung kebutuhan *setup*, silakan *file* berikut sebagai *library*. :::CtaButton{label="NICEPAY.jar" externalHref="https://github.com/nicepay-dev/plugs-libs/tree/master/Java%20API%20V2" openInNewTab="true"} ::: # NICEPAY API Registration *** *NICEPAY API Registration* bertujuan agar dapat mendaftarkan pada di dan terintegrasi dengan dari . Tahapan ini dilakukan paling dahulu supaya mengetahui bahwa bersangkutan sudah terdaftar secara resmi dan dapat terhubung dengan dari . | **API URL** | `https://www.nicepay.co.id/nicepay/api/vacctCustomerRegist.do` | | ------------------ | ---------------------------------------------------------------- | | **Request Method** | **POST****** | | **Merchant Token** | SHA256(`iMid`+`customerId`+`merchantKey`) | | **Request Format** | `application/x-www-form-urlencoded` | ## Request Parameter for Registration VA Static *** Berikut ini adalah daftar untuk melakukan pengajuan pendaftaran tipe *static *(*fix open*). Parameter ini digunakan melalui platform pengujian sebagai salah satu tahapan supaya milik dapat terhubung dengan dari . | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ------------------------------------------------------------ | -------- | ----------------------------------- | ------------- | ---------------------------------------------------------------- | | `iMid`
Required | AN | 10 | ID | FIXOPEN001 | | `customerId`
Required | N | Max 8
(Depend on Prefix) | ID | 10021198 | | `customerNm`
Required | AN | 20 - 30 | Name | Jack | | `merchantToken`
Required | AN | 255 | Token | c31fec3c0e66c9d8703f9f8221f7c450950d7d26822abe037ce33c12f462c785 | ## Response Parameter untuk Registration VA Static *** Berikut adalah *response* dari hasil *request* untuk meregistrasikan Statistic. | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ---------------------------------------------------------- | --------------- | --------------------------------------------- | ------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------- | | `resultCd`
Required | N | 4 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | 0000 | | `resultMsg`
Required | AN | 255 | Result message: [Error Code](docId\:yEh1VA9k2y6sL1kQF2aWD) | SUCCESS | | `customerID`
Required | N | Max 8
(Depend on
Prefix) | ID | 10021198 | | `customerNm` | AN | 20 - 30 | Name | Jack | | `vacctInfoList`
Required | Array of object | | List | List
\[
\{
"bankCd": "BDIN",
"vacctNo": "7917019110021198"
},...] | ## Sample JSON Registration Virtual Account Static *** :::CodeblockTabs Form-urlencoded Request ```none iMid: "FIXOPEN001" customerId: "10021198" customerNm: "Jack" merchantToken: "c31fec3c0e66c9d8703f9f8221f7c450950d7d26822abe037ce33c12f462c785" ``` JSON Response ```json { "resultCd": "0000", "resultMsg": "SUCCESS", "customerId": "10021198", "customerNm": "Jack", "vacctInfoList": [ { "bankCd": "BDIN", "vacctNo": "7917019110021198" }, { "bankCd": "BNIA", "vacctNo": "11695109010021198" }, { "bankCd": "BMRI", "vacctNo": "8804910910021198" }, { "bankCd": "BNIN", "vacctNo": "1111111310021198" }, { "bankCd": "IBBK", "vacctNo": "1111112010021198" }, { "bankCd": "HNBN", "vacctNo": "765430000000000010021198" }, { "bankCd": "BBBA", "vacctNo": "1111111910021198" }, { "bankCd": "CENA", "vacctNo": "7007216110021198" }, { "bankCd": "YUDB", "vacctNo": "9044444450010021198" } ] } ``` Java Request ```java // VA Registration // // VA Registration Mandatory Field nicePay.setCustomerID("10021198"); nicePay.setCustomerName("Jack"); nicePay.setMerchantToken(nicePay.makeToken(nicePay.getCustomerID())); // Request VA Registration nicePay.vaRegist(); // Response String // System.out.println("Final Response String : " + nicePay.getResponseString()); String resultCd = nicePay.Get("resultCd"); String resultMsg = nicePay.Get("resultMsg"); String customerId = nicePay.Get("customerId"); String vacctInfoList = nicePay.Get("VacctInfoList"); ``` ::: ### Vacct Info List | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ---------------------------------------------------- | -------- | ---------- | ----------------------------------------- | -------------------- | | `bankCd`
Required | AN | 4 | [Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | BDIN | | `vacctNo`
Required | N | 16 | Number | 7917019110021198 | ### Sample JSON Vacct Account :::CodeblockTabs JSON Vacct Account Response ```json { "vacctInfoList": [ { "bankCd": "BDIN", "vacctNo": "7917019110021198" }, { "bankCd": "BNIA", "vacctNo": "11695109010021198" }, { "bankCd": "BMRI", "vacctNo": "8804910910021198" }, { "bankCd": "BNIN", "vacctNo": "1111111310021198" }, { "bankCd": "IBBK", "vacctNo": "1111112010021198" }, { "bankCd": "HNBN", "vacctNo": "765430000000000010021198" }, { "bankCd": "BBBA", "vacctNo": "1111111910021198" }, { "bankCd": "CENA", "vacctNo": "7007216110021198" }, { "bankCd": "YUDB", "vacctNo": "9044444450010021198" } ] } ``` ::: # NICEPAY Virtual Account Inquiry *** *NICEPAY Virtual Account Inquiry* bertujuan untuk mendapatkan serta nomor agar dapat dilakukan pemantauan untuk pengembangan berikutnya. :::hint{type="info"} Pengaturan pada Inquiry bertujuan untuk mengumpulkan daftar terdaftar dari mana saja berdasarkan `merFixId`. ::: | **Target Url** | `https://www.nicepay.co.id/nicepay/api/vacctCustomerInquiry.do` | | -------------------- | ---------------------------------------------------------------- | | **Method** | ******POST, GET****** | | **Description** | Untuk melakukan pengecekan VA pada `customerId` | | **Merchant Token** | SHA256(`iMid`+`customerId`+`merchantKey`) | | **Request Format** | `application/x-www-form-urlencoded` | ## Request Parameter for Virtual Account Inquiry *** Berikut ini adalah daftar untuk melakukan *request * inquiry. Parameter ini digunakan melalui platform pengujian sebagai salah satu tahapan supaya milik dapat terhubung dengan dari . | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ------------------------------------------------------------ | -------- | ----------------------------------- | ------------- | ---------------------------------------------------------------- | | `iMid`
Required | AN | 10 | ID | FIXOPEN001 | | `customerId`
Required | N | Max 8
(Depend on Prefix) | ID | 10021198 | | `merchantToken`
Required | AN | 255 | Token | c31fec3c0e66c9d8703f9f8221f7c450950d7d26822abe037ce33c12f462c785 | ## Response Parameter for Inquiry *** Berikut adalah *response * dari hasil *request * untuk mendaftarkan Static. | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ---------------------------------------------------------- | --------------- | --------------------------------------------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `resultCd`
Required | N | 4 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | 0000 | | `resultMsg`
Required | AN | 255 | Result Message: [Error Code](docId\:yEh1VA9k2y6sL1kQF2aWD) | SUCCESS | | `customerID`
Required | N | Max 8
(Depend on
Prefix) | ID | 10021198 | | `customerNm`
Required | A | 20 - 30 | Name | Jack | | `vacctInfoList`
Required | Array of object | | List | \[
        \{
            "bankCd": "BDIN",
            "vacctNo": "7917019110021198"
        },
        \{
            "bankCd": "BNIA",
            "vacctNo": "11695109010021198"
        },
...
] | ## Sample JSON NICEPAY Virtual Account Inquiry *** :::CodeblockTabs Form-Urlencode Request ```none iMid: "FIXOPEN001" customerId: "10021198" merchantToken: "c31fec3c0e66c9d8703f9f8221f7c450950d7d26822abe037ce33c12f462c785" ``` JSON Response ```json { "resultCd": "0000", "resultMsg": "SUCCESS", "customerId": "10021198", "customerNm": "Jack", "vacctInfoList": [ { "bankCd": "BDIN", "vacctNo": "7917019110021198" }, { "bankCd": "BNIA", "vacctNo": "11695109010021198" }, { "bankCd": "BMRI", "vacctNo": "8804910910021198" }, { "bankCd": "BNIN", "vacctNo": "1111111310021198" }, { "bankCd": "IBBK", "vacctNo": "1111112010021198" }, { "bankCd": "HNBN", "vacctNo": "765430000000000010021198" }, { "bankCd": "BBBA", "vacctNo": "1111111910021198" }, { "bankCd": "CENA", "vacctNo": "7007216110021198" }, { "bankCd": "YUDB", "vacctNo": "9044444450010021198" } ] } ``` Java Request ```java 1. // VA Inquiry // 2. // VA Inquiry Mandatory Field 3. nicePay.setCustomerID("12345"); 4. nicePay.setMerchantToken(nicePay.makeToken(nicePay.getCustomerID())); 5. 6. // Request VA Inquiry 7. nicePay.vaInquiry(); 8. // Response String // 9. System.out.println("Final Response String : " + nicePay.getResponseString()); 10. 11. String resultCd = nicePay.Get("resultCd"); 12. String resultMsg = nicePay.Get("resultMsg"); 13. String customerId = nicePay.Get("customerId"); 14. String vacctInfoList = nicePay.Get("VacctInfoList"); ``` ::: ### Vacct Info List | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ---------------------------------------------------- | -------- | ---------- | ----------------------------------------- | -------------------- | | `bankCd`
Required | AN | 4 | [Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | BDIN | | `vacctNo`
Required | N | 16 | Number | 7917019110021198 | ### Sample JSON Vacct Account :::CodeblockTabs JSON Vacct Account ```json { "vacctInfoList": [ { "bankCd": "BDIN", "vacctNo": "7917019110021198" }, { "bankCd": "BNIA", "vacctNo": "11695109010021198" }, { "bankCd": "BMRI", "vacctNo": "8804910910021198" }, { "bankCd": "BNIN", "vacctNo": "1111111310021198" }, { "bankCd": "IBBK", "vacctNo": "1111112010021198" }, { "bankCd": "HNBN", "vacctNo": "765430000000000010021198" }, { "bankCd": "BBBA", "vacctNo": "1111111910021198" }, { "bankCd": "CENA", "vacctNo": "7007216110021198" }, { "bankCd": "YUDB", "vacctNo": "9044444450010021198" } ] } ``` ::: # NICEPAY Virtual Account Deposit *** *NICEPAY Virtual Account Deposit* dalam bertujuan untuk memeriksa *fix open* dan untuk menampilkan seberapa banyak `amt` (*amount*) dibayarkan dengan `tXid` (ID ) tertentu dan dalam waktu tertentu. | **Target Url** | `https://www.nicepay.co.id/nicepay/api/vacctInquiry.do` | | ------------------ | ---------------------------------------------------------------- | | **Method** | ******POST****** | | **Description** | API Check Status For VA Fixopen | | **Merchant Token** | SHA256(`iMid`+`customerId`+`merchantKey`) | | **Request Format** | `application/x-www-form-urlencoded` | ## Request Parameter for Virtual Account Check Status *** Berikut ini adalah daftar untuk melakukan mengajukan pemeriksaan deposit . Parameter ini digunakan melalui platform pengujian sebagai salah satu tahapan supaya milik dapat terhubung dengan dari . | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ---------------------------------------------------------- | -------- | ---------- | ----------------------------------------------- | ---------------------------------------------------------------- | | `iMid`
Required | AN | 10 | ID | FIXOPEN001 | | `vacctNo`
Required | N | 16 | Number | 8804910910021197 | | `merchantToken`
Required | AN | 255 | Token | 20221215 | | `startDt`
Required | N | 8 | Request Start Date
(`YYYYMMDD`) | 20221222 | | `endDt`
Required | N | 8 | Request Start Date
(`YYYYMMDD`) | 75d137e8823108e47d04dadc3290cb36dc305d573323123f410c6f61acf1db63 | ## Response Parameter for Virtual Account Check Status *** Berikut adalah *response * dari hasil *request * untuk pemeriksaan . | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | -------------------------------------------------------- | --------------- | ---------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `resultCd`
Required | N | 4 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | 0000 | | `resultMsg`
Required | AN | 255 | Result Message: [Error Code](docId\:yEh1VA9k2y6sL1kQF2aWD) | SUCCESS | | `vacctNo`
Required | N | 16 | Number | 8804910910021197 | | `depositInfo`
Required | Array of object | | List | \[
\{
"bankCd": "BMRI",
"date": "20221220",
"time": "100733",
"amt": "1600000",
"tXid": "FIXOPEN00102202212201007334066",
"status": "0",
"referenceNo": "10021197"
},...] | ## Sample JSON Virtual Account Deposit *** :::CodeblockTabs Form-Urlencode Request ```none iMid: "FIXOPEN001" vacctNo: "8804910910021197" startDt: "20221215" endDt: "20221222" merchantToken: "75d137e8823108e47d04dadc3290cb36dc305d573323123f410c6f61acf1db63" ``` JSON Response ```json { "resultCd": "0000", "resultMsg": "SUCCESS", "vacctNo": "8804910910021197", "depositInfo": [ { "bankCd": "BMRI", "date": "20221220", "time": "100733", "amt": "1600000", "tXid": "FIXOPEN00102202212201007334066", "status": "0", "referenceNo": "10021197" }, { "bankCd": "BMRI", "date": "20221220", "time": "101001", "amt": "160000", "tXid": "FIXOPEN00102202212201010014071", "status": "0", "referenceNo": "10021197" } ] } ``` Java Request ```java // VA Check Status Deposit// nicepay.setiMid("FIXOPEN001"); nicepay.setVacctNo("8804910910021197"); nicepay.setMerchantToken(nicepay.getToken()); nicepay.setStartDt("20221215"); nicepay.setEndDt("20221231"); // Request VA Check Status Deposit// nicepay.vaCheckStatusDeposit(); // Response VA Check Status Deposit// System.out.println("Response :" + nicepay.getResponse(); String resultCd = nicepay.get("resultCd"); String resultMsg = nicepay.get("resultMsg"); String vacctNo = nicepay.get("vacctNo"); String depositInfo = nicepay.get("depositInfo"); ``` ::: # NICEPAY Virtual Account Update *** *NICEPAY Virtual Account Update* dalam bertujuan untuk memperbarui mengenai profil milik . dapat melakukan modifikasi pada untuk perbaharui atau hapus melalui `updateType`. | **Target Url** | `https://www.nicepay.co.id/nicepay/api/vacctCustomerUpdate.do` | | ------------------ | ---------------------------------------------------------------- | | **Method** | ******POST****** | | **Description** | merficAcctNm for Update | | **Merchant Token** | SHA256(`iMid`+`customerId`+`merchantKey`) | | **Request format** | `application/x-www-form-urlencoded` | ## Request Parameter for Virtual Account Update *** Berikut ini adalah daftar untuk melakukan *request* *update* dari dilakukan pada tipe Static (*fix open*). Parameter ini digunakan melalui platform pengujian sebagai salah satu tahapan supaya milik dapat terhubung dengan dari . | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ---------------------------------------------------------- | -------- | ------------------------------ | --------------------------------------------------------- | ---------------------------------------------------------------- | | `iMid`
Required | AN | 10 | ID | FIXOPEN001 | | `customerId`
Required | N | Max 8 (Depend on Prefix) | ID | 10021197 | | `merchantToken`
Required | AN | 255 | Token | c92a4372a8417d96407becec2c3221033358c16e1c29b5ccf7fe0cec211ecbf4 | | `customerNm`
Required | AN | 20 - 30 | Name | Howard | | `updateType`
Required | N | 2 | `1`: Create
`2`: Update
`3`: Delete | 2 | ## Response Parameter for Virtual Account Update *** Berikut adalah *response * dari hasil *request * untuk *update*. | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ---------------------------------------------------------- | --------------- | ----------------------------------- | ----------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | | `resultCd`
Required | N | 4 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | 0000 | | `resultMsg`
Required | AN | 255 | Result Message: [Error Code](docId\:yEh1VA9k2y6sL1kQF2aWD) | SUCCESS | | `customerNm`
Required | AN | 20 - 30 | Name | Howard | | `customerId`
Required | N | Max 8
(Depend on Prefix) | ID | 10021197 | | `vacctInfoList`
Required | Array of Object | | List | \[
\{
"bankCd": "BDIN",
"vacctNo": "7917019110021197"
},...] | ## Sample JSON for VA Update *** :::CodeblockTabs Form-Urlencode Request ```none iMid: "FIXOPEN001" customerId: "10021197" customerNm: "Howard" merchantToken: "c92a4372a8417d96407becec2c3221033358c16e1c29b5ccf7fe0cec211ecbf4" updateType: "2" ``` JSON Response ```json { "resultCd": "0000", "resultMsg": "SUCCESS", "customerId": "10021197", "customerNm": "Howard", "vacctInfoList": [ { "bankCd": "BDIN", "vacctNo": "7917019110021197" }, { "bankCd": "BNIA", "vacctNo": "11695109010021197" }, { "bankCd": "BMRI", "vacctNo": "8804910910021197" }, { "bankCd": "BNIN", "vacctNo": "1111111310021197" }, { "bankCd": "IBBK", "vacctNo": "1111112010021197" }, { "bankCd": "HNBN", "vacctNo": "765430000000000010021197" }, { "bankCd": "BBBA", "vacctNo": "1111111910021197" }, { "bankCd": "CENA", "vacctNo": "7007216110021197" }, { "bankCd": "YUDB", "vacctNo": "9044444450010021197" } ] } ``` Java Request ```json // VA Update/// nicepay.setiMid("FIXOPEN001"); nicepay.setCustomerId("10021197"); nicepay.setMerchantToken(nicepay.getToken()); nicepay.setCustomerNm("Howard"); nicepay.setUpdateType("2"); // Request VA Update// nicepay.vaUpdate(); // Response VA Update// System.out.println("Response :" + nicepay.getResponse(); String resultCd = nicepay.get("resultCd"); String resultMsg = nicepay.get("resultMsg"); String customerNm = nicepay.get("customerNm"); String customerId = nicepay.get("customerId"); String vacctInfoList = nicepay.get("depositInfo"); ``` ::: # See Also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Status Inquiry - API Checkout](docId\:K9vBS87ev9_w5oJAU0et3) untuk mengetahui untuk memeriksa inquiry khusus . ::: :::VerticalSplitItem [Cancel - API Checkout](docId\:MMmlusWDkyUsJxF421yKn) untuk mengetahui untuk membatalkan khusus . ::: :::: ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Status Inquiry - API Virtual Account](docId\:hqHww3quoVreZVG1Zp5ds) untuk mengetahui untuk memeriksa inquiry pada khusus . ::: :::VerticalSplitItem [Cancel - API Virtual Account](docId\:XnIHmWqi1kWBP9mYS4VQv) untuk mengetahui untuk membatalkan pada khusus . ::: :::: [title] Notification - DANA Recurring API [path] NICEPAY API/API Non-SNAP/Advance API/E-Wallet - Advance API/DANA Recurring - E-Wallet API Advance/ # Tentang Notification - DANA Recurring API *** mengirimkan *push notification* melalui `dbProcessUrl` . harus memastikan tidak melakukan Blacklist IP dan melakukan Whitelist IP untuk mendapatkan *push notification* hanya dikirim dari server . # Notification - DANA Recurring API *** | **API Endpoint** | `dbProcessUrl` on Registration API Request | | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Request Method** | **POST** (Parameter) | | **Description** | Transaction Result Notification (when success)
If your use firewall, add allow policy for IP =
IP Public environtment Production:
`103.20.51.34`
`103.20.51.33`
`18.98.96.50`

IP Public environtment Dev:
`103.20.51.39`
`103.20.51.40`
`18.98.96.54` | | **Merchant Token** | SHA256(`timeStamp`+`iMid`+`tXid`+`amt`+`merchantKey`) | ## Request Parameter Notification - DANA Recurring API *** Berikut ini adalah daftar untuk melakukan *request * pada DANA Recurring . | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | --------------- | -------- | ---------- | ---------------------------------------------------------- | ---------------------------------------------------------------- | | `tXid` | AN | 30 | Transaction ID (Key from ) | IONPAYTEST02201607051516334706 | | `referenceNo` | ANS | 40 | Order Number (Key from ) | | | `amt` | N | 12 | Amount | 15000 | | `merchantToken` | AN | 255 | Token | b9ea38b22df7fbed4c5d341bd9e899c7a63aaca6d17a33e4ad72cfc7c4c69741 | | `mitraCd` | A | 4 | [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8) | DANA | | `matchCl` | N | 1 | [Payment Amount Match Flag](docId\:WdoGjBeqc1VmRdFJqG1ZE) | 1 (Match) | | `status` | N | 1 | Deposit Status | `0`: Success | | `currency` | AN | 3 | Currency | IDR | | `goodsNm` | AN | 100 | Goods Name | Goods 1 | | `transDt` | N | 8 | Transaction Date (`YYYYMMDD`) | 20160303 | | `transTm` | N | 6 | Transaction Time (`HH24MISS`) | 135959 | | `billingNm` | A | 30 | Buyer Name | Buyer Name | | `payMethod` | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | `05`: | ## Sample Parameter Notification - DANA Recurring API *** :::CodeblockTabs Recurring Issue ```json tXid=IONPAYTEST05202108231310459282&merchantToken=03fbc2823365d18441bc491b7b063fdc78e36c8ee5894001f05432a79b65991d&referenceNo=OrdNo20217131024122&goodsNm=Nicepay Subscription&mitraCd=DANA&transTm=131045&amt=100&billingNm=HongGilDong&matchCl=1&payMethod=05¤cy=IDR&transDt=20210823&status=0 ``` Recurring Payment ```json tXid=IONPAYTEST05202108301315024172&merchantToken=70cbb29e76cba39dacc4cffcdef47e9b53887082061fefc1753e35c20452f2ed&referenceNo=OrdNo20217131024122&goodsNm=NicepaySubscription&mitraCd=DANA&transTm=131502&amt=100&billingNm=HongGilDong&matchCl=1&payMethod=05¤cy=IDR&transDt=20210830&status=0 ``` ::: [title] Cancel - API Direct Debit [path] NICEPAY API/API Non-SNAP/Payment API/API Direct Debit/ # Tentang API Direct Debit Cancel *** ini digunakan untuk melakukan *cancel* pada . # API Direct Debit Cancel *** Cancel digunakan untuk pembatalan pada melalui . | **API End Point** | `/nicepay/direct/v2/cancel` | | ------------------ | ----------------------------------------------------- | | **Request Method** | **POST****** | | **Header** | `Content-Type: application/json` | | **Merchant Token** | SHA256(`timeStamp`+`iMid`+`tXid`+`amt`+`merchantKey`) | | **Request Format** | `application/json` | # Payment Methods Available for Cancel *** **Code** **PayMethod** *** `01` *** `02` *** `03` **Convenience Store****** *** `04` *** `05` *** `06` *** `08` *** `09` *** ## Request Parameters for Direct Debit Cancel *** Berikut ini adalah daftar untuk mengaktifkan *cancel* pada . Parameter ini digunakan melalui platform pengujian . | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ----------------------------------------------------------- | -------- | ---------- | --------------------------------------------------------------------------------------- | ---------------------------------------------------------------- | | `timeStamp`
Required | N | 14 | Request Timestamp | 20230515141929 | | `tXid`
Required | AN | 30 | Transaction ID
| TNICECP04104202305151417238166 | | `iMid`
Required | AN | 10 | ID
| TNICECP041 | | `payMethod`
Required | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | 04 | | `cancelType`
Required | N | 2 | [Cancel Type Code](docId\:Mq9xE7wdOPR8OkZ3v-pVc) | 1 | | `cancelMsg` | AN | 255 | Cancel Message | Request Cancel | | `merchantToken`
Required | AN | 255 | Token
| 89fa33ec4c17f5048e69c404b42d07005f1dd6ab64354c583d04670cf9690ed8 | | `amt`
Required | N | 12 | Amount | 10000 | | `preauthToken` | AN | 100 | Pre-Auth Token | | | `cancelUserId` | AN | 30 | User ID | admin | ## Response Parameters for Direct Debit Cancel *** Berikut adalah *response parameter* dari hasil *request parameter* untuk Cancel*.* | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh Catatan** | | ----------------------------------------------------------------------- | -------- | ---------- | ----------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- | | `resultCd` | N | 4 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) [ ](https://app.archbee.com/docs/36sM2OxRIwwbi9iNlqMTP/wpcEMaZro_Xvnxz-1ZAiB) | 0000 | | `resultMsg` | AN | 255 | Result Message: [Error Code](docId\:yEh1VA9k2y6sL1kQF2aWD) | SUCCESS | | `tXid` | AN | 30 | Transaction ID | TNICECP04104202305151417238166 | | `referenceNo` | ANS | 40 | Order Number | 20230515141702 | | `transDt` | N | 8 | Transaction Date | 20230515 | | `transTm` | N | 6 | Transaction Time | 141723 | | `amt` | N | 12 | Amount | 2000 | | `cancelReferenceNo`
(Optional For CC) | ANS | 40 | Cancel Number | CancelNo20230515141702 | ## Sample Parameter for Direct Debit Cancel *** :::CodeblockTabs JSON Request ```json { "timeStamp":"20230515141929", "tXid":"TNICECP04104202305151417238166", "iMid":"TNICECP041", "payMethod":"04", "cancelType":"1", "cancelMsg":"Request Cancel", "merchantToken":"89fa33ec4c17f5048e69c404b42d07005f1dd6ab64354c583d04670cf9690ed8", "preauthToken":"", "amt":"10000", "cancalUserId":"admin" } ``` JSON Response ```json { "tXid": "TNICECP04104202305151417238166", "referenceNo": "20230515141702", "resultCd": "0000", "resultMsg": "SUCCESS", "transDt": "20230515", "transTm": "141723", "amt": "2000", "cancelReferenceNo": "CancelNo20230515141702" } ``` Java Request ```java //Cancel Registration// nicePay.setTimeStamp("20230515141929"); nicePay.setiMid("TNICECP041"); nicePay.setAmt("2000"); nicePay.setMerchantToken(nicePay.makeToken(nicePay.getMerchantToken()); nicePay.settXid("TNICECP04104202305151417238166"); nicePay.setPayMethod("04"); nicePay.setCancelType("1"); nicePay.setCancelMsg("Request Cancel"); nicePay.setCancalUserId("admin"); // Request Cancel nicePay.cancel(); // Response String // System.out.println("Final Response String : " + nicePay.getResponseString()); String resultCd = nicePay.Get("resultCd"); String resultMsg = nicePay.Get("resultMsg"); String tXid = nicePay.Get("tXid"); String referenceNo = nicePay.Get("referenceNo"); String amt = nicePay.Get("amt"); String cancelReferenceNo = nicePay.Get("cancelReferenceNo"); ``` ::: [title] Notification Match Amount Indicator [path] NICEPAY API/API Non-SNAP/NICEPAY Code/ *Notification Match Amount Indicator* ditemukan pada untuk VA () dan CVS (). Bagian ini digunakan sebagai sebuah bagi untuk mengindikasi apakah *nominal* *amount *pada hendak dibayarkan kepada sesuai dengan harga dari sisi kepada . Pada kasus ini, terdapat 2 contoh tipe tersedia dan ditentukan bergantung pada aturan bahwa mau menerapkan kepada dalam . | **Tipe *****Amount*** | **Deskripsi** | | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Close | *Amount *(nominal uang dibayarkan) ditransfer oleh harus sesuai dengan tagihan perlu dilunasi pada . Jika tidak sesuai, maka akan langsung di sebagai kegagalan pada . | | Open | *Amount *(nominal uang dibayarkan) ditransfer oleh tidak harus sesuai dengan tagihan perlu dilunasi pada . Sistem akan lanjut untuk menerima transfer *amount * dilakukan oleh dan kemudian bergantung dari kebijakan terkait langkah harus diambil pada tahap tertentu dalam . | Jika ingin mengetahui lebih lengkap mengenai tipe VA (), silakan kunjungi [Fitur VA](docId\:GnUAAyq81JNJ8UNRanWUZ). :::hint{type="info"} *Notification Match Amount Indicator* disediakan oleh dalam bentuk agar dapat melakukan kepada terkait *amount * dikirimkan melalui *Value Code.* ::: *Value Code *untuk *Notification Match Amount Indicator*, antara lain: | **Value Code** | **Description** | | -------------- | --------------- | | `0` | Non-Proceeding | | `1` | Normal-Matching | | `2` | Overpaid | | `3` | Underpaid | :::hint{type="info"} - *Match* berarti bahwa *amount * dibayarkan oleh sudah sesuai dengan/sama dengan *amount * ditagihkan oleh . - *Over* berarti bahwa *amount * dikirim oleh melewati *amount * ditagihkan oleh . - *Under* berarti *amount * dikirim kepada kurang dari *amount * ditagihkan oleh . ::: [title] Seamless - Registration API Paylater [path] NICEPAY API/API Non-SNAP/Payment API/API Paylater/Registration - API Payloan/ # Tentang Seamless - Registration API Paylater *** Transaksi tipe Seamless adalah milik memberikan pengalaman nanti atau cicilan lebih cepat dan efisien. Melalui ini, pengguna dapat menghubungkan akun mereka dengan tanpa perlu melakukan autentikasi seperti login akun terlebih dahulu saat . Sehingga, setiap antara dan dapat berjalan lebih efisien tanpa pengulangan tahap autentikasi login akun pengguna dengan keamanan tetap terjaga dan dapat diandalkan oleh . :::hint{type="info"} Saat ini, hanya Kredivo sudah mendukung fitur Seamless. ::: Terdapat dua cara untuk mengaktifkan dengan tipe Seamless, yaitu: 1. Melakukan tokenize data dengan membuat terlebih dahulu. 2. Menggunakan fitur [Registration & Notification - Account Binding Paylater API](docId\:HU_q-9UZjxF32uv9gLBGK). Halaman ini menjelaskan lebih mendalam mengenai tokenize data melalui pertama, sehingga fitur Seamless dapat digunakan untuk berikutnya. # Alur Proses *** ## Tokenize ### Tokenize With Transaction ![Tokenize with Transaction](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/vvlXOpdEIQ3r5gP5ZLOP-_diagram-seamless-payment-api-paylater-tokenize-with-transaction.jpg "Tokenize with Transaction") Deskripsi alur: 1. melakukan *checkout*. 2. mengajukan *checkout *kepada . 3. mengajukan *checkout *kepada . 4. mengajukan *checkout *kepada . 5. mendaftarkan *checkout*. 6. mengirimkan *response *kepada . 7. mengirimkan *redirect *URL kepada . 8. mengarahkan menuju . 9. melakukan login pada Halaman Login . 10. mengirimkan kredensial kepada . 11. melakukan validasi login. 12. mengirimkan laporan kepada . 13. melihat laporan . 14. membayar dan mengonfirmasi kepada . 15. melakukan validasi . 16. Pada saat berlangsung: - Jika disetujui, maka: - mem persetujuan. - mengirimkan hasil persetujuan kepada . - menerima hasil persetujuan. - mengirimkan hasil persetujuan kepada . - menerima hasil persetujuan. - melakukan pengajuan kepada . - melakukan pengecekan . - mengirimkan hasil kepada . - menerima akhir. - mengirimkan kepada . - menerima hasil persetujuan. - Jika masih diperiksa, maka: - mengarahkan menuju /. - ditampilkan /. - menunggu persetujuan. ### Tokenize Without Transaction ![Tokenize without Transaction](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/l8UDhrC12AHMaddXNdn-i_diagram-seamless-payment-api-paylater-tokenize-without-transaction.jpg "Tokenize without Transaction") Deskripsi alur: 1. mendaftarkan nomor telepon kepada . 2. mengajukan penghubungan akun kepada . 3. mengajukan penghubungan akun kepada . 4. melakukan validasi. 5. mengirimkan *response *kepada . 6. melakukan *return redirect* URL terhadap . 7. mengarahkan menuju . 8. melakukan login melalui Halaman Login . 9. mengirimkan kredensial kepada . 10. melakukan validasi login. 11. melakukan *return *OTP terhadap . 12. memasukkan OTP kepada . 13. melakukan *generate *User Token. 14. mengarahkan menuju /. 15. Pada saat pengajuan penghubungan akun: - Pada : - Halaman / ditampilkan pada . - menunggu persetujuan. - Dari Notifikasi: - mengirimkan kepada . - menerima . - mengirimkan kepada . - menerima . - menampilkan hasil penghubungan akun kepada . ## Deactivate Tokenize :::hint{type="info"} kunjungi [Deactivate - Account Binding Paylater API](docId\:zZvRQbO6U_qUaiV2A0tMj) untuk lebih lanjut terkait menonaktifkan user token pada fitur Seamless. ::: Tokenize - Registration API Paylater (First Payment) ==================================================== *** | **API Endpoint** | `nicepay/direct/v2/registration` | | ------------------ | ------------------------------------------------------------------------- | | **Request Method** | **POST****** | | **Description** | Create user token | | **Merchant Token** | **SHA256 **(`iMid` + `referenceNo` + `billingPhone` + `merchantKey`) | | **Request Format** | `application/JSON` | ## Request Parameter for Tokenize - Registration API Paylater (First Payment) *** | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | | ------------------------------------------------------------------------------------- | ------------------ | ---------- | ---------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------- | | `timeStamp `
Required | N | 14 | Request Timestamp (`YYYYMMDDHH24MISS`) | 20220131125959 | | | `iMid `
Required | AN | 10 | ID
| PAYLOANTES | | | `payMethod`
Required | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok)
| 06 | | | `currency`
Required | A | 3 | Currency
| IDR | | | `amt`
Required | N | 12 | Amount
| 10000 | | | `referenceNo`
Required | ANS | 40 | 's Reference Number
| ORD12345 | | | `callBackUrl` | ANS | 255 | Result URL | | | | `goodsNm `
Required | AN | 100 | Goods Name
| Test Transaction | | | `billingNm `
Required | A | 100 | Buyer Name
| John Doe | | | `billingPhone`
Required | N | 15 | Buyer Phone Number
| 08123456789 | | | `billingEmail`
Required | ANS | 40 | Buyer E-Mail
| email\@merchant.com | | | `billingAddr`
Required | AN | 100 | Buyer Address
| Jalan Bukit Berbunga 22 | | | `billingCity`
Required | A | 50 | Buyer City
| Jakarta | | | `billingState`
Required | A | 50 | Billing State
| DKI Jakarta | | | `billingPostCd `
Required | N | 10 | Billing Post Number
| 12345 | | | `billingCountry `
Required | A | 10 | Billing Country
| | | | `cartData `
Required | `JSONstring`
| 4000 | Cart Data
| \{"count":3,"item":\[\{"goods\_id":30,"goods\_name":"Beanie","goods\_type":"Accessories","goods\_amt":5000,"goods\_sellers\_id":"NICEPAY-NamaMerchant","goods\_sellers\_name":"NICEPAYSHOP","goods\_quantity":1,"goods\_url":"[http://www.nicestore.com/product/beanie/](http://www.nicestore.com/product/beanie/)"},..]} | | | `userIP `
Required for CC, E-Wallet, Paylater, QRIS | AN | 15 | User IP
| 127.0.0.1
| | | `dbProcessUrl`
Required | ANS | 255 | Notification URL
| https\://merchant.com/dbProcessUrl | | | `merchantToken`
Required | AN | 255 | Token
| 9b38b12e83b6ee124d4b549238f232c6179b168effc4ffb7f64d00c15f08e230 | | | `deliveryNm`
Required | A | 30 | Delivery Name | email\@merhchant.com | | | `deliveryPhone`
Required | N | 15 | Delivery Phone | 08123456789 | | | `deliveryAddr`
Required | AN | 100 | Delviery Address | Jalan Bukit Berbunga 22 | | | `deliveryCity`
Required | A | 50 | Delivery City | Jakarta | | | `deliveryState`
Required | A | 50 | Delivery State | DKI Jakarta | | | `deliveryPostCd`
Required | N | 10 | Delivery Post Code | 12345 | | | `deliveryCountry`
Required | A | 10 | Delivery Country | | | | `mitraCd`
Required | N | 2 | [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8) | KDVI | | | `instmntType`
Required | N | 8 | [Installment Type Code](docId:7CIX-U_4z295XgtNVEsbO) | 2 | | | `instmntMon`
Required | N | 6 | `1`: 1 Month/Full , *jika* *instmntType:* *null/1*
`3`: 3 Months
`6`: 6 Months
`12`: 12 Months
| 3 | | | `userSessionID` | AN | 255 | ID User Session | 697D6922C961070967D3BA1BA5699C2C | | | `userAgent` | ANS | 255 | User Agent | Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML,like Gecko) Chrome/60.0.3112.101 Safari/537.36 | | | `userLanguage` | ANS | 255 | User Language | ko-KR,en-US;q=0.8,ko;q=0.6,en;q=0.4 | | | `sellers`
Required | `JSON String` | 4000 | Seller Data | \[\{\\"sellersId\\":\\"NICEPAY-NamaMerchant\\",\\"sellersNm\\":\\"NICEPAYSHOP\\",\\"sellersUrl\\":\\"http\://nicestore.store/product/beanie/\\",\\"sellersEmail\\":\\"Nicepay\@nicepay.co.id\\",\\"sellersAddress\\":\{\\"sellerNm\\":\\"NICEPAYSHOP\\",\\"sellerLastNm\\":\\"NICEPAYSHOP\\",\\"sellerAddr\\":\\"Jln. Kasablanka Kav 88\\",\\"sellerCity\\":\\"Jakarta\\",\\"sellerPostCd\\":\\"14350\\",\\"sellerPhone\\":\\"082111111111\\",\\"sellerCountry\\":\\"ID\\"}}] | | | `tokenizeUser`
Required | N | 1 | Seamless | Transaction Tokenize Type:
`0`: Normal
`1`: Tokenize (First Transaction)
`2`: Seamless (Next ) | 1 | | `clientUserKey`
Required | AN | 100 | Seamless
(Mandatory) | User Key, must be unique for each . | Gili.heriawan\@nicepay.co.id | ## Response Parameter for Tokenize - Registration API Paylater (First Payment) *** | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | --------------- | -------- | ---------- | ----------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `resultCd` | N | 4 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | 0000 | | `resultMsg` | AN | 255 | Result Message: [Error Code](docId\:yEh1VA9k2y6sL1kQF2aWD) | SUCCESS | | `tXid` | AN | 30 | Transaction ID (Key from ) | IONPAYTEST02201607291027025291 | | `referenceNo` | ANS | 40 | Order Number (Key from ) | OrdNo20160525000-52104 | | `payMethod` | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | 06 | | `amt` | N | 12 | Amount | 1000 | | `currency` | AN | 3 | Currency | IDR | | `goodsNm` | AN | 100 | Goods Name | Goods 1 | | `billingNm` | A | 30 | Buyer Name | Buyer Name | | `transDt` | N | 8 | Transaction Date (`YYYYMMDD`) | 20160303 | | `transTm` | N | 6 | Transaction Time (`HH24MISS`) | 135959 | | `description` | AN | 100 | Transaction Description | Payment of OrdNo20160525000-52104 | | `bankCd` | A | 4 | [Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | BMRI | | `vacctNo` | N | 20 | Number | 123457891011 | | `vacctValidDt` | N | 8 | VA Expiry Date (`YYYYMMDD`) | 20160303 | | `vacctValidTm` | N | 6 | VA Expiry Time (`HH24MISS`) | 135959 | | `mitraCd` | AN | 4 | [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8) | KDVI | | `payNo` | N | 12 | CVS Number | 123456789012 | | `payValidDt` | N | 8 | CVS Expiry Date (`YYYYMMDD`) | 20170313 | | `payValidTm` | N | 6 | CVS Expiry Time (`HH24MISS`) | 135959 | | `paymentExpDt` | N | 6 | QR Expiry Date (`YYYYMMDD`) | 20201005 | | `paymentExpTm` | N | 6 | QR Expiry Time (`HH24MISS`) | 124354 | | `qrContent` | ANS | 360 | QR String in Plain Text | 00020101021226590016ID.CO.SHOPEE.WWW011893600918000041566602064156660303UME52045399530336054045.005802ID5913NICEPAY dummy6015KOTA JAKARTA SE61051287062360520082020100512385458400708T000000163044A04 | | `qrUrl` | ANS | 360 | URL for QR Image, Valid for 5 Minutes. | https\://api.wallet.airpay.co.id/v3/merchant-host/qr/download?qr=wOCiKheIXwgyjnUUk6PhJLTS1e9Ros7zf0ESj6AavQ | | `clientUserKey` | AN | 100 | User Key, must be unique for each . | gili.heriawan\@nicepay.co.id | :::hint{type="info"} Setelah berhasil melakukan dengan tokenize, akan mendapatkan parameter `userToken` dari [Notification - API Paylater](docId\:tLx6S6yonkvOMuyhJMQ8Z) terkait sukses melalui URL parameter `dbprocessUrl` pada saat registrasi tokenize sebelumnya. `userToken` tersebut akan digunakan untuk mengaktifkan fitur Seamless pada berikutnya. ::: ## Sample Parameter for Tokenize - Registration API Paylater (First Payment) *** :::CodeblockTabs Request Parameter ```json { "timeStamp": "20210913090977", "iMid": "PAYLOANTES", "payMethod": "06", "currency": "IDR", "amt": "25145", "referenceNo": "ord20210913090977", "goodsNm": "Test Transaction Nicepay", "billingNm": "Customer Name", "billingPhone": "12345678", "billingEmail": "email@merchant.com", "billingAddr": "Jalan Bukit Berbunga 22", "billingCity": "Jakarta", "billingState": "DKI Jakarta", "billingPostCd": "12345", "billingCountry": "Indonesia", "deliveryNm": "email@merchant.com", "deliveryPhone": "12345678", "deliveryAddr": "Jalan Bukit Berbunga 22", "deliveryCity": "Jakarta", "deliveryState": "DKI Jakarta", "deliveryPostCd": "12345", "deliveryCountry": "Indonesia", "dbProcessUrl": "http://ptsv2.com/t/nicepay-test/post", "merchantToken": "596129570572f2ce4f6b459a09c8c1aaf36910ed6f3feb5a6da0a7086233714a", "reqDomain": "merchant.com", "reqServerIP": "127.0.0.1", "userIP": "127.0.0.1", "userSessionID": "697D6922C961070967D3BA1BA5699C2C", "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML,like Gecko) Chrome/60.0.3112.101 Safari/537.36", "userLanguage": "ko-KR,en-US;q=0.8,ko;q=0.6,en;q=0.4", "cartData": "{\"count\":\"1\",\"item\":[{\"goods_id\":\"BB12345678\",\"goods_detail\":\"BB12345678\",\"goods_name\":\"Pasar Modern\",\"goods_amt\":\"25145\",\"goods_type\":\"Sembako\",\"goods_url\":\"http://merchant.com/cellphones/iphone5s_64g\",\"goods_quantity\":\"1\",\"goods_sellers_id\":\"SEL123\",\"goods_sellers_name\":\"Sellers 1\"}]}", "sellers": "[{\"sellersId\": \"SEL123\",\"sellersNm\": \"Sellers 1\",\"sellersEmail\":\"sellers@test.com\",\"sellersAddress\": {\"sellerNm\": \"Sellers\",\"sellerLastNm\": \"1\",\"sellerAddr\": \"jalan berbangsa 1\",\"sellerCity\":\"Jakarta Barat\",\"sellerPostCd\": \"12344\",\"sellerPhone\":\"08123456789\",\"sellerCountry\": \"ID\"}}]", "instmntType": "2", "instmntMon": "1", "mitraCd": "KDVI", "tokenizeUser": "1", "clientUserKey": "gili.heriawan@nicepay.co.id", "userToken": "" } ``` Response Parameter ```json { "resultCd": "0000", "resultMsg": "SUCCESS", "tXid": "PAYLOANTES06202109130937199795", "referenceNo": "ord20210913090977", "payMethod": "06", "amt": "25145", "transDt": null, "transTm": null, "description": null, "bankCd": null, "vacctNo": null, "mitraCd": "KDVI", "payNo": null, "currency": null, "goodsNm": null, "billingNm": null, "vacctValidDt": null, "vacctValidTm": null, "payValidDt": null, "payValidTm": null, "requestURL": null, "paymentExpDt": null, "paymentExpTm": null, "qrContent": null, "qrUrl": null, "clientUserKey": "gili.heriawan@nicepay.co.id" } ``` ::: # Seamless - Registration API Paylater *** | **API Endpoint** | `nicepay/direct/v2/registration` | | ------------------ | ------------------------------------------------------------------------- | | **Request Method** | **POST****** | | **Description** | Create user token | | **Merchant Token** | **SHA256 **(`iMid` + `referenceNo` + `billingPhone` + `merchantKey`) | | **Request Format** | `application/JSON` | ## Request Parameter for Seamless - Registration API Paylater *** | **Parameter** | **Tipe** | **Ukuran** | **Kebutuhan** | **Deskripsi** | **Contoh / Catatan** | | ----------------- | -------- | ---------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- | | `timeStamp` | N | 14 | Mandatory | Request Date | 20170708123456 | | `iMid` | AN | 10 | Mandatory | ID | PAYLOANTES | | `payMethod` | AN | 2 | Mandatory | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok)
`06`: | 06 | | `currency` | AN | 3 | Mandatory | Currency | IDR | | `amt` | N | 12 | Mandatory | Amount | 1000 | | `referenceNo` | ANS | 40 | Mandatory | Order Number (Key from | ReferenceNumber001 | | `goodsNm` | AN | 100 | Mandatory | Goods Name | Goods 1 | | `billingNm` | A | 30 | Mandatory | Buyer Name | Buyer Name | | `billingPhone` | N | 15 | Mandatory | Buyer Phone Number | 02112345678 | | `billingEmail` | AN | 40 | Mandatory | Buyer Email | buyer\@merchant.com | | `billingAddr` | AN | 100 | | Buyer Address | Billing Address | | `billingCity` | A | 50 | Mandatory | Buyer City | Jakarta | | `billingState` | A | 50 | Mandatory | Billing State | Jakarta | | `billingPostCd` | N | 10 | Mandatory | Billing Post Number | 12345 | | `billingCountry` | A | 10 | Mandatory | Billing Country | Indonesia | | `deliveryNm` | A | 30 | Mandatory | Delivery Name | Buyer Name | | `deliveryPhone` | N | 15 | Mandatory | Delivery Phone Number | 02112345678 | | `deliveryAddr` | AN | 100 | Mandatory | Delivery Address | Billing Address  | | `deliveryCity` | A | 50 | Mandatory | Delivery City | Jakarta  | | `deliveryState` | A | 50 | Mandatory | Delivery State | Jakarta  | | `deliveryPostCd` | N | 10 | Mandatory | Delivery Post Number | 12345 | | `deliveryCountry` | A | 10 | Mandatory | Delivery Country | Indonesia  | | `dbProcessUrl` | AN | 255 | Mandatory | Notification URL (Async Notification) | "http\://www\.merchant.com/notification” | | `description` | AN | 100 | | Transaction Description | Description | | `merchantToken` | AN | 255 | Mandatory | Token | 6cfccfc0046773c1b589d8e98f8b596c284f3c70a4ecf86eba14c18944b74bcd | | `userIP` | AN | 15 | Mandatory | User IP ( ) | 127.0.0.1 | | `userSessionID` | AN | 100 | | User Session ID | userSessionID | | `userAgent` | AN | 100 | | User Agent Information | Mozilla | | `userLanguage` | A | 2 | | User Language | en-US | | `cartData` | AN | 4000 | Mandatory | Cart Data | (JSON Format) | | `sellers` | AN | 4000 | Mandatory | Sellers | (JSON Format) | | `instmntType` | N | 2 | Mandatory | Installment Type:
`1`: Charge
`2`: Charge | 2 | | `instmntMon` | N | 2 | Mandatory | Installment Month | 1 | | `mitraCd` | A | 4 | Mandatory | [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8):
`KDVI`: Kredivo | KDVI | | `tokenizeUser` | N | 1 | Seamless | Transaction Tokenize Type:
`0`: Normal
`1`: Tokenize (First Transaction)
`2`: Seamless (Next ) | 2 | | `userToken` | AN | 50 | Seamless | User Token for using Seamless feature.

You can get this token from `dbprocessUrl` Notification after Tokenize is success. | 59bd0cc5-0b26-42ae-be0f-caeab9424f95
| ## Response Parameter for Seamless - Registration API Paylater *** | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | --------------- | -------- | ---------- | ----------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `resultCd` | N | 4 | Result Code | 0000 | | `resultMsg` | AN | 255 | Result Message | SUCCESS | | `tXid` | AN | 30 | Transaction ID (Key from ) | IONPAYTEST02201607291027025291 | | `referenceNo` | ANS | 40 | Order Number (Key from ) | OrdNo20160525000-52104 | | `payMethod` | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | 06 | | `amt` | N | 12 | Amount | 1000 | | `currency` | AN | 3 | Currency | IDR | | `goodsNm` | AN | 100 | Goods Name | Goods 1 | | `billingNm` | A | 30 | Buyer Name | Buyer Name | | `transDt` | N | 8 | Transaction Date (`YYYYMMDD`) | 20160303 | | `transTm` | N | 6 | Transaction Time (`HH24MISS`) | 135959 | | `description` | AN | 100 | Transaction Description | Payment of OrdNo20160525000-52104 | | `bankCd` | A | 4 | [Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | BMRI | | `vacctNo` | N | 20 | Number | 123457891011 | | `vacctValidDt` | N | 8 | VA Expiry Date (`YYYYMMDD`) | 20160303 | | `vacctValidTm` | N | 6 | VA Expiry Time (`HH24MISS`) | 135959 | | `mitraCd` | AN | 4 | [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8) | KDVI | | `payNo` | N | 12 | CVS Number | 123456789012 | | `payValidDt` | N | 8 | CVS Expiry Date (`YYYYMMDD`) | 20170313 | | `payValidTm` | N | 6 | CVS Expiry Time (`HH24MISS`) | 135959 | | `paymentExpDt` | N | 6 | QR Expiry Date (`YYYYMMDD`) | 20201005 | | `paymentExpTm` | N | 6 | QR Expiry Time (`HH24MISS`) | 124354 | | `qrContent` | ANS | 360 | QR String in Plain Text | 00020101021226590016ID.CO.SHOPEE.WWW011893600918000041566602064156660303UME52045399530336054045.005802ID5913NICEPAY dummy6015KOTA JAKARTA SE61051287062360520082020100512385458400708T000000163044A04 | | `qrUrl` | ANS | 360 | URL for QR Image, Valid for 5 Minutes. | https\://api.wallet.airpay.co.id/v3/merchant-host/qr/download?qr=wOCiKheIXwgyjnUUk6PhJLTS1e9Ros7zf0ESj6AavQ | | `clientUserKey` | AN | 100 | User Key | gili.heriawan\@nicepay.co.id | | `userToken` | AN | 50 | User Token for Seamless, only returned in response body when is Seamless (tokenizeUser: `2`) | 59bd0cc5-0b26-42ae-be0f-caeab9424f95 | ## Sample Parameter for Seamless - Payment API Paylater *** :::CodeblockTabs Request Parameter ```json { "timeStamp": "20210913090998", "iMid": "PAYLOANTES", "payMethod": "06", "currency": "IDR", "amt": "25145", "referenceNo": "ord20210913090998", "goodsNm": "Test Transaction Nicepay", "billingNm": "Customer Name", "billingPhone": "12345678", "billingEmail": "email@merchant.com", "billingAddr": "Jalan Bukit Berbunga 22", "billingCity": "Jakarta", "billingState": "DKI Jakarta", "billingPostCd": "12345", "billingCountry": "Indonesia", "deliveryNm": "email@merchant.com", "deliveryPhone": "12345678", "deliveryAddr": "Jalan Bukit Berbunga 22", "deliveryCity": "Jakarta", "deliveryState": "DKI Jakarta", "deliveryPostCd": "12345", "deliveryCountry": "Indonesia", "dbProcessUrl": "http://ptsv2.com/t/nicepay-test/post", "merchantToken": "14d2461cb1d5399c82343d0e3a8e12cdcc845625e966d0ed5fb8de6a02b3433d", "reqDomain": "merchant.com", "reqServerIP": "127.0.0.1", "userIP": "127.0.0.1", "userSessionID": "697D6922C961070967D3BA1BA5699C2C", "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML,like Gecko) Chrome/60.0.3112.101 Safari/537.36", "userLanguage": "ko-KR,en-US;q=0.8,ko;q=0.6,en;q=0.4", "cartData": "{\"count\":\"1\",\"item\":[{\"goods_id\":\"BB12345678\",\"goods_detail\":\"BB12345678\",\"goods_name\":\"Pasar Modern\",\"goods_amt\":\"25145\",\"goods_type\":\"Sembako\",\"goods_url\":\"http://merchant.com/cellphones/iphone5s_64g\",\"goods_quantity\":\"1\",\"goods_sellers_id\":\"SEL123\",\"goods_sellers_name\":\"Sellers 1\"}]}", "sellers": "[{\"sellersId\": \"SEL123\",\"sellersNm\": \"Sellers 1\",\"sellersEmail\":\"sellers@test.com\",\"sellersAddress\": {\"sellerNm\": \"Sellers\",\"sellerLastNm\": \"1\",\"sellerAddr\": \"jalan berbangsa 1\",\"sellerCity\":\"Jakarta Barat\",\"sellerPostCd\": \"12344\",\"sellerPhone\":\"08123456789\",\"sellerCountry\": \"ID\"}}]", "instmntType": "2", "instmntMon": "1", "mitraCd": "KDVI", "tokenizeUser": "2", "clientUserKey": "", "userToken": "e0478456-6b50-460c-85e0-627a1e22d2e0" } ``` Response Parameter ```json { "resultCd": "0000", "resultMsg": "SUCCESS", "tXid": "PAYLOANTES06202109130955379813", "referenceNo": "ord20210913090998", "payMethod": "06", "amt": "25145", "transDt": null, "transTm": null, "description": null, "bankCd": null, "vacctNo": null, "mitraCd": "KDVI", "payNo": null, "currency": null, "goodsNm": null, "billingNm": null, "vacctValidDt": null, "vacctValidTm": null, "payValidDt": null, "payValidTm": null, "requestURL": null, "paymentExpDt": null, "paymentExpTm": null, "qrContent": null, "qrUrl": null, "userToken": "e0478456-6b50-460c-85e0-627a1e22d2e0" } ``` ::: [title] Advance API [path] NICEPAY API/API Non-SNAP/ Advance merupakan lanjutan dari memilki keunikan tersendiri, akan tetapi masih butuhkan untuk kelancaran . dapat menggunakan spesifik sesuai dengan kebutuhan . Kami menyediakan tingkat lanjut, di antaranya: ::::LinkArray{contentSource="CUSTOM"} :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/KydS1hZWPH_Efgdfj5zC6_header-non-snap-advance-api-paylater.jpg"} [Paylater - Advance API](docId:4x6QM_ewhHnwU3uYmnr6D) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/4qi0ZwPOHZ2NvhvMfpDWC-20260320-080029.jpg"} [Virtual Account - Advance API](docId\:wyA2yOu4CqrS8aNTsau9r) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/dQ_aejmFAwPhsditQ5Smc-20260320-082541.jpg"} [Inquiry List API](docId\:pznN9QIpKy7noBdmUxUnF) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/dZdIySVI75ArZ5x1P8wBa-20260320-080601.jpg"} [E-Wallet - Advance API](docId\:PVPGVkTZHNqmhJkI9vLCe) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/123ylFkW88JtXoras-chz-20260320-080640.jpg"} [NICEPAY Service Status API - Advance API](docId\:k-xCbtAYqyNEhSrsnvJpm) ::: :::: # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [API Checkout](docId\:Djp90D-rlCNeDCzKwGC-d) untuk mengetahui digunakan pada checkout. ::: :::VerticalSplitItem [Payment API](docId\:OK8pnFvDrqo-4Qq3umLQz) untuk mengetahui digunakan pada setiap . ::: :::: ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [NICEPAY Code](docId\:kYd45uYYIjwzVs3dt8_rk) untuk mengetahui arti kode digunakan oleh . ::: :::VerticalSplitItem ::: :::: [title] Payment Status Code [path] NICEPAY API/API Non-SNAP/NICEPAY Code/ *Payment Status Code *digunakan untuk memeriksa berjalan sesuai dengan dipilih pada suatu dalam . Setiap memiliki berbeda. Berikut adalah rincian kode untuk setiap . # Credit Card *** | **Nilai Kode** | **Deskripsi** | | -------------- | ---------------------- | | `0` | Success | | `1` | Void | | `2` | Refund | | `8` | Failed | | `9` | *Initialization * | # Virtual Account *** | **Nilai Kode** | **Deskripsi** | | -------------- | ------------- | | `0` | Paid | | `1` | Reversal | | `3` | Unpaid | | `4` | Expired | # CVS *** | **Nilai Kode** | **Deskripsi** | | -------------- | -------------------------------------- | | `0` | Paid | | `3` | Unpaid | | `4` | Expired | | `5` | Ready to Commit (untuk Alfamart Group) | # Direct Debit *** | **Nilai Kode** | **Deskripsi** | | -------------- | -------------- | | `0` | Success | | `1` | Void / Refund | | `3` | Unpaid | | `9` | Initialization | # E-Wallet *** | **Nilai Kode** | **Deskripsi** | | -------------- | ------------- | | `0` | Paid | | `1` | Void | | `2` | Refund | | `3` | Unpaid | | `4` | Processing | | `5` | Expired | | `8` | Failed | | `9` | Initiated | # Paylater *** | **Nilai Kode** | **Deskripsi** | | -------------- | ------------- | | `0` | Paid | | `1` | Void | | `2` | Refund | | `3` | Unpaid | | `8` | Fail | | `9` | Init | # Payout *** | **Nilai Kode** | **Deskripsi** | | -------------- | ---------------------- | | `0` | Approved | | `3` | Request | | `4` | Cancel | | `8` | Time Out | | `9` | Failed | | `5` | Reject before Approved | # QRIS *** | **Nilai Kode** | **Deskripsi** | | -------------- | ------------------------------ | | `0` | Success | | `2` | Refund | | `3` | Unpaid | | `5` | Expired / Cancel | | `6` | Payment Failed
| # GPN *** | **Nilai Kode** | **Deskripsi** | | -------------- | ---------------------- | | `0` | Success | | `1` | Void | | `2` | Refund | | `8` | Failed | | `9` | *Initialization * | [title] Field Type Code [path] NICEPAY API/API Messaging/SMS API/Untitled/ Tiap *field *pada memiliki tipe data berbeda. IT Developer dapat mengisi *value *dari *key * sesuai dengan *field type* sudah ditentukan pada tabel di bawah ini. | **Key** | **Deskripsi** | | ------- | ---------------------------- | | `A` | Alphabet | | `AN` | Alphanumeric | | `N` | Number | | `ANS` | Alphanumeric, Number, Symbol | | `AOO` | Array of Object | [title] NICEPAY Code - SMS API [path] NICEPAY API/API Messaging/SMS API/ **NICEPAY Code** adalah kumpulan daftar digunakan dalam khusus . :::hint{type="warning"} Bagian ini memuat informasi terkait . ::: ::::LinkArray{contentSource="CUSTOM"} :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/PCszpExUVdvhkwM7EDfzZ_header-messaging-sms-api-nicepay-code-field-type-code.jpg"} [Field Type Code](docId\:mjFSAuRLXB1hgmrpB2ofp) adalah daftar kode tipe data digunakan dalam . ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/6CLXyW82sgD2_0ALJYE5a_header-messaging-sms-api-nicepay-code-error-code.jpg"} [Error Code](docId\:JKO_1O-kS-XzfZAqPwNIN) adalah daftar kode *error *yang digunakan dalam . ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/IR6UNudCi2iXEycuqQjK4_header-messaging-sms-api-nicepay-code-transmission-status-code.jpg"} [Transmission Status Code](docId:0dccdS0W5z7yNa0JULSsu) adalah daftar kode transmisi digunakan pada dan dalam . ::: :::: [title] Paylater - Advance API [path] NICEPAY API/API Non-SNAP/Advance API/ # Tentang Paylater - Advance API *** Informasi berikut ditujukan untuk dengan fitur *Account Binding* saat ini hanya tersedia pada Kredivo. ::::LinkArray{contentSource="CUSTOM"} :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/nQGfw4Xyi0y5t_fPgDDaJ_header-non-snap-advance-api-paylater-account-binding.jpg"} [Account Binding - Paylater API Advance](docId\:ML7Bb9Ohu2luG9zPv-JtW) ::: :::: [title] Fail Transaction API [path] NICEPAY API/API Laporan Bisnis/ # Tentang Fail Transaction API Fail Transaction API dapat digunakan untuk melakukan rekonsiliasi laporan gagal dalam . Dengan ini, dapat memperoleh daftar gagal hingga 5.000 data *per request*, sesuai dengan tanggal diminta. :::Iframe{iframeHeight="0" code="Merchant harus menghubungi NICEPAY Customer Service dengan mengirimkan IP Merchant untuk proses Whitelist pada NICEPAY terlebih dahulu dan melakukan pengajuan kredensial API untuk menggunakan Fail Transaction API."} ::: # Fail Transaction API | **API End Point** | [`bo.nicepay.co.id/failReport.do`](https://bo.nicepay.co.id/failReport.do) | | ---------------------------------------------- | ---------------------------------------------------------------------------- | | **Request Method **application/json | ******POST** | | **Description** | Untuk memeriksa laporan Fail Transaction dengan | | **Header** | `Content-Type: application/json` | | **Request Format** | `application/json` | :::hint{type="info"} Nilai nominal tersedia dalam laporan ini menggunakan mata uang Rupiah. ::: ## Request Parameter | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ------------------------------------------------------ | -------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------- | | `mid`
Required | VARCHAR2 | 10 | iMid | IONPAYTEST | | `passwd`
Required | VARCHAR2 | 100 | *Password* setelah Whitelist IP telah berhasil di-*register & approved* di sisi .

(Mohon untuk menghubungi **tim NICEPAY Customer Service** untuk asistensi). | 123456 | | `date`
Required | VARCHAR2 | 8 | Tanggal data mau dilihat
Format: `YYYYMMDD` | 20260727 | | `paymethod`
Required | VARCHAR2 | 2 | [Payment Method](docId\:CrGE1s9poBnuAdENJUkb8) | 00 | | `startno`
Required | NUMBER | 10 | Nomor urut awal data ingin ditampilkan (baris awal dari rentang data yang diminta). | 1
Default: 1 | | `endno`
Required | NUMBER | 10 | Nomor urut akhir data ingin ditampilkan (baris akhir dari rentang data yang diminta).

**Notes**: Maksimal rentang data antara
`startno`
dan
`endno`
adalah 5.000 data. | 100
Default: 100 | ## Response Parameter | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ----------------------------------------------------------- | -------- | ---------- | -------------------------------------------------------------------------- | --------------------------------------- | | `HEADER`
Required | Object | - | - | `"HEADER": { ... } ` | | `CODE`
Required | NUMBER | 4 | [Header Code Response](docId\:CrGE1s9poBnuAdENJUkb8) | 00 | | `MID`
Required | VARCHAR2 | 10 | iMid | IONPAYTEST | | `TRANS_DT`
Required | VARCHAR2 | 8 | Tanggal data di-*request*
Format: `YYYYMMDD` | 20260727 | | `DATA`
Required | Object | - | - | `"DATA": [ { ... } ] ` | | `CODE`
Required | NUMBER | 2 | [Data Code Response](docId\:CrGE1s9poBnuAdENJUkb8) | 10 | | `TXID`
Required | VARCHAR2 | 30 | ID Transaksi | IONPAYTEST01202607272022549895 | | `ORDER_NO`
Required | VARCHAR2 | 8 | Nomor Referensi | 99999 | | `RESULT_CD`
Required | N | 4 | Result Code | 9151 | | `RESULT_MSG`
Required | AN | 255 | Result Message | cardBin Information exist in blackList. | | `TRANS_DT`
Required | VARCHAR2 | 8 | Tanggal data di-*request*
Format : `YYYYMMDD` | 20260727 | | `TRANS_TM`
Required | VARCHAR2 | 8 | Waktu jam dari data di-*request*
Format:
`HHmmss` | 202321 | | `BILLING_NM`
Required | A | 100 | Buyer Name | John Doe | | `PAY_METHOD`
Required | VARCHAR2 | 2 | [Payment Method](docId\:CrGE1s9poBnuAdENJUkb8) | 01 | | `TRANS_AMT`
Required | NUMBER | 19,2 | Amount Transaksi | 1000 | | `BANK_CD`
Optional | VARCHAR2 | 4 | [Bank Code](docId\:CrGE1s9poBnuAdENJUkb8) | CENA | | `CUSTOMER_NO`
Required | VARCHAR2 | 40 | [Customer Account Transaction Number](docId\:CrGE1s9poBnuAdENJUkb8)
| 79150000\*\*\*\*\*\*\*\*8310 | | `TAIL`
Required | Object | - | - | `"TAIL": { ... }` | | `CODE`
Required | NUMBER | 4 | [Tail Code Response](docId\:CrGE1s9poBnuAdENJUkb8) | 99 | | `MID`
Required | VARCHAR2 | 10 | iMid | IONPAYTEST | | `TRANS_DT`
Required | VARCHAR2 | 8 | Tanggal data di-*request*
Format : `YYYYMMDD` | 20260727 | | `FAIL_TRANS_CNT`
Required | NUMBER | 10 | Jumlah total volume yang gagal | 5 | | `FAIL_TRANS_AMT`
Required | NUMBER | 19,2 | Jumlah total amount yang gagal | 14000 | ## Sample Parameter :::CodeblockTabs Request Parameter ```json { "mid": "IONPAYTEST", "passwd": "gpAFym0vGYmGIcPz5dVDyoKprI+Uul4miEH7LLiJiLUWfESSk1egsFhb82DHyRZhHwbqaFjij9hhUfBSUgm4Yg==", "date": "20260727", "paymethod": "00", "startno": 1, "endno": 1000 } ``` Response Parameter ```json { "HEADER": { "CODE": "00", "MID": "IONPAYTEST", "TRANS_DT": "20260727" }, "DATA": [ { "CODE": "10", "TXID": "IONPAYTEST01202607272022549895", "ORDER_NO": "T212F0I7HJUODYN", "RESULT_CD": "9151", "RESULT_MSG": "cardBin Information exist in blackList.", "TRANS_DT": "20260727", "TRANS_TM": "202321", "BILLING_NM": "John Doe", "PAY_METHOD": "01", "TRANS_AMT": 15725, "CUSTOMER_NO": "45353524********3322" }, { "CODE": "10", "TXID": "IONPAYTEST01202607271029583585", "ORDER_NO": "P21KKCBYWK87667", "RESULT_CD": "-", "RESULT_MSG": "Server is busy. Please kindly try again in few minutes.", "TRANS_DT": "20260727", "TRANS_TM": "103102", "BILLING_NM": "John Doe", "PAY_METHOD": "01", "TRANS_AMT": 83670, "BANK_CD": "CENA", "CUSTOMER_NO": "34353453********3445" }, { "CODE": "10", "TXID": "IONPAYTEST01202607271029583585", "ORDER_NO": "P21KKCBYWK87667", "RESULT_CD": "9151", "RESULT_MSG": "cardBin Information exist in blackList.", "TRANS_DT": "20260727", "TRANS_TM": "103023", "BILLING_NM": "John Doe", "PAY_METHOD": "01", "TRANS_AMT": 83670, "CUSTOMER_NO": "45353453********3453" } ], "TAIL": { "CODE": "99", "MID": "IONPAYTEST", "TRANS_DT": "20260727", "FAIL_TRANS_CNT": 3, "FAIL_TRANS_AMT": 183065 } } ``` ::: [title] Notification - API Convenience Store [path] NICEPAY API/API Non-SNAP/Payment API/API Convenience Store/ # Tentang API Convenience Store Notification *** mengirimkan *push notification* dikirim melalui `dbProcessUrl` . harus memastikan tidak melakukan Blacklist IP dan melakukan Whitelist IP untuk mendapatkan *push notification* hanya dikirim dari server . | **Request Method** | **POST****** | | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Merchant Token** | SHA256 ( `iMid`+ `tXid` + `amt`+ `merchantKey`) | | **IP** | IP Public environtment Production:
`103.20.51.34`
`103.20.51.33`
`18.98.96.50`

IP Public environtment Dev:
`103.20.51.39`
`103.20.51.40`
`18.98.96.54` | | **User-Agent** | `User-Agent: Jakarta Commons-HttpClient/3.1` | # Notification Parameter Convenience Store *** :::hint{type="info"} Ketika diterima pada `dbProcessUrl` , kami menyarankan dengan sangat kepada untuk melakukan verifikasi kembali menggunakan [Status Inquiry - API Convenience Store](docId\:WMITrWcw3j9ChajRg-o1D). ::: | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ----------------------------------------------------------------------------------------- | -------- | ---------- | ---------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- | | `tXid` | N | 30 | Transaction ID | TNICECV03103202212141459041632 | | `merchantToken` | AN | 255 | Token | 8b5565e793731a1a1c8817c9e42bcbbdc3f5fb6a2785a6e0b19a2d5e3a41a51b | | `referenceNo` | ANS | 40 | Order Number | ord0123456 | | `mitraCd` | A | 4 | [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8) | ALMA | | `payMethod` | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | 04 | | `payNo` | N | 20 | Number | 504100002539 | | `payValidTm` | N | 6 | CVS Expiry Time (`HH24MISS`) | null | | `payValidDt` | N | 8 | CVS Expiry Date (`YYYYMMDD`) (CVS) | null | | `amt` | N | 12 | Amount | 5000 | | `clientUserKey`
Mandatory if tokenize
| AN | 100 | User Key, Must be Unique for Each | 1134431 | | `userToken` | ANS | | User Token | 12345eea9-6234-6789-12r3-123re3456tt5 | | `tokenizeUser` | N | 1 | Transaction Tokenize Type | 1 | | `transDt` | N | 8 | Transaction Date | 20221214 | | `transTm` | N | 6 | Transaction Time | 150229 | | `currency` | A | 3 | Currency | IDR | | `goodsNm` | AN | 100 | Goods Name | Testing | | `billingNm` | A | 100 | Billing Name | John-Doe | | `matchCl` | N | 1 | Payment Flag: [Notification Match Amount Indicator](docId\:WdoGjBeqc1VmRdFJqG1ZE) | 1 | | `status` | A | 1 | Deposit Status: [Notification Status Code](docId\:CdRwf99UxER6PH64ADA2C)
`0` : Deposit
`1` : Reversal | 0 | | `instmntType` | N | 2 | [Installment Type Code](docId:7CIX-U_4z295XgtNVEsbO) | 1 | | `instmntMon` | N | 2 | Installment Month | 1 | :::hint{type="warning"} *Merchant Token* diterima dari *Notification*, harus melakukan perbandingan kembali secara internal untuk mencegah palsu/tidak berlaku. **💡Contoh Kasus:** Misalnya, memiliki `merchantKey` digunakan untuk melakukan *generate *token, yaitu `1234`. Ketika `merchantToken` di-*generate * diketahui adalah `abcd`, sementara `merchantToken` didapatkan pada adalah `abdd`, maka tersebut dianggap **palsu/tidak berlaku.** ::: ## Sample for Convenience Store Notification *** :::CodeblockTabs Sample POST for Convenience Store Notification ```none merchantToken=8b5565e793731a1a1c8817c9e42bcbbdc3f5fb6a2785a6e0b19a2d5e3a41a51b goodsNm=Testing referenceNo=ord0123456 mitraCd=ALMA transTm=150229 tXid=TNICECV03103202212141459041632 amt=5000 instmntType=1 billingNm=John-Doe matchCl=1 payNo=504100002539 payValidTm=null payMethod=03 currency=IDR instmntMon=1 payValidDt=null transDt=20221214 status=0 ``` ::: [title] Notification - API Direct Debit [path] NICEPAY API/API Non-SNAP/Payment API/API Direct Debit/ # Tentang API Direct Debit Notification *** akan mengirimkan *push notification* melalui `dbProcessUrl` sesuai dengan pada [Registration - API Direct Debit](docId\:VxFYMW2MFyiQVX-Rj9DRe). harus memastikan tidak melakukan Blacklist IP dan melakukan Whitelist IP untuk mendapatkan *push notification* hanya dikirim dari server . | **Request Method** | **POST****** | | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Merchant Token** | SHA256 ( `iMid`+ `tXid` + `amt`+ `merchantKey`) | | **IP** | IP Public environtment Production:
`103.20.51.34`
`103.20.51.33`
`18.98.96.50`

IP Public environtment Dev:
`103.20.51.39`
`103.20.51.40`
`18.98.96.54` | | **User-Agent** | `User-Agent: Jakarta Commons-HttpClient/3.1` | # Notification Parameter Direct Debit Notification *** :::hint{type="info"} Ketika diterima pada `dbProcessUrl` , kami sangat menyarankan untuk melakukan verifikasi kembali dengan menggunakan [Status Inquiry - API Direct Debit](docId\:TvyS0QCC6pqcXX8NulLFr). ::: | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ----------------------------------------------------------------------------------------- | -------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------- | | `tXid`
Required | N | 30 | Transaction ID | TNICECP04100202210201205567417 | | `merchantToken`
Required | AN | 255 | Token | ecd49958d29595d09cd7ccab6057e9db119dfeb83676c27fb7649d3393b911aa | | `referenceNo`
Required | ANS | 40 | Order Number | ORD20250307130386 | | `mitraCd`
Required | A | 4 | [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8) | JENC | | `payMethod`
Required | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | 04 | | `payNo`
Optional | N | 20 | Number | 504100002539 | | `payValidTm`
Optional | N | 6 | CVS Expiry Time (`HH24MISS`) | null | | `payValidDt`
Optional | N | 8 | Expiry Date (`YYYYMMDD`) | null | | `amt`
Required | N | 12 | Amount | 10000 | | `clientUserKey`
Mandatory if tokenize
| AN | 100 | User Key, Must be Unique for Each | 1134431 | | `userToken`
Optional | ANS | 255 | User Token | 12345eea9-6234-6789-12r3-123re3456tt5 | | `tokenizeUser`
Optional | N | 1 | Transaction Tokenize Type | 1 | | `transDt`
Optional | N | 8 | Transaction Date | 20221020 | | `transTm`
Optional | N | 6 | Transaction Time | 120803 | | `currency`
Required | A | 3 | Currency | IDR | | `goodsNm`
Required | AN | 100 | Goods Name | John Doe | | `billingNm`
Required | A | 100 | Billing Name | John-Doe | | `receiptCode`
Required | ANS | 20 | Authorization Number | 951523387713 | | `instmntType`
Required | N | 2 | [Installment Type Code](docId:7CIX-U_4z295XgtNVEsbO) | 2 | | `instmntMon`
Required | N | 2 | Installment Month
`1`: 1 Month/Full , jika `instmntType`*:* *null/1*
`3`: 3 Months
`6`: 6 Months
`12`: 12 Months | 1 | | `mRefNo`
Required | AN | 18 | Reference Number | 202503071335234 | | `matchCl`
Required | N | 1 | Flag: [Notification Match Amount Indicator](docId\:WdoGjBeqc1VmRdFJqG1ZE) | 1 | | `status`
Required | A | 1 | Deposit Status: [Notification Status Code](docId\:CdRwf99UxER6PH64ADA2C)
`0` : Deposit
`1` : Reversal | 0 | :::hint{type="warning"} harus melakukan perbandingan kembali terhadap setiap Token diterima dari Notification secara internal untuk mencegah palsu/tidak berlaku. **💡Contoh Kasus:** Misalnya, memiliki `merchantKey` digunakan untuk melakukan *generate* token, yaitu `1234`. Ketika `merchantToken` di-*generate* diketahui adalah `abcd`, sementara `merchantToken` didapatkan pada adalah `abdd`, maka tersebut dianggap **palsu/tidak berlaku.** ::: ## Sample for Direct Debit Notification *** :::CodeblockTabs Sample POST for Direct Debit Notification ```none merchantToken=ecd49958d29595d09cd7ccab6057e9db119dfeb83676c27fb7649d3393b911aa goodsNm=John Doe referenceNo=ORD20250307130386 transTm=133600 tXid=TNICECP04104202503071335233256 amt=10000 receiptCode=951523387713 instmntType=2 billingNm=John Doe matchCl=1 mRefNo=202503071335234 payMethod=04 currency=IDR instmntMon=1 transDt=20250307 status=0 ``` ::: [title] Bank Code [path] NICEPAY API/API Non-SNAP/NICEPAY Code/ *Value *(Nilai) berikut dapat dapat digunakan untuk mengisi `bankCd` pada . *Value Bank Code* juga muncul pada *response* sebagai `bankCd`, `acqBankCd`, dan `issuerBankCode` . # Bank Code *** ## Virtual Account ::File{src="https://archbee-doc-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/gw_IEUSDphas02T3gjQYy_bank-code-virtual-account.csv" label="Bank Code - Virtual Account.csv"} | **Nilai** | **Deskripsi** | | --------- | ----------------------- | | `BMRI` | Mandiri | | `IBBK` | International Maybank | | `BBBA` | Permata | | `BBBB` | Permata Syariah | | `CENA` | Central Asia (BCA) | | `BNIN` | Negara 46 (BNI) | | `HNBN` | KEB Hana | | `BRIN` | Rakyat (BRI) | | `BNIA` | PT CIMB Niaga, Tbk. | | `BDIN` | PT Danamon , Tbk. | | `PDJB` | BJB | | `YUDB` | Neo Commerce (BNC) | | `BDKI` | Jakarta | | `BSYI` | Syariah | | `OTHR` | Other | ## Payout ::File{src="https://archbee-doc-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/WgOrNC_kjE1LHfEuIK_oT_bank-code-payout.csv" label="Bank Code - Payout.csv"} | **Value** | **Description** | | --------- | --------------------------------------- | | `ABAL` | BPD BALI | | `ABNA` | ROYAL BANK SCOTLAND | | `AGSS` | BANK AGRIS | | `AGTB` | BRI AGRONIAGA | | `AKTB` | BARCLAYS INDO | | `ANTD` | BANK ANTARDAERAH | | `ANZB` | BANK ANZ INDO | | `ARFA` | PANIN SYARIAH | | `ARTG` | BANK ARTHA GRAHA | | `ATOS` | BANK JAGO | | `AWAN` | BANK QNB INDO | | `BBAI` | BANK BUMI ARTA | | `BBBA` | PT BANK PERMATA, TBK | | `BBIJ` | BANK UOB INDO | | `BBUK` | BANK BUKOPIN | | `BCIA` | BANK CAPITAL INDO | | `BDIN` | BANK DANAMON | | `BDIP` | SAHABAT SAMPOERNA | | `BDKI` | BANK JAKARTA | | `BDPC` | BANK DANPAC | | `BDSY` | DANAMON SYARIAH | | `BHTL` | BANK HARMONI INTL | | `BICN` | COMMONWEALTH | | `BIDX` | BANK INDEX SELINDO | | `BJTM` | BANK JATIM | | `BKCH` | BANK OF CHINA | | `BKKB` | BANGKOK BANK | | `BMDM` | BANK MESTIKA DHARMA | | `BMRI` | MANDIRI | | `BMSE` | MULTI ARTA SENTOSA | | `BNIA` | CIMB NIAGA | | `BNIN` | BNI | | `BNPA` | BNP PARIBAS INDO | | `BOFA` | BANK OF AMERICA | | `BOTK` | MUFG BANK, LTD | | `BPIA` | RESONA PERDANIA | | `BPKO` | BANK PIKKO | | `BRIN` | BRI | | `BSYI` | BANK SYARIAH INDONESIA | | `BSSP` | BPD SUMSELBABEL | | `BTAN` | BTN | | `BUMI` | BANK MNC INTL | | `BUST` | KROM BANK INDONESIA | | `BUTG` | BANK MEGA SYARIAH | | `BVIC` | VICTORIA INTL | | `BWKI` | CHINA CONSTRUCTION | | `CENA` | BCA | | `CICT` | BANK MUTIARA | | `CITI` | CITIBANK | | `CNBA` | BANK CENTRATAMA | | `CTCB` | BANK CTBC INDO | | `DBSB` | DBS INDO | | `DEUT` | DEUTSCHE AG | | `EKON` | BANK HSBC INDO | | `EKST` | BANK PUNDI INDONESIA(KPO) | | `FAMA` | SUPERBANK | | `GNES` | BANK GANESHA | | `HNBN` | BANK KEB HANA | | `HRDA` | BANK HARDA INTL | | `HVBK` | WOORI SAUDARA INDO | | `IBBK` | MAYBANK INDO | | `ICBK` | BANK ICBC INDO | | `INDO` | BANK INDONESIA(KPO) | | `INPB` | BANK INA PERDANA | | `JSAB` | BANK JASA JAKARTA | | `KSEB` | BANK SEABANK INDONESIA | | `LFIB` | NOBU NATIONAL BANK | | `LMAN` | BANK DINAR INDO | | `LOMA` | BANK AMAR INDO | | `MASD` | BANK MASPION INDO | | `MAYA` | BANK MAYAPADA | | `MAYO` | BANK MAYORA | | `MBBE` | MAYBANK SYARIAH | | `MEEK` | BANK METRO EXPRESS | | `MEGA` | BANK MEGA TBK. | | `MGAB` | BANK MITRANIAGA | | `MHCC` | BANK MIZUHO INDO | | `MUAB` | BANK MUAMALAT | | `NISP` | OCBC NISP | | `NUPA` | BANK NUSANTARA | | `PDAC` | BANK ACEH | | `PDBK` | BPD BENGKULU | | `PDIJ` | BPD PAPUA | | `PDJB` | BANK JABAR | | `PDJG` | BPD JAWA TENGAH | | `PDJM` | BPD JAMBI | | `PDJT` | BANK JATIM SYARIAH | | `PDKB` | BPD KALBAR | | `PDKG` | BPD KALTENG | | `PDKS` | BPD KALSEL | | `PDKT` | BPD KALTIM | | `PDLP` | BPD LAMPUNG | | `PDML` | BPD MALUKU | | `PDNB` | BPD NTB | | `PDNT` | BPD NTT | | `PDRI` | BPD RIAU KEPRI | | `PDSB` | BPD SUMBAR | | `PDSU` | BPD SUMUT | | `PDWG` | BPD SULAWESITENGAH | | `PDWR` | BPD SULAWESITENGGARA | | `PDWS` | BANK SULSELBAR | | `PDWU` | BPD SULAWESIUTARA | | `PDYK` | BPD YOGYA SYARIAH | | `PINB` | PANIN | | `PMAS` | BANK PRIMA MASTER | | `PUBA` | BANK BTPN SYARIAH | | `RABO` | RABO BANK | | `RIPA` | BANK OKE INDO | | `ROYB` | BANK ROYAL INDO | | `SBID` | BANK SBI INDO | | `SBJK` | BANK SINARMAS | | `SCBL` | STANDARD CHARTERED | | `SDOB` | BUKOPIN SYARIAH | | `SIHB` | BANK SINAR HARAPAN | | `SUNI` | SUMITOMO MITSUI(KPO) | | `SWAG` | VICTORIA SYARIAH | | `SWBA` | BANK OF INDIA INDO | | `SYAC` | BPD ACEH SYARIAH | | `SYBK` | MAYBANK INDO UUS | | `SYBT` | BTN SYARIAH | | `SYCA` | BCA SYARIAH | | `SYDK` | BANK JAKARTA SYARIAH | | `SYJB` | BANK JABAR SYARIAH | | `SYKB` | BPD KALBAR SYARIAH | | `SYKS` | BPD KALSEL SYARIAH | | `SYKT` | BPD KALTIM SYARIAH | | `SYNA` | CIMB NIAGA SYARIAH | | `SYNI` | BNI SYARIAH | | `SYON` | OCBC NISP SYARIAH | | `SYSB` | BPD SUMBAR SYARIAH | | `SYSS` | BPD SUMSEL SYARIAH | | `SYSU` | BPD SUMUT SYARIAH | | `SYYK` | BPD YOGYA | | `TAPE` | BTPN | | `YUDB` | BANK YUDHA BAKTI | | `IDMC` | INDOMARET* | | `APID` | AIRPAY INTERNATIONAL | | `DANA` | ESPAY DEBIT INDONESIA KOE | | `CHAS` | JPMORGAN CHASE | | `NANO` | BANK NANO SYARIAH | | `SYAT` | BANK JAGO TBK UUS | | `ALSY` | BANK ALADIN SYARIAH TBK | | `SHBK` | BANK SHINHAN INDONESIA | | `SYJM` | BPD JAMBI UUS | *berlaku hanya untuk Cashout ## Advance API - Inquiry Detail ::File{src="https://archbee-doc-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/WkCre36tqG-Ovp8VqcoG__bank-code-advance-api-inquiry-detail.csv" label="Bank Code - Advance API - Inquiry Detail.csv" uploadAsPublic="true"} | **Value** | **Deskripsi** | | --------- | ----------------------- | | `BMRI` | Mandiri | | `IBBK` | International Maybank | | `BBBA` | Permata | | `BBBB` | Permata Syariah | | `CENA` | Central Asia (BCA) | | `BNIN` | Negara 46 (BNI) | | `HNBN` | KEB Hana | | `BRIN` | Rakyat (BRI) | | `BNIA` | PT CIMB Niaga, Tbk. | | `BDIN` | PT Danamon , Tbk. | | `OTHR` | Lain, *Unknown* | # Acquiring Bank Code *** ::File{src="https://archbee-doc-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/JcakQ9K8BAC4-ZpylG_7Y_bank-code-acquiring-bank-code.csv" label="Bank Code - Acquiring Bank Code.csv" uploadAsPublic="false"} | **Value** | **Deskripsi** | | --------- | --------------------- | | `BMRI` | Mandiri | | `BNIN` | Negara 46 (BNI) | | `CENA` | Central Asia (BCA) | | `BRIN` | Rakyat (BRI) | | `BNIA` | PT CIMB Niaga, Tbk. | # Issuing Bank Code *** ::File{src="https://archbee-doc-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/qSx0bykTCV9fscWi2B4Hm_bank-code-issuing-bank-code.csv" label="Bank Code - Issuing Bank Code.csv"} | **Value** | **Description** | | --------- | ------------------------- | | `ABAL` | BPD BALI | | `ABNA` | ROYAL SCOTLAND | | `AGSS` | BANK AGRIS | | `AGTB` | BRI AGRONIAGA | | `AKTB` | BARCLAYS INDO | | `ANTD` | BANK ANTARDAERAH | | `ANZB` | BANK ANZ INDO | | `ARFA` | PANIN SYARIAH | | `ARTG` | BANK ARTHA GRAHA | | `ATOS` | BANK JAGO | | `AWAN` | BANK QNB INDO | | `BBAI` | BANK BUMI ARTA | | `BBBA` | PT BANK PERMATA, TBK | | `BBIJ` | BANK UOB INDO | | `BBUK` | BANK BUKOPIN | | `BCIA` | BANK CAPITAL INDO | | `BDIN` | BANK DANAMON | | `BDIP` | SAHABAT SAMPOERNA | | `BDKI` | BANK JAKARTA | | `BDPC` | BANK DANPAC | | `BDSY` | DANAMON SYARIAH | | `BHTL` | BANK HARMONI INTL | | `BICN` | COMMONWEALTH | | `BIDX` | BANK INDEX SELINDO | | `BJTM` | BANK JATIM | | `BKCH` | BANK OF CHINA | | `BKKB` | BANGKOK BANK | | `BMDM` | BANK MESTIKA DHARMA | | `BMRI` | MANDIRI | | `BMSE` | MULTI ARTA SENTOSA | | `BNIA` | CIMB NIAGA | | `BNIN` | BNI | | `BNPA` | BNP PARIBAS INDO | | `BOFA` | BANK OF AMERICA | | `BOTK` | MUFG BANK, LTD | | `BPIA` | RESONA PERDANIA | | `BPKO` | BANK PIKKO | | `BRIN` | BRI | | `BSYI` | BANK SYARIAH INDONESIA | | `BSSP` | BPD SUMSELBABEL | | `BTAN` | BTN | | `BUMI` | BANK MNC INTL | | `BUST` | KROM BANK INDONESIA | | `BUTG` | BANK MEGA SYARIAH | | `BVIC` | VICTORIA INTL | | `BWKI` | CHINA CONSTRUCTION | | `CENA` | BCA | | `CICT` | BANK MUTIARA | | `CITI` | CITIBANK | | `CNBA` | BANK CENTRATAMA | | `CTCB` | BANK CTBC INDO | | `DBSB` | DBS INDO | | `DEUT` | DEUTSCHE AG | | `EKON` | BANK HSBC INDO | | `EKST` | BANK PUNDI INDONESIA(KPO) | | `FAMA` | SUPERBANK | | `GNES` | BANK GANESHA | | `HNBN` | BANK KEB HANA | | `HRDA` | BANK HARDA INTL | | `HVBK` | WOORI SAUDARA INDO | | `IBBK` | MAYBANK INDO | | `ICBK` | BANK ICBC INDO | | `INDO` | BANK INDONESIA(KPO) | | `INPB` | BANK INA PERDANA | | `JSAB` | BANK JASA JAKARTA | | `KSEB` | BANK KESEJAHTERAAN | | `LFIB` | NOBU NATIONAL BANK | | `LMAN` | BANK DINAR INDO | | `LOMA` | BANK AMAR INDO | | `MASD` | BANK MASPION INDO | | `MAYA` | BANK MAYAPADA | | `MAYO` | BANK MAYORA | | `MBBE` | MAYBANK SYARIAH | | `MEEK` | BANK METRO EXPRESS | | `MEGA` | BANK MEGA TBK. | | `MGAB` | BANK MITRANIAGA | | `MHCC` | BANK MIZUHO INDO | | `MUAB` | BANK MUAMALAT | | `NISP` | OCBC NISP | | `NUPA` | BANK NUSANTARA | | `PDAC` | BANK ACEH | | `PDBK` | BPD BENGKULU | | `PDIJ` | BPD PAPUA | | `PDJB` | BANK JABAR | | `PDJG` | BPD JAWA TENGAH | | `PDJM` | BPD JAMBI | | `PDJT` | BANK JATIM SYARIAH | | `PDKB` | BPD KALBAR | | `PDKG` | BPD KALTENG | | `PDKS` | BPD KALSEL | | `PDKT` | BPD KALTIM | | `PDLP` | BPD LAMPUNG | | `PDML` | BPD MALUKU | | `PDNB` | BPD NTB | | `PDNT` | BPD NTT | | `PDRI` | BPD RIAU KEPRI | | `PDSB` | BPD SUMBAR | | `PDSU` | BPD SUMUT | | `PDWG` | BPD SULAWESITENGAH | | `PDWR` | BPD SULAWESITENGGARA | | `PDWS` | BANK SULSELBAR | | `PDWU` | BPD SULAWESIUTARA | | `PDYK` | BPD YOGYA SYARIAH | | `PINB` | PANIN | | `PMAS` | BANK PRIMA MASTER | | `PUBA` | BANK BTPN SYARIAH | | `RABO` | RABO BANK | | `RIPA` | BANK OKE INDO | | `ROYB` | BANK ROYAL INDO | | `SBID` | BANK SBI INDO | | `SBJK` | BANK SINARMAS | | `SCBL` | STANDARD CHARTERED | | `SDOB` | BUKOPIN SYARIAH | | `SIHB` | BANK SINAR HARAPAN | | `SUNI` | SUMITOMO MITSUI(KPO) | | `SWAG` | VICTORIA SYARIAH | | `SWBA` | BANK OF INDIA INDO | | `SYAC` | BPD ACEH SYARIAH | | `SYBK` | MAYBANK INDO UUS | | `SYBT` | BTN SYARIAH | | `SYCA` | BCA SYARIAH | | `SYDK` | BANK JAKARTA SYARIAH | | `SYJB` | BANK JABAR SYARIAH | | `SYKB` | BPD KALBAR SYARIAH | | `SYKS` | BPD KALSEL SYARIAH | | `SYKT` | BPD KALTIM SYARIAH | | `SYNA` | CIMB NIAGA SYARIAH | | `SYNI` | BNI SYARIAH | | `SYON` | OCBC NISP SYARIAH | | `SYSB` | BPD SUMBAR SYARIAH | | `SYSS` | BPD SUMSEL SYARIAH | | `SYSU` | BPD SUMUT SYARIAH | | `SYYK` | BPD YOGYA | | `TAPE` | BTPN | | `YUDB` | BANK YUDHA BAKTI | [title] Cancel - API Credit Card [path] NICEPAY API/API Non-SNAP/Payment API/API Credit Card/ # Tentang Cancel - API Credit Card *** ini digunakan oleh untuk membatalkan sudah dibayarkan. :::hint{type="info"} Jika membatalkan sebelum selesai, maka tersebut dianggap **Void** dan dana tersebut akan dikembalikan ke . Namun, pembatalan setelah Settlement selesai, maka masuk dalam kategori **Refund.** untuk membuka [Penyelesaian Transaksi Pada Kartu Kredit](docId:4rCLEHp5GhD71y_aARfnQ) untuk mengetahui lebih lanjut mengenai istilah *Void *maupun *Refund.* ::: # Cancel - API Credit Card *** Cancel digunakan untuk membatalkan pada melalui . | **API Endpoint** | `/nicepay/direct/v2/cancel` | | ------------------ | ----------------------------------------------------- | | **Request Method** | **POST****** | | **Header** | `Content-Type: application/json` | | **Merchant Token** | SHA256(`timeStamp`+`iMid`+`tXid`+`amt`+`merchantKey`) | ## Request Parameters for Cancel - API Credit Card *** Berikut ini adalah daftar untuk melakukan *request * *cancel payment* pada . Parameter ini digunakan melalui platform pengujian . | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | | --------------------------------------------------------------------- | -------- | ---------- | ------------------------------------------------------------------------------------------ | ---------------------------------------------------------------- | ------------------------ | | `timeStamp`
Required | N | 14 | Request Timestamp | 20221214111239 | | | `tXid`
Required | AN | 30 | Transaction ID
| IONPAYTEST01202212141146401456 | | | `iMid`
Required | AN | 10 | ID
| IONPAYTEST | | | `payMethod`
Required | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | 01 | | | `cancelType`
Required | N | 2 | [Cancel Type Code](docId\:Mq9xE7wdOPR8OkZ3v-pVc)
| 2 | | | `merchantToken`
Required | AN | 255 | Token
| ff139e49606387091cd9baeadff3161aff6afd9406e1f481e0fdb8b46d1ae5ae | | | `referenceNo` | ANS | 40 | Reference Number | ordNo20221214111208 | | | `amt`
Required | N | 12 | Amount
| 1000 | | | `cancelMsg` | AN | 255 | Cancel Message | Cancellation Of Transaction | | | `cancelServerIp` | AN | 15 | Server IP | 127.0.0.1 | | | `cancelUserId` | AN | 30 | User ID | Admin | | | `cancelUserIp` | AN | 15 | User IP | 127.0.0.1 | | | `cancelUserInfo` | AN | 100 | User Information | Test Cancel | | | `cancelRetryCnt` | N | 2 | Retry Count | 5 | | | `cancelReferenceNo`
Optional For CC | AN | 40 | Cancel Number | ordNo20221214111208 | ordNo20221214111208 | | `worker` | AN | 10 | Worker | Worker | | ## Response Parameter for Cancel - API Credit Card *** Berikut adalah *response* dari hasil *request* untuk *cancel handling* : | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | --------------------------------------------------------------------- | -------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- | | `resultCd` | N | 4 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) [ ](https://app.archbee.com/docs/36sM2OxRIwwbi9iNlqMTP/wpcEMaZro_Xvnxz-1ZAiB) | 0000 | | `resultMsg` | AN | 255 | Result Message: [Error Code](docId\:yEh1VA9k2y6sL1kQF2aWD) | SUCCESS | | `tXid` | AN | 30 | Transaction ID | IONPAYTEST01202212141146401456 | | `referenceNo` | ANS | 40 | Order Number | ordNo20221214111208 | | `transDt` | N | 8 | Transaction Date | 20221214 | | `transTm` | N | 6 | Transaction Time | 114640 | | `amt` | N | 12 | Amount | 5000 | | `cancelReferenceNo`
Optional For CC | AN | 40 | Cancel Number | ordNo20221214111208 | | `acquirerData`
Only For CC | Array | 20 | A dynamic array consisting of a unique reference number RRN that is provided by ing when a refund is ed. This reference number can be used by to track of refund with . | `"acquirerData": {`
` "rrn":"332608321717"`
` }` | ## Sample Parameter for Cancel - API Credit Card *** ### Request Parameter :::CodeblockTabs cURL ```curl curl --location 'https://dev.nicepay.co.id/nicepay/direct/v2/cancel' \ --header 'Content-Type: application/json' \ --data '{ "timeStamp": "20251008131011", "payMethod": "01", "tXid": "IONPAYTEST01202509241944339756", "iMid": "IONPAYTEST", "merchantToken": "45505e04460a30418c425506e6b53295cc548b7ec11dd6685b0bf669e26c8db6", "referenceNo":"OrdNo20250924194433", "amt": "10000", "cancelType": "2", "cancelMsg": "Cancellation Of Transaction", "cancelServerIp": "127.0.0.1", "cancelUserId": "", "cancelUserIp": "127.0.0.1", "cancelUserInfo": "", "cancelRetryCnt": "", "cancelReferenceNo": "OrdNo20250924194433", "worker": "" }' ``` Node.js ```nodejs const config = { isProduction: false, privateKey: cons.privateKey, clientSecret: cons.clientSecret, clientId: cons.clientId, isCloudServer: false, merchantKey: cons.merchantKey, }; let parameterCancel = { timeStamp: "20251008131011", payMethod: "01", tXid: "IONPAYTEST01202509241944339756", iMid: "IONPAYTEST", merchantToken: "45505e04460a30418c425506e6b53295cc548b7ec11dd6685b0bf669e26c8db6", referenceNo: "OrdNo20250924194433", amt: "10000", cancelType: "2", cancelMsg: "Cancellation Of Transaction", cancelServerIp: "127.0.0.1", cancelUserId: "", cancelUserIp: "127.0.0.1", cancelUserInfo: "", cancelRetryCnt: "", cancelReferenceNo: "OrdNo20250924194433", worker: "", }; let secondVersion = new SecondApiVersion(config); response = secondVersion.requestAPI(parameterCancel, "/direct/v2/cancel"); ``` ```java NICEPayConfig configCc = NICEPay.builder() .isProduction(false) .isCloudServer(false) .partnerId("IONPAYTEST") .build(); String txId = "IONPAYTEST01202509241944339756"; // from JSON String amount = "10000"; String reffNo = "OrdNo20250924194433"; Cancel requestCancel = Cancel.builder() .timeStamp("20251008131011") .tXid(txId) .referenceNo(reffNo) .merchantToken( "20251008131011", "IONPAYTEST", txId, amount, "YOUR_MERCHANT_KEY" ) .iMid("IONPAYTEST") .payMethod("01") .cancelType("2") .amt(amount) .cancelMsg("Cancellation Of Transaction") .cancelUserIp("127.0.0.1") .cancelServerIp("127.0.0.1") .cancelUserInfo("") .cancelRetryCnt("") .cancelReferenceNo("OrdNo20250924194433") .worker("") .build(); NICEPayResponseV2 result = V2CancelService.callV2CancelTransaction(requestCancel, configCc); ``` ```python bodyCancel = ( builderCancel.BuildCancel() .setPayMethod("01") .setTxid("IONPAYTEST01202509241944339756") .setReferenceNo("OrdNo20250924194433") .setCancelUserId("") .setCancelType("2") .setCancelMsg("Cancellation Of Transaction") .setAmt("10000") .setCancelServerIp("127.0.0.1") .setCancelUserIp("127.0.0.1") .setCancelUserInfo("") .setCancelRetryCnt("") .setCancelReferenceNo("OrdNo20250924194433") .setWorker("") .build() ) environment = ( builderEnvironment.BuildEnvironment() .isCloud(True) .isProduction(False) .build() ) response = ServiceNicepay.serviceCancel(DataGenerator.getCancelBody(bodyCancel.jsonCancel()), environment) ``` C# ```csharp string merchantKey = config.MerKey; string clientId = config.ClientId; string timestamp = "20251008131011"; string amount = "10000"; string txid = "IONPAYTEST01202509241944339756"; string referenceNo = "OrdNo20250924194433"; bool isProduction = false; bool isCloudServer = false; // ✅ Build Merchant Token (keep original logic) var builder = new MerchantTokenBuilder() .SetTimeStamp(timestamp) .SetIMid(clientId) .SetTXid(txid) .SetAmount(amount) .SetMerchantKey(merchantKey); string merchantToken = builder.BuildCancelMerchantToken(); // ✅ Build Cancel Request Body var Bodybuilder = new NicepayRequestBuilder() .SetCancel( iMid: "IONPAYTEST", timeStamp: timestamp, tXid: txid, amt: amount, merchantToken: merchantToken, payMethod: "01", cancelType: "2", cancelMsg: "Cancellation Of Transaction", cancelUserId: "", cancelServerIp: "127.0.0.1", cancelRetryCnt: "", cancelReferenceNo: "OrdNo20250924194433" ); // ✅ Prepare API endpoint and send request ApiEndpoints apiEndpoints = new ApiEndpoints(); Dictionary payload = Bodybuilder.Build(); string jsonPayload = Newtonsoft.Json.JsonConvert.SerializeObject(payload, Newtonsoft.Json.Formatting.Indented); var registrationService = new NicepayRegistrationService(apiEndpoints, isProduction, isCloudServer); var result = await registrationService.SendPostAsync(apiEndpoints.CancelV2, payload); ``` Laravel ```php protected $useProd = false; protected $useCloud = false; protected $cancel_endpoint = "/nicepay/direct/v2/cancel"; $url = HttpUtil::getNicepayDomain($this->useProd, $this->useCloud) . $this->cancel_endpoint; // Request body parameter $timestamp = "20251008131011"; $txid = "IONPAYTEST01202509241944339756"; $reference_no = "OrdNo20250924194433"; $amt = "10000"; $merchant_token = "45505e04460a30418c425506e6b53295cc548b7ec11dd6685b0bf669e26c8db6"; $body = [ "timeStamp" => $timestamp, "tXid" => $txid, "iMid" => "IONPAYTEST", "referenceNo" => $reference_no, "payMethod" => "01", "merchantToken" => $merchant_token, "amt" => $amt, "cancelMsg" => "Cancellation Of Transaction", "cancelType" => "2", "cancelServerIp" => "127.0.0.1", "cancelUserId" => "", "cancelUserIp" => "127.0.0.1", "cancelUserInfo" => "", "cancelRetryCnt" => "", "cancelReferenceNo" => "OrdNo20250924194433", "worker" => "" ]; $response = HttpUtil::postJsonRequest($url, $body); ``` PHP Native ```php $config = $this->configV2; $timestamp = "20251008131011"; $txId = "SHOPEETEST01202410111242218557"; $reffNo = "ordCancel20251008131011"; $iMid = "SHOPEETEST"; $amount = "1000"; $requestBody = Cancel::builder() ->setTimeStamp($timestamp) ->setPayMethod("01") ->setTXid($txId) ->setIMid($iMid) ->setMerchantToken($timestamp, $iMid, $txId, $amount, $this->merchantKey) ->setReferenceNo($reffNo) ->setAmt($amount) ->setCancelType("2") ->setCancelMsg("Cancelation of Card Trans with PHP Native") ->setCancelUserIp("127.0.0.1") ->setCancelUserId("") ->setCancelUserInfo("") ->setCancelRetryCnt("") ->setCancelReferenceNo("OrdNo20250924194433") ->setWorker("") ->build(); $cardService = new V2CardService($config); $response = $cardService->cancel($requestBody); ``` ```kotlin val request: DirectV2Cancel = DirectV2Cancel.Builder() .timeStamp("20251008131011") .tXid("IONPAYTEST01202509241944339756") .iMid("IONPAYTEST") .merchantKey("YOUR_MERCHANT_KEY") .referenceNo("OrdNo20250924194433") .amt("10000") .payMethod("01") .cancelType("2") .cancelReferenceNo("OrdNo20250924194433") .build() val response: NICEPayResponseV2 = v2CardService.cancel(request, config)!! ``` CodeIgniter ```php $config = $this->configV2; $timestamp = "20251008131011"; $txId = "IONPAYTEST01202509241944339756"; $amount = "10000"; $reffNo = "OrdNo20250924194433"; $requestBody = Cancel::builder() ->setTimeStamp($timestamp) ->setIMid($this->iMid) ->setTXid($txId) ->setReferenceNo($reffNo) ->setMerchantToken($timestamp, $this->iMid, $txId, $amount, $this->merchantKey) ->setPayMethod("01") ->setCancelType("2") ->setAmt($amount) ->setCancelReferenceNo("OrdNo20250924194433") ->build(); $v2VaService = new V2VAService($config); $response = $v2VaService->cancel($requestBody); ``` ::: ### Response Parameter :::CodeblockTabs Sample Response ```json { "tXid": "IONPAYTEST01202509241944339756", "referenceNo": "OrdNo20250924194433", "resultCd": "0000", "resultMsg": "SUCCESS", "transDt": "20250924", "transTm": "194433", "description": "This is testing transaction", "amt": "10000", "cancelReferenceNo": "OrdNo20250924194433", "acquirerData": { "rrn": null } } ``` ::: [title] Kartu Kredit [path] Payment/ ::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/kQRBsR0pJbHRSP_2OKJje_lumios-typewriter-old.png" size="80" width="1920" height="1080" caption="Kartu Kredit" position="center" darkWidth="1920" darkHeight="1080" alt="Kartu Kredit" showCaption="true"} # Tentang Kartu Kredit *** **Kartu Kredit** adalah sebuah alat digunakan sebagai pengganti uang tunai dan dikeluarkan oleh *Issuer *sebagai penerbit kartu atas pengajuan nasabah untuk dapat digunakan dalam sehari-hari. Nilai dan volume dengan secara *online* telah meningkat secara signifikan dalam beberapa tahun terakhir ini. Berdasarkan laporan (BI) pada periode Juni 2021 - Juni 2022, nilai menggunakan mencapai Rp 26.62 trilliun rupiah dengan rata-rata mencapai angka hampir 28 juta per bulan. Hal tersebut membuktikan bahwa menggunakan pada *online* adalah hal mudah, cepat, dan aman dilakukan oleh . telah mendapatkan kepercayaan dari para dalam melayani lancar dan aman, sehingga tidak perlu khawatir untuk ber- dengan . :::hint{type="info"} juga menerima Kartu Debit melalui sama dengan . ::: ## Keunggulan Menggunakan Metode Kartu Kredit Bersama NICEPAY *** - Miliki banyak dukungan dengan mudah baik domestik maupun internasional. sudah didukung oleh Visa, Mastercard, JCB, dan American Express, serta telah tersertifikasi **PCI DSS Level 1**. - perlu memiliki sertifikat PCI DSS pada untuk dapat melakukan secara *online*. Namun, tidak perlu khawatir karena sudah resmi bersertifikat PCI DSS, sehingga tidak diperlukan untuk melakukan pengajuan sertifikasi PCI DSS untuk dapat bertransaksi dengan secara *online*. :::hint{type="info"} **PCI DSS** (*Payment Card Industry Data Security Standard*) adalah suatu standar keamanan untuk perusahaan menangani melalui beserta jaringannya. Standar PCI DSS ini diwajibkan untuk dipatuhi oleh Payment Card Industry Security Standards Council. Adapun terdapat 4 jenis level untuk PCI DSS yang di mana level 1 adalah level tertinggi dari jenis validasi tingkat keamanannya. ::: - Beragam [Fitur Kartu Kredit](docId\:cgLxG10p9zmVtuX_-b7ga) tersedia mulai dari Full Payment, Installment, Recurring, Pre-authorization & Capture, dan Tokenization. - Proteksi dengan FDS (*Fraud Detection System*), deteksi dini aksi penipuan untuk *online* . - Metode pada telah dilengkapi dengan fitur 3Ds (*Three Domain Secure*) 2.0, didukung oleh Visa Secure, Mastercard Identity Check, American Express Safety Key, dan J/Secure, yaitu protokol keamanan mampu memproteksi penipuan bertransaksi *online* melalui autentikasi OTP dengan pemegang kartu. - juga memiliki opsi pilihan melakukan tanpa memasukkan OTP. - Monitoring segala pada dengan mudah melalui [Merchant Back Office](docId\:VMD8YtiiJqku6H8dRhcS6). # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [API Credit Card](docId:3UQNpJZ5YX-Ew2N3wxM0K) untuk mengetahui rincian digunakan pada . ::: :::VerticalSplitItem ::: :::: [title] Integrasi & Testing Kartu Kredit [path] Payment/Kartu Kredit/ Proses Integrasi dan Testing untuk . # Langkah Integrasi & API yang digunakan *** 1. Lakukan Call Transaction Registration. - Direct: [Registration - API Credit Card](docId\:LNVo8u5nDYbxuMSZN748m). - Redirect: [Credit Card - API Checkout](docId\:uue8Nk9jvMflKwGFDjm2J). 2. Lakukan Call Payment Charge. - Direct: [Payment - API Credit Card](docId\:FcJslW1q-2oJhb0HWqJsj). - Redirect: [Payment - API Checkout](docId\:YnNFZr9aonpJ7ZIKAFYSx). 3. Menerima *callback *dan *push notification *dari . 4. Lakukan Check Status. - Direct: [Status Inquiry - API Credit Card](docId\:voJ9rhAQRLcF-_74cYrFi). - Redirect: [Status Inquiry - API Checkout](docId\:K9vBS87ev9_w5oJAU0et3). 5. Opsional: Lakukan Cancel untuk membatalkan . 1. Direct: [Cancel - API Credit Card](docId\:wtiAnrXNbTTfKUY8FFEIo). 2. Redirect: [Cancel - API Checkout](docId\:MMmlusWDkyUsJxF421yKn). # Cara Uji Coba Kartu Kredit *** | **Langkah Tes** | **Aturan dan Kondisi** | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 1. Gunakan *Real Card* atau *Dummy Card* dimulai `45xxxx` atau `54xxxxx`. 2. Ketik nomor akun ke sisi laman dengan `accountNo`. 3. dan lanjutkan tersebut hingga sukses. | 1) Transaksi akan di-*settle* berdasarkan peraturan . 2) Penggunaan kartu secara otomatis akan mengurangi limit kartu. 3) Pada *void* (dibatalkan pada hari sama sebelum waktu *cut-off* ), dana *void* akan langsung dikembalikan kepada limit secara *real-time.* 4) Kartu terblokir adalah tanggung jawab Pengguna jika ditemukan kecurangan dalam (*Fraud*). | **** # Alasan Peluang Transaksi Gagal *** 1. Kartu tidak aktif. 2. Kartu kedaluwarsa. 3. Nomor kartu tidak valid. 4. Tanggal kedaluwarsa tidak valid. 5. CVV tidak valid. 6. Jaringan *Issuer* tidak mendukung. 7. Limit penggunaan kartu harian sudah mencapai batas. 8. Visa 3Ds. :::hint{type="info"} kunjungi [Error Code](docId\:yEh1VA9k2y6sL1kQF2aWD) untuk melihat *error* lebih lengkap. ::: # Integration Checklist & Test Case *** - [ ] Implementasi status inquiry setelah mendapatkan *callback.* - [ ] Implementasi status inquiry setelah mendapatkan di dalam `dbProcessUrl`. - [ ] Meninjau *log* . - [ ] Meninjau pengaturan firewall (eg. cloudflare untuk pengaturan `dbprocessUrl`). - [ ] Memeriksa implementasi `merchantToken`. - [ ] Menjalankan tes skenario pada *Development Environment.* - [ ] Menjalankan tes skenario pada *Production Environment.* [Get Sample Scenario](https://docs.google.com/spreadsheets/d/e/2PACX-1vQIaIMCM0vZ3L1cA-JkW3YxyIpjsB966fg1wTeT8qpFDowEvulIEWOoY6I4uJPL3A/pub?output=xlsx) - [ ] Meninjau *Error Handling* (*Timeout, Failed, Negative Case*). # Fitur Kartu Kredit *** - Full , untuk satu kali *charge* berlangsung. - Installment , untuk *charge* cicilan mengikuti tenor . - Recurring , untuk berulangan menggunakan token . - Pre-Auth & Capture , untuk Pre-Auth sebelum *final charge* Capture pada . :::hint{type="info"} Pelajari lebih lengkap mengenai fitur dari pada [Fitur Kartu Kredit](docId\:cgLxG10p9zmVtuX_-b7ga). ::: # Best Practice *** - Untuk uji coba , dapat memasang `recurrOpt automatic Cancel`. Pelajari teknis pemasangan Recurring Token di [API Credit Card](docId\:cyRgujq86sHzFaLML0S1E). - *Cancel *untuk mendukung *full cancel* (pembatalan penuh) dan *partial cancel *(pembatalan sebagian). Pelajari lebih lanjut mengenai [Cancel Type Code](docId\:Mq9xE7wdOPR8OkZ3v-pVc). - Setelah ke `dbProcessUrl` diterima, merekomendasikan untuk melakukan verifikasi *notification *menggunakan Inquiry . Pelajari mengapa inquiry sangat penting untuk pada [Status Inquiry - API Checkout](docId\:K9vBS87ev9_w5oJAU0et3) dan [Status Inquiry - API Credit Card](docId\:voJ9rhAQRLcF-_74cYrFi). - `Notification Handling` berguna untuk meminimalisir aksi *Fraud*, sangat merekomendasikan untuk melakukan verifikasi `Notification Handling`. :::hint{type="danger"} ⚠️Sangat penting untuk melakukan pemeriksaan terhadap Notifikasi dan Inquiry. Lihat \{} lebih lengkap di [Notification - API Credit Card](docId\:kC5XHZ2fbwmcDcmh2iBJ5) / [Notification - API Checkout](docId:0BfdvETd5MPDBAkFzIVBE). ::: # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Alur Pembayaran Kartu Kredit](docId\:i33-9_tZc9P783QJAsX-d) untuk mengetahui pada saat melakukan dengan . ::: :::VerticalSplitItem [Fitur Kartu Kredit](docId\:cgLxG10p9zmVtuX_-b7ga) untuk mengetahui fitur pada . ::: :::: ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Daftar Istilah Kartu Kredit](docId\:BBKv4-thEkBPrsCzI6QRe) untuk mengetahui istilah khusus digunakan oleh . ::: :::VerticalSplitItem [FAQ Kartu Kredit](docId\:k9Fux2-dg-nCUDyI38UgF) jika ingin mengetahui pertanyaan sering diajukan terkait . ::: :::: [title] Fitur VA [path] Payment/Virtual Account (VA)/ Berikut ini adalah fitur terdapat dalam di : 1. *Normal Closed* 2. *Normal Open* 3. *Fixed Closed* 4. *Fixed Open* # Istilah VA Secara Umum *** | **Istilah** | ***Supporting Bank(s)*** | **Deskripsi** | | --------------- | --------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Normal Account | BCA, Mandiri, BRI, Permata, KEB Hana, BNI, Danamon, Maybank, BDKI, BJB, BNC, CIMB | Nomor VA akan secara otomatis dibuat secara acak sesuai dengan limit nomor virtual per oleh . | | Fixed Account | BCA, Mandiri, BRI, Permata, KEB Hana, BNI, Danamon, Maybank, BJB, CIMB, BNC | Nomor VA ini bersifat statis dan dapat dibuat sesuai keinginan seperti nomor terkait dengan identitas biasanya diwakili oleh nomor HP ataupun dapat juga dibuat secara acak oleh secara otomatis sesuai dengan limit nomor virtual per . | | Open Amount | BCA, Mandiri, BRI, Permata, KEB Hana, BNI, Danamon, Maybank, BJB, CIMB | Tipe dapat menerima nominal dari berapa pun jumlahnya. | | Variable Amount | BCA | dapat membayar tagihan dengan nominal mereka inginkan ataupun ditentukan oleh pada periode waktu tentukan juga. | | Closed Amount | BCA, Mandiri, BRI, Permata, KEB Hana, BNI, Danamon, Maybank, BJB, BDKI, BNC, CIMB | Proses pembayarannya akan berhasil apabila nominal dibayarkan oleh sesuai dengan nominal ditentukan oleh .

Dengan demikian, wajib untuk mengatur *field* *amount* nomor VA tersebut sebelum terjadi. | # Tipe VA dari Proses Pembuatan & Penyimpanan Nomor *** | **Pihak yang *****generate***** nomor VA** | **Bank yang Mendukung** | **Deskripsi** | | ---------------------------------------------------- | --------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | | | BCA, Mandiri, BRI, Permata, KEB Hana, Danamon, BJB, BNI, Maybank, CIMB, BNC & DKI | membuat nomor VA nantinya akan validasi sebelum diberlakukan. Nomor VA disimpan di sisi . | | | BCA, Mandiri, BRI, Permata, KEB Hana, Danamon, Maybank, CIMB | membuat nomor VA nantinya akan validasi sebelum diberlakukan. Nomor VA disimpan di sisi . | | | BNC | membuat nomor VA nantinya akan validasi sebelum diberlakukan. | # Perbedaan Antara Variable Amount di VA dengan Installment di Kartu Kredit atau Payloan *** | **Variable VA** | **Installment Kartu Kredit atau Payloan** | | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | | Tidak ada bunga | Ada bunga | | Jangka waktu cenderung lebih singkat | Jangka waktu cenderung lebih lama | | Dapat dicicil sesuai dengan nominal keinginan dengan periode waktu setujui oleh dan | Harus dicicil sesuai dengan nominal sudah ditetapkan oleh pihak pada periode waktu di setujui oleh | # See also ::::VerticalSplit :::VerticalSplitItem [Alur Pembayaran VA](docId\:lL0aeF-P7zmvqABj6Oq8G) untuk mengetahui pada saat melakukan dengan . ::: :::VerticalSplitItem [Integrasi & Testing VA](docId\:sts64cm0VYN3Q8_quNq23) untuk mengetahui cara dan uji coba . ::: :::: ::::VerticalSplit :::VerticalSplitItem [Daftar Istilah VA](docId:2xrW5DVjK-076w2JsQvI8) untuk mengetahui istilah khusus digunakan oleh . ::: :::VerticalSplitItem [FAQ VA](docId\:n5d3A27rcZ6_ZxBN-sIIs) jika ingin mengetahui pertanyaan sering diajukan terkait . ::: :::: [title] Bank Permata [path] Payment/Virtual Account (VA)/Panduan Bayar VA/ ![](https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-T1X2qwHxleKbB1GLoP5lv-20241119-073022.png "Permata Bank") :::hint{type="info"} Pastikan melakukan transfer dana sebelum masa berlaku habis dan dengan nominal tepat. ::: | **Nomor Virtual Account** | `86250XXXXXXXXXXX` | | ------------------------- | --------------------------- | | **Bank** | Permata | | **Nominal** | Rp 10.000 | | **Nama Penerima** | `Merchant Name - billingNm` | | **Nomor Order** | Invoice-1234 | | **Masa Berlaku** | 16-06-2016 / 17:15:00 | file format JSON Panduan Bayar Bank Permata untuk operasi . ::File{src="https://archbee-doc-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/O7yFMY1G4eZquAKhLlooP_va-ind-permata.json" label="VA_IND_PERMATA.json"} # ATM *** 1. kartu `ATM` dan `PIN` . 2. `Transaksi Lainnya`. 3. `Pembayaran`. 4. `Pembayaran Lain-Lain`. 5. `Virtual Account`. 6. `Nomor Virtual Account`, misal `86250XXXXXXXXXXX` sebagai kode bayar. 7. `Benar`. 8. `Ya`. 9. Simpan bukti . 10. Selesai. # Mobile Banking *** 1. Akses aplikasi `Mobile Banking`. 2. `Pembayaran Tagihan`. 3. `Virtual Account`. 4. `Nomor Virtual Account`, misal `86250XXXXXXXXXXX` sebagai kode bayar. 5. `Nominal`, misal `10000`. 6. `Kirim`. 7. `Token`. 8. `Kirim`. 9. Bukti akan ditampilkan. 10. Selesai. # Internet Banking *** 1. Akses `Internet Banking`. 2. `Pembayaran Tagihan`. 3. `Virtual Account`. 4. `Nomor Virtual Account`, misal `86250XXXXXXXXXXX` sebagai kode bayar. 5. `Nominal` , misal `10000`. 6. `Kirim`. 7. `Token`. 8. `Kirim`. 9. Bukti akan ditampilkan. 10. Selesai. [title] Integrasi & Testing VA [path] Payment/Virtual Account (VA)/ Proses dan untuk mencakup 6 fitur . Fitur tersebut, antara lain *Normal Close*, *Normal Open*, *Fixed Close*, *Fixed Open*, *NICEPAY Inquiry Virtual Account Close*, dan *NICEPAY Inquiry Virtual Account Open*. # Langkah Integrasi & API yang Digunakan *** 1. Lakukan Call Transaction Registration. - SNAP: [Registration - API Virtual Account SNAP](docId\:K4DeuHcQ_4pSto2beLqb7). - Redirect: [Virtual Account - API Checkout](docId:-D655p6HMEzTcUQJKnxbL). 2. Menerima *callback *dan *push notification *dari . 3. Lakukan Status Inquiry. - SNAP: [Check Status Transaction - API Virtual Account SNAP](docId\:xaW0SxwKv9j7b5zLbtVpR). - Redirect: [Status Inquiry - API Checkout](docId\:K9vBS87ev9_w5oJAU0et3). 4. Opsional: lakukan Cancel untuk membatalkan . - SNAP: [Cancel - API Virtual Account SNAP](docId\:vN3l9wxp-CA7deDK7AtM8). - Redirect: [Cancel - API Checkout](docId\:MMmlusWDkyUsJxF421yKn). # Cara Uji Coba Virtual Account *** | **Langkah Tes** | **Aturan dan Kondisi** | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 1. Menggunakan MID atau MID sandbox (`IONPAYTEST`) AutoPaid. 2. Membuat Regist 3. Masuk ke aplikasi MBanking atau Internet Banking. 4. Memeriksa inquiry payment . 5. Konfirmasi . 6. Transaksi berhasil. 7. Memeriksa (`dbProcessUrl`). | 1) Transaksi akan di-*settle *berdasarkan peraturan . 2) Ketika berhasil, pada akun akan segera berkurang sesuai dengan nominal dibayarkan pada . 3) Transaksi sudah melalui tidak bisa dibatalkan. | # Alasan Peluang Transaksi Gagal *** 1. Nomor VA / nomor tagihan tidak ditemukan. 2. Kode perusahaan tidak terdaftar. 3. Memasukkan nomor VA salah. 4. Waktu sudah habis sehingga nomor VA sudah tidak bisa digunakan. 5. Pembayaran dengan nomor VA berhasil tetapi terkena *timeout *dari . # Integration Checklist & Test Case *** - [ ] Implementasi status inquiry setelah mendapatkan *callback.* - [ ] Implementasi status inquiry setelah mendapatkan di dalam `dbProcessUrl`. - [ ] Meninjau *log *. - [ ] Meninjau pengaturan firewall (eg. cloudflare untuk pengaturan `dbprocessUrl`). - [ ] Memeriksa implementasi `merchantToken`. - [ ] Menjalankan tes skenario pada *Development Environment*. - [ ] Menjalankan tes skenario pada *Production Environment*. [Get Sample Scenario](https://docs.google.com/spreadsheets/d/e/2PACX-1vQIaIMCM0vZ3L1cA-JkW3YxyIpjsB966fg1wTeT8qpFDowEvulIEWOoY6I4uJPL3A/pub?output=xlsx)**** - [ ] Meninjau *Error Handling* (*Timeout, Failed, Negative Case*). # Best Practice *** - Untuk uji coba , dapat memasang `merFixAcctld`. Pelajari lebih lanjut mengenai [API Virtual Account SNAP](docId:2XCcJFVmwY9jDmD6w09oN), [Virtual Account Static](docId\:TlvtOb_yPO_kFiaaVTqb6). - Cancel mendukung untuk membatalkan secara penuh dan sebagian. Pelajari lebih lanjut mengenai [Cancel Type Code](docId\:Mq9xE7wdOPR8OkZ3v-pVc). - Ketika diterima pada `dbProcessUrl` , sangat merekomendasikan untuk melakukan verifikasi menggunakan Inquiry . - `Notification Handling` berguna untuk meminimalisir aksi *Fraud*, sangat merekomendasikan untuk melakukan verifikasi `Notification Handling`. # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Alur Pembayaran VA](docId\:lL0aeF-P7zmvqABj6Oq8G) untuk mengetahui pada saat melakukan dengan . ::: :::VerticalSplitItem [Fitur VA](docId\:GnUAAyq81JNJ8UNRanWUZ) untuk mengetahui fitur pada . ::: :::: ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Daftar Istilah VA](docId:2xrW5DVjK-076w2JsQvI8) untuk mengetahui istilah khusus digunakan oleh . ::: :::VerticalSplitItem [FAQ VA](docId\:n5d3A27rcZ6_ZxBN-sIIs) jika ingin mengetahui pertanyaan sering diajukan terkait . ::: :::: [title] Bank BCA [path] Payment/Virtual Account (VA)/Panduan Bayar VA/ ::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/RPhJPqDXXtb7vDJy4nX3I_bca.jpg" size="50" width="500" height="500" caption="Bank BCA" position="center" darkWidth="500" darkHeight="500" showCaption="true"} :::hint{type="info"} Pastikan melakukan transfer dana sebelum masa berlaku habis dan dengan nominal tepat. ::: | **Nomor Virtual Account** | `10859XXXXXXXXXXX ` | | ------------------------- | --------------------------- | | **Bank** | BCA | | **Nominal** | Rp10.000 | | **Nama Penerima** | `Merchant Name - billingNm` | | **Nomor Order** | Invoice-1234 | | **Masa Berlaku** | 16-06-2016 / 17:15:00 | file format JSON Panduan Bayar Bank BCA untuk operasi . ::File{src="https://archbee-doc-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/S6ETtmPKyX37Sbl-zv5TW_va-ind-bca.json" label="VA_IND_BCA.json"} # ATM *** 1. kartu `ATM` dan `PIN` . 2. menu `Transaksi Lainnya`. 3. `Transfer`. 4. `Ke Rekening BCA Virtual Account.` 5. `Nomor Virtual Account`, misal `10859XXXXXXXXXXX` sebagai kode bayar. 6.  `Ya`. 7. Ambil bukti bayar . 8. Selesai. # Mobile Banking *** 1. Login `Mobile Banking`. 2. `m-Transfer`. 3. `BCA Virtual Account`. 4. `Nomor Virtual Account`, misal `10859XXXXXXXXXXX` sebagai kode bayar. 5.  `Send`. 6. Informasi `Virtual Account` akan ditampilkan. 7.  `OK`. 8. Input `PIN`Mobile Banking. 9. Bukti bayar ditampilkan. 10. Selesai. # Internet Banking *** 1. Login Internet Banking. 2.  `Transaksi Dana`. 3.  `Transfer Ke BCA Virtual Account`. 4. `Nomor Virtual Account`, misal `10859XXXXXXXXXXX` sebagai kode bayar. 5.  `Lanjutkan`. 6. Input `Respon KeyBCA Appli 1`. 7.  `Kirim`. 8. Bukti bayar ditampilkan. 9. Selesai. [title] Bank KEB Hana [path] Payment/Virtual Account (VA)/Panduan Bayar VA/ ::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/MgZ3xdnaFH_M11KuBeQNc_kebhana.jpg" size="50" width="500" height="500" caption="Bank KEB Hana" position="center" darkWidth="500" darkHeight="500" showCaption="true"} :::hint{type="info"} Pastikan melakukan transfer dana sebelum masa berlaku habis dan dengan nominal tepat. ::: | **Nomor Virtual Account** | `97720XXXXXXXXXXX` | | ------------------------- | --------------------------- | | **Bank** | KEB Hana | | **Nominal** | Rp10.000 | | **Nama Penerima** | `Merchant Name - billingNm` | | **Nomor Order** | Invoice-1234 | | **Masa Berlaku** | 16-06-2016 / 17:15:00 | file format JSON Panduan Bayar Bank KEB Hana untuk operasi . ::File{src="https://archbee-doc-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/t1QdlS0Q_0PgegBO2ZHYe_va-ind-hana.json" label="VA_IND_HANA.json"} # ATM *** 1. kartu `ATM` dan `PIN` . 2. `Pembayaran`. 3. `Lainnya`. 4. `Nomor Virtual Account`, misal `97720XXXXXXXXXXX` sebagai kode bayar. 5. `Benar`. 6. `Ya`. 7. Ambil bukti . 8. Selesai. # Internet Banking *** 1. Akses `Internet Banking`. 2. `Transfer`, kemudian pilih `Withdrawal Account Information`. 3. `Account Number`. 4. `Nomor Virtual Account`, misal `97720XXXXXXXXXXX` sebagai kode bayar. 5. `Nominal`, misal `10000`. 6. `Submit`. 7. `SMS PIN`. 8. Bukti akan ditampilkan pada layar. 9. Selesai. [title] Bank Maybank [path] Payment/Virtual Account (VA)/Panduan Bayar VA/ ::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/ggGyy2LVmjudJJ7PD_5M1_maybank3.jpg" size="50" width="500" height="500" caption="Bank Maybank" position="center" darkWidth="500" darkHeight="500" showCaption="true"} :::hint{type="info"} Pastikan melakukan transfer dana sebelum masa berlaku habis dan dengan nominal tepat. ::: | **Nomor Virtual Account** | `78000XXXXXXXXXXX` | | ------------------------- | --------------------------- | | **Bank** | Maybank | | **Nominal** | Rp10.000 | | **Nama Penerima** | `Merchant Name - billingNm` | | **Nomor Order** | Invoice-1234 | | **Masa Berlaku** | 16-06-2016 / 17:15:00 | file format JSON Panduan Bayar Bank Maybank untuk operasi . ::File{src="https://archbee-doc-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-rUfXFtxG7SmbmRBtpwUpi-20250811-132436.json" label="va-ind-maybank.json"} # ATM Maybank (Menu Transfer) *** 1. PIN ATM . 2. `Transfer`. 3. `Virtual Account`. 4. `Nomor Virtual Account`, misal `78000XXXXXXXXXXX` sebagai kode bayar. 5. `Benar`. 6. `Ya`. 7. Transaksi selesai. # ATM Maybank (Menu Pembayaran) *** 1. PIN ATM . 2. `Pembayaran/Top Up Pulsa`. 3. `Virtual Account`. 4. `Nomor Virtual Account`, misal `78000XXXXXXXXXXX` sebagai kode bayar. 5. `Benar`. 6. `Ya`. 7. Simpan bukti bayar . 8. Transaksi selesai. # ATM Non-Maybank *** 1. PIN ATM . 2. `Transaksi Lainnya`. 3. `Ke Rek Bank Lain`. 4. kode Maybank (`016`). 5. `Benar`. 6. `Nomor Virtual Account`, misal `78000XXXXXXXXXXX` sebagai kode bayar. 7. `Benar`. 8. jumlah sesuai dengan tagihan dalam konfirmasi. 9. `Benar` untuk menyetujui . 10. Simpan bukti bayar . 11. Transaksi selesai. # SMS Banking *** 1. `App Maybank SMS+ Banking`. 2. *Passcode* (opsional). 3. Media Koneksi: `SMS, USSD atau Data (lihat indikator koneksi pada pojok kanan atas)`. 4. *Icon* `Transfer` pada utama. 5. `Virtual Account`. 6. rekening sumber (pada media koneksi USSD tidak diperlukan) pada kolom tersedia. 7. jumlah akan dibayarkan pada kolom tersedia. 8. No. Ref./Berita pada kolom tersedia. 9. `Nomor Virtual Account`, misal `78000XXXXXXXXXXX` sebagai kode bayar. 10. `Kirim`. 11. PIN dikirim melalui . 12. Transaksi selesai. # Internet Banking *** 1. Akses Internet Banking. 2. `Rekening dan Transaksi`. 3. `Maybank Virtual Account`. 4. `Sumber Tabungan`. 5. `Nomor Virtual Account`, misal `78000XXXXXXXXXXX` sebagai kode bayar. 6. `Nominal`, misal `10.000`. 7. `Submit`. 8. `SMS Token`. 9. Bukti ditampilkan pada layar. 10. Transaksi selesai. # Internet atau Mobile Banking Non-Maybank *** :::hint{type="info"} Panduan bayar ini **berlaku untuk metode transfer selain BI-FAST** ::: 1. Akses aplikasi Internet Banking . 2. ID dan *Password* . 3. `Transaksi Antarbank`. 4. `Nomor Virtual Account`, misal `78000XXXXXXXXXXX` sebagai kode bayar. 5. Pastikan detail tagihan sudah benar, kemudian pilih `OK` atau `Lanjut`. 6. PIN Transaksi . 7. Transaksi selesai. # Website M2U *** 1. Akses *Website* M2U masukkan User ID dan *Password*. 2. `Rekening dan Transaksi`. 3. `Transfer`. 4. `Maybank Virtual Account`. 5. `Nomor Virtual Account`, misal `78000XXXXXXXXXXX` sebagai kode bayar. 6. `Lanjut`. 7. `Request SMS Token/TAC`. 8. `SMS Token/TAC`. 9. `Setuju`. 10. Transaksi selesai. # Aplikasi M2U *** 1. Akses Aplikasi M2U menggunakan *Fingerprint* atau masukkan *Password.* 2. `Transfer`. 3. `Virtual Account`. 4. `Sumber Tabungan`. 5. `Nomor Virtual Account`, misal `78000XXXXXXXXXXX` sebagai kode bayar. 6. `LANJUT`. 7. jumlah transfer. 8. `OK`. 9. `PROSES`. 10. `KONFIRMASI&TRANSAKSI`. 11. `SECURE2U`. 12. `OK`. 13. Transaksi selesai. [title] Fitur Kartu Kredit [path] Payment/Kartu Kredit/ Terdapat beberapa fitur dapat digunakan, antara lain: # Full Payment *** *Full Payment* merupakan fitur dasar dari berlogo Visa, Mastercard, JCB, dan American Express. *Regular sale* artinya menggunakan sebagai sumber dana. Tagihan akan memotong limit dan akan ditagihkan dengan nominal penuh mengikuti siklus tagihan . Jika menggunakan Kartu Debit, maka akan dipotong dari Kartu Debit dengan nominal penuh. akan menerima dana sesuai siklus . # Installment *** *Installment *adalah fitur menyediakan cicilan kepada dengan beberapa pilihan tenor cicilan. tidak perlu menagihkan cicilan dan tetap menerima dana dengan nilai penuh sesuai siklus . Fitur cicilan tersedia untuk menggunakan berlogo Visa, Mastercard, JCB, dan Amex. ::::hint{type="warning"} :::Iframe{code="❕Fitur Installment tidak diaktifkan secara default, untuk menggunakan fitur Installment, silakan menghubungi NICEPAY Customer Service atau Marketing NICEPAY." iframeHeight="0"} ::: :::: # Recurring *** *Recurring *atau disebut juga dengan *subscription* merupakan berulang ditagihkan kepada *cardholder *pada setiap periode waktu tertentu. Fitur ini dapat digunakan untuk *cardholder * memiliki jenis maupun Debit. # Pre-Authorization & Capture *** *Pre-Authorization & Capture* merupakan fitur memungkinkan untuk mengonfirmasi terlebih dahulu jumlah dana ditransaksikan oleh (*Pre-Authorization*). Setelah *authorization*, dana dari tersebut pun sudah terjamin siap untuk dipotong. Lalu, dana tersebut akan ditahan sampai *authorization* kedaluwarsa. Jika *authorization* sudah kedaluwarsa, maka dana sudah terjamin tadi akan dianggap *void*. :::hint{type="info"} **Void** merupakan tipe tidak diselesaikan secara tuntas prosesnya. *Void* bisa terjadi apabila *cardholder* meminta untuk di-*cancel* transaksinya pada saat sebelum terjadi atau apabila tidak melakukan Capture sampai dengan waktu kedaluwarsa. Dana dari dianggap *void* akan dikembalikan kepada *cardholder* dengan jumlah *full *oleh *.* ::: Untuk dapat menghindari *void* tersebut, diperlukan untuk melakukan Capture atau mengonfirmasi bahwa dana tersebut memang sesuai dengan jumlah *amount* ditagih. Setelah Capture selesai, dana tersebut akan dikirim menuju rekening . Proses ini berlangsung secara otomatis pada *Payment Gateway*, di mana permintaan dikirim oleh *Payment Gateway* berguna untuk menyelesaikan sebelumnya diautorisasi. memudahkan dengan menyediakan bisa digunakan untuk mengaktifkan *Pre-Authorization & Capture* pada milik . # 3D Secure 2.0 *** pada juga sudah dilengkapi dengan fitur keamanan berstandar internasional, yaitu 3D Secure 2.0 (3Ds 2.0) atau disebut juga dengan EMV (Europepay, Mastercard, Visa) pada kartu berjenis Visa, Mastercard, JCB, maupun AMEX. :::hint{type="info"} **3Ds 2.0 **merupakan standar keamanan versi terbaru dari 3Ds 1.0 memungkinkan *cardholder* untuk mendapatkan verifikasi identitas berupa OTP (*One Time Password*) ke nomor hp terdaftar saat dilakukan. Hal ini dilakukan untuk mencegah adanya upaya pencurian dan tindakan penipuan saat bertransaksi dengan . ::: Untuk itu, tidak perlu khawatir lagi mengenai isu *Fraud *karena di sudah berstandar internasional seperti 3Ds 2.0, serta dilengkapi dengan PCI DSS Level 1. # Tokenization *** menyediakan fitur tokenisasi memungkinkan untuk melakukan tanpa harus mengisi kembali kartu dan pribadi selain dari kode CVV pada saat *checkout*. Fitur ini sangat berguna untuk setia sudah pernah berbelanja dengan untuk dapat mengurangi waktu *checkout, *di mana mereka tidak perlu mengisi kartu berulang kali pada setiap *checkout *terjadi. Sehingga, akan merasa nyaman untuk terus berbelanja dengan . # See also ::::VerticalSplit :::VerticalSplitItem [Alur Pembayaran Kartu Kredit](docId\:i33-9_tZc9P783QJAsX-d) untuk mengetahui pada saat melakukan dengan . ::: :::VerticalSplitItem [Integrasi & Testing Kartu Kredit](docId\:ZA5d5J-5w_gT44qGTxB5n) untuk mengetahui cara dan uji coba . ::: :::: ::::VerticalSplit :::VerticalSplitItem [Daftar Istilah Kartu Kredit](docId\:BBKv4-thEkBPrsCzI6QRe) untuk mengetahui istilah khusus digunakan oleh . ::: :::VerticalSplitItem [FAQ Kartu Kredit](docId\:k9Fux2-dg-nCUDyI38UgF) jika ingin mengetahui pertanyaan sering diajukan terkait . ::: :::: [title] Panduan Bayar VA [path] Payment/Virtual Account (VA)/ ::::LinkArray{contentSource="CUSTOM" customOrder="tfpnA6oIuVuef8eJzJXse,0f2wa396XfRDxoGEYzHwD,by6hmBcIH1VypLYe414aV,6UWzQlqfA6U83u_HuE1hM,d-s3Oe3NCS7XavRDNtwRU,kwQZGgWxM6MORAPlplsD_,C6uaqgGdrAt7nhRRCHbs3,VbMWdn-7dt674vh46VNGI,b3t22WNSBvLqjDsTy-CHq,rTafzE-tHSuyH32Nkv26j,vuFttoWDlKglS7iq3fvSm,QpvPSXC5QTcu7v6rTf5EK,gCtSP5Mj-j1BOM_hU7CdB,JIZ-C1zxou9U9SCX7b8gh,VQDfQdgcnQiQmTFQDerue,MJxNfk_GGh6Irpz4k_8nS"} :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/uNc0P8kaKvLVbZkS-31qW_bca1.png"} [Bank BCA](docId\:rgf-H-NgZPjtFCKMgSney) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/jTYuxmyCY_q8J9i8pXVnX_mandiri1.png"} [Bank Mandiri](docId\:P9pQxnP8-VjS79aS8tz0w) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/AOzLo30ZlfoGNral8hAwQ_bni1.png"} [Bank BNI](docId\:q123-BpWG8xeV3kjScqw1) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/sa4k1caWuEJrJfEiyBfJx_maybank1.png"} [Bank Maybank](docId\:Tn1ONTtKQgnu_gqrpjrxg) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-T1X2qwHxleKbB1GLoP5lv-20241119-073022.png"} [Bank Permata](docId:5lQn3uqPz41knhjURjnzt) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/N1ljPvpoe9-hRz6SF1VS-_kebhana1.png"} [Bank KEB Hana](docId\:Rr5elgaOzH4fq2uFP2jYF) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/g_Ys8EgNkJ5HPCdE9Y_KC_bri1.png"} [Bank BRI](docId:6KcMnN1TZ7M-TkIhhMfAd) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/tfhB7yPR3DQypBSJIORAl_cimb1.png"} [Bank CIMB Niaga](docId\:OxGV3QBrSzMkOOG0xquw5) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/oXgxzQTjaOEgiS1RDtO0e_neo1.png"} [Bank Neo Commerce](docId\:PljVjmRAMOG2X-c-b8uIg) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/DmcFGsTe1Ez2zRHa_xpry_danamon1.png"} [Bank Danamon](docId\:QadPDdYuoLylKnuRhAOXP) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/QVSRTq0qW_4ijZx81cT-d_bjb1.png"} [Bank BJB](docId\:qQCj-wQVbLWJjkQajQlWu) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-pT-ZvDFWAXTzQsaOEPNjG-20250725-095104.png"} [Bank Jakarta](docId\:XH7lc8WcYio3XAg900jGS) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/SA0KSbJ5_1m2uhWmtVlKZ-20260309-074423.png"} [Bank BSI](docId\:wXiHjl-6G82J0k4A7TfgU) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/SRGXS8GkvUZgVv2Wc31Pm_alto4.png"} [ALTO](docId\:jQ3ftOvJCQjUuR5Ixbmdd) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/w5VMgw1Vm8meNPpwFjV12_atmbersama1.png"} [ATM Bersama](docId\:TT8_VM5eS0S5jKLCpmoyT) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/bOU7Nlrb5_h_O29lc0Xo1_prima1.png"} [Prima](docId:8HKtw-JgkU5GTZK7fnZbc) ::: :::: # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Panduan Bayar Kartu Kredit](docId\:pf0yYjEhAE07p65seIrFt) untuk mengetahui cara membayar menggunakan . ::: :::VerticalSplitItem [Panduan Bayar Direct Debit](docId\:eJ49bFx8eJVfBsoGQORTO) untuk mengetahui cara membayar menggunakan . ::: :::: ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Panduan Bayar GPN](docId\:aVzjzuByPtCcIq5feYQvh) untuk mengetahui cara membayar menggunakan . ::: :::VerticalSplitItem Daftar pembaharuan *log* panduan bayar dapat dilihat pada [Release Information - Panduan Bayar](docId\:oBJOho15Y6-A0JVj4JODP). ::: :::: [title] Bank BRI [path] Payment/Virtual Account (VA)/Panduan Bayar VA/ ::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/sqCC08nZa6wdTlm-T5AH3_logo-bri-bank-rakyat-indonesia-png-terbaru.png" size="50" width="1080" height="1080" caption="Bank BRI" position="center" darkWidth="1080" darkHeight="1080" showCaption="true"} :::hint{type="info"} Pastikan melakukan transfer dana sebelum masa berlaku habis dan dengan nominal tepat. ::: | **Nomor Virtual Account** | `88788XXXXXXXXXXX` | | ------------------------- | --------------------------- | | **Bank** | BRI | | **Nominal** | Rp10.000 | | **Nama Penerima** | `Merchant Name - billingNm` | | **Nomor Order** | Invoice-1234 | | **Masa Berlaku** | 16-06-2016 / 17:15:00 | file format JSON Panduan Bayar Bank BRI untuk operasi . ::File{src="https://archbee-doc-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/qUcN8uddZOz66RdGuviYs_va-ind-bri.json" label="VA_IND_BRI.json"} # ATM *** 1. kartu `ATM` dan `PIN` . 2. `Transaksi Lain`. 3. `Pembayaran`. 4. `Lain-lain`. 5. `BRIVA`. 6. `Nomor Virtual Account`, misal `88788XXXXXXXXXXX` sebagai kode bayar. 7. `Ya`. 8. Ambil `bukti bayar` . 9. Selesai. # Mobile Banking *** 1. Akses aplikasi `BRI Mobile`. 2. `Mobile Banking BRI`. 3. `Pembayaran`. 4. `BRIVA`. 5. `Nomor Virtual Account`, misal `88788XXXXXXXXXXX` sebagai kode bayar. 6. `Nominal`, misal `10000`. 7. `Kirim`. 8. `PIN Mobile`. 9. `Kirim`. 10. Bukti akan dikirim melalui . 11. Selesai. # Internet Banking *** 1. Akses `Internet Banking`. 2. `Pembayaran`. 3. `BRIVA.` 4. `Nomor Virtual Account`, misal `88788XXXXXXXXXXX` sebagai kode bayar. 5. `Kirim`. 6. `Password`. 7. `mToken`. 8. `Kirim`. 9. Bukti akan ditampilkan pada layar. 10. Selesai. [title] Dispute & Chargeback [path] Payment/Kartu Kredit/ # Overview *** **Dispute** atau sanggahan adalah penyanggahan dilakukan oleh pemegang kartu kepada atas mungkin tidak dilakukan oleh pemegang kartu. Proses ini dapat dilakukan setelah berhasil. Proses sanggahan terjadi karena adanya indikasi penipuan, melaporkan ada barang rusak atau tidak sesuai dan lain-lain.    Sementara, **Chargeback** adalah sejumlah dana disanggah oleh dan akan dikembalikan oleh di mana sanggahannya sudah terbukti *valid *oleh ataupun sudah menyetujui sanggahan tersebut dari Pelanggannya. Dalam hal ini, menjadi perantara antara dan untuk berkomunikasi selama Dispute berlangsung. Apabila ingin menolak sanggahan dari , akan meminta bukti transaksinya kepada dan juga harus memberikan dokumen yang dibutuhkan dalam tenggat waktu tertentu. Isi dokumen tersebut antara lain nama pemegang kartu, rincian alamat tujuan, rincian *billing statement*, barang melalui , dan nomor resi.  :::hint{type="info"} Tenggat waktu sanggahan dapat berbeda tergantung dari *Acquiring* digunakan.  ::: # Proses Dispute *** ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/qXXYHZAjYO2eS--GsesCG_dispute-id.png "Proses Dispute") 1. Pihak penyanggah mengajukan sanggahan kepada &#xNAN;* Issuing.* 2. Issuing melaporkan sanggahan kepada *Principal.* 3. Principal melaporkan sanggahan kepada *Acquiring.* 4. Acquiring meminta bukti kepada . 5. menerima laporan dari *Acquiring.* 6. meminta bukti kepada . 7. memberikan dokumen pendukung berupa bukti kepada . 8. Jika pihak penyanggah masih keberatan dengan bukti diberikan: 1. meminta rincian kepada sebagai tambahan dokumen pendukung. 2. mengirimkan bukti berhasil dikumpulkan menjadi *second presentment* kepada &#xNAN;* Acquiring*.  3. menerima bukti berhasil dikumpulkan oleh . - Jika pihak penyanggah mengakui bukti , maka penyanggahan akan berakhir.  - Jika mengakui sanggahan, maka akan mengizinkan untuk melakukan *chargeback* dana tersebut akan dikembalikan kepada penyanggah.  - Jika pihak tetap menolak bukti , maka akan lanjut ke arbitrasi.  :::hint{type="info"} Proses Arbitrasi adalah dilakukan jika pihak penyanggah dan tidak mencapai kesepakatan dalam Dispute. Jika kalah saat pengajuan banding, maka harus mengembalikan dana (Chargeback) dan membayar* associated fee*.  ::: Setelah arbitrasi berakhir: - Jika pihak penyanggah kalah saat pengajuan banding, maka tidak akan terjadi Chargeback  - Jika pihak penyanggah menang saat pengajuan banding, maka akan melakukan Chargeback dan membayar* associated fee*.  :::hint{type="info"} *Associated fee* adalah biaya dibebankan dari nominal suatu dan harus dibayar oleh setelah arbitrasi berakhir pada kondisi tertentu.   ::: ::::hint{type="info"} :::Iframe{code="Silakan menghubungi tim Dispute kami apabila ada hal yang ingin ditanyakan lebih lanjut mengenai Dispute & Chargeback." iframeHeight="0"} ::: :::: # See also ::::VerticalSplit :::VerticalSplitItem [Penyelesaian Transaksi Pada Kartu Kredit](docId:4rCLEHp5GhD71y_aARfnQ) untuk mengetahui macam-macam cara menyelesaikan pada . ::: :::VerticalSplitItem [FAQ Kartu Kredit](docId\:k9Fux2-dg-nCUDyI38UgF) jika ingin mengetahui pertanyaan sering diajukan terkait . ::: :::: [title] Daftar Istilah Kartu Kredit [path] Payment/Kartu Kredit/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/iYWu5rM0wlBUTNwNvIEJw_2.png "Kartu Kredit") # Card Number / PAN (*Personal Account Number*) Deret angka merupakan nomor kartu terdiri dari 15-20 angka (umumnya 16 digit) tertera di depan . # CVV / CAV / CVV2 / CSC Deret angka terdiri dari 3 hingga 4 digit nomor tertera di belakang . :::hint{type="warning"} - CVV hanya di-input pada . - CVV bersifat rahasia. tidak diperkenankan menginformasikan CVV kepada siapapun. - tidak diperkenankan menyimpan CVV dalam bentuk apapun. - tidak diperkenankan menanyakan CVV kepada . ::: # Expiry Date Tanggal kedaluwarsa berlakunya tertera pada bagian depan kartu. # Acquirer Lembaga Bank penerima dan pemrosesan dana dari Pelanggan/Nasabah, seperti Visa dan Mastercard. # Issuer Lembaga /Non- menerbitkan kepada Pelanggan/Nasabah. # OTP (*One Time Password*) Deret angka acak (umumnya terdiri dari empat hingga enam digit) dikirimkan ke ponsel /Nasabah sebagai bagian dari autentikasi. :::hint{type="warning"} - OTP bersifat rahasia. tidak diperkenankan untuk memberitahu pihak manapun. - OTP hanya boleh diketik secara langsung oleh atau Pemilik akun pada . ::: # Amex Singkatan dari American Express, *Principal.* # Chargeback Pengembalian dana dari kepada setelah menerima pengajuan dari dan melakukan pemeriksaan . [title] FDS [path] Payment/Kartu Kredit/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/UhfxLeMd-ISDRyHU3d0AN_microsoftteams-image-27.png "Fraud Detection System") *Fraud Detection System* atau disingkat menjadi FDS merupakan keamanan tambahan pada dimiliki oleh untuk mencegah adanya indikasi penipuan dalam secara *online*. FDS dilengkapi dengan fitur *machine learning* dapat mendeteksi adanya upaya tindakan kriminal sebelum hal tersebut terjadi. Dalam hal ini, setiap akan menghasilkan *risk score* dan akan menjadi suatu nilai risiko apakah tersebut dianggap sebagai *low risk* atau *high risk* pada . *Risk score* ini dapat diatur sesuai dengan preferensi atau kebutuhan untuk dapat menolak - mencurigakan atau menerima tersebut sesuai dengan resiko diterima. ::::hint{type="info"} :::Iframe{code="Silakan hubungi tim NICEPAY Merchant Support kami apabila Anda ingin menanyakan lebih lanjut mengenai FDS." iframeHeight="0"} ::: :::: # See also ::::VerticalSplit :::VerticalSplitItem [Penyelesaian Transaksi Pada Kartu Kredit](docId:4rCLEHp5GhD71y_aARfnQ) untuk mengetahui cara menyelesaikan pada . ::: :::VerticalSplitItem [Dispute & Chargeback](docId\:Erwmv4mKNDQM_VOfdxOx2) untuk mengetahui tentang sanggahan dan pengembalian dana. ::: :::: [title] Penyelesaian Transaksi Pada Kartu Kredit [path] Payment/Kartu Kredit/ # Settlement *** Proses menyelesaikan antara dan dilakukan setelah melakukan pesanan kepada dengan menggunakan . Proses ini bertujuan memberikan kepada terkait pendapatan diterima dengan pembukuan apakah nominal diterima sesuai pada nominal tercatat pada . Terkadang, mengalami *void *atau *refund * membuat tidak berhasil. # Pembatalan Transaksi *** ## Void Pembatalan dapat diajukan jika tersebut sudah melakukan penuh (*full amount*) sudah berhasil dan belum melalui oleh &#xNAN;* Acquirer*. Apabila *void *terjadi, maka tidak ada tagihan tercetak pada lembar penagihan pemegang kartu. Pembatalan pada berlogo Visa, Mastercard, JCB dan Amex, dapat dilakukan menggunakan maupun menggunakan telah disediakan untuk . ## Refund *Refund *adalah pengembalian dana terjadi atas persetujuan dan tanpa adanya sanggahan di antara kedua belah pihak. hanya dapat mengajukan *refund* dalam kurun waktu 3 bulan dari waktu terlaksana. Setelah mengajukan *refund* kepada , akan melaporkan *Refund* kepada . Terdapat 2 jenis *Refund*, yaitu: ### Full Refund Pengembalian seluruh dana memungkinkan untuk mengajukan pengembalian dana atas seluruh belanjaan dari daftar belanja pada dan mengakomodasi untuk dapat melakukan pengembalian dana pada sesuai dengan nominal diajukan. ### Partial Refund Pengembalian sebagian dana memungkinkan untuk mengajukan pengembalian dana untuk barang tertentu dari daftar belanja pada dan mengakomodasi untuk dapat melakukan pengembalian dana pada sesuai dengan nominal diajukan. :::hint{type="warning"} Proses pengembalian dana untuk dari kepada dilakukan melalui Cancel ( : [Cancel - API Checkout](docId\:MMmlusWDkyUsJxF421yKn) | Non-: [Cancel - API Credit Card](docId\:wtiAnrXNbTTfKUY8FFEIo)) atau [Merchant Back Office](docId\:VMD8YtiiJqku6H8dRhcS6). tidak diperkenankan melakukan transfer dana secara langsung kepada . Hal ini diperlukan untuk memenuhi kepatuhan terhadap peraturan . ::: ## Proses Refund ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/fSt6KoWqS69ln0FvbyzTt_nicepay-archbee-payment-proses-refund.png "Proses Refund") 1. mengajukan permohonan pengembalian dana kepada . 2. mengajukan permohonan pengembalian dana kepada . 3. mengajukan permohonan pengembalian dana kepada pihak *Acquiring.* 4. Pihak *Acquiring *mengajukan permohonan pengembalian dana kepada *Issuing.* 5. Pihak *Issuing *mengembalikan dana kepada . 6. Pihak *Issuing *melakukan perubahan biaya perlu dibayarkan pada . # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Dispute & Chargeback](docId\:Erwmv4mKNDQM_VOfdxOx2) untuk mengetahui *Dispute* dan tahapan untuk mendapatkan *Chargeback.* ::: :::VerticalSplitItem [FAQ Kartu Kredit](docId\:k9Fux2-dg-nCUDyI38UgF) jika ingin mengetahui pertanyaan sering diajukan terkait . ::: :::: [title] Payment [path] / ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/9VSpGtW9gYKwUBCTYW6Vu_payment.jpg "Payment") **Payment** merupakan menyediakan berbagai macam secara *online* dapat digunakan oleh dengan nyaman, aman, dan cepat. :::hint{type="info"} adalah istilah baru untuk Direct/Enterprise. ::: telah didukung oleh lebih dari 140 dan puluhan strategis serta sudah berlisensi dan bersertifikasi keamanan secara lokal, seperti PJP (Penyedia Jasa Pembayaran) dan PTD (Penyelenggara Transfer Dana) dari , PSE Domestik dari Kominfo serta kepatuhan Internasional seperti PCI DSS dan PCI 3DS. Sehingga, tidak perlu khawatir mengenai keamanan dalam menggunakan . :::hint{type="danger"} Proses wajib dilakukan khusus untuk metode dan bagi telah menggunakan Direct V2 /Enterprise V1. kunjungi [Implementasi SNAP](docId:9NC4zMt_CIYOOoQ3RweUm) untuk mengetahui alur migrasi pada . ::: # Metode Transaksi *** Pada bagian ini, terdapat penjelasan terkait alur dan tambahan terkait setiap digunakan pada dan . :::hint{type="info"} kunjungi [API Checkout](docId\:Djp90D-rlCNeDCzKwGC-d), [API SNAP](docId\:Rz9KHBT6vz0PGg0jszAgn), dan [API Non-SNAP - Payment API](docId\:OK8pnFvDrqo-4Qq3umLQz) untuk melihat . ::: Berikut daftar berbagai macam populer sudah terintegrasi dengan kami: ::::LinkArray{contentSource="CUSTOM"} :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/yVS-5qupBa9tSiqx5FeKN-20260608-081542.jpg"} ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/9o6HxINLfIHjqTBZv9k5j-20260608-081620.jpg"} [Virtual Account (VA)](docId:9tV3ro3_Lj1f-guZ2gark) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/yGKtya2aSo9TH0v4CNYNn-20260608-081706.jpg"} [Convenience Store (CVS)](docId\:lyQ0ppG9p7aGo6vQwvTp5) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/GkJWEeYvgOKLqXxWetPVO-20260608-081756.jpg"} [Direct Debit](docId\:uNFXkAwzKTCzlss__2PUt) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/V-RquAo2s4NYWmWDXzhOS-20260608-081915.jpg"} [E-Wallet](docId\:iJbzxzkxCTRitCCMseIKB) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/erWoa73qVSCQrYcNuaR-7-20260608-081944.jpg"} [Paylater](docId\:a7Zm1Frn9z7QiG0lc-Sr2) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/xo299wO4TJrh-aUKidmRX-20260608-082100.jpg"} [GPN](docId\:qmes8DhJjO6aHaW2DlLBy) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/Nh8vOS1eCj97ruedxcMqR-20260608-082140.jpg"} [QRIS](docId\:KRBNuRjoReOW1YejZS3_Q) ::: :::: Tawarkan kemudahan ber dengan berbagai pilihan aman dan nyaman bersama ! Mari gunakan sekarang! # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem Temukan penjelasan terkait sudah disediakan pada [Checkout](docId\:yxIg_kKwRUKCb_lTM_1bc). ::: :::VerticalSplitItem [NICEPAY API](docId:6qGtFCV3tHP1B_wS9zEqd) untuk mengetahui rincian terkait . ::: :::: [title] Full Payment & Installment - Payment API Credit Card [path] NICEPAY API/API Non-SNAP/Payment API/API Credit Card/Payment - API Credit Card/ # Tentang Full Payment & Installment - Payment API Credit Card *** ini digunakan setelah menyelesaikan [Full Payment & Installment - Registration API Credit Card](docId:_Ls7or4RN1z2Pgc8wH8lD). digunakan pada tahap ini sama dengan untuk tipe Recurring Token dan Pre-Auth & Capture. Namun, terdapat perbedaan pada *request* dikirimkan. # Full Payment & Installment - Payment API Credit Card *** | **API Endpoint** | `/nicepay/direct/v2/payment` | | ------------------ | ------------------------------------------------------------ | | **Request Method** | **POST****** | | **Description** | Full & Installment - | | **Merchant Token** | SHA256(`timeStamp`+`iMid`+`referenceNo`+`amt`+`merchantKey`) | | **Request Format** | `application/x-www-form-urlencoded` | :::hint{type="warning"} Pada , jika autentikasi 3Ds diperlukan, akan diarahkan ke 3Ds *Card Issuer* memerlukan untuk *input* kode OTP (*One Time Password*) untuk menyelesaikan nya. ::: ## Request Parameter for Full Payment & Installment - Payment API Credit Card *** Berikut ini adalah daftar *request * untuk mem pada *Full Payment & Installment*. *Request* dilakukan melalui Form-Url dengan rincian sebagai berikut. | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ----------------------------------------------------------------------------------------------- | -------- | ---------- | -------------------------------------- | ---------------------------------------------------------------- | | `timeStamp`
Required | N | 14 | Request Timestamp (`YYYYMMDDHH24MISS`) | 20221202141217 | | `tXid`
Required | AN | 30 | Transaction ID | IONPAYTEST01202212021455054652 | | `referenceNo` | N | 40 | Reference Number for | ordNo20221202141217 | | `cardNo `
Required for CC
| N | 20 | Number | 4434260000000008 | | `cardExpYymm `
Required for CC | A | 4 | Card Expiry (`YYMM`) | 3901 | | `cardCvv `
Required for CC | N | 4 | Card CVV | 101 | | `cardHolderNm `
Required | AN | 45 | Card Holder Name | John Doe

**Only alphabet allowed**
| | `cardHolderEmail`
Required | ANS | 100 | Card Holder Email | johndoe\@gmail.com | | `merchantToken `
Required | AN | 255 | Token | c91e6531f6c84869439bc5ebe5389bd71e7752c054fc9dbfe193d087a1b797ae | | `callBackUrl `
Required | ANS | 255 | Result URL | https\://merchant.com/callBackUrl | Parameter dibutuhkan untuk adalah data /Debit dari , yaitu berupa `cardNo`*, *`cardExpYymm`*, *`cardCvv`*, *`cardHolderNm` & `cardHolderEmail`*. * Jadi, untuk dapat melakukan , kami sarankan agar untuk memperoleh data kartu tersebut dari terlebih dahulu sebelum melakukan . :::hint{type="warning"} Mencantumkan `cardCVV` pada setiap bergantung dari MID tipe *CVV* atau *Non-CVV*. ::: ## Response Parameter for Full Payment & Installment - Payment API Credit Card *** Setelah melakukan *request*, akan mendapatkan *response *dari Callback URL dengan rincian r*esponse * sebagai berikut. | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ------------- | -------- | ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- | | `resultCd` | N | 14 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | | | `resultMsg` | AN | 255 | Result message: [Error Code](docId\:yEh1VA9k2y6sL1kQF2aWD) | | | `tXid` | AN | 30 | Transaction ID | When success | | `referenceNo` | ANS | 40 | Order Number | When success | | `payMethod` | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | When success | | `amt ` | N | 12 | Amount | When success | | `currency` | AN | 3 | Currency | When success | | `goodsNm` | A | 100 | Goods Name | When success | | `billingNm` | A | 100 | Buyer Name | When success | | `transDt` | N | 8 | Transaction Date (`YYYYMMDD`) | When success | | `transTm` | N | 6 | Transaction Time (`HH24MISS`) | When success | | `description` | AN | 100 | Transaction Description | When success | | `authNo` | N | 10 | Approval Number | When success, CC | | `issuBankCd` | A | 4 | [Issuing Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | When success, CC | | `acquBankCd` | A | 4 | [Acquiring Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | When success, CC | | `cardNo` | ANS | 20 | Card Number with Masking | When success, CC | | `cardExpYymm` | N | 4 | Card Expiry (`YYMM`) | When success, CC | | `instmntMon` | N | 2 | Installment Month | When success, CC | | `instmntType` | N | 2 | [Installment Type Code](docId:7CIX-U_4z295XgtNVEsbO) | When success, CC | | `ccTransType` | N | 2 | [Credit Card Transaction Type](docId:8m3-7Smhm_jhdrE5pCRzp)
`1`: Normal
`2`: Recurring
`3`: Pre-Auth
`4`: Capture | When Success, CC | Sample Parameter for Full Payment & Installment - Payment API Credit Card ------------------------------------------------------------------------- *** ### Request Parameter :::CodeblockTabs cURL ```curl curl --location 'https://www.nicepay.co.id/nicepay/direct/v2/payment' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --data-urlencode 'timeStamp=20250922143200' \ --data-urlencode 'tXid=IONPAYTEST8108202509221432005539' \ --data-urlencode 'referenceNo=reffNo20250922143200' \ --data-urlencode 'merchantToken=020c4c90a89a388206d057cffe7c83df2ec1ead78ec17656544e4a58430ab7ea' \ --data-urlencode 'cardNo=5123450000000008' \ --data-urlencode 'cardExpYymm=3601' \ --data-urlencode 'cardCvv=100' \ --data-urlencode 'cardHolderNm=TEST' \ --data-urlencode 'callBackUrl=https://www.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp' ``` Node.js ```nodejs let secondVersion = new SecondApiVersion(config); let parameterPayment = { amt: "1000", referenceNo: "reffNo20250922143200", tXid: "IONPAYTEST8108202509221432005539", cardNo: "5123450000000008", callBackUrl: "https://www.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp", cardExpYymm: "2901", cardCvv: "100", recurringToken: "", cardHolderNm: "Nicepay Test", preauthToken: "", cardHolderEmail: "test@email.com", }; let response = secondVersion.requestPayment(parameterPayment); ``` ```java NICEPay config = NICEPay.builder() .isProduction(false) // Set to true for production .build(); Card requestData = Card.builder() .timeStamp("20250922143200") // Current timestamp (yyyyMMddHHmmss) .tXid("IONPAYTEST8108202509221432005539") // Transaction ID from registration .iMid("IONPAYTEST") // Your NICEPay iMid .referenceNo("reffNo20250922143200") // Unique order reference .amt("1000") // Payment amount .merchantToken(timeStamp, iMid, reffNo, amount, MERCHANT_KEY) // Secure token generation .cardNo("5123450000000008") // Test card number .cardExpYymm("2908") // Card expiry date (YYMM) .cardCvv("100") // 3-digit CVV .cardHolderNm("NICEPAY TEST") // Cardholder name .callBackUrl("https://www.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp") // Callback URL .recurringToken("") // Leave empty if not recurring .preauthToken("") // Leave empty if not pre-auth .build(); String responseHtml = V2CardService.callV2CardPaymentRequest(requestData, config); ``` ```python bodyPayment = ( builderPayment.BuildPayment() .setTimestamp(datetime.now().strftime("%Y%m%d%H%M%S")) # Current timestamp (yyyyMMddHHmmss) .setTxid("IONPAYTEST8108202509221432005539") # Transaction ID from registration .setReferenceNo("reffNo20250922143200") # Unique order reference .setCashtag("") # Leave empty if not using cashtag .setCardNo("5123450000000008") # Test card number .setCardExpYymm("3901") # Card expiry date (YYMM) .setCardCvv("100") # 3-digit CVV .setRecurringToken("") # Leave empty if not recurring .setPreAuthToken("") # Leave empty if not pre-auth .setAmt("1000") # Payment amount .build() ) environment = ( builderEnvironment.BuildEnvironment() .isCloud(False) # Set to True if using NICEPay Cloud .isProduction(False) # Set to True for production .build() ) response = ServiceNicepay.servicePayment( DataGenerator.getPaymentBody(bodyPayment.dataPayment()), environment ) ``` Vanilla JS ```javascript const paymentData = { cardNo: "5123450000000008", // Test card number cardExpYymm: "2901", // Card expiry in YYMM format cardCvv: "100", // 3-digit CVV cardHolderEmail: "customer@example.com", // Cardholder email cardHolderNm: "John Doe", // Cardholder name callBackUrl: "https://your-domain.com/callback", // Callback URL after payment tXid: "IONPAYTEST8108202509221432005539", // Transaction ID from registration merchantToken: "020c4c90a89a388206d057cffe7c83df2ec1ead78ec17656544e4a58430ab7ea", // Secure token recurringToken: "", // Leave empty if not recurring }; const response = await Nicepay.paymentTransaction(paymentData); ``` Laravel ```php $url = HttpUtil::getNicepayDomain($this->useProd, $this->useCloud) . $this->payment_endpoint; // Request body parameters $txid = "IONPAYTEST8108202509221432005539"; $timestamp = Carbon::now()->format("YmdHis"); // Current timestamp (yyyyMMddHHmmss) $reference_no = "reffNO20250922143200"; $amt = "1000"; // Generate secure merchant token $merchant_token = $this->generateMerchantToken( $timestamp, $this->imid, $reference_no, $amt, $this->mer_key ); $param = [ "timeStamp" => $timestamp, // Current timestamp "tXid" => $txid, // Transaction ID from registration "merchantToken" => $merchant_token, // Secure hash token "cardNo" => "5123450000000008", // Test card number "cardExpYymm" => "3901", // Card expiry date (YYMM) "cardCvv" => "100", // 3-digit CVV "callBackUrl" => "https://www.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp", // Callback URL "returnJsonFormat"=> "1", // Force JSON response format ]; $response = HttpUtil::redirectWithQueryParams($url, $param); ``` PHP Native ```php $config = NICEPay::builder() ->setIsProduction(true) // Set to false for sandbox/testing ->build(); $parameter = Card::builder() ->timeStamp($timestamp) // Current timestamp (yyyyMMddHHmmss) ->iMid("IONPAYTEST") // Your NICEPay iMid ->tXid("IONPAYTEST8108202509221432005539") // Transaction ID from registration ->referenceNo("reffNo20250922143200") // Unique order reference ->merchantToken( $timestamp, $iMid, $newCCTrx->getReferenceNo(), $newCCTrx->getAmt(), $this->merchantKey ) // Generate secure token ->cardNo(TestConst::$CARD_NO) // Test card number from constants ->cardExpYymm(TestConst::$CARD_EXP_YYMM) // Card expiry date (YYMM) ->cardCvv(TestConst::$CARD_CVV) // 3-digit CVV ->cardHolderNm("Nicepay test") // Cardholder name ->callBackUrl("https://dev.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp?") // Callback URL after payment ->build(); $cardService = new V2CardService($config); $response = $cardService->payment($parameter); ``` ```kotlin var config: NICEPay? = NICEPay.Builder() .isProduction(true) // Set to false for sandbox/testing .build() val request: DirectV2RequestPaymentCard = DirectV2RequestPaymentCard.Builder() .timeStamp("20250922143200") // Current timestamp (yyyyMMddHHmmss) .tXid("IONPAYTEST8108202509221432005539") // Transaction ID from registration .iMid("IONPAYTEST") // Your NICEPay iMid .merchantKey(MERCHANT_KEY) // Secret merchant key .referenceNo("reffNO20250922143200") // Unique order reference number .amt("1000") // Payment amount .callBakUrl("https://www.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp") // Callback URL after payment .cardNo("5123450000000008") // Test card number .cardCvv("123") // 3-digit CVV (sample) .cardExpYymm("2512") // Card expiry date (YYMM) .build() val response = paymentService.registration(request, config)!! ``` ::: ### Response Parameter :::CodeblockTabs Sample Response ```html
``` ::: ## CallBack Handling for Full Payment & Installment - Payment API Credit Card *** Setelah terjadi, akan mendapatkan dari kami sesuai dengan Callback URL masukkan dalam *request* pada [Payment - API Credit Card](docId\:FcJslW1q-2oJhb0HWqJsj). :::hint{type="success"} Saat *Callback *telah diterima `callbackUrl` , kami sangat menganjurkan untuk melakukan verifikasi Status menggunakan [Status Inquiry - API Credit Card](docId\:voJ9rhAQRLcF-_74cYrFi). ::: :::hint{type="warning"} `CallBack Handling` sangat penting untuk membantu meminimalisir tindakan *Fraud, *kami sangat merekomendasikan untuk melakukan verifikasi menggunakan `CallBack Handling`. ::: :::CodeblockTabs URL CallBack ```json "callbackUrl" : "https://www.merchant.com/callbackUrl/" ``` Response CallBack ```json { "resultCd":"0000", "resultMsg":"SUCCESS", "tXid":"IONPAYTEST01202212141112221428", "referenceNo":"", "payMethod":"01", "amt":"10000", "transDt":"20221212", "transTm":"121212", "description":"Testing Credit Card Transaction", "authNo":"080623", "issuBankCd":"OTHR" "acquBankCd":"BMRI", "cardNo":"453211*****1111", "goodsNm":"Test Transaction Nicepay" "billingNm":"John Doe", "currency":"IDR", "timeStamp":"20221212121212", "merchantToken":"2035d2295d9578fffb40137186f0203474142ae3e57992d4847826c5fcaffce6", "cardExpYymm":"2712", "instmntMon":"1", "instmntType":"1", "ccTransType":"1" } ``` ::: [title] Inquiry List API [path] NICEPAY API/API Non-SNAP/Advance API/ # List Inquiry API *** ## Tentang List Inquiry API ini digunakan untuk mendapatkan daftar berdasarkan Seller ID `msId`. | **API End Point** | `/nicepay/direct/v2/listInquiry` | | --------------------------------------------------------------------- | ------------------------------------------- | | **Request Method **application/json | **POST****** | | **Header** | `Content-Type: application/json` | | **Merchant Token** | `SHA256 ( timeStamp + iMid + Merchant Key)` | ## Request Parameter for List Inquiry *** | **Tipe** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh/ Catatan** | | ---------------------------------------------------------- | -------- | ---------- | --------------------------------------------------- | ----------------------------------------------------------------- | | `timeStamp`
Required | N | 14 | Request Date | 20170708123456 | | `msId`
Required | AN | 30 | Seller ID | 123 | | `iMid`
Required | AN | 10 | ID | IONPAYTEST | | `payMethod`
Required | AN | 40 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | 05 | | `fromDt`
Required | N | 8 | Query Start Date | 20191201 | | `toDt`
Required | N | 8 | Query End Date | 20191231 | | `merchantToken`
Required | AN | 64 | Token | 46a8219f2e5a903252bb173608ca4324cb25b964d0208625a2ea5 79b385d264a | ## Response Parameter for List Inquiry *** | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ------------- | -------- | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------ | | `resultCd` | N | 4 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | 0000 | | `resultMsg` | AN | 255 | Result Message: [Error Code](docId\:yEh1VA9k2y6sL1kQF2aWD) | SUCCESS | | `tXid` | AN | 30 | Transaction ID | IONPAYTEST05201912022223379276 | | `referenceNo` | ANS | 40 | Order Number | ord20191202221283 | | `amt` | N | 12 | Amount | 11000 | | `fee` | N | 12 | Fee | | | `reqDt` | N | 8 | Transaction Request Date
(`YYYYMMDD`) | 20160301 | | `reqTm` | N | 6 | Transaction Request Time (`HH24MISS`) | 135959 | | `transDt` | N | 8 | Transaction Date (`YYYYMMDD`) | 20160303 | | `transTm` | N | 6 | Transaction Time (`HH24MISS`) | 135959 | | `goodsNm` | AN | 100 | Goods Name | Test Transaction | | `billingNm` | A | 100 | Billing Name | Name | | `status` | N | 1 | Transaction Status
`0`: Approved
`3`: Request
`4`: Cancel
`8`: Timeout
`9`: Failed
`5`: Reject before Approved |
| ## Sample JSON for List Inquiry API *** :::CodeblockTabs Request ```json { "timeStamp": "20200306160251", "msId": "123", "iMid": "IONPAYTEST", "payMethod": "05", "fromDt": "20191201", "toDt": "20191231", "merchantToken": "" } ``` Response ```json { "resultCd": "0000", "resultMsg": "SUCCESS", "trxCnt": "2", "trxList": [ { "tXid": "IONPAYTEST05201912022223379276", "referenceNo": "ord20191202221283", "amt": "11000", "fee": "", "reqDt": "20191202", "reqTm": "222430", "transDt": "20191202", "transTm": "222430", "goodsNm": "Test Transaction Nicepay", "billingNm": "Customer Name", "status": "0" }, { "tXid": "IONPAYTEST05201912022232599277", "referenceNo": "ord20191202221261", "amt": "11000", "fee": "", "reqDt": "20191202", "reqTm": "223319", "transDt": "20191202", "transTm": "223319", "goodsNm": "Test Transaction Nicepay", "billingNm": "Customer Name", "status": "0" } ] } ``` ::: # Inquiry Detail API *** ## Tentang Inquiry Detail API ini digunakan untuk memeriksa kumpulan pesanan. | **API End Point** | `/nicepay/direct/v2/InquiryDetail` | | ------------------------ | ------------------------------------------------------------ | | **Request Method ** | **POST****** | | **Header** | `Content-Type: application/json` | | **Merchant Token** | `SHA256 (timeStamp + iMid + referenceNo+ amt + merchantKey)` | ### Request Parameter for Inquiry Detail *** | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ---------------------------------------------------------- | -------- | ---------- | ------------------ | ---------------------------------------------------------------- | | `timeStamp`
Required | N | 14 | Request Date | 20180810152800 | | `tXid`
Required | AN | 30 | Transaction ID | BMRITEST0101201808101526233736 | | `iMid`
Required | AN | 10 | ID | BMRITEST01 | | `referenceNo`
Required | ANS | 40 | Order Number | OrdNo2018715255268 | | `amt`
Required | N | 12 | Transaction Amount | 1000 | | `merchantToken`
Required | AN | 255 | Token | 5a859cf700880565ef7f69218c0efce5bd601766d7bb479e2302f74fdeb95c74 | ### Response Parameter for Inquiry Detail *** | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | -------------- | -------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- | | `count` | N | 12 | Transaction Count | 3 | | `transactions` | AOO | | Transaction List | JSON Array | | `acquirerData` | Array | 20 | A dynamic array consisting of a unique reference number RRN that is provided by ing when a refund is ed. This reference number can be used by to track of refund with . | `"acquirerData": {`
` "rrn": "2399849"`
` }` | ### Sample JSON for Inquiry Detail API *** :::CodeblockTabs Request ```json { {"timeStamp":"20180810152800", "merchantToken":"5a859cf700880565ef7f69218c0efce5bd601766d7bb479e2302f74fdeb95c74", "referenceNo":"OrdNo2018715255268", "amt":"1000", "tXid":"BMRITEST0101201808101526233736", "iMid":"BMRITEST01" } ``` Response ```json { "count": 3, "transactions": [ { "tXid": "BMRITEST0101201808101526233736", "iMid": "BMRITEST01", "currency": "IDR", "amt": "1000", "instmntMon": "1", "instmntType": "1", "referenceNo": "OrdNo2018715255268", "goodsNm": null, "payMethod": "01", "billingNm": "HongGilDong", "billingPhone": "021-579-00000", "billingEmail": "no-reply@ionpay.net", "billingAddr": "Jalan Jenderal Gatot Subroto Kav.57", "billingCity": "Jakarta", "billingState": "Jakarta", "billingPostCd": "12950", "billingCountry": "ID", "deliveryNm": "HongGilDong", "deliveryPhone": "62-21-0000-0000", "deliveryAddr": "Jalan Jenderal Gatot Subroto Kav.57", "deliveryCity": "Jakarta", "deliveryState": "Jakarta", "deliveryPostCd": "12950", "deliveryCountry": "ID", "vat": null, "fee": null, "notaxAmt": null, "description": null, "merchantToken": null, "reqDt": "20180810", "reqTm": "152623", "resultCd": "0000", "resultMsg": "paid", "merFixAcctId": null, "vacctValidDt": null, "vacctValidTm": null, "status": "0", "vacctNo": null, "bankCd": "BMRI", "cardNo": "483574******9802", "depositAmt": null, "issuBankCd": "HSBC", "preauthToken": null, "mitraCd": null, "payNo": null, "receiptCode": "009942", "cancelAmt": null, "transDt": "20180810", "transTm": "152726", "recurringToken": "58412707a41c69e3142a3ce1d99a09afbf0b8bcd9513f1726e09aabe2e5a3ddd", "ccTransType": "1", "payValidDt": null, "payValidTm": null, "mRefNo": null, "acquStatus": "00", "cardExpYymm": "2110", "issuBankNm": "HSBC", "acquBankNm": "Mandiri", "depositDt": null, "depositTm": null, "paymentExpDt": null, "paymentExpTm": null, "paymentTrxSn": null, "cancelTrxSn": null, "userId": null, "shopId": null, "partialFlag": null, "cancelReferenceNo": null, "eciValue": "05", "acquirerData": { "rrn": "332608321717" } }, { "tXid": "BMRITEST0101201808101527134133", "iMid": "BMRITEST01", "currency": "IDR", "amt": "1000", "instmntMon": "1", "instmntType": "1", "referenceNo": null, "goodsNm": "T-1000", "payMethod": "01", "billingNm": "HongGilDong", "billingPhone": "021-579-00000", "billingEmail": "no-reply@ionpay.net", "billingAddr": "Jalan Jenderal Gatot Subroto Kav.57", "billingCity": "Jakarta", "billingState": "Jakarta", "billingPostCd": "12950", "billingCountry": "ID", "deliveryNm": "HongGilDong", "deliveryPhone": "62-21-0000-0000", "deliveryAddr": "Jalan Jenderal Gatot Subroto Kav.57", "deliveryCity": "Jakarta", "deliveryState": "Jakarta", "deliveryPostCd": "12950", "deliveryCountry": "ID", "vat": null, "fee": null, "notaxAmt": null, "description": null, "merchantToken": null, "reqDt": "20180810", "reqTm": "152713", "resultCd": "0000", "resultMsg": "void", "merFixAcctId": null, "vacctValidDt": null, "vacctValidTm": null, "status": "1", "vacctNo": null, "bankCd": null, "cardNo": null, "depositAmt": null, "issuBankCd": null, "preauthToken": null, "mitraCd": null, "payNo": null, "receiptCode": null, "cancelAmt": null, "transDt": "20180810", "transTm": "153805", "recurringToken": null, "ccTransType": null, "payValidDt": null, "payValidTm": null, "mRefNo": null, "acquStatus": null, "cardExpYymm": null, "issuBankNm": "HSBC", "acquBankNm": "Mandiri", "depositDt": null, "depositTm": null, "paymentExpDt": null, "paymentExpTm": null, "paymentTrxSn": null, "cancelTrxSn": null, "userId": null, "shopId": null, "partialFlag": null, "cancelReferenceNo": null, "eciValue": null, "acquirerData": { "rrn": "332608321717" } }, { "tXid": "BMRITEST0101201808101538058789", "iMid": "BMRITEST01", "currency": "IDR", "amt": "1000", "instmntMon": "1", "instmntType": "1", "referenceNo": null, "goodsNm": "T-1000", "payMethod": "01", "billingNm": "HongGilDong", "billingPhone": "021-579-00000", "billingEmail": "no-reply@ionpay.net", "billingAddr": "Jalan Jenderal Gatot Subroto Kav.57", "billingCity": "Jakarta", "billingState": "Jakarta", "billingPostCd": "12950", "billingCountry": "ID", "deliveryNm": "HongGilDong", "deliveryPhone": "62-21-0000-0000", "deliveryAddr": "Jalan Jenderal Gatot Subroto Kav.57", "deliveryCity": "Jakarta", "deliveryState": "Jakarta", "deliveryPostCd": "12950", "deliveryCountry": "ID", "vat": null, "fee": null, "notaxAmt": null, "description": null, "merchantToken": null, "reqDt": "20180810", "reqTm": "153805", "resultCd": "0000", "resultMsg": "void", "merFixAcctId": null, "vacctValidDt": null, "vacctValidTm": null, "status": "1", "vacctNo": null, "bankCd": null, "cardNo": null, "depositAmt": null, "issuBankCd": null, "preauthToken": null, "mitraCd": null, "payNo": null, "receiptCode": null, "cancelAmt": null, "transDt": "20180810", "transTm": "153805", "recurringToken": null, "ccTransType": null, "payValidDt": null, "payValidTm": null, "mRefNo": null, "acquStatus": null, "cardExpYymm": null, "issuBankNm": "HSBC", "acquBankNm": "Mandiri", "depositDt": null, "depositTm": null, "paymentExpDt": null, "paymentExpTm": null, "paymentTrxSn": null, "cancelTrxSn": null, "userId": null, "shopId": null, "partialFlag": "0", "cancelReferenceNo": null, "eciValue": null, "acquirerData": { "rrn": "332608321717" } } ] } ``` ::: ## Transaction List *** ### Parameter for Transaction List | **Parameter** | **Tipe** | **Ukuran** | **Dekripsi** | **Contoh / Catatan** | | ------------------- | -------- | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- | | `resultCd` | N | 4 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | 000 | | `resultMsg` | AN | 255 | Result Message: [Error Code](docId\:yEh1VA9k2y6sL1kQF2aWD) | SUCCESS | | `tXid` | AN | 30 | Transaction ID (Key from ) | BMRITEST0101201808101526233736 | | `iMid` | AN | 10 | ID | BMRITEST01 | | `referenceNo` | ANS | 40 | Order Number (Key from ) | OrdNo2018715255268 | | `payMethod` | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | `01`: | | `amt` | N | 12 | Amount | 1000 | | `currency` | AN | 3 | Currency | IDR | | `reqDt` | N | 8 | Transaction Request Date (`YYYYMMDD`) | 20160301 | | `reqTm` | N | 6 | Transaction Request Time (`HH24MISS`) | 135959 | | `transDt` | N | 8 | Transaction Date (`YYYYMMDD`) | 20160303 | | `transTm` | N | 6 | Transaction Time (`HH24MISS`) | 135959 | | `goodsNm` | AN | 100 | Goods Name | Goods 1 | | `billingNm` | AN | 100 | Buyer name | HongGilDong | | `billingPhone` | N | 15 | Buyer Phone | 021-579-00000 | | `billingEmail` | ANS | 40 | Buyer E-mail | no-reply\@ionpay.net | | `billingAddr` | ANS | 100 | Buyer Address | Jalan Jenderal Gatot Subroto Kav.57 | | `billingCity` | A | 50 | Buyer City | Jakarta | | `billingState` | A | 50 | Billing State | Jakarta | | `billingPostCd` | N | 10 | Billing Post Number | 12950 | | `billingCountry` | A | 10 | Billing Country | ID | | `deliveryNm` | A | 30 | Delivery Name | HongGilDong | | `deliveryPhone` | N | 15 | Delivery Phone | 62-21-0000-0000 | | `deliveryAddr` | AN | 100 | Delivery Address | Jalan Jenderal Gatot Subroto Kav.57 | | `deliveryCity` | A | 50 | Delivery City | Jakarta | | `deliveryState` | A | 50 | Delivery State | Jakarta | | `deliveryPostCd` | N | 10 | Delivery Post Code | 12950 | | `deliveryCountry` | A | 10 | Delivery Country | ID | | `bankCd` | AN | 4 | [Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | BMRI | | `status` | N | 1 | Transaction Status
`0`: Paid
`1`: Void
`2`: Refund
`3`: Unpaid
`4`: Expired (VA, CVS, Direct Debit-Cancel)
`8`: Fail (Refer Status Code) | 0 | | `eciValue` | N | 2 | Card ECI | 05 | | `issuBankCd` | A | 4 | [Issuing Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | BMRI | | `acquBankCd` | A | 4 | [Acquiring Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | BMRI | | `cardNo` | AN | 20 | Card Number with Masking | 483574\*\*9802 | | `cardExpYymm` | N | 4 | Card Expiry (`YYMM`) | 2110 | | `instmntMon` | N | 2 | Installment Month | 1 | | `instmntType` | N | 2 | [Installment Type Code](docId:7CIX-U_4z295XgtNVEsbO) | 1 | | `preauthToken` | AN | 255 | Pre-Auth Token (Need for Capture for PREAUTH Only) | Ty23revc85452geg46hw33aaca6d17a33e4ad72cfc7c4c656hjt4 | | `recurringToken` | AN | 255 | Recurring Token (Can Use Next Payment for RECURRING Only) | 412707a41c69e3142a3ce1d99a09afbf0b8bcd9513f1726e09aabe2e5a3ddd | | `receiptCode` | N | 6 | Receipt Code | null | | `ccTransType` | AN | 2 | [Credit Card Transaction Type](docId:8m3-7Smhm_jhdrE5pCRzp)
`1`: Normal
`2`: Recurring
`3`: Pre-Auth
`4`: Capture | 1 | | `acquStatus` | AN | 2 | Purchase Status
`00`: Not Purchase
`01`: Later Cancel Not Purchase
`10`: Finish Purchase
`99`: etc | 00 | | `vat` | N | 12 | Vat | null | | `fee` | N | 12 | Service Fee | null | | `notaxAmt` | N | 12 | Tax Free Amount | null | | `depositDt` | N | 8 | Transaction Request Date (`YYYYMMDD`) | null | | `depositTm` | N | 6 | Transaction Request Time (`HH24MISS`) | null | | `depositAmt` | N | 20 | Deposit Amount | null | | `paymentExpDt` | N | 6 | Expiry Date (`YYYYMMDD`) | null | | `paymentExpTm` | N | 6 | Expiry Time (`HH24MISS`) | null | | `paymentTrxSn` | N | 32 | Expiry Date (`YYYYMMDD`) | null | | `cancelTrxSn` | AN | 32 | Cancel Transaction Number | null | | `cancelAmt` | N | 12 | Cancel Amount | null | | `userId` | AN | 128 | User ID Hash | null | | `shopId` | AN | 32 | Shop ID | null | | `partialFlag` | A | 4 | Partial Flagging | null | | `cancelReferenceNo` | ANS | 40 | Cancel Reference Number | null | | `mitraCd` | A | 4 | [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8) | null | | `mRefNo` | AN | 20 | Reference Number | null | ### Sample JSON Array for Transaction List *** ```json { "count": 3, "transactions": [ { "tXid": "BMRITEST0101201808101526233736", "iMid": "BMRITEST01", "currency": "IDR", "amt": "1000", "instmntMon": "1", "instmntType": "1", "referenceNo": "OrdNo2018715255268", "goodsNm": null, "payMethod": "01", "billingNm": "HongGilDong", "billingPhone": "021-579-00000", "billingEmail": "no-reply@ionpay.net", "billingAddr": "Jalan Jenderal Gatot Subroto Kav.57", "billingCity": "Jakarta", "billingState": "Jakarta", "billingPostCd": "12950", "billingCountry": "ID", "deliveryNm": "HongGilDong", "deliveryPhone": "62-21-0000-0000", "deliveryAddr": "Jalan Jenderal Gatot Subroto Kav.57", "deliveryCity": "Jakarta", "deliveryState": "Jakarta", "deliveryPostCd": "12950", "deliveryCountry": "ID", "vat": null, "fee": null, "notaxAmt": null, "description": null, "merchantToken": null, "reqDt": "20180810", "reqTm": "152623", "resultCd": "0000", "resultMsg": "paid", "merFixAcctId": null, "vacctValidDt": null, "vacctValidTm": null, "status": "0", "vacctNo": null, "bankCd": "BMRI", "cardNo": "483574******9802", "depositAmt": null, "issuBankCd": "HSBC", "preauthToken": null, "mitraCd": null, "payNo": null, "receiptCode": "009942", "cancelAmt": null, "transDt": "20180810", "transTm": "152726", "recurringToken": "412707a41c69e3142a3ce1d99a09afbf0b8bcd9513f1726e09aabe2e5a3ddd", "ccTransType": "1", "payValidDt": null, "payValidTm": null, "mRefNo": null, "acquStatus": "00", "cardExpYymm": "2110", "issuBankNm": "HSBC", "acquBankNm": "Mandiri", "depositDt": null, "depositTm": null, "paymentExpDt": null, "paymentExpTm": null, "paymentTrxSn": null, "cancelTrxSn": null, "userId": null, "shopId": null, "partialFlag": null, "cancelReferenceNo": null, "eciValue": "05" }, { "tXid": "BMRITEST0101201808101527134133", "iMid": "BMRITEST01", "currency": "IDR", "amt": "1000", "instmntMon": "1", "instmntType": "1", "referenceNo": null, "goodsNm": "T-1000", "payMethod": "01", "billingNm": "HongGilDong", "billingPhone": "021-579-00000", "billingEmail": "no-reply@ionpay.net", "billingAddr": "Jalan Jenderal Gatot Subroto Kav.57", "billingCity": "Jakarta", "billingState": "Jakarta", "billingPostCd": "12950", "billingCountry": "ID", "deliveryNm": "HongGilDong", "deliveryPhone": "62-21-0000-0000", "deliveryAddr": "Jalan Jenderal Gatot Subroto Kav.57", "deliveryCity": "Jakarta", "deliveryState": "Jakarta", "deliveryPostCd": "12950", "deliveryCountry": "ID", "vat": null, "fee": null, "notaxAmt": null, "description": null, "merchantToken": null, "reqDt": "20180810", "reqTm": "152713", "resultCd": "0000", "resultMsg": "void", "merFixAcctId": null, "vacctValidDt": null, "vacctValidTm": null, "status": "1", "vacctNo": null, "bankCd": null, "cardNo": null, "depositAmt": null, "issuBankCd": null, "preauthToken": null, "mitraCd": null, "payNo": null, "receiptCode": null, "cancelAmt": null, "transDt": "20180810", "transTm": "153805", "recurringToken": null, "ccTransType": null, "payValidDt": null, "payValidTm": null, "mRefNo": null, "acquStatus": null, "cardExpYymm": null, "issuBankNm": "HSBC", "acquBankNm": "Mandiri", "depositDt": null, "depositTm": null, "paymentExpDt": null, "paymentExpTm": null, "paymentTrxSn": null, "cancelTrxSn": null, "userId": null, "shopId": null, "partialFlag": null, "cancelReferenceNo": null, "eciValue": null }, { "tXid": "BMRITEST0101201808101538058789", "iMid": "BMRITEST01", "currency": "IDR", "amt": "1000", "instmntMon": "1", "instmntType": "1", "referenceNo": null, "goodsNm": "T-1000", "payMethod": "01", "billingNm": "HongGilDong", "billingPhone": "021-579-00000", "billingEmail": "no-reply@ionpay.net", "billingAddr": "Jalan Jenderal Gatot Subroto Kav.57", "billingCity": "Jakarta", "billingState": "Jakarta", "billingPostCd": "12950", "billingCountry": "ID", "deliveryNm": "HongGilDong", "deliveryPhone": "62-21-0000-0000", "deliveryAddr": "Jalan Jenderal Gatot Subroto Kav.57", "deliveryCity": "Jakarta", "deliveryState": "Jakarta", "deliveryPostCd": "12950", "deliveryCountry": "ID", "vat": null, "fee": null, "notaxAmt": null, "description": null, "merchantToken": null, "reqDt": "20180810", "reqTm": "153805", "resultCd": "0000", "resultMsg": "void", "merFixAcctId": null, "vacctValidDt": null, "vacctValidTm": null, "status": "1", "vacctNo": null, "bankCd": null, "cardNo": null, "depositAmt": null, "issuBankCd": null, "preauthToken": null, "mitraCd": null, "payNo": null, "receiptCode": null, "cancelAmt": null, "transDt": "20180810", "transTm": "153805", "recurringToken": null, "ccTransType": null, "payValidDt": null, "payValidTm": null, "mRefNo": null, "acquStatus": null, "cardExpYymm": null, "issuBankNm": "HSBC", "acquBankNm": "Mandiri", "depositDt": null, "depositTm": null, "paymentExpDt": null, "paymentExpTm": null, "paymentTrxSn": null, "cancelTrxSn": null, "userId": null, "shopId": null, "partialFlag": "0", "cancelReferenceNo": null, "eciValue": null } ] } ``` [title] FAQ NICEPAY API [path] NICEPAY API/ ## General *** ### Apa yang dimaksud dengan callback URL? Callback URL adalah sebuah URL pengalihan dimiliki oleh , akan mengalihkan pengguna menuju `callbackUrl` dan melewati beberapa setelah sukses/gagal. *** ### Apa yang dimaksud dengan `dbProcess` URL? `dbProcess` URL adalah sebuah URL dimiliki oleh (webhook) untuk menerima dan mem dari server . *** ### Apakah Merchant dapat mengecek status pembayaran? Ya, menyediakan Status Inquiry untuk memeriksa . memeriksa pada daftar berikut untuk lebih lanjut. | | [Status Inquiry - API Checkout](docId\:K9vBS87ev9_w5oJAU0et3) | | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | [Check Status Transaction - API Virtual Account SNAP](docId\:xaW0SxwKv9j7b5zLbtVpR)
[Check Status Transaction - API QRIS SNAP](docId:3aXWe6p6cyHX_ZuN-bvgQ)
[Check Status Transaction - API E-Wallet (Direct Debit) SNAP](docId\:vB63D8suaKPYP-4bIOWx9) | | Non- | [Status Inquiry - API Credit Card](docId\:voJ9rhAQRLcF-_74cYrFi)
[Status Inquiry - API Convenience Store](docId\:WMITrWcw3j9ChajRg-o1D)
[Status Inquiry - API Direct Debit](docId\:TvyS0QCC6pqcXX8NulLFr)
[Status Inquiry - API Paylater](docId\:r6YyG1qEKKLzWnVhazxCV)
[Status Inquiry - API GPN](docId\:XF3Gyd2RzjUw2VPCiT0L9) | *** ### Apa perbedaan Checkout API dan Payment API? adalah memiliki fitur *payment page, *sehingga memudahkan dalam melakukan dengan . adalah memberikan kuasa kepada untuk membuat *payment page *sendiri, sehingga dapat melakukan *custom payment page*. *** ### Apakah para merchant dapat menggunakan Merchant ID dan Merchant Key yang sudah disediakan untuk melakukan uji coba pada ***Live Environment***? Ya, ID dan Key disediakan oleh dapat digunakan untuk melakukan uji coba pada *Live Environment*. *** ### Apa yang harus dilakukan oleh Merchant jika pembayaran Pelanggan telah ditolak? 1. dapat memeriksa nomor , waktu kedaluwarsa dan nominal . 2. membandingkan tersebut dengan bukti (*Invoice).* - Jika hasil perbandingan sesuai dan dibatalkan, maka tolong gunakan lain. Contoh: awalnya melakukan dengan menggunakan ATM, kemudian ditolak. Maka, harus menggunakan pilihan lain, seperti *Mobile Banking*. ***Jika pembayaran masih gagal, harap menghubungi *****Customer Service *****NICEPAY.*** *** ### Apa yang harus dilakukan jika Pelanggan sudah berhasil membayar sebuah transaksi tetapi belum menerima e-mail konfirmasi? (khusus Merchant yang menerima e-mail konfirmasi) Umumnya, akan menerima sebuah e-mail konfirmasi dalam jangka waktu maksimal 5 menit. Jika tidak menerima e-mail konfirmasi apapun dalam jangka waktu 5 menit, mohon kirimkan sebuah e-mail kepada beserta dengan bukti . *** ### Mengapa Merchant tidak mendapatkan ***push notification***? - memberikan *response * tidak sesuai seperti 404 (URL* Not Found*), 500 (*Internal Server Error*), atau 403 (*Forbidden*). - Tidak memasukkan *value* atau memasukkan value tidak tepat pada `dbProcessUrl` - Server tidak dapat di-*hit* karena *firewall *di sisi . ## API SNAP BI *** ### Apakah proses pembuatan signature sama dengan yang dijelaskan di ASPI? Yakni menggunakan symetric key? mengunjungi [SNAP API Testing](docId\:UZex33ReLyENKOgbJJnYp) untuk lebih lanjut. *** ### Bagaimana cara menyerahkan Public Key dari Merchant kepada tim NICEPAY? ::::hint{type="info"} :::Iframe{iframeHeight="0" code="ℹ️ Merchant dapat menyerahkan public key terkait melalui e-mail kepada tim IT NICEPAY terkait."} ::: :::: *** ### Dimana kredensial seperti client ID, client secret / symetric key dan merchant key bisa dilihat di Merchant Management System? Saat ini, terkait tidak dapat dilihat pada portal tersebut, melainkan dikirimkan melalui e-mail oleh tim . *** ### Bagaimana cara meminta tambahan akses Merchant Management System NICEPAY? ::::hint{type="info"} :::Iframe{iframeHeight="0" code="ℹ️ Silakan menghubungi NICEPAY Customer Service untuk informasi lebih lanjut."} ::: :::: [title] Status Inquiry - API Direct Debit [path] NICEPAY API/API Non-SNAP/Payment API/API Direct Debit/ # Tentang API Direct Debit Status Inquiry *** Integrasi Status Inquiry pada diperlukan supaya dapat memeriksa berlangsung pada dilakukan oleh baik ber *success*, *fail*, dan lainnya. Sehingga, dapat memiliki laporan mengenai tersebut. # API Direct Debit Status Inquiry *** Integrasi inquiry pada bertujuan supaya dapat terhubung dengan untuk melakukan pemeriksaan pada secara berkala. | **API Endpoint** | `/nicepay/direct/v2/inquiry ` | | ------------------ | ------------------------------------------------------------ | | **Request Method** | **POST****** | | **Description** | Performs Inquiry Request to for Status Checking | | **Merchant Token** | SHA256(`timeStamp`+`iMid`+`referenceNo`+`amt`+`merchantKey`) | | **Request Format** | `application/json` | :::hint{type="info"} Ketika diterima `dbProcessUrl` , kami sangat menganjurkan untuk melakukan verifikasi tersebut dengan menggunakan [Status Inquiry - API Direct Debit](docId\:TvyS0QCC6pqcXX8NulLFr). ::: :::hint{type="info"} `Notification Handling` sangat berguna untuk meminimalisir terjadinya *Fraud*. Kami sangat menganjurkan untuk melakukan verifikasi `Notification Handling`. Temukan lebih rinci mengenai `Notification Handling` pada [Notification - API Direct Debit](docId\:FkgudEVyTgI6wulN93-Xv). ::: ## Request Parameter for Direct Debit Status Inquiry *** Berikut ini adalah daftar untuk melakukan *request * inquiry pada . | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ------------------------------------------------------------ | -------- | ---------- | -------------------------------------- | ---------------------------------------------------------------- | | `timeStamp`
Required | N | 14 | Request Timestamp (`YYYYMMDDHH24MISS`) | 20220521144206 | | `tXid `
Required | AN | 30 | Transaction ID | TNICECP04104202205191442060467 | | `iMid`
Required | AN | 10 | ID | TNICECP041 | | `referenceNo `
Required | ANS | 40 | Order Number | 20220519144204 | | `amt `
Required | N | 12 | Transaction Amount | 2000 | | `merchantToken `
Required | AN | 255 | Token | 415c63ed51b7fd1f8fb39b48138cd15d8edf301309b2330f7548970196a0073c | ## Response Parameter for Direct Debit Status Inquiry *** Berikut ini adalah daftar *response *dari *request * inquiry pada . | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ---------------- | -------- | ---------- | ------------------------------------------------------------------------------------------------------------- | ------------------------------ | | `resultCd` | N | 4 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | 0000 | | `resultMsg ` | AN | 255 | Result Message: [Error Code](docId\:yEh1VA9k2y6sL1kQF2aWD) | unpaid | | `tXid ` | AN | 30 | Transaction ID | TNICECP04104202205191442060467 | | `iMid ` | AN | 10 | ID | TNICECP041 | | `referenceNo` | ANS | 40 | Reference Number | 20220519144204 | | `payMethod ` | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | 04 | | `amt ` | N | 12 | Amount | 2000 | | `CancelAmt` | N | 12 | Cancel Amount | null | | `reqDt` | N | 8 | Transaction Request Date (`YYYYMMDD`) | 20220519 | | `reqTm` | N | 6 | Transaction Request Time (`HH24MISS`) | 144206 | | `transDt` | N | 8 | Transaction Date (`YYYYMMDD`) | null | | `transTm` | N | 6 | Transction Time (`HH24MISS`) | null | | `depositDt ` | N | 8 | Transaction Deposit Date (`YYYYMMDD`) | null | | `depositTm ` | N | 6 | Transaction Deposit Time (`HH24MISS`) | null | | `mitraCd` | A | 4 | [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8) | null | | `instmntMon` | N | 2 | Installment Month | null | | `instmntType` | N | 2 | [Installment Type Code](docId:7CIX-U_4z295XgtNVEsbO) | 1 | | `cardNo` | N | 20 | Credit Card Number | null | | `preauthToken` | AN | 64 | Pre-Auth Token | null | | `acquBankCd` | A | 4 | [Acquiring Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | null | | `issuBankCd` | A | 4 | [Issuing Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | null | | `vacctValidDt` | N | 8 | VA Expiry Date (`YYYYMMDD`) | null | | `vacctValidTm` | N | 6 | VA Expiry Time (`HH24MISS`) | null | | `vacctNo` | N | 20 | Virtual Account No. | null | | `bankCd` | A | 4 | [Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | null | | `payNo` | N | 12 | CVS Number (CVS) | null | | `receiptCode` | ANS | 20 | Authorization Number | null | | `recurringToken` | AN | 64 | Recurring Token | null | | `ccTransType` | N | 2 | [Credit Card Transaction Type](docId:8m3-7Smhm_jhdrE5pCRzp) | null | | `payValidDt` | N | 8 | Expiry Date (`YYYYMMDD`) | null | | `payValidTm` | N | 6 | Expiry Time (`HH24MISS`) | null | | `mRefNo` | AN | 18 | Reference Number | null | | `acquStatus` | N | 2 | Purchase Status
`1`: Normal
`2`: Recurring
`3`: Pre-Auth
`4`: Capture | null | | `cardExpYymm` | N | 4 | Card Expiration (`YYMM`) | null | | `acquBankNm` | A | 255 | Acquiring Name | null | | `issuBankNm` | A | 255 | Issuing Name | null | | `depositDt` | N | 8 | Deposit Date (`YYYYMMDD`) | null | | `depositTm` | N | 6 | Deposit Time (`HH24MISS`) | null | | `paymentExpDt` | N | 6 | QR Expiry Date (`YYYYMMDD`) | null | | `paymentExpTm` | N | 6 | QR Expiry Time (`HH24MISS`) | null | | `paymentTrxSn` | N | 32 | Transaction Number | null | | `cancelAmt` | N | 12 | Cancel Amount | null | | `cancelTrxSn` | AN | 32 | Cancel Transaction Number | null | | `currency ` | A | 3 | Currency | IDR | | `goodsNm ` | AN | 100 | Goods Name | Test Transaction | | `billingNm ` | A | 100 | Buyer Name | John Doe | | `status ` | N | 1 | [Payment Status Code](docId:8m3-7Smhm_jhdrE5pCRzp) | 9 | | `userId` | AN | 128 | User ID Hash | null | | `shopId` | AN | 32 | Shop ID | null | Sample JSON for Direct Debit Status Inquiry ------------------------------------------------- *** :::CodeblockTabs JSON Request ```json { "timeStamp":"20220521144206", "tXid":"TNICECP04104202205191442060467", "iMid":"TNICECP041", "referenceNo":"20220519144204", "amt":"2000", "merchantToken":"415c63ed51b7fd1f8fb39b48138cd15d8edf301309b2330f7548970196a0073c" } ``` JSON Response ```json { "tXid": "TNICECP04104202205191442060467", "iMid": "TNICECP041", "currency": "IDR", "amt": "2000", "instmntMon": null, "instmntType": "1", "referenceNo": "20220519144204", "goodsNm": "Test Transaction", "payMethod": "04", "billingNm": "John Doe", "reqDt": "20220519", "reqTm": "144206", "status": "9", "resultCd": "0000", "resultMsg": "init", "cardNo": null, "preauthToken": null, "acquBankCd": null, "issuBankCd": null, "vacctValidDt": null, "vacctValidTm": null, "vacctNo": null, "bankCd": null, "payNo": null, "mitraCd": null, "receiptCode": null, "cancelAmt": null, "transDt": null, "transTm": null, "recurringToken": null, "ccTransType": null, "payValidDt": null, "payValidTm": null, "mRefNo": null, "acquStatus": null, "cardExpYymm": null, "acquBankNm": null, "issuBankNm": null, "depositDt": null, "depositTm": null, "paymentExpDt": null, "paymentExpTm": null, "paymentTrxSn": null, "cancelTrxSn": null, "userId": null, "shopId": null } ``` Java Request ```java //Inquiry Registration// nicePay.setTimeStamp("20220521144206"); nicePay.setiMid("TNICECP041"); nicePay.setAmt("2000"); nicePay.setReferenceNo("20220519144204"); nicePay.setMerchantToken(nicePay.makeToken(nicePay.getMerchantToken()); nicePay.settXid("TNICECP04104202205191442060467"); // Request Inquiry nicePay.inquiry(); // Response String // System.out.println("Final Response String : " + nicePay.getResponseString()); String resultCd = nicePay.Get("resultCd"); String resultMsg = nicePay.Get("resultMsg"); String tXid = nicePay.Get("tXid"); String referenceNo = nicePay.Get("referenceNo"); String payMethod = nicePay.Get("payMethod"); String status = nicePay.Get("status") String amt = nicePay.Get("amt"); String transDt = nicePay.Get("transDt"); String transTm = nicePay.Get("transTm"); String shopId = nicePay.Get("shopId"); ``` ::: [title] NICEPAY Code [path] NICEPAY API/API Non-SNAP/ **NICEPAY Code** adalah kumpulan daftar digunakan dalam atau tertentu pada . ::::LinkArray{contentSource="CUSTOM"} :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/IEBaXXC-sJ6Rqn2TwkuRi-20260323-074832.jpg"} [Field Type Code](docId\:AeTs-HU1GGg2-R2SMB-le) adalah daftar kode tipe data digunakan dalam . ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/1xRwSk4M6iTcWkdO4HNvz-20260323-074911.jpg"} [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) adalah daftar kode digunakan dalam . ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/L6F9BvhMjMm0Jf9lC2ae7-20260323-074951.jpg"} [Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) adalah daftar kode digunakan dalam . ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/TP6gET6POepkMMDvnDnaX-20260323-075112.jpg"} [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8) adalah daftar kode digunakan dalam . ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/2vk6mWwLJI89KHkJ5MiYP-20260323-075728.jpg"} [Payment Status Code](docId:8m3-7Smhm_jhdrE5pCRzp) adalah daftar kode digunakan dalam . ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/b1sPj_rPLa5G351amPgYQ-20260323-075809.jpg"} [Notification Status Code](docId\:CdRwf99UxER6PH64ADA2C) adalah daftar kode digunakan dalam . ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/OGBJcjPCHoKM-vymT9O9C-20260323-080201.jpg"} [Notification Match Amount Indicator](docId\:WdoGjBeqc1VmRdFJqG1ZE) adalah daftar kode untuk mengetahui apakah *amount *pada CVS dan VA sama dalam . ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/hlHq6xsBkzuWV1wkEmw4_-20260323-080254.jpg"} [Installment Type Code](docId:7CIX-U_4z295XgtNVEsbO) adalah daftar kode tipe Installment digunakan dalam . ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/2jvzsTub8UZNtTEug1mYp-20260323-080417.jpg"} [Cancel Type Code](docId\:Mq9xE7wdOPR8OkZ3v-pVc) adalah daftar kode tipe pembatalan digunakan dalam . ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/sylN7yaY16H1nJOYssLH3-20260323-082748.jpg"} [Error Code](docId\:yEh1VA9k2y6sL1kQF2aWD) adalah daftar kode *error * digunakan dalam . ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/uwXjzIzVcuF-TdIRW1HX_-20260323-082814.jpg"} [Merchant Code](docId\:RLvep_EvtW-vtO2tMBVbd) adalah daftar kode digunakan dalam . ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/H9sqrRZq7pxG6ImPHhDz7-20260323-082842.jpg"} [Response Code](docId\:FBaoaTzInzEBrMMgeVNDH) adalah daftar kode *response * digunakan dalam . ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/FjVw0-29obS_o8j9qyQia-20260323-083409.jpg"} [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) adalah daftar kode hasil digunakan dalam . ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/UfoUMm4m3tDKaAnw9dDPI-20260323-083457.jpg"} [Recurring Type Code](docId:7huicmz14lpUcQs_mVmFs) adalah daftar kode tipe Recurring digunakan dalam . ::: :::: # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [API Checkout](docId\:Djp90D-rlCNeDCzKwGC-d) untuk mengetahui digunakan pada *checkout*. ::: :::VerticalSplitItem [Payment API](docId\:OK8pnFvDrqo-4Qq3umLQz) untuk mengetahui digunakan pada setiap . ::: :::: ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Advance API](docId\:qyS-Qyem-hUj6iKk-tAu7) untuk mengetahui rincian khusus lebih terdepan. ::: :::VerticalSplitItem ::: :::: [title] Status Inquiry - API Credit Card [path] NICEPAY API/API Non-SNAP/Payment API/API Credit Card/ # Tentang Status Inquiry - API Credit Card *** Integrasi dengan Status Inquiry pada diperlukan supaya dapat memeriksa pada sedang berlangsung baik berstatus *success*, *fail*, dan lainnya. # Status Inquiry - API Credit Card *** Integrasi inquiry pada bertujuan supaya dapat terhubung dengan untuk melakukan pemeriksaan pada . | **API End Point** | `/nicepay/direct/v2/inquiry ` | | ------------------ | ------------------------------------------------------------ | | **Request Method** | **POST****** | | **Description** | Performs Inquiry Request to for Status Checking | | **Merchant Token** | SHA256(`timeStamp`+`iMid`+`referenceNo`+`amt`+`merchantKey`) | | **Request Format** | `application/json` | :::hint{type="info"} Ketika diterima `dbProcessUrl` , kami sangat menyarankan untuk melakukan verifikasi tersebut dengan menggunakan [Status Inquiry - API Credit Card](docId\:voJ9rhAQRLcF-_74cYrFi). ::: :::hint{type="info"} `Notification Handling` sangat berguna untuk meminimalisir terjadinya *Fraud*. Kami sangat menganjurkan untuk memverifikasi `Notification Handling`. dapat membaca lebih rinci mengenai `Notification Handling` pada [Notification - API Credit Card](docId\:kC5XHZ2fbwmcDcmh2iBJ5). ::: ## Request Parameter for Status Inquiry - API Credit Card *** Berikut ini adalah daftar untuk melakukan *request * inquiry pada . | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ------------------------------------------------------------ | -------- | ---------- | -------------------------------------- | ----------------------------------- | | `timeStamp`
Required | N | 14 | Request Timestamp (`YYYYMMDDHH24MISS`) | 20221214091282 | | `tXid `
Required | AN | 30 | Transaction ID | IONPAYTEST01202212140949101366 | | `iMid`
Required | AN | 10 | ID | IONPAYTEST | | `referenceNo `
Required | ANS | 40 | Order Number | ordNo20221214091293
| | `amt `
Required | N | 12 | Transaction Amount | 5000 | | `merchantToken `
Required | AN | 255 | Token | 7eceb5801db4e039223698c4eb9... | ## Response Parameter for Status Inquiry - API Credit Card *** Berikut ini adalah daftar *response *dari pengajuan inquiry pada . | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ---------------- | -------- | ---------- | ----------------------------------------------------------- | ------------------------------ | | `resultCd` | N | 4 | [Result Code](docId\:gvAdBBr0SQ92N1zHplSFM) | 0000 | | `resultMsg ` | AN | 255 | Result Message: [Error Code](docId\:yEh1VA9k2y6sL1kQF2aWD) | Paid | | `tXid` | AN | 30 | Transaction ID | IONPAYTEST01202212140949101366 | | `iMid` | AN | 10 | ID
| IONPAYTEST | | `currency` | A | 3 | Currency | IDR | | `instmntMon` | N | 2 | Installment Month | 1 | | `instmntType` | N | 2 | [Installment Type Code](docId:7CIX-U_4z295XgtNVEsbO) | 1 | | `referenceNo ` | ANS | 40 | Reference Number | ordNo20221214091293 | | `payMethod` | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | 01 | | `amt` | N | 12 | Amount | 5000 | | `CancelAmt` | N | 12 | Cancel Amount | null | | `reqDt ` | N | 8 | Transaction Request Date (`YYYYMMDD`)** ** | 20221214 | | `reqTm ` | N | 6 | Transaction Request Time (`HH24MISS`) | 094910 | | `status` | N | 1 | [Transaction Status](docId:5kyLpX5MpjSl96c8mhOik) | 0 | | `transDt` | N | 8 | Transaction Date (`YYYYMMDD`) | 20221214 | | `transTm` | N | 6 | Transaction Time (`HH24MISS`) | 094910 | | `depositDt` | N | 8 | Transaction Deposit Date (`YYYYMMDD`) | null | | `depositTm` | N | 6 | Transaction Deposit Time (`HH24MISS`) | null | | `currency` | A | 3 | Currency | IDR | | `goodsNm ` | AN | 100 | Goods Name | Goods | | `billingNm ` | A | 100 | Buyer name | John Doe | | `status` | N | 1 | [Payment Status Code](docId:8m3-7Smhm_jhdrE5pCRzp) | 0 | ## Additional Response Parameter for Status Inquiry - API Credit Card *** Berikut ini adalah daftar *response *tambahan dari *request* inquiry pada . | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Catatan / Contoh** | | ---------------- | -------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------- | | `authNo` | N | 10 | Auth Number | 101366 | | `issuBankCd` | A | 4 | [Issuing Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | OTHR | | `acquBankCd` | A | 4 | [Acquiring Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | BMRI | | `acquBankNm` | A | 255 | Acquiring Name | Mandiri | | `vacctValidDt` | N | 8 | VA Expiry Date (`YYYYMMDD`) | null | | `vacctValidTm` | N | 6 | VA Expiry Time (`HH24MISS`) | null | | `vacctNo` | N | 20 | Number | null | | `bankCd` | A | 4 | [Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | null | | `payNo` | N | 12 | CVS Number | null | | `mitraCd` | A | 4 | [Mitra Code](docId\:DwzaQDD7DXZMECz80A6o8) | null | | `receiptCode` | ANS | 20 | Authorization Number | null | | `cancelAmt` | N | 12 | Cancel Amount | null | | `payValidDt` | N | 8 | CVS Expiry Date (`YYYYMMDD`) | null | | `payValidTm` | N | 6 | CVS Expiry Time (`HH24MISS`) | null | | `mRefNo` | AN | 20 | Reference Number | | | `issuBankNm` | A | 100 | Issuing Name | OTHER | | `paymentExpDt` | N | 6 | Expiry Date (`YYYYMMDD`) | null | | `paymentExpTm` | N | 6 | Expiry Time (`HH24MISS`) | null | | `paymentTrxSn` | AN | 32 | Transaction Number | null | | `userId` | AN | 128 | User ID Hash | null | | `shopId` | AN | 32 | Shop ID | null | | `cardNo` | ANS | 20 | Masked Card Number | 453211\*1111 | | `cardExpYymm` | N | 4 | Card Expiration (`YYMM`) | 2712 | | `instmntMon` | N | 2 | Installment Month | 1 | | `instmntType` | N | 2 | [Installment Type Code](docId:7CIX-U_4z295XgtNVEsbO) | 1 | | `preauthToken` | AN | 255 | Pre-Auth Token (Needed for Capture ) | null | | `recurringToken` | AN | 255 | Recurring Token (Needed for Recurring ) | null | | `ccTransType` | N | 2 | [Credit Card Transaction Type](docId:8m3-7Smhm_jhdrE5pCRzp) | 1 | | `acquStatus` | N | 2 | Purchase Status
`1`: Normal
`2`: Recurring
`3`: Pre-Auth
`4`: Capture | 10 | | `acquirerData` | Array | 20 | A dynamic array consisting of a unique reference number RRN that is provided by ing when a refund is ed. This reference number can be used by to track of refund with . | `"acquirerData": {`
` "rrn": "332608321717"`
` }` | ## Sample Parameter for Status Inquiry - API Credit Card *** ### Request Parameter :::CodeblockTabs cURL ```curl curl --location 'https://dev.nicepay.co.id/nicepay/direct/v2/inquiry' \ --header 'Content-Type: application/json' \ --data '{ "timeStamp": "20221214091282", "tXid": "IONPAYTEST01202212140949101366", "iMid": "IONPAYTEST", "merchantToken": "7eceb5801db4e039223698c4eb9871432217132d8b0483122001a2569e8c7537", "referenceNo": "ordNo20221214091293", "amt": "5000" }' ``` Node.js ```nodejs const config = { isProduction: true, isCloudServer: false, merchantKey: "YOUR_MERCHANT_KEY", clientId: "IONPAYTEST", privateKey: cons.privateKey, clientSecret: cons.clientSecret, }; const parameter = { timeStamp: "20221214091282", tXid: "IONPAYTEST01202212140949101366", iMid: "IONPAYTEST", referenceNo: "ordNo20221214091293", amt: "5000", }; const secondVersion = new SecondApiVersion(config); const response = await secondVersion.requestAPI(parameter, "/direct/v2/inquiry"); console.log("Inquiry Response:", response); ``` ```java config = NICEPay.builder() .isProduction(false) .isCloudServer(false) .timestamp("20221214091282") .build(); String timestamp = "20221214091282"; String imid = "IONPAYTEST"; String merchantKey = TestingConstants.MERCHANT_KEY; String reffNo = "ordNo20221214091293"; String amount = "5000"; InquiryStatus requestData = InquiryStatus.builder() .timeStamp(timestamp) .tXid("IONPAYTEST01202212140949101366") .iMid(imid) .referenceNo(reffNo) .merchantToken(timestamp, imid, reffNo, amount, merchantKey) .amt(amount) .build(); NICEPayResponseV2 result = V2CardService.callV2InquiryStatus(requestData, config); System.out.println("Inquiry Response: " + result); ``` ```python bodyInquiry = ( builderInquiry.BuildInquiry() .setTxid("IONPAYTEST01202212140949101366") .setReferenceNo("ordNo20221214091293") .setAmt("5000") .build() ) environment = ( builderEnvironment.BuildEnvironment() .isCloud(False) .isProduction(False) .build() ) response = ServiceNicepay.serviceInquiry( DataGenerator.getInquiryBody(bodyInquiry.jsonInquiry()), environment ) ``` C# ```csharp string merchantKey = config.MerKey; string clientId = config.ClientId; string timestamp = "20221214091282"; string tXid = "IONPAYTEST01202212140949101366"; string refNo = "ordNo20221214091293"; string amount = "5000"; bool isProduction = true; bool isCloudServer = false; // Generate merchant token using provided JSON values var builder = new MerchantTokenBuilder() .SetTimeStamp(timestamp) .SetIMid(clientId) .SetTXid(tXid) .SetAmount(amount) .SetMerchantKey(merchantKey); string merchantToken = builder.BuildMerchantToken(); Console.WriteLine("Create Merchant Token: " + merchantToken); // Build Check Status request using JSON values var Bodybuilder = new NicepayRequestBuilder() .SetCheckStatus( iMid: clientId, timeStamp: timestamp, tXid: tXid, amt: amount, referenceNo: refNo, merchantToken: merchantToken ); ApiEndpoints apiEndpoints = new ApiEndpoints(); Dictionary payload = Bodybuilder.Build(); string jsonPayload = Newtonsoft.Json.JsonConvert.SerializeObject(payload); var checkStatusService = new NicepayRegistrationService(apiEndpoints, isProduction, isCloudServer); var result = await checkStatusService.SendPostAsync(apiEndpoints.InquiryV2, payload); ``` Laravel ```php protected $useProd = false; protected $useCloud = false; protected $inquiry_endpoint = "/nicepay/direct/v2/inquiry"; $url = HttpUtil::getNicepayDomain($this->useProd, $this->useCloud) . $this->inquiry_endpoint; // Request body parameter from JSON $timestamp = "20221214091282"; $txid = "IONPAYTEST01202212140949101366"; $reference_no = "ordNo20221214091293"; $amt = "5000"; $merchant_token = "7eceb5801db4e039223698c4eb9871432217132d8b0483122001a2569e8c7537"; $body = [ "timeStamp" => $timestamp, "tXid" => $txid, "iMid" => "IONPAYTEST", "merchantToken" => $merchant_token, "referenceNo" => $reference_no, "amt" => $amt, ]; try { $response = HttpUtil::postJsonRequest($url, $body); } catch (\Exception $e) { echo "Inquiry failed: " . $e->getMessage(); } ``` PHP Native ```php $timeStamp = "20221214091282"; $txId = "IONPAYTEST01202212140949101366"; $iMid = "IONPAYTEST"; $referenceNo = "ordNo20221214091293"; $amount = "5000"; $config = $this->v2Config; $parameter = InquiryStatus::builder() ->setTimeStamp($timeStamp) ->setTxId($txId) ->setIMid($iMid) ->setMerchantToken($timeStamp, $iMid, $referenceNo, $amount, $this->merchantKey) ->setReferenceNo($referenceNo) ->setAmt($amount) ->build(); $cardService = new V2CardService($config); $response = $cardService->inquiryStatus($parameter); ``` ```kotlin val request: DirectV2CheckStatus = DirectV2CheckStatus.Builder() .timeStamp("20221214091282") .tXid("IONPAYTEST01202212140949101366") .iMid("IONPAYTEST") .merchantKey(DEFAULT_MERCHANT_KEY) .referenceNo("ordNo20221214091293") .amt("5000") .build() val response: NICEPayResponseV2 = v2CardService.checkStatus(request, config)!! ``` CodeIgniter ```php $timeStamp = "20221214091282"; $reffNo = "ordNo20221214091293"; $amount = "5000"; $config = $this->v2Config; $parameter = InquiryStatus::builder() ->setTimeStamp($timeStamp) ->setTxId("IONPAYTEST01202212140949101366") ->setIMid("IONPAYTEST") ->setMerchantToken($timeStamp, "IONPAYTEST", $reffNo, $amount, $this->merchantKey) ->setReferenceNo($reffNo) ->setAmt($amount) ->build(); $v2CardService = new V2CardService($config); $response = $v2CardService->inquiryStatus($parameter); ``` ::: ### Response Parameter :::CodeblockTabs Sample Response ```json { "tXid": "IONPAYTEST01202212140949101366", "iMid": "IONPAYTEST", "currency": "IDR", "amt": "5000", "instmntMon": "1", "instmntType": "1", "referenceNo": "ordNo20221214091293", "goodsNm": "Goods", "payMethod": "01", "billingNm": "Hantu Kesorean", "reqDt": "20221214", "reqTm": "094910", "status": "0", "resultCd": "0000", "resultMsg": "paid", "cardNo": "453211*****1111", "preauthToken": null, "acquBankCd": "BMRI", "issuBankCd": "OTHR", "vacctValidDt": null, "vacctValidTm": null, "vacctNo": null, "bankCd": null, "payNo": null, "mitraCd": null, "receiptCode": null, "cancelAmt": null, "transDt": "20221214", "transTm": "094910", "recurringToken": null, "ccTransType": "1", "payValidDt": null, "payValidTm": null, "mRefNo": null, "acquStatus": "10", "cardExpYymm": "2712", "acquBankNm": "Mandiri", "issuBankNm": "OTHER", "depositDt": null, "depositTm": null, "paymentExpDt": null, "paymentExpTm": null, "paymentTrxSn": null, "cancelTrxSn": null, "userId": null, "shopId": null, "authNo": "101366", "acquirerData": { "rrn": null } } ``` ::: [title] Notification - API Credit Card [path] NICEPAY API/API Non-SNAP/Payment API/API Credit Card/ # Tentang Notification - API Credit Card *** mengirimkan *push notification* dikirim melalui `dbProcessUrl` . harus memastikan tidak melakukan Blacklist IP dan melakukan Whitelist IP untuk mendapatkan *push notification* hanya dikirim dari server . | **Request Method** | **POST****** | | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Merchant Token** | SHA256 ( `iMid`+ `tXid` + `amt`+ `merchantKey`) | | **IP** | IP Public environtment Production:
`103.20.51.34`
`103.20.51.33`
`18.98.96.50`

IP Public environtment Dev:
`103.20.51.39`
`103.20.51.40`
`18.98.96.54` | | **User-Agent** | `User-Agent: Jakarta Commons-HttpClient/3.1` | # Notification Parameter for Notification - API Credit Card *** :::hint{type="info"} Ketika Notifikasi diterima pada `dbProcessUrl` , kami sangat menyarankan untuk melakukan verifikasi kembali dengan menggunakan [Status Inquiry - API Credit Card](docId\:voJ9rhAQRLcF-_74cYrFi). ::: | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ----------------------- | -------- | ---------- | ---------------------------------------------------------------------------------------------------------------- | -------------------- | | `tXid ` | N | 30 | Transaction ID | | | `merchantToken` | AN | 255 | Token | | | `referenceNo` | ANS | 40 | Order Number | | | `payMethod ` | N | 2 | [Payment Method Code](docId\:g7inRV70XcSA9lP7bpmok) | | | `amt ` | N | 12 | Amount | | | `transDt` | N | 8 | Transaction Date | | | `transTm` | N | 6 | Transaction Time | | | `currency ` | A | 3 | Currency | | | `goodsNm` | AN | 100 | Goods Name | | | `billingNm` | A | 100 | Billing Name | | | `matchCl ` | N | 1 | Flag: [Notification Match Amount Indicator](docId\:WdoGjBeqc1VmRdFJqG1ZE) | | | `status` | A | 1 | Deposit Status: [Notification Status Code](docId\:CdRwf99UxER6PH64ADA2C)
`0` : Deposit
`1` : Reversal | | | `cpGuaranteeableStatus` | N | 2 | Cp Guaranteeable Status | | # Additional Parameter for Notification - API Credit Card *** | **Parameter** | **Tipe** | **Ukuran** | **Deskripsi** | **Contoh / Catatan** | | ---------------- | -------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------ | -------------------- | | `authNo` | N | 10 | Approval Number | | | `IssueBankCd ` | A | 4 | [Issuing Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | | | `issueBankNm` | A | 100 | Issuing Name | | | `acquBankCd` | A | 4 | [Acquiring Bank Code](docId:1U7QOax_wrzXMoCG-Mqad) | | | `acquBankNm ` | A | 4 | Acquiring Name | | | `cardNo ` | ANS | 20 | Card Number with Masking | | | `cardExpYymm ` | N | 4 | Card Expiry (`YYMM`) | | | `instmntMon ` | N | 2 | Installment Month | | | `instmntType` | N | 2 | [Installment Type Code](docId:7CIX-U_4z295XgtNVEsbO) | | | `preauthToken ` | AN | 255 | Pre-Auth Token | | | `recurringToken` | AN | 255 | Recurring token | | | `cc_trans_type` | A | 2 | [Credit Card Transaction Type](docId:8m3-7Smhm_jhdrE5pCRzp)
`1` : Normal
`2` : Recurring
`3` : Pre-Auth
`4` : Captured | | | `vat` | N | 12 | Number | | | `fee ` | N | 12 | Service Fee | | | `notaxAmt ` | N | 12 | Tax Free Amount | | :::hint{type="warning"} Token diterima dari *Notification*, harus melakukan perbandingan kembali secara internal untuk mencegah palsu/tidak berlaku. ::: # Sample Parameter for Notification - API Credit Card *** ## Request Parameter :::CodeblockTabs cURL ```curl curl -X POST "https://www.merchantdbprocessurl.com" \ -H "Content-Type: application/x-www-form-urlencoded" \ -d "ccTransType=1" \ -d "fee=0" \ -d "tXid=IONPAYTEST01202212141419051594" \ -d "amt=5000" \ -d "notaxAmt=0" \ -d "cardNo=453211*****1111" \ -d "issuBankCd=OTHR" \ -d "matchCl=1" \ -d "preauthToken=null" \ -d "cardExpYymm=2712" \ -d "acquBankNm=Mandiri" \ -d "payMethod=01" \ -d "currency=IDR" \ -d "instmntMon=1" \ -d "cc_trans_type=1" \ -d "issuBankNm=" \ -d "merchantToken=f8e51ce8c14527592c9a5f1df61975759123c93a75861c7629cc20f32b1d376b" \ -d "goodsNm=Goods" \ -d "referenceNo=ordNo20221214141284" \ -d "authNo=051594" \ -d "transTm=141905" \ -d "cpGuaranteeableStatus=null" \ -d "recurringToken=null" \ -d "vat=0" \ -d "instmntType=1" \ -d "billingNm=John+Doe" \ -d "acquBankCd=BMRI" \ -d "transDt=20221214" \ -d "status=0" ``` ::: ## Response Parameter ```json { "responseCode": 200, "responseMessage": "Success" } ``` [title] Kredivo [path] Payment/Payloan/Panduan Bayar Payloan/ ::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/bLPsOlqN8rrCNuDMQSYqV_image.png" size="50" width="932" height="316" caption="Kredivo" position="center" darkWidth="932" darkHeight="316" showCaption="true"} # Informasi Nomor Pembayaran *** :::hint{type="info"} Pastikan melakukan sebelum masa berlaku habis. ::: | **Mitra Paylater** | Kredivo | | ------------------- | ------------------------------------- | | **Nominal** | Rp10.000 | | **Nama Penerima** | `billingNm` | | **Nomor Pemesanan** | Invoice-1234 | | **Masa Berlaku** | 16-06-2016 / 17:15:00
| # Pembayaran *** Kredivo Payment Page Langkah dengan Kredivo 1. Pilih Pembayaran melalui `Kredivo`. 2. akan dipindahkan ke `Halaman Pembayaran Kredivo`. 3. Masuk menggunakan akun dan OTP. 4. Pastikan `Credit Limit` Anda cukup. 5. Lanjut dan Konfirmasi. 6. Pembayaranmu sudah `Berhasil`! akan dipindahkan ke *result* *page*. file format JSON Panduan Bayar Kredivo untuk operasi . ::File{src="https://archbee-doc-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/1yhqQfj-tVmum00WEPXTe_payloanindkredivo.json" label="PAYLOAN_IND_KREDIVO.json"} [title] Payout [path] / ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/Iq9hulGDjvSs2n-_GDdU8_payout.jpg "Payout") # Tentang Payout *** adalah dari memungkinkan untuk mengirimkan sejumlah dana kepada Penerima dituju lewat via dan menarik sejumlah dana melalui , yaitu Indomaret secara tunai. Dengan demikian, terbagi menjadi dua , yaitu: 1. : pengiriman dana. 2. : penarikan dana. :::hint{type="danger"} Proses wajib dilakukan bagi telah menggunakan Direct V2 /Enterprise V1. kunjungi halaman [Implementasi SNAP](docId:9NC4zMt_CIYOOoQ3RweUm) untuk mengetahui alur migrasi pada . ::: ## Layanan Disbursement *** **Disbursement **merupakan sebuah untuk mengirimkan sejumlah dana ke penerima dana dalam skala besar secara *online* dan *real-time. *Dengan menggunakan ini, dapat melakukan pengiriman dana antar untuk beberapa penerima dana secara bersamaan. Pada umumnya, ini digunakan untuk melakukan gaji karyawan *(payroll*), melunasi biaya kontrak , serta pembagian *cashback* dari suatu promo iklan produk kepada . ## Layanan Cashout *** **Cashout **merupakan sebuah tarik tunai tanpa kartu tersedia pada dan dapat digunakan oleh kepada nya***. ***Saat ini, bekerja sama dengan Indomaret untuk menyediakan ini di seluruh cabang Indomaret tersebar di . :::hint{type="info"} - kunjungi [Metode Payout](docId\:WBZdLVm1w_QrVjXtPZ_0J) untuk mendapatkan penjelasan lebih lanjut terkait . ::: Pelajari lebih lanjut terkait metode di Indomaret melalui demo di bawah ini. :::Iframe{iframeHeight="0" code=""Directory "} ::: # Keuntungan Menggunakan Payout NICEPAY *** Sistem kami memiliki banyak keuntungan bagi , yakni: 1. Memudahkan dalam melakukan transfer dengan jumlah Penerima banyak serta lebih dari satu dalam satu kali . 2. Proses pengiriman dana antar mudah, cepat, dan aman. 3. Mengirimkan dana kepada lebih dari 140 terdaftar di 4. Memfasilitasi pengiriman dana secara terprogram menggunakan . 5. Laporan jelas, konsisten, lengkap dan akurat. 6. Memenuhi standar Penyelenggara Transfer Dana dari . 7. Memudahkan penarikan dana oleh melalui Indomaret tanpa menggunakan mesin ATM. :::hint{type="info"} kunjungi [Produk & Biaya Layanan](docId:2deQYlDf8Az72oHGYaV7_) untuk lebih lanjut mengenai biaya standar. ::: # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Messaging](docId\:TUr_6cb3iEKRgA0L6OO46) untuk mempelajari mengirim pesan dimiliki . ::: :::VerticalSplitItem [Payout API (Disbursement) - SNAP](docId\:pImeP_3g-q6QNBFmwvkOr) untuk mempelajari rincian digunakan. ::: :::: [title] Fitur CVS [path] Payment/Convenience Store (CVS)/ # Tipe Nomor CVS *** Berikut penjelasan terkait fitur CVS beserta deskripsinya. | **Fitur** | **Deskripsi** | | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Normal Account | Pada Normal Account, nomor tagihan CVS akan secara otomatis dibuat secara acak oleh sesuai dengan limit nomor virtual pada setiap toko . | | Fixed Account | Nomor CVS ini bersifat statis dan dapat dibuat sesuai keinginan , seperti nomor terkait dengan identitas biasanya diwakili oleh nomor HP ataupun dapat juga dibuat secara acak oleh secara otomatis sesuai dengan limit nomor virtual pada setiap toko kami. | | Close Amount | CVS hanya mendukung fitur *close amount*. Pada CVS berjenis *closed amount*, pembayarannya akan berhasil apabila nominal dibayarkan oleh sesuai dengan nominal ditentukan oleh . Dengan demikian, wajib untuk mengatur *field amount* nomor CVS tersebut sebelum terjadi. | # See also ::::VerticalSplit :::VerticalSplitItem [Alur Pembayaran CVS](docId\:Qb3J_IzkOf9DEI_8Zk32W) untuk mengetahui pada saat melakukan dengan . ::: :::VerticalSplitItem [Integrasi & Testing CVS](docId:6zSlSRyypvTgFXAKRIXHI) untuk mengetahui cara dan uji coba pada . ::: :::: ::::VerticalSplit :::VerticalSplitItem [Daftar Istilah CVS](docId:-M-nZrtY-prU0aJjTYj9g) untuk mengetahui istilah khusus digunakan oleh . ::: :::VerticalSplitItem [FAQ CVS](docId\:Bf4kvuVF_blHBxysENnWn) jika ingin mengetahui pertanyaan sering diajukan terkait . ::: :::: [title] ALTO [path] Payment/Virtual Account (VA)/Panduan Bayar VA/ ::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/a30xjRXMC9AyhFCjRvg2d_alto.jpg" size="50" width="500" height="500" caption="ALTO" position="center" darkWidth="500" darkHeight="500" showCaption="true"} :::hint{type="info"} Pastikan melakukan transfer dana sebelum masa berlaku habis dan dengan nominal tepat ::: | **Nomor Virtual Account** | `484XXXXXXXXXXXXX` | | ------------------------- | --------------------------- | | **Bank** | Keb Hana | | **Nominal** | Rp10.000 | | **Nama Penerima** | `Merchant Name - billingNm` | | **Nomor Order** | Invoice-1234 | | **Masa Berlaku** | 16-06-2016 / 17:15:00 | file format JSON Panduan Bayar ALTO untuk operasi . ::File{src="https://archbee-doc-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/m4bU16YF8y-oP0I6c7vle_va-ind-alto.json" label="VA_IND_ALTO.json"} # ATM *** 1. nomor kartu `ATM`dan `PIN` Anda. 2. `Transfer`, kemudian pilih `Bank Lainnya`. 3. kode `Keb Hana Bank`: `484`. 4. `Virtual Account Number` yang diberikan, misal `484XXXXXXXXXXXXX`. 5. `Nominal` hendak dibayarkan, misal `10.000`. 6. Ikuti instruksi selanjutnya untuk menyelesaikan . # Mobile/Internet Banking *** 1. Masuk ke akun `Mobile/Internet Banking` Anda. 2. `Transfer`, kemudian pilih `Keb Hana Bank` atau masukkan kode `Keb Hana Bank`: `484`. 3. `Virtual Account Number` diberikan, misal `484XXXXXXXXXXXXX`. 4. `Nominal` hendak dibayarkan, misal `10.000`. 5. Ikuti instruksi selanjutnya untuk menyelesaikan . [title] Bank CIMB Niaga [path] Payment/Virtual Account (VA)/Panduan Bayar VA/ ::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/PFz_3w09OIm7W6by76H3L_cimb.png" size="50" width="1024" height="1024" caption="Bank CIMB NIAGA" position="center" darkWidth="1024" darkHeight="1024" showCaption="true"} :::hint{type="info"} Pastikan melakukan transfer dana sebelum masa berlaku habis dan dengan nominal tepat. ::: | **Nomor Virtual Account** | `5919XXXXXXXXXXXX` | | ------------------------- | --------------------------- | | **Bank** | CIMB | | **Nominal** | Rp10.000 | | **Nama Penerima** | `Merchant Name - billingNm` | | **Nomor Order** | Invoice-1234 | | **Masa Berlaku** | 16-06-2016 / 17:15:00 | file format JSON Panduan Bayar Bank CIMB Niaga untuk operasi . ::File{src="https://archbee-doc-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/dhK8hNNrz7tbJ786rlFOx_va-ind-cimb.json" label="VA_IND_CIMB.json"} # ATM *** 1. kartu `ATM` dan `PIN` . 2. `Pembayaran`. 3. `Lanjut`. 4. `Virtual Account`. 5. `Nomor Virtual Account`, misal `59190XXXXXXXXXXX` sebagai kode bayar. 6. `Proses`. 7. Rincian data akan ditampilkan pada layar. 8. `Proses`. 9. Silakan ambil bukti bayar . 10. Selesai. # Mobile Banking *** 1. Akses aplikasi `Go Mobile`. 2. `Transfer`. 3. `Transfer ke CIMB Niaga Lain`. 4. sumber dana akan digunakan. 5. `Nomor Virtual Account`, misal `59190XXXXXXXXXXX` sebagai kode bayar. 6. `Nominal`, misal `10000`. 7. `Lanjut`. 8. Rincian data akan ditampilkan pada layar. 9. `PIN Mobile`. 10. `Konfirmasi`. 11. Bukti akan dikirim melalui . 12. Selesai. # Internet Banking *** 1. Akses `Internet Banking`. 2. `Bayar Tagihan`. 3. rekening sumber akan gunakan. 4. jenis `Virtual Account`. 5. `Masukkan Nomor Virtual Account` untuk melakukan . 6. `Nomor Virtual Account`, misal `59190XXXXXXXXXXX` sebagai kode bayar. 7. Isi `Remark` jika diperlukan. 8. `Lanjut`. 9. Rincian data akan ditampilkan pada layar. 10. `mPIN`. 11. `Kirim`. 12. Rincian data akan ditampilkan pada layar. 13. Selesai. [title] Aturan dan Limitasi Direct Debit [path] Payment/Direct Debit/ Berikut adalah ketentuan batas nominal menggunakan . | **Jenis Aturan & Limitasi** | **Jenius Pay** | | --------------------------- | -------------- | | Nominal Minimal Transaksi | Rp10.000 | | Nominal Maksimal Transaksi | Rp100.000.000 | # See also ::::VerticalSplit :::VerticalSplitItem [Penyelesaian Transaksi Pada Direct Debit](docId\:Q1PAefVtNESlg13MVALgI) untuk mengetahui macam-macam cara menyelesaikan . ::: :::VerticalSplitItem [FAQ Direct Debit](docId\:RWli_xmLMdOHPpXlQDUEx) jika ingin mengetahui pertanyaan sering diajukan terkait . ::: :::: [title] Convenience Store (CVS) [path] Payment/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/QxIGjwlSxGgR8T1u1k4d7_header-20.png "Convenience Store Partner") # Tentang Convenience Store *** **Convenience Store (CVS) **merupakan tagihannya dapat dibayarkan secara langsung di Mini Market sering jumpai, seperti Alfamart dan Indomaret. Dengan hanya memberikan nomor tagihan CVS kepada kasir Mini Market tersebut dari *online*, dengan mudah dapat menyelesaikan tagihkan tanpa harus memiliki rekening atau sekalipun. # Partner CVS NICEPAY *** bekerja sama dengan beberapa pihak untuk memudahkan para dalam bertransaksi dan mendapatkan lebih banyak . Berikut adalah daftar sudah bekerja sama dengan . | **No** | **Nama Convenience Store** | | ------ | -------------------------------------------------- | | 1 | Alfa Group (Alfamart, Alfamidi, Dan+Dan, Lawson) | | 2 | Indomaret (Ceriamart, Mitra Indogrosir, dan isaku) | # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [API Convenience Store](docId\:D27aRe5Bm0Ax39UkpPmtl) untuk mengetahui rincian digunakan pada . ::: :::VerticalSplitItem ::: :::: [title] Tipe QRIS [path] Payment/QRIS/ # Tentang QRIS MPM *** MPM atau kepanjangan dari *Merchant Presented Mode *adalah dimiliki oleh Penjual untuk melakukan dengan Pembeli. Pada mode ini, Pembeli melakukan dengan memindai kode QR diberikan oleh menggunakan aplikasi *mobile banking *atau . Kemudian, Pembeli akan memasukkan nominal uang harus dibayarkan dan melakukan konfirmasi pada aplikasi *Mobile Banking *atau mereka. Lalu, Pembeli akan menginformasikan bahwa telah berhasil dilakukan kepada . MPM terbagi menjadi 2 tipe, yaitu MPM Dinamis dan MPM Statis. # Perbedaan QRIS MPM Dinamis dan MPM Statis *** | | **QRIS MPM Dinamis** | **QRIS MPM Statis** | | ------------------------- | ----------------------------------------------------- | ------------------- | | Jumlah kode QR dimiliki | Banyak, karena dihasilkan otomatis melalui *online* | Satu | | Kode QR digunakan untuk | Berbeda untuk setiap | Sama untuk setiap | # Mengenai QRIS MPM (*Merchant Present Mode*) Dinamis *** sendiri menggunakan jenis MPM (*Merchant Present Mode*) Dinamis untuk mendukung pada . Pada jenis MPM Dinamis, akan memindai kode QR dengan menggunakan aplikasi atau untuk melakukan . Kemudian, akan memasukkan nominal dibayarkan atau langsung melakukan konfirmasi nominal hendak dibayarkan untuk menyelesaikan . Fitur MPM dapat digunakan oleh semua segmen usaha mulai dari mikro hingga besar. Umumnya digunakan pada pedagang kaki lima, pasar tradisional, *online market*, *chain store*, tempat ibadah & donasi, acara pameran, dan parkir. # See also ::::VerticalSplit :::VerticalSplitItem [Alur Pembayaran QRIS](docId\:m-HeeKLNLzY1G1thlaKy-) untuk mengetahui pada saat melakukan dengan . ::: :::VerticalSplitItem [Integrasi & Testing QRIS](docId\:tCFbU7--Xd0Sm5_rQ00_w) untuk mengetahui cara dan uji coba . ::: :::: ::::VerticalSplit :::VerticalSplitItem [Daftar Istilah QRIS](docId:6BFA6ymPlc8HEHi6jXRO2) untuk mengetahui istilah khusus digunakan oleh . ::: :::VerticalSplitItem [FAQ QRIS](docId\:AHrsQb4knslavXU-aBiF4) jika ingin mengetahui pertanyaan sering diajukan terkait . ::: :::: [title] DANA [path] Payment/E-Wallet/Panduan Bayar E-Wallet/ ::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/ojZIzQYuFVcAE21whNP7t_logodanabluesvg.png" size="42" width="2560" height="730" caption="DANA" position="center" showCaption="true"} # Informasi Nomor Pembayaran *** | **Nomor Seluler** | `082-1851-XXX-XX` | | ---------------------- | ------------------------------------- | | **Mitra E-Wallet** | DANA | | **Nominal** | Rp10.000 | | **Nama Penerima ** | `billingNm` | | **Nomor Pemesanan** | Invoice-1234 | | **Masa Berlaku ** | 16-06-2016 / 17:15:00
| # Pembayaran *** 1. Pilih pembayaran melalui DANA. 2. `Nomor Seluler` yang terdaftar. 3. akan dipindahkan ke `Halaman Pembayaran DANA`. 4. Masuk menggunakan akun . 5. Pastikan `Saldo` cukup. 6. `Pay`, `Bayar`, atau `Confirm`. 7. Pembayaran berhasil! akan dipindahkan ke *result* *page*. file format JSON Panduan Bayar DANA untuk operasi . ::File{src="https://archbee-doc-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/rgGxrEzsv1UAKfxdr9gMQ_ewalletinddana.json" label="EWALLET_IND_DANA.json"} ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/00Y4Pz4LoOg-RiWr07yO__3.png "Alur Pembayaran E-Wallet - DANA 1") ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/u8iT1DT1FETad7pLLfFwn_4.png "Alur Pembayaran E-Wallet - DANA 2") ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/AYBaqRFvbbej1DfsbNGFr_5.png "Alur Pembayaran E-Wallet - DANA 3") [title] Alur Pembayaran Paylater [path] Payment/Payloan/ ![Paylater Payment Flow](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/c66dRPvoO-86raFpkx5ty_diagram-nicepay-paylater-payment-flow.jpg "Paylater Payment Flow") Deskripsi langkah dengan : 1. melakukan *request checkout* kepada . 2. mengirimkan Registration kepada . 3. Pada bagian *Registration:* - Jika menggunakan Akulaku: - akan *request* pesanan kepada Akulaku selaku . - Akulaku akan *generate *pesanan. - Akulaku mengirimkan *response *data kepada . - akan mengirimkan *capture response * Regist kepada . - Jika menggunakan Kredivo/Indodana: - akan menyimpan Order Regist*.* - akan mengirimkan *response *Order Regist. 4. mengirimkan kepada . 5. Kemudian pada bagian *Payment.* - Jika menggunakan Akulaku: - mengalihkan *redirect* ke Akulaku. - melakukan *login *akun. - melakukan konfirmasi kepada Akulaku selaku . - Akulaku melakukan validasi . - Akulaku mengalihkan dengan `callbackUrl`*.* - Jika menggunakan Kredivo/Indodana: - *request* *checkout* kepada . - melakukan *checkout*. - mengirim *response *dan mengalihkan ke milik . - melakukan konfirmasi kepada . - mengirimkan OTP kepada . - memasukkan OTP kepada . - melakukan validasi OTP. - melakukan konfirmasi hasil pesanan kepada . 6. Pada bagian *Notification:* - Jika menggunakan Akulaku: - Akulaku selaku mengirimkan *push capture notif *kepada . - menyimpan . - mengirimkan *capture update notification *kepada . - menampilkan *response *kepada . - Jika menggunakan Kredivo/Indodana: - mengirimkan *push notification *kepada . - melakukan validasi terhadap diterima. - mengajukan konfirmasi pesanan. - melakukan konfirmasi proses pesanan. - mengirim data konfirmasi pesanan kepada . - mengirimkan hasil konfirmasi pesanan. 7. Jika digunakan adalah Akulaku, dapat melakukan konfirmasi bukti : - mengirimkan konfirmasi bukti kepada . - mengajukan konfirmasi bukti kepada . - mengajukan konfirmasi bukti kepada Akulaku. - Akulaku melakukan konfirmasi bukti . - Akulaku mengirim *response *data kepada . - mengirim *response *data kepada . - menampilkan hasil data kepada . 8. mengirimkan *request* pemeriksaan menggunakan Status kepada . 9. mengirimkan *response *pemeriksaan kepada . 10. menerima terakhir. 11. mengirimkan konfirmasi kepada . # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem Kunjungi halaman [Fitur Paylater](docId\:B78u4Xq_3rXzfw_QPS4No) untuk mengetahui fitur transaksi pada Payloan. ::: :::VerticalSplitItem Kunjungi halaman [Integrasi & Testing Paylater](docId\:ZEuw_0d227R_LUPBI3ptN) untuk mengetahui cara integrasi dan uji coba sistem Payloan NICEPAY. ::: :::: ::::VerticalSplit{layout="middle"} :::VerticalSplitItem Kunjungi halaman [Daftar Istilah Paylater](docId\:Gu0PXWuHJFG-EwxUsoRfQ) untuk mengetahui istilah khusus yang digunakan oleh Payloan. ::: :::VerticalSplitItem Kunjungi halaman [FAQ Paylater](docId\:y88CwYlN6KTcATxOHbJYP) jika ingin mengetahui pertanyaan yang sering diajukan terkait Payloan. ::: :::: [title] Alur Pembayaran QRIS [path] Payment/QRIS/ ![](https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-CzPy1ulufdYHfjOTTLn6C-20240821-040352.jpg "Alur Pembayaran QRIS") Deskripsi langkah: 1. melakukan *checkout* pesanan kepada . 2. mengirimkan Registration kepada . 3. mengajukan *order payment *kepada . 4. melakukan *generate *kode QR. 5. mengirimkan *response *QR kepada . 6. mengirimkan *response *QR kepada . 7. menampilkan QR kepada . 8. memindai QR dan melakukan kepada . 9. menampilkan *response * kepada . 10. mengirimkan *push notification *kepada . 11. melakukan validasi . 12. mengirim pemeriksaan kepada . 13. mengirimkan *response* kepada . 14. memperbarui . 15. mengirimkan *push notification *kepada . 16. mengajukan pemeriksaan menggunakan Status kepada . 17. mengirim *response *pemeriksaan kepada . 18. menerima terakhir. 19. mengirim perubahan konfirmasi kepada . # See also ::::VerticalSplit :::VerticalSplitItem [Tipe QRIS](docId\:yxX3p9Itvvu6qTepCfjbU) untuk mengetahui jenis digunakan pada . ::: :::VerticalSplitItem [Integrasi & Testing QRIS](docId\:tCFbU7--Xd0Sm5_rQ00_w) untuk mengetahui cara dan uji coba . ::: :::: ::::VerticalSplit :::VerticalSplitItem [Daftar Istilah QRIS](docId:6BFA6ymPlc8HEHi6jXRO2) untuk mengetahui istilah khusus digunakan oleh . ::: :::VerticalSplitItem [FAQ QRIS](docId\:AHrsQb4knslavXU-aBiF4) jika ingin mengetahui pertanyaan sering diajukan terkait . ::: :::: [title] Payment Link [path] / ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/YheeeEFDKzuyAC0-IaVzQ_payment-link.jpg "Payment Link") **Payment Link** merupakan fitur dari memberikan kemudahan kepada untuk dapat memilih mereka inginkan saat berbelanja secara aman dan nyaman dengan hanya menggunakan *link*. cukup membuat tersebut dan membagikan *link* melalui *e-mail* maupun media komunikasi pilih dengan . pun nanti diarahkan ke *payment page* milik dan tagihan jumlah belanjaannya pun siap dibayar pada *payment page* tersebut. Kelebihan dari fitur ini adalah tidak perlu direpotkan untuk apapun secara teknis dengan (*no-code required*), cukup daftarkan diri sebagai dan pun dapat mengakses fitur ini dengan mudah. Selain itu, ini tidak akan memakan waktu lebih dari satu menit untuk dilakukan. # Proses Pada Sisi Merchant *** 1. Akses . 2. `Service > Email Payment`. 3. `Register` pada `Search Option`. 4. `Payment Method: Customer Select`. 5. rincian pesanan akan diproses. 6. `Save` untuk menyimpan data dan membuat pesanan. - *Pop-Up Saved* akan muncul setelah berhasil dibuat. - Data pesanan muncul pada tabel `Search Result`. - Status menjadi `Registration`. 7. Centang \{\{bag}} `Request` pada kolom pesanan ingin diproses melalui `Search Result`. 8. `Process` untuk melanjutkan . - Muncul *pop-up* untuk melihat . - Jika berhasil, akan berubah menjadi `Payment Request`. 9. `Detail` pada kolom pesanan. 10. Salin `Payment Link` dari *pop-up* *Detail Email Payment* ke *browser* untuk melakukan . - Jika berhasil, akan berubah menjadi `Payment Complete` dan TXID berhasil dibuat. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/ILNmRk6FhHhleo834wAxO_1.png "Service") ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/MT-ul0Euo0jSSEzNur6CD_2.png "Service > Email Payment") ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/Fn4c0bBG8p0yqDL-XPC5N_3.png "Service > Email Payment > Regist > Payment Method") ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/YYWUcXj2aFrteSt4AB307_4.png "Service > Email Payment > Regist") ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/CgpaXsI7lNbZ7DDzSAQaU_5.png "Email Payment Pembuatan Data") ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/ofyaoZvq-9pznwLHJ0MBn_6.png "Email Payment Pengajuan") ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/DktUpObOLggPIPG3ltMT8_7.png "Email Payment Rincian") ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/kPv0ln60NFdCDwpJQGaEH_8.png "Proses Pembayaran dengan Email Payment Link") # Metode Pembayaran Pada Payment Link *** Metode pada sudah melingkupi semua metode ada di . Berikut sample *payment page* kami: ![Payment Link Page](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/ohh_r6otn4iPQSs_4RfL1_image-id-nicepay-secure-payment-page-main-dashboard.jpg "Payment Link Page") ## Panduan Pembayaran | **Metode Pembayaran** | **Referensi** | | --------------------- | ---------------------------------------------------------- | | | [Panduan Bayar Kartu Kredit](docId\:pf0yYjEhAE07p65seIrFt) | | | [Panduan Bayar VA](docId\:bSNUZMHNlj9h0wRndsQYj) | | | [Panduan Bayar CVS](docId:_dY8vW1ygeXkx0NQ0J4GB) | | | [Panduan Bayar Direct Debit](docId\:eJ49bFx8eJVfBsoGQORTO) | | | [Panduan Bayar E-Wallet](docId:-v30F8TW2bUenjkPfjaX5) | | | [Panduan Bayar Paylater](docId\:P8AvV0TcLlEVuI80Pc7Rc) | | | [Panduan Bayar QRIS](docId\:og8vGEkiCoG9mupWHrrJ0) | # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Payout](docId:_tBoQGqS-T6sk-ziXQl55) untuk mempelajari terbaru . ::: :::VerticalSplitItem [NICEPAY API](docId:6qGtFCV3tHP1B_wS9zEqd) untuk mengetahui rincian terkait . ::: :::: [title] Invoice & Receipt [path] Operasi Bisnis/ *Invoice *atau disebut juga dengan faktur tagihan adalah bukti tagihan akan diberikan kepada setelah menggunakan & dari . Faktur tagihan ini akan dikirimkan kepada per bulannya dan dilengkapi dengan rincian *fee rates* dari & telah digunakan selama periode tersebut. # Billing Invoice *** Secara *default*, akan mengurangi dana secara otomatis dari suatu dengan *fee rate* sudah disepakati bersama sesuai PKS, apabila menggunakan tipe . Namun, untuk tipe , pengurangan jumlah dana sesuai *fee rate* akan dilakukan nanti apabila sudah mengirimkan tagihan *invoice *tersebut kepada terlebih dahulu. ## 1. Direct Deduction Setiap terjadinya berhasil, *fee *dari penggunaan akan secara otomatis berlaku dan jumlah dana dari akan dikurangkan secara otomatis sesuai dengan *fee* yang berlaku. akan tetap menerima rincian faktur tagihan setiap bulan dari . ## 2. Indirect Deduction *Fee *dari penggunaan dan akan diakumulasi dan ditagihkan kepada pada setiap bulannya. akan mendapatkan rincian dari setiap dan akan membayar tagihan tersebut sesuai dengan jumlah ditagihkan. # Receipt Apabila sudah melunasi tagihan dari dan , akan mendapatkan kuitansi tersebut melalui email berikan kepada . ::::hint{type="info"} :::Iframe{code="Silakan menghubungi Tim Finance NICEPAY untuk mengetahui lebih lanjut mengenai faktur tagihan dan kuitansi." iframeHeight="0"} ::: :::: # See also ::::VerticalSplit :::VerticalSplitItem [Reconcile](docId\:O90KkHXe895FMVFotNceL) untuk mengetahui cara memeriksa data terkait operasi . ::: :::VerticalSplitItem [Proses Settlement](docId\:l04EuP_s604Oi2Ib3x_y6) untuk mengetahui cara menyelesaikan terkait operasi . ::: :::: ::::VerticalSplit :::VerticalSplitItem [Cancel Payment](docId:_fVpAc1b3FRIAOE8Tj56q) untuk mengetahui cara membatalkan dalam . ::: :::VerticalSplitItem Kunjungi [Pajak](docId\:dR7m2aSPVC5vwz-HV2lql) untuk mengetahui informasi terkait dalam operasi bisnis . ::: :::: [title] FAQ Operasi Bisnis NICEPAY [path] Operasi Bisnis/ # Customer Service & Umum *** ### Bagaimana cara bergabung atau bekerja sama dengan NICEPAY? :::Iframe{iframeHeight="0" code="Anda dapat berkomunikasi langsung melalui e-mail dengan tim Bisnis Support kami melalui Marketing NICEPAY. Silakan berikan informasi singkat mengenai data pribadi dan konsep bisnis tersebut, nantinya tim NICEPAY akan menghubungi secara langsung untuk menindaklanjuti."} ::: *** ### Bagaimana cara dan berkomunikasi dengan NICEPAY? :::Iframe{iframeHeight="0" code="Ada beberapa cara untuk menghubungi Customer Service kami, namun metode yang disarankan adalah mengirim e-mail melalui tim Customer Service kami: NICEPAY Customer Service yang akan menempatkan permintaan Anda langsung ke antrian dan akan di respon dalam waktu 1x24 jam. Customer Service NICEPAY beroperasi setiap hari, Senin-Minggu pukul 00:00-24:00 WIB termasuk hari libur nasional. NICEPAY juga melayani penanganan melalui telepon langsung dengan nomor: 021-28542410."} ::: *** ### Jenis kategori bisnis apa saja yang dapat menggunakan jasa pembayaran NICEPAY? Pada prinsipnya, semua jenis kategori dapat menggunakan selama tidak dilarang oleh Undang–undang yang berlaku, Regulator, , atau *Principal *(contoh: Visa dan Mastercard, Indonesia, OJK (Otoritas Jasa Keuangan) dan lain-lain). Kami mengikuti standar ditetapkan oleh pihak-pihak tersebut demi kenyaman dan dengan pihak . *** ### Apakah kelebihan NICEPAY dengan jasa pembayaran yang lain? Selain fitur lengkap dan biaya yang bersahabat, kami sangat berkomitmen untuk mengutamakan pelayanan dapat diandalkan, ramah, dan siap melayani kebutuhan dengan memberikan *response *dan cepat. Kami juga memiliki perwakilan staf IT, Bisnis, dan Operasional ditugaskan kepada masing-masing secara eksklusif untuk dapat berkomunikasi apabila ada kendala, permintaan, atau hal lain, sehingga memudahkan operasional . Dalam hal keamanan ber , juga memiliki dan tim khusus untuk mendeteksi potensi kecurangan dapat mengurangi potensi kerugian pada bisnis . Nikmati pengalaman terbaik menggunakan jasa . *** ### Skala bisnis saya masih kecil dan belum ada legalitas perusahaan (PT), apakah tetap bisa bekerja sama dengan NICEPAY? Tentu bisa, kami menyediakan fasilitas kerja sama secara , yaitu pendaftaran akan didaftarkan ke melalui perantara kami, sehingga /pengiriman dana akan dibayarkan melalui ke setelah melakukan /. Untuk tipe kerja sama ini, kami hanya membutuhkan beberapa dokumen dan verifikasi lebih lanjut untuk membantu mulai menerima &#xNAN;* online*. *** ### Sebagai Merchant, kami belum mempunyai situs/aplikasi pribadi untuk Pelanggan bertransaksi atau memesan barang. Apakah tetap dapat menggunakan jasa pembayaran NICEPAY? :::Iframe{iframeHeight="0" code="Bisa, melalui layanan Payment Link, NICEPAY menyediakan fitur transaksi pembayaran untuk memudahkan Pelanggan bertransaksi online tanpa membutuhkan halaman website dan checkout. Untuk informasi perihal layanan ini, silakan menghubungi tim NICEPAY melalui e-mail: Marketing NICEPAY."} ::: *** ### Bisnis saya berada di luar Jakarta atau di luar pulau Jawa, apakah bisa bergabung dengan NICEPAY? Kami telah membantu banyak  di seluruh , bahkan dunia. Cakupan kami tidak hanya terpusat di Jakarta atau pulau Jawa. hubungi tim Marketing kami untuk lebih lanjut. *** ### Berapa lamakah proses pengajuan dari awal sampai Merchant dapat bertransaksi? Semua tergantung kelengkapan dokumen diberikan. Pada umumnya, memakan waktu 14 (empat belas) sampai 30 (tiga puluh) hari kerja dari mulai pengajuan, , dan *testing *sampai dapat ber di . *** ### Jenis ***service*** atau pembayaran apa saja yang dapat digunakan dalam bekerja sama dengan NICEPAY? - (Visa, Mastercard, JCB, AMEX, Union Pay). - (ATM, Internet Banking, Mobile Banking, SMS Banking, dan Teller seluruh Indonesia). - (Pembayaran tanpa perlu , cocok bagi tidak mempunyai *website* atau *platform*). - (Alfamart & Indomart, tersedia pada lebih dari 20.000 gerai). - (Jenius) - (OVO, DANA, Shopeepay, LinkAja) - (Akulaku, Kredivo, Indodana) - (Pengiriman uang ke banyak rekening tujuan dalam waktu bersamaan dengan mudah karena menggunakan ). - (Scanning kode QR) - (Kartu yang sudah terdaftar pada sistem GPN) *** # Settlement, Tagihan, Reversal dan Refund *** ### Siapa yang akan mengirimkan dana penyelesaian (Settlement) kepada Merchant? akan menerima dana penyesaian dari sedangkan akan menerima dana penyelesaian dari atau . *** ### Bagaimana cara penyelesaian dana (Settlement) antara NICEPAY dan Merchant? Jika *Settlement model* digunakan adalah tipe , maka dana transaksi akan langsung masuk ke rekening yang dimiliki setelah sukses dibayarkan. pun akan menagihkan *fee * (dan PPn) kepada termasuk pemotongan dana penyelesaian lainnya (jika ada) dikirim oleh kepada . Jika *Settlement model* digunakan adalah tipe , maka akan mewakili dalam . Dana penyelesaian pun akan diterima oleh dari dan sudah dipotong *fee *(dan PPn) oleh dan dana tersebut sudah menjadi hak sepenuhnya untuk digunakan. *** ### Bagaimana cara memeriksa tagihan dari NICEPAY atas transaksi mana saja? 1. Masuk ke . 2. `Settlement.` 3. `Settlement Report`. 4. `Data Type,` yaitu `Settlement Data` dan `Date`, yaitu satu bulan dari tanggal satu sampai akhir bulan. 5. `Excel Detail`. 6. *File* *Excel* akan terunduh berisi rincian dipotong *fee *(dan PPn). *** ### Bagaimana cara memeriksa rincian transaksi atas dana penyelesaian yang diterima hari ini dari NICEPAY? 1. Masuk ke . 2. `Settlement`. 3. `Settlement Report`. 4. `Data Type`, yaitu `Settlement Data` dan `Date`, yaitu hari ini. 5. `Excel Detail`. 6. *File* *Excel* akan terunduh berisi rincian dipotong *fee *(dan PPn). *** ### Kapan akan diterima dana penyelesaian dari NICEPAY atas transaksi yang terjadi hari ini? Pengiriman dana penyelesaian tergantung pada . Biasanya dilaksanakan dalam hari kerja. Untuk lebih rinci dapat masuk ke . 1. `Profile`. 2. `Merchant Data`. 3. jendela `Service Info` dan pilih nya, misalnya VA. 4. Cari kolom `Settlement Period`. Informasi pada kolom `Settlement Period` itu adalah berapa lama dana penyelesaian akan dikirimkan. *** ### Bank apa saja yang bisa digunakan untuk menerima dana penyelesaian dari NICEPAY? Semua bisa digunakan. membebaskan biaya kirim dana penyelesaian jika dipilih, yaitu: - Mandiri, BCA, BNI, CIMB, BRI, Danamon, Hana, Syariah Mandiri, dan Maybank. - Di luar tersebut akan dikenakan biaya per transfer sebesar IDR 5.000 untuk SKN (di bawah IDR 500 juta) atau IDR 30.000 untuk RTGS (di atas IDR 500 juta). *** ### Mengapa bisa terjadi ***Reversal ***pembayaran? *Reversal* pembayaran biasanya terjadi pada \{\{meto}} VA (). Hal ini disebabkan karena berhasilnya VA dengan kondisi seperti dibawah ini: 1. Nomor VA yang sudah *expired* 2. Menggunakan nomor VA yang sudah terbayar dan dibayar lagi 3. Nomor VA yang sudah dibatalkan untuk dibayar :::Iframe{iframeHeight="0" code="Silakan segera hubungi tim NICEPAY Customer Service apabila transaksi Anda mengalami kondisi seperti diatas namun Bank tidak melakukan proses reversal."} ::: *** ### Bagaimana proses pengembalian dana (***Refund***) setelah settlement di NICEPAY? Untuk tipe , di mana akun secara legalitas terhubung langsung dengan dan menerima dana langsung dari , maka apabila terdapat refund*, *pada umumnya dana akan dipotong otomatis oleh pihak . Namun untuk tipe , di mana dana akan diterima melalui , maka tim akan memberikan untuk dilakukan pemotongan dana refund kepada sesuai dengan perjanjian telah disepakati oleh kedua belah pihak. :::hint{type="info"} Apabila jumlah tagihan refund melebihi dari jumlah dana akan diselesaikan (*to be* *settled*), maka tagihan refund akan diteruskan menuju siklus terdekat berikutnya. Sehingga, tidak akan ada dana diterima oleh sampai jumlah tagihan refund tersebut terlunasi. ::: :::Iframe{iframeHeight="0" code="Merchant juga dapat membayar tagihan refund ini dengan mekanisme top-up Payout apabila metode Payout aktif. Silahkan hubungi tim NICEPAY Customer Service untuk info lebih lanjut."} ::: | **Metode Pembayaran** | **Proses Pengembalian Dana (*****Refund*****)** | | --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ,, ,, dan | Inisiasi pengembalian dana dapat dilakukan langsung oleh melalui milik ataupun menggunakan Cancel yang tersedia.
Pengembalian dana akan di oleh instansi terkait seperti atau sehingga dana refund akan langsung diterima oleh | | dan | Tidak ada *Refund* | ** ** *** ### Berapa lama uang akan kembali ke Pelanggan setelah saya melakukan ***Refund***? Terdapat perbedaan waktu dibutuhkan untuk melakukan pengembalian uang kepada setelah *Refund* dilakukan. Waktu pengembalian dana pada *Refund* bergantung sesuai dipilih pada saat ber . | **Metode Pembayaran** | **Jangka Waktu Pengembalian Dana** | | --------------------- | ---------------------------------- | | dan | 7-14 hari kerja | | , , dan | 1-3 hari kerja | | | 14-30 hari kerja | | dan | Tidak ada proses *Refund* | *** ### Kapan pengembalian dana ditransfer ke Merchant? Dikirim bersamaan dengan dana penyelesaian. periksa ke pertanyaan pemeriksaan rincian atas dana penyelesaian diterima hari ini oleh . *** ### Apakah terdapat biaya yang harus dibayar pada transaksi ***Refund ***atau ***Chargeback***? Tidak ada. tidak membebankan biaya tambahan pada *Refund*. *** # Keamanan & Pencegahan Penipuan *** ### Apakah menggunakan jasa pembayaran NICEPAY aman? adalah salah satu jasa mempunyai standar keamanan dan pencegahan penipuan terkini. Kami juga mengimplementasikan beberapa teknik deteksi pencegahan *Fraud* didukung oleh FDS (*Fraud Detection System*) dan tim Risk Management untuk menjamin keamanan dan kenyamanan bertransaksi melalui . *** ### Sejauh mana NICEPAY menjaga keamanan informasi Pelanggan? Sebagai penyedia jasa , telah memliki sertifikasi keamanan data PCI DSS (*Payment Card Industry – Data Security Standard*) tingkat 1, yaitu tingkat tertinggi standar keamanan data , pemegang kartu baik , ATM, Debit, maupun e-money. Sertifikasi ini membuktikan bahwa berkomitmen dan patuh pada standar keamanan ekosistem pemrosesan kartu dan termasuk perangkat-perangkat di dalamnya. *** ### Saya mengalami tindakan penipuan dari seseorang atau oknum melalui transaksi menggunakan NICEPAY, bagaimana saya melapor hal tersebut? :::Iframe{iframeHeight="0" code="Apabila Anda merasa menjadi sasaran tindakan penipuan melalui perantara transaksi menggunakan NICEPAY, dimohon melaporkan transaksi tersebut melalui e-mail NICEPAY Customer Service secepatnya, dengan menyertakan:"} ::: - Data (nama, email, alamat lokasi, jumlah , nomor telepon). - Bukti (struk , *invoice*, dll). - Kronologi penipuan. - Pelaporan pengaduan kepada atau instansi terkait. - Pelaporan kepolisian. *** ### Bagaimana jika Merchant menemukan atau menerima pelaporan penipuan? Berikut cara-cara mungkin dapat berguna dilakukan di sisi : - Pastikan untuk menganalisa dengan rinci dari mulai pengguna, karakter pengguna, jenis barang pembelian, jenis digunakan, riwayat dan lain-lain. - Apabila terdapat kemungkinan mengarah pada penipuan, blokir akun pengguna segera untuk mengindari pengulangan . Apabila masih memungkinkan dapat menahan proses pengiriman barang kepada alamat tujuan. - ke dalam daftar hitam/*blacklist, *seperti: Nama Pengguna, Email ID, Nomor , ID perangkat, dan lain-lain. - Demi keamanan, jangan memberikan rahasia kepada pihak luar tanpa ada perintah tertulis. Contoh: Surat kepolisian atau instansi berwenang. - Lakukan pembenahan teknis dan non-teknis serta menutup celah-celah dapat digunakan penipu sebagai sasaran tindak kejahatan. - Selalu terbuka untuk bekerja sama dengan pihak terkait, contoh: Gateway (), , regulator, dan lain-lain untuk dapat bertukar umum mengenai tindakan penipuan terkini umumnya terjadi pada industri sama. *** ### Apa yang perlu dilakukan terdapat sanggahan dari Pelanggan atau Bank (***Dispute***)? Sanggahan atau biasa dikenal dengan *Dispute *adalah hal umum terjadi pada *online* menggunakan . Ini terjadi karena *online* dilakukan tanpa adanya kegiatan verfikasi secara fisik untuk melihat keaslian . Sehingga, memberikan kesempatan untuk melakukan mediasi antara pemilik kartu dan pedagang () untuk membuktikan apakah kedua belah pihak telah melakukan kegiatan jual-beli semestinya. Oleh karena itu, apabila mendapatkan laporan sanggahan, berikut langkah perlu dilakukan: - Memberikan rincian selengkap mungkin, contoh: pengguna, alamat rumah, alamat *billing*, rincian pengiriman barang, invoice, dan lain-lain. - Apabila perlu, dapat mengirimkan dalam bentuk *file* gambar untuk memperkuat dokumen. - Menyertakan TNC, *disclaimer *atau ketentuan-ketentuan pada . - Membuktikan bahwa telah menggunakan perlindungan keamanan tambahan seperti fasilitas 3Ds, OTP (*One Time Password*), dan lain-lain. *** ### Apa yang terjadi jika sanggahan tersebut menjadi ***Chargeback ***dan biaya apa saja yang akan ditanggung? *Chargeback *terjadi apabila pihak *Principal *di mana Visa atau Mastercard menyatakan seluruh dokumen yang diberikan tidak dapat mendukung sanggahan dilakukan oleh pemegang kartu. Apabila terdapat *Chargeback*, harus membayar atau mengembalikan sejumlah disanggah tersebut kepada pemegang . Namun dalam hal ini, tidak ada biaya tambahan lain dibebankan oleh kepada . *** # Payment Link *** ### Bagaimana cara membuat Payment Link? mengunjungi [Payment Link](docId\:ChpAc7d9l0s9A8mai3itC) untuk mengetahui lengkap mengenai . *** # Asuransi Qoala *** ### Mengapa harus membeli Asuransi Kecelakaan Diri melalui NICEPAY? dapat menghemat waktu karena pembelian dilakukan bersamaan dengan , selain itu harga untuk polis asuransi kecelakaan diri relatif murah Rp1.000 dan perlindungan sampai dengan 30 hari. dan Qoala berkomitmen untuk menyediakan inovasi baru dalam rangka meningkatkan kepuasan dan sebagai nilai tambah bagi para pengguna dan di sisi lain memperluas akses asuransi sesuai dengan kebutuhan masyarakat. *** ### Berapa waktu yang dibutuhkan untuk proses klaim pertama kali? Proses pengajuan dan klaim akan dilakukan dalam maksimal 30 hari kerja sejak pembelian asuransi dan di sejak dokumen klaim sudah lengkap. *** ### Berapa batas waktu pengajuan atau pelaporan klaim? Batas pengajuan atau pelaporan klaim maksimal 15 hari kerja sejak tanggal kecelakaan atau suatu kejadian. *** ### Apa saja kondisi asuransi yang telah berakhir? 1. Pertanggungan dibatalkan baik oleh Qoala atau Perusahaan Asuransi maupun . 2. Tanggal dimana mengajukan pembatalan asuransi. 3. Tanggal meninggal dunia. *** ### Apakah uang premi asuransi dapat di *refund*? Jika sudah membeli premi asuransi, uang tersebut tidak dapat di refund. [title] Produk & Biaya Layanan [path] Operasi Bisnis/ # Overview *** Demi mewujudkan transparan dan terpercaya mengenai biaya perlu dibayarkan saat menggunakan & kami, menyediakan tabel di bawah ini mengenai rincian biaya & terkini kami berdasarkan kategori ingin gunakan. # Daftar Produk & Biaya Layanan NICEPAY *** ## Metode Pembayaran dan Payout | **Produk** | **Tipe Biaya** | **Biaya Standar** | **Deskripsi** | | ------------------------------------------------- | --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **
(VISA, Mastercard, JCB, American Express) | MDR | 2,9% | - A*cquirer*: Mandiri, BCA, BNI, BRI - Mendukung semua *Issuer* - Berstandar PCIDSS Level 1 dan terintegrasi dengan 3D Secure 2.0 - Terdapat fitur *full payment*, *installment*, *recurring*, serta *pre-authorization* & *capture* - Tidak termasuk PPN | | **
(VISA, Mastercard, JCB, American Express) | FDS | Rp1.500 | * FDS merupakan keamanan tambahan bagi untuk menghindari adanya indikasi *Fraud* *transaction* pada | |
| BCA | BCA Fee + Rp1.000 (biaya ) | - Tidak ada biaya *interchange *antar - Notifikasi secara *real-time*, 24 jam - Mendukung *Fixed Account/Normal Account/Close Amount/Open Amount *serta *Variable Amount *(Khusus BCA) untuk depositnya - Mendukung menggunakan seluruh perbankan: ATM, Internet Banking, Mobile Banking, Banking - Tidak termasuk | |
| BRI, Mandiri, BNI, Permata, Maybank, KEB Hana, CIMB Niaga, Danamon, Permata Syariah, BJB, BNC, DKI, BSI | Rp4.000 | * Tidak ada biaya *interchange *antar * Notifikasi secara *real-time*, proses 24 jam * Mendukung *Fixed Account/Dynamic Account/Close Amount/Open Amount *untuk depositnya * Menyediakan tipe VA - * Mendukung menggunakan seluruh perbankan: ATM, Internet Banking, Mobile Banking, Banking * Tidak termasuk | |
| ATM Bersama, Prima, Alto | Rp4.000 | - Terdapat biaya *interchange* - Notifikasi secara *real-time*, 24 jam - Mendukung *Fixed Account/Dynamic Account/Close Amount/Open Amount *untuk depositnya - Menyediakan tipe VA - - Mendukung menggunakan seluruh perbankan: ATM, Internet Banking, Mobile Banking, Banking - Tidak termasuk | | | Indomaret | Indomaret Fee + Rp2.000 (biaya NICEPAY) | Tidak termasuk | | | Alfa Group (Alfamart, Alfamidi, Dan+Dan, Lawson) | Rp5.000 | Tidak termasuk | | | JeniusPay | 1,5% atau Rp3.000 | Tidak termasuk | | | LinkAja | 2% | Tidak termasuk | | | OVO | 1,5% (Non-Digital Content)

2,73% (Digital Content) | Tidak termasuk | | | DANA | 1,5% | Tidak termasuk | | | DANA Subscription | 2,5% | Tidak termasuk | | | ShopeePay | 2% (Non-Digital Content)

4% (Digital Content) | Tidak termasuk | | | AstraPay | 1,5% | Tidak termasuk | | (Installment Non-Bank) | Kredivo | 2,3% + Rp1.500 | Tidak termasuk | | (Installment Non-Bank) | Akulaku | 1,5% + Rp1.500 | Tidak termasuk | | (Installment Non-Bank) | Indodana Paylater | 1% | Tidak termasuk | | Debit Online | MDR | 2,9% + NICEPAY Fee (Rp1.500) | * *Issuer*: BNI & BTN * Terdapat fitur *full payment* dan *recurring* * Dilengkapi fitur keamanan B-Secure * Tidak termasuk PPN | | (*Quick Response Indonesian Standard*) | ShopeePay QRIS | 0,7% | Termasuk PPN | | /Solusi | *Online* | Rp2.000 | - Transfer *real-time* - perlu melakukan deposit sejumlah nilai kepada sebagai sumber pengurangan dalam - Tidak termasuk PPN | | /Solusi | LLG/SKN | Rp4.000 | * Transfer *real-time* * perlu melakukan deposit sejumlah nilai kepada sebagai sumber pengurangan dalam * Tidak termasuk PPN | | /Solusi | RTGS | Rp30.000 | - perlu melakukan deposit sejumlah nilai kepada sebagai sumber pengurangan dalam - Tidak termasuk PPN | | | Indomaret | Rp5.000 | * Transfer *real-time* * Max 1.000.000/ * Melakukan deposit sejumlah nilai kepada sebagai sumber pengurangan dalam * Tidak termasuk * dapat membuat nama diinginkan untuk digunakan pada Indomaret tersebut (Tarik Tunai "`MerchantName`") | :::hint{type="info"} - Apabila ingin mengetahui waktu dari masing-masing kami, silakan kunjungi [Proses Settlement](docId\:l04EuP_s604Oi2Ib3x_y6). - Apabila mempunyai pertanyaan seputar & di , silakan hubungi [tim Sales kami](https://nicepay.co.id/id/contact-sales/). ::: ## Mengirim Pesan SMS *** | **Produk** | **Biaya Standar** | | ------------------------------------------------------------- | ---------------------------------------------------------- | | Indosat Ooredoo Hutchison, Telkomsel, XL Axiata, & Smartfren | Reguler: Rp550
OTP: Rp550
Internasional: Rp2.500 | # See Also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Back Office](docId\:NeiD6RfBV4EDRspHb2BPD) untuk mengetahui mendukung operasi . ::: :::VerticalSplitItem [Deposit Saldo](docId\:VdIDXX3uGz0y1dGVucMGp) untuk mengetahui cara untuk menggunakan beberapa khusus . ::: :::: ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Reconcile](docId\:O90KkHXe895FMVFotNceL) untuk mengetahui cara memeriksa data terkait operasi . ::: :::VerticalSplitItem [Invoice & Receipt](docId\:XM0SqUaTFWCjls6vYo8Pi) untuk mengetahui terkait bukti dalam operasi . ::: :::: [title] Bank Danamon [path] Payment/Virtual Account (VA)/Panduan Bayar VA/ ::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/YLgOzgb9sYUqYddEmXmyr_danamon.jpg" size="50" width="1024" height="1024" caption="Bank Danamon" position="center" darkWidth="1024" darkHeight="1024" showCaption="true"} :::hint{type="info"} Pastikan melakukan transfer dana sebelum masa berlaku habis dan dengan nominal tepat. ::: | **Nomor Virtual Account** | `79150XXXXXXXXXXX` | | ------------------------- | --------------------------- | | **Bank** | Danamon | | **Nominal** | Rp10.000 | | **Nama Penerima** | `Merchant Name - billingNm` | | **Nomor Order** | Invoice-1234 | | **Masa Berlaku** | 16-06-2016 / 17:15:00 | file format JSON Panduan Bayar Bank Danamon untuk operasi . ::File{src="https://archbee-doc-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/-7vAj_iVipJGvD8eCFXSm_va-ind-danamon.json" label="VA_IND_DANAMON.json"} # ATM Dengan Kartu Bank Danamon *** 1. PIN ATM . 2. `Pembayaran`, lalu `Virtual Account`. 3. `Nomor Virtual Account`, misal `79150XXXXXXXXXXX` sebagai kode bayar.. 4. `Nominal`. 5. Pastikan tujuan dan nominal sudah sesuai pada layar konfirmasi . 6. `Ya` untuk melanjutkan . # ATM Non-Danamon Dengan Kartu Bank Danamon *** 1. Masuk ke transfer. 2. tujuan rekening lain (*Online Transfer*). 3. `Nomor Virtual Account`, misal `79150XXXXXXXXXXX` sebagai kode bayar. 4. `Nominal Pembayaran` akan dibayarkan. 5. Pastikan nama tujuan dan nominal sudah sesuai pada layar konfirmasi . 6. Konfirmasi . # Aplikasi D-Mobile *** 1. Akses `Aplikasi D-Mobile`. 2. `Virtual Account`. 3. `Nomor Virtual Account`, misal `79150XXXXXXXXXXX` sebagai kode bayar. 4. `Nominal`. 5. Pastikan tujuan dan nominal sudah sesuai pada layar konfirmasi . 6. `Ya` untuk melanjutkan . # Internet Banking Non-Danamon, Transfer Online (ATM Bersama/ALTO/Prima) *** :::hint{type="info"} Panduan bayar ini **berlaku untuk metode transfer selain BI-FAST** ::: 1. Masuk ke `Transfer ke Bank Lain`. 2. `Transfer Online`. 3. tujuan, `Bank Danamon`. 4. `Nomor Virtual Account`, misal `79150XXXXXXXXXXX` sebagai kode bayar. 5. `Nominal`. 6. Pastikan tujuan dan nominal sudah sesuai pada layar konfirmasi . 7. Konfirmasi . [title] Daftar Istilah VA [path] Payment/Virtual Account (VA)/ # Prefix Nomor unik pada setiap terletak pada awal nomor VA. # Field Amount *Field * disediakan untuk mengisi sendiri nominal akan dibayarkan. # Single Use Nomor VA sekali pakai sering digunakan pada saat memesan barang atau jasa pertama kali pada suatu . # Multiple Use Nomor VA dapat digunakan berulang kali selama nomor VA tersebut masih aktif untuk digunakan. Jenis VA ini cocok digunakan untuk berulang oleh satu sama. Terdapat pada BCA, Mandiri, BRI, Permata, KEB Hana, BNI, Danamon, Maybank, BJB, CIMB, dan BNC. # See also ::::VerticalSplit :::VerticalSplitItem [Alur Pembayaran VA](docId\:lL0aeF-P7zmvqABj6Oq8G) untuk mengetahui pada saat melakukan dengan . ::: :::VerticalSplitItem [Fitur VA](docId\:GnUAAyq81JNJ8UNRanWUZ) untuk mengetahui fitur pada . ::: :::: ::::VerticalSplit :::VerticalSplitItem [Integrasi & Testing VA](docId\:sts64cm0VYN3Q8_quNq23) untuk mengetahui cara dan uji coba . ::: :::VerticalSplitItem [FAQ VA](docId\:n5d3A27rcZ6_ZxBN-sIIs) jika ingin mengetahui pertanyaan sering diajukan terkait . ::: :::: [title] Pajak [path] Operasi Bisnis/ # Tentang Pajak *** Setiap perusahaan menjalankan di , tidak terlepas dari kewajiban untuk melakukan sesuai dengan Peraturan Perpajakan berlaku. Dalam hal ini, sebagai perusahaan jasa terdaftar sebagai Pengusaha Kena Pajak (PKP) berkewajiban untuk memungut Pajak Pertambahan Nilai (PPN) kepada dan **Wajib** memungut Pajak Penghasilan Pasal 23 kepada . # Pajak Pertambahan Nilai (PPN) *** Pajak Pertambahan Nilai adalah atas konsumsi barang dan jasa di dalam Daerah Pabean dikenakan secara bertingkat dalam setiap jalur produksi dan distribusi. Berdasarkan ketentuan Undang-Undang No. 42 tahun 2009 Pasal 7 sebagaimana telah diubah dengan Undang-Undang Harmonisasi Perpajakan (UU HPP) pada bab IV Pasal 7 ayat 1 dan merujuk pada PMK 131/2024 Tentang Perlakuan Pajak Pertambahan Nilai (PPN), besaran Tarif Pajak Pertambahan Nilai ditetapkan sebagai berikut: 1. Tarif Pajak Pertambahan Nilai (PPN) 12% berlaku 1 Januari 2025 untuk Barang dan Jasa Mewah. 2. Tarif Efektif Pajak Pertambahan Nilai (PPN) 11% berlaku 1 Januari 2025 untuk selain Barang dan Jasa Mewah. (Tarif efektif berdasarkan perhitungan dari Tarif PPN 12% × 11/12 × DPP Nilai Lain dari Harga Jual). merupakan Jasa Sistem Komunikasi Data termasuk dalam kategori Jasa selain Barang Mewah, maka PPN berlaku adalah Tarif Efektif PPN 11% untuk selain Barang dan Jasa Mewah. Objek Pajak dibebaskan dari Pajak Pertambahan Nilai (PPN) sesuai dengan Undang-Undang Perpajakan meliputi Barang Kebutuhan Pokok, Jasa Pelayanan Kesehatan, Jasa Pendidikan, dan Jasa Pelayanan Sosial. Dalam hal ini, Faktur Pajak merupakan bukti bahwa telah memungut Pajak Pertambahan Nilai (PPN), di mana akan menerbitkan Faktur Pajak 1 (satu) kali dalam 1 (satu) bulan per MID dan dikirim H+5 Hari Kerja setiap awal bulan kepada . # Pajak Penghasilan Pasal 23 (PPh 23) *** Pajak Penghasilan Pasal 23 adalah dipotong oleh pemungut dari Wajib Pajak saat meliputi dividen, royalti, bunga, hadiah dan penghargaan, sewa, dan penghasilan lain terkait dengan penggunaan aset selain tanah atau transfer bangunan atau jasa, berdasarkan ketentuan Undang-undang Pajak Penghasilan No. 36 Tahun 2008 tentang Pajak Penghasilan dikenakan Tarif sebesar 2%. Langkah-langkah penerbitan Bukti Potong dan *reimbursement* Pajak Penghasilan Pasal 23 : 1. akan menerbitkan Tagihan kepada . 2. menerbitkan dan mengirimkan Elektronik Bukti Potong Unifikasi (e-Bupot Unifikasi). 3. dapat mengajukan *reimbursement* Pajak Penghasilan Pasal 23. 4. menerbitkan *Debit Note.* Cara pengajuan *reimbursement* oleh dapat dilakukan dengan memberikan lampiran poin 2-4. Proses pengembalian maksimal 5 (lima) hari kerja dari Pengajuan. (\*S\&K berlaku) **Apabila Tagihan belum di-*****direct***** oleh NICEPAY, maka pada saat Merchant ingin melakukan pembayaran utang dapat langsung dilakukan pemotongan/pemungutan PPh 23 (2%)** :::hint{type="info"} Elektronik Bukti Potong Unifikasi (e-Bupot Unifikasi) dapat diterbitkan melalui *website* [Coretax Direktorat Jenderal Pajak (DJP)](https://coretaxdjp.pajak.go.id/). Coretax adalah sistem teknologi informasi terbaru yang dikembangkan oleh Direktorat Jenderal Pajak (DJP) untuk mengintegrasikan seluruh layanan administrasi perpajakan di Indonesia. Kebijakan mengenai sistem Coretax tertuang dalam Peraturan Menteri Keuangan (PMK) Nomor 81 Tahun 2024 yang ditetapkan Sri Mulyani Indrawati pada 14 Oktober 2024. ::: Di bawah ini merupakan perusahaan perlu diperhatikan oleh saat mengisi form e-Bupot Unifikasi: - NPWP Perusahaan. - Nama Perusahaan. - Kode Objek Pajak (24-XXX-XX). - Kode Jenis Setoran (24-104-XX). - Dokumen Referensi (*Invoice* atau Faktur Pajak). - Identitas Pemotong/Pemungut. ::::hint{type="info"} Jika Surat Keterangan Bebas (SKB) PPh 23 sudah tersedia, maka akan diperbaharui setiap tahun. :::Iframe{code="Apabila Anda memiliki pertanyaan terkait perpajakan, silakan menghubungi Tim Finance NICEPAY kami melalui email." iframeHeight="0"} ::: :::: # See also ::::VerticalSplit :::VerticalSplitItem [Reconcile](docId\:O90KkHXe895FMVFotNceL) untuk mengetahui cara memeriksa data terkait operasi . ::: :::VerticalSplitItem [Proses Settlement](docId\:l04EuP_s604Oi2Ib3x_y6) untuk mengetahui cara menyelesaikan terkait operasi . ::: :::: ::::VerticalSplit :::VerticalSplitItem [Cancel Payment](docId:_fVpAc1b3FRIAOE8Tj56q) untuk mengetahui cara membatalkan dalam . ::: :::VerticalSplitItem [Invoice & Receipt](docId\:XM0SqUaTFWCjls6vYo8Pi) untuk mengetahui terkait bukti dalam operasi . ::: :::: [title] FAQ CVS [path] Payment/Convenience Store (CVS)/ ### Mengapa transaksi CVS dapat gagal? 1. Salah memasukkan `payNo`. 2. `payNo` sudah kedaluwarsa atau tidak berlaku. 3. Ditolak dari karena jaringan sedang *offline.* *** ### Apa yang dimaksud dengan Settlement? adalah pembukuan suatu & pemindahan dana dari lembaga finansial ( atau ) ke suatu individu atau perusahaan dalam kasus ini akan disebut sebagai . kunjungi [Proses Settlement](docId\:l04EuP_s604Oi2Ib3x_y6) untuk lebih lanjut. *** ### Berapa lama waktu yang dibutuhkan untuk melakukan proses Settlement Convenience Store? kunjungi [Proses Settlement](docId\:l04EuP_s604Oi2Ib3x_y6) untuk lebih lanjut. *** ### Apakah terdapat proses ***refund ***pada Merchant Back Office untuk pembayaran melalui Convenience Store***?*** [Merchant Back Office](docId\:VMD8YtiiJqku6H8dRhcS6) tidak menyediakan *refund *untuk dengan . bisa melakukan *refund *secara manual melalui terkait. *** ### Apakah masa berlaku ***payment number*** bisa diatur dari sisi Merchant? Bisa, dengan `payValidDt` dan `payValidTm`. *** ### Apa yang dilakukan oleh Merchant jika tidak menerima notifikasi terkait pembayaran Convenience Store dari NICEPAY? dapat melakukan mengirimkan ulang secara manual melalui Dashboard [Merchant Back Office](docId\:VMD8YtiiJqku6H8dRhcS6) . *** ### Apa yang harus dilakukan jika sudah melakukan pengiriman ulang notifikasi secara manual namun tetap tidak berhasil? Jika saat melakukan *resend* mendapat *response* 500 (*Internal Server eEror*), maka harus melakukan pengecekan pada sisi . [title] Penyelesaian Transaksi Pada Direct Debit [path] Payment/Direct Debit/ # Settlement *** Proses menyelesaikan antara dan dilakukan setelah melakukan pesanan kepada dengan menggunakan . Proses ini bertujuan memberikan kepada terkait pendapatan diterima dengan pembukuan apakah nominal diterima sesuai pada nominal tercatat pada . Terkadang, mengalami *void *atau *refund * membuat tidak berhasil. # Void *** Pembatalan dapat diajukan jika tersebut sudah melakukan penuh (*full amount*) sudah berhasil dan belum melalui . # Refund *** *Refund *adalah pengembalian dana terjadi atas persetujuan dan tanpa adanya sanggahan di antara kedua belah pihak. ## Full Refund Pengembalian seluruh dana memungkinkan untuk mengajukan pengembalian dana atas seluruh belanjaan dari daftar belanja pada dan mengakomodasi untuk dapat melakukan pengembalian dana pada sesuai dengan nominal diajukan. ## Partial Refund Pengembalian sebagian dana memungkinkan untuk mengajukan pengembalian dana untuk barang tertentu dari daftar belanja pada dan mengakomodasi untuk dapat melakukan pengembalian dana pada sesuai dengan nominal diajukan. ## Proses Refund ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/fSt6KoWqS69ln0FvbyzTt_nicepay-archbee-payment-proses-refund.png "Proses Refund") 1. mengajukan permohonan pengembalian dana kepada . 2. mengajukan permohonan pengembalian dana kepada . 3. mengajukan permohonan pengembalian dana kepada pihak *Acquiring.* 4. Pihak *Acquiring *mengajukan permohonan pengembalian dana kepada *Issuing.* 5. Pihak *Issuing *mengembalikan dana kepada . 6. Pihak *Issuing *melakukan perubahan biaya perlu dibayarkan pada . # See also ::::VerticalSplit :::VerticalSplitItem [Aturan dan Limitasi Direct Debit](docId\:Q2JZYrFPf3aki-ujIlNKI) untuk mengetahui ketentuan khusus . ::: :::VerticalSplitItem [FAQ Direct Debit](docId\:RWli_xmLMdOHPpXlQDUEx) jika ingin mengetahui pertanyaan sering diajukan terkait . ::: :::: [title] Panduan Bayar GPN [path] Payment/GPN/ ::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/O_dkmwKpMccz_t8chVoiB_jaringan-primagerbang-pembayaran-nasional0604.jpg" size="50" width="1875" height="1110" caption="Panduan Bayar GPN" position="center" showCaption="true"} Berikut langkah panduan bayar untuk . 1. melalui . 2. akan dipindahkan ke `Halaman Pembayaran GPN`, pilihlah akun ingin transaksikan. 3. berupa nomor kartu, *expired date *(`MM`/`YY`)*, *dan CVV (3 digit angka terakhir terletak di bagian belakang kartu) di kolom disediakan. 4. `Konfirmasi`.* * 5. kode OTP dikirimkan kepada ponsel . 6. pilihan `Konfirmasi`. 7. akan memberikan bukti kepada . file format JSON Panduan Bayar GPN untuk operasi . ::File{src="https://archbee-doc-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/XhLt1zlLBFCfos68wGVyL_gpnind.json" label="GPN_IND.json"} # See also ::::VerticalSplit :::VerticalSplitItem [Panduan Bayar Kartu Kredit](docId\:pf0yYjEhAE07p65seIrFt) untuk mengetahui cara membayar menggunakan . ::: :::VerticalSplitItem [Panduan Bayar VA](docId\:bSNUZMHNlj9h0wRndsQYj) untuk mengetahui cara membayar menggunakan . ::: :::: ::::VerticalSplit :::VerticalSplitItem [Panduan Bayar Direct Debit](docId\:eJ49bFx8eJVfBsoGQORTO) untuk mengetahui cara membayar menggunakan . ::: :::VerticalSplitItem Daftar pembaharuan *log* panduan bayar dapat dilihat pada [Release Information - Panduan Bayar](docId\:oBJOho15Y6-A0JVj4JODP). ::: :::: [title] Aturan dan Limitasi Paylater [path] Payment/Payloan/ Berikut adalah aturan dan limitasi pada . | **Jenis Aturan & Limitasi** | **Akulaku** | **Indodana** | **Kredivo** | **SPayLater** | | -------------------------------------- | --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | | Tampilan Pembayaran | Redirect URL | Redirect URL | Redirect URL | Redirect URL & JumpApp | | Nominal Transaksi | Minimal: Rp10.000

Maksimal: Rp25.000.000 | 30 Hari / 1 Bulan:
* Minimal Rp10.000 * Maksimal Rp2.000.000

3 Bulan:
* Minimal Rp300.000 * Maksimal Rp50.000.000

6 Bulan:
* Minimal Rp500.000 * Maksimal Rp50.000.000

12 Bulan, 18 Bulan, 24 Bulan:
* Minimal Rp1.000.000 * Maksimal Rp50.000.000 | 30 Hari:
* Minimal: Rp1 * Maksimal: tergantung limit kredit Pengguna

3 Bulan, 6 Bulan, 9 Bulan, 12 Bulan, 18 Bulan & 24 Bulan:
* Minimal: Rp500.000 * Maksimal: Rp30.000.000 | 30 Hari / 1 Bulan:
* Minimal: Rp1

3 Bulan, 6 Bulan, 12 Bulan, 18 Bulan & 24 Bulan:
* Minimal: Rp50.000 * Maksimal: Rp50.000.000 | | Cicilan | - 1 Bulan - 3 Bulan - 6 Bulan - 9 Bulan - 12 Bulan | * 30 Hari / 1 Bulan * 3 Bulan * 6 Bulan * 9 Bulan * 12 Bulan, 18 Bulan, 24 Bulan | - 30 Hari / 1 Bulan - 3 Bulan - 6 Bulan - 9 Bulan - 12 Bulan - 18 Bulan - 24 Bulan | * Beli Sekarang, Bayar Nanti (30 Hari / 1 Bulan) * 3 Bulan * 6 Bulan

* 12 Bulan * 18 Bulan * 24 Bulan | | Kedaluwarsa URL Pembayaran (*Default*) | 24 Jam | 24 Jam | 24 Jam | 5 menit | # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Model Bisnis dan Biaya Paylater](docId\:jy781lXh-jdIJrWLuV0n1) untuk mengetahui bagaimana selesai. ::: :::VerticalSplitItem [Penyelesaian Transaksi Pada Paylater](docId\:cQdqwni_Sfh7x9mSTCpt4) untuk mengetahui macam-macam cara menyelesaikan . ::: :::: ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Daftar Istilah Paylater](docId\:Gu0PXWuHJFG-EwxUsoRfQ) untuk mengetahui istilah khusus digunakan oleh . ::: :::VerticalSplitItem [FAQ Paylater](docId\:y88CwYlN6KTcATxOHbJYP) jika ingin mengetahui pertanyaan sering diajukan terkait . ::: :::: [title] NICEPAY EDC [path] / ::Image[]{src="https://api.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/IYZeQTOJDoWCv2RNAU6ar_image.png" size="32" width="1440" height="2560" position="center" caption="NICEPAY EDC" alt="NICEPAY EDC" darkWidth="1440" darkHeight="2560" showCaption="true"} menyediakan fitur menggunakan mesin EDC (*Electronic Data Capture*) terintegrasi dan beroperasi secara *real-time* dengan aplikasi elektronik berbasis Android, *Jump App*. :::hint{type="warning"} wajib memiliki aplikasi sendiri dan telah memenuhi [persyaratan](docId\:S2CT_wXC_zW5ypUcweI8k) menjadi sebelum menggunakan EDC. ::: *Jump App* digunakan untuk melakukan komunikasi dan pertukaran data pada saat *offline *dan *online*. Aplikasi ini menggunakan skema URL dan mendukung secara *real-time.* ::::hint{type="info"} :::Iframe{iframeHeight="0" code="Apabila Anda tertarik dengan NICEPAY EDC untuk kelancaran transaksi Anda, silakan hubungi Tim Sales atau Tim Customer Service NICEPAY untuk informasi lebih lanjut terkait produk NICEPAY EDC."} ::: :::: # Alur Proses *** ## Transaksi *** ::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/3LMiFtS9EzvgYTyuek1Cr_image-nicepay-edc-transaction.png" size="30" isUploading="false" position="center" caption="EDC - Transaksi" width="247" height="443" darkWidth="247" darkHeight="443" alt="EDC - Transaksi" showCaption="true"} Berikut adalah menggunakan mesin EDC. 1. Kasir melakukan *checkout* pesanan . 2. Kasir melakukan pengajuan melalui EDC. 3. EDC menerima pengajuan dari Kasir. 4. Kasir menampilkan faktur kepada . 5. mem pesanan menggunakan metode disediakan . 6. Kasir menampilkan hasil kepada melalui struk. [title] Operasi Bisnis [path] / ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/LUw8kzqex1Qb1PmlVx09x_operasi-bisnis.jpg "Operasi Bisnis") Menjalankan sebuah bukanlah hal yang mudah. Ada banyak hal perlu ketahui dan disiapkan agar dapat membuat perencanaan serta mitigasi resiko baik. Sebagai jasa terpercaya di , berusaha memberikan terbaik dengan menyiapkan sebuah saling terintegrasi dengan berbagai untuk menunjang . Sehingga, dapat langsung menerima dan mengatur manajemen dengan mudah dan cepat sesuai dengan kebutuhan. Pada ini, menyediakan beberapa panduan sangat berguna bagi dalam menjalankan operasi . dapat melihat tersebut dengan lebih rinci melalui beberapa tautan di bawah ini: ::::LinkArray{contentSource="CUSTOM" customOrder="Nzw5dMJ-sUOIXoxqJYV_f,7xh4DuXW-b3rOmMIj6yBu,3bDuF7t-aMl_5ZK-6ZCYN,ZQCdwdGtajcfLPWCcFsVq,VEFbchFskkbHXpK2gFlTH,j28FsAZqExV3qUzoDopQW,TsC2m49ztaS50hnsXC1tP,VTG50fXV8TVvWFkebDRVG,-20dKIB9O9HXG-Lt6PTDV,UQ67hvqD9VOvvojbJtO4B"} :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/9GLEwa_dQBI76kCrzhupN_id-operasi-bisnis-9.jpg"} [Back Office](docId\:NeiD6RfBV4EDRspHb2BPD) adalah yang disediakan oleh untuk membantu para dalam mengatur manajemen . ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/uLy2wzQQnBV_iZwdmO0Sm_id-operasi-bisnis.jpg"} [Produk & Biaya Layanan](docId:2deQYlDf8Az72oHGYaV7_) adalah daftar serta rincian biaya terdapat pada . ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/79QrnGkmB6lhA4O7GdV8j_id-operasi-bisnis-1.jpg"} [Deposit Saldo](docId\:VdIDXX3uGz0y1dGVucMGp) menjelaskan cara untuk melakukan deposit pada dan SMS. ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/vauwyxeMYWHdCMM1o77jF_id-operasi-bisnis-8.jpg"} [Reconcile](docId\:O90KkHXe895FMVFotNceL) adalah terkait membandingkan data pada . ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/fvApi1qvpPdlshR2AjkRI_id-operasi-bisnis-7.jpg"} [Proses Settlement](docId\:l04EuP_s604Oi2Ib3x_y6) adalah terkait penyelesaian pada . ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/6-zMxJMcRB1Ndy2joCHFK_id-operasi-bisnis-6.jpg"} [Cancel Payment](docId:_fVpAc1b3FRIAOE8Tj56q) menjelaskan tentang jenis pembatalan terdapat pada . ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/ghPwf6pO-b_V1xqsXiEDQ_id-operasi-bisnis-2.jpg"} [Invoice & Receipt](docId\:XM0SqUaTFWCjls6vYo8Pi) menjelaskan tentang jenis bukti tagihan terdapat pada . ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/vB6RhDdfUI4yaL9_aWoI__id-operasi-bisnis-3.jpg"} [Pajak](docId\:dR7m2aSPVC5vwz-HV2lql) menjelaskan tentang pajak terdapat pada . ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/Suvwi21ziLgxiB-n0pVTG_id-operasi-bisnis-5.jpg"} [FAQ Operasi Bisnis NICEPAY](docId\:kh78qDaW46j70HgqATU7e) berisi tentang pertanyaan umum terkait Operasi Bisnis terdapat pada . ::: :::: # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [NICEHub](docId\:LhDLrrC4HO1GT8pM-YRhZ) untuk mempelajari pada CMS. ::: :::VerticalSplitItem [Merchant Back Office](docId\:VMD8YtiiJqku6H8dRhcS6) untuk mempelajari *platform* disediakan . ::: :::: [title] Penyelesaian Transaksi Pada Paylater [path] Payment/Payloan/ # Settlement *** Proses menyelesaikan antara dan dilakukan setelah melakukan pesanan kepada dengan menggunakan . Proses ini bertujuan memberikan kepada terkait pendapatan diterima dengan pembukuan apakah nominal diterima sesuai pada nominal tercatat pada . Berikut adalah waktu sudah ditentukan dari bekerja sama dengan . | **Nama Layanan** | **Waktu Settlement** | **Keterangan** | | ---------------- | --------------------- | ---------------------------------------------------------------------------------- | | Akulaku | H+4 | Waktu dihitung setelah melakukan [Confirm Receipt](docId:1jAr45oEk0lYZuXjyZb5c) | | Indodana | H+4 | Hari kerja | | Kredivo | 2 hari dalam seminggu | Selasa dan Kamis | Terkadang, mengalami *void *atau *refund * membuat tidak berhasil. # Void *** Pembatalan dapat diajukan jika tersebut sudah melakukan penuh (*full amount*) sudah berhasil dan belum melalui . # Refund *** *Refund *adalah pengembalian dana terjadi atas persetujuan dan tanpa adanya sanggahan di antara kedua belah pihak. Setelah mengajukan *refund *kepada , akan menggunakan *dashboard* khusus diberikan oleh untuk mengurus *refund *secara langsung*.* :::hint{type="warning"} Proses pengembalian dana untuk dari kepada dilakukan melalui Cancel ( : [Cancel - API Checkout](docId\:MMmlusWDkyUsJxF421yKn) | Non-: [Cancel - API Paylater](docId\:GxDH-yDgXbTZTVLdJykDL)) atau [Merchant Back Office](docId\:VMD8YtiiJqku6H8dRhcS6). tidak diperkenankan melakukan transfer dana secara langsung kepada . Hal ini diperlukan untuk memenuhi kepatuhan terhadap peraturan . ::: ## Full Refund Pengembalian seluruh dana memungkinkan untuk mengajukan pengembalian dana untuk seluruh belanjaan dari daftar belanja pada dan mengakomodasi untuk dapat melakukan pengembalian dana pada sesuai dengan nominal diajukan. Berikut adalah waktu *full refund* sudah ditentukan dari bekerja sama dengan . | **Nama Layanan** | **Waktu Refund** | **Keterangan** | | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- | | Akulaku | Sebelum dan sesudah konfirmasi | *Online* | | Indodana | - Sebelum waktu *cut-off * - Setelah waktu *cut-off * - *Refund* *online*: di bawah 30 hari - *Refund* manual: di atas 30 hari - *Cancel* RTO sebelum waktu *cut-off * - *Cancel* RTO setelah waktu *cut-off * | Waktu *cut-off* = 23.59 | | Kredivo | * *Online*: di bawah 30 hari * *Offline*: di atas 30 hari | | ## Partial Refund Pengembalian sebagian dana memungkinkan untuk mengajukan pengembalian dana untuk barang tertentu dari daftar belanja pada dan mengakomodasi untuk dapat melakukan pengembalian dana pada sesuai dengan nominal diajukan. Berikut adalah waktu *partial refund * sudah ditentukan dari bekerja sama dengan . | **Nama Layanan** | **Waktu Refund** | **Keterangan** | | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- | | Akulaku | Sebelum dan sesudah konfirmasi | *Online* | | Indodana | - Sebelum waktu *cut-off* - Setelah waktu *cut-off* - *Refund* *online*: di bawah 30 hari - *Refund* manual: di atas 30 hari - *Cancel* RTO sebelum waktu *cut-off* - *Cancel* RTO setelah waktu *cut-off* | Waktu *cut-off* = 23.59 | | Kredivo | * *Refund online*: di bawah 30 hari * *Refund offline*: di atas 30 hari | | ## Proses Refund ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/fSt6KoWqS69ln0FvbyzTt_nicepay-archbee-payment-proses-refund.png "Proses Refund") 1. mengajukan permohonan pengembalian dana kepada . 2. mengajukan permohonan pengembalian dana kepada . 3. mengajukan permohonan pengembalian dana kepada pihak *Acquiring.* 4. Pihak *Acquiring *mengajukan permohonan pengembalian dana kepada *Issuing.* 5. Pihak *Issuing *mengembalikan dana kepada . 6. Pihak *Issuing *melakukan perubahan biaya perlu dibayarkan pada . # Flagging *** *Flagging *adalah suatu kondisi terjadi saat dana sudah terpotong akan tetapi masih belum berubah pada . akan melakukan konfirmasi kepada apakah dapat diproses *flagging *secara manual (sukses) atau akan di-*refund *di sisi .  # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Model Bisnis dan Biaya Paylater](docId\:jy781lXh-jdIJrWLuV0n1) untuk mengetahui bagaimana selesai. ::: :::VerticalSplitItem [Aturan dan Limitasi Paylater](docId\:AssO3UWjtG3j_pyf7l2Et) untuk mengetahui ketentuan khusus . ::: :::: ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Daftar Istilah Paylater](docId\:Gu0PXWuHJFG-EwxUsoRfQ) untuk mengetahui istilah khusus digunakan oleh . ::: :::VerticalSplitItem [FAQ Paylater](docId\:y88CwYlN6KTcATxOHbJYP) jika ingin mengetahui pertanyaan sering diajukan terkait . ::: :::: [title] Panduan Bayar Direct Debit [path] Payment/Direct Debit/ ::::LinkArray :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/1qyNN-D14bEYgHV1hmMLA_jeniuspay-02.png"} [Jenius Pay](docId\:JOHcsWErcw7CxeiC5xY2V) ::: :::: # See also ::::VerticalSplit :::VerticalSplitItem [Panduan Bayar Kartu Kredit](docId\:pf0yYjEhAE07p65seIrFt) untuk mengetahui cara membayar menggunakan . ::: :::VerticalSplitItem [Panduan Bayar VA](docId\:bSNUZMHNlj9h0wRndsQYj) untuk mengetahui cara membayar menggunakan . ::: :::: ::::VerticalSplit :::VerticalSplitItem [Panduan Bayar GPN](docId\:aVzjzuByPtCcIq5feYQvh) untuk mengetahui cara membayar menggunakan . ::: :::VerticalSplitItem Daftar pembaharuan *log* panduan bayar dapat dilihat pada [Release Information - Panduan Bayar](docId\:oBJOho15Y6-A0JVj4JODP). ::: :::: [title] ShopeePay [path] Payment/E-Wallet/Panduan Bayar E-Wallet/ ::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/XJYfo7a6B7jaL3bN6FC6U_shopeepaylogoorangehorizontal.png" size="50" width="3499" height="1430" caption="ShopeePay" position="center" showCaption="true"} # Informasi Nomor Pembayaran *** :::hint{type="info"} Pastikan melakukan sebelum 5 menit. ::: | **Nomor Seluler** | `082-1851-XXX-XX` | | ------------------------ | ------------------------------------- | | **Mitra E-Wallet** | ShopeePay | | **Nominal** | Rp10.000 | | **Nama Penerima ** | `billingNm` | | **Nomor Pemesanan ** | Invoice-1234 | | **Masa Berlaku ** | 16-06-2016 / 17:15:00
| # Pembayaran *** ## ShopeePay Langkah dengan ShopeePay: 1. melalui `ShopeePay` dan aplikasi akan *Jump App* ke ShopeePay. 2. Aplikasi ShopeePay akan menampilkan detail . 3. Pastikan `Saldo` cukup. 4. Kemudian klik `Bayar Sekarang` dan masukkan PIN `ShopeePay`. 5. Pembayaran berhasil! akan dipindahkan ke `result page`. file format JSON Panduan Bayar ShopeePay untuk operasi . ::File{src="https://archbee-doc-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/nzs0X9BtjbEri2FG3bUWc_ewalletindshopee.json" label="EWALLET_IND_SHOPEE.json"} ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/C7dSjojynVNI65rE-EMiX_shopeepay.png "Panduan Bayar - ShopeePay 1") ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/uLfp3l2IO46QqcfM4DWts_12.png "Panduan Bayar - ShopeePay 2") [title] Aturan dan Limitasi Payout [path] Payout/ Berikut adalah ketentuan batas nominal menggunakan . | **Jenis Aturan & Limitasi** | **Nominal Minimal Transaksi** | **Nominal Maksimal Transaksi** | ***Cut-Off*** | **Keterangan** | | ------------------------------- | ----------------------------- | ------------------------------ | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | | **Online (On Us/Over Booking)** | Tidak ada limit | Tidak ada limit | Tersedia 24/7 | Khusus Bank Permata, Mandiri, BRI, Danamon | | **Online (Off Us)** | Rp10.000 | Rp250.000.000 | Tersedia 24/7 | - | | **SKN** | Rp10.000 | Kurang dari Rp999.999.999 | 09:00 WIB - 15:30 WIB (Hanya Hari Kerja) | NICEPAY API dan layanan Payout tersedia 24/7. Namun, transaksi yang dilakukan pada saat *cut-off* akan diproses pada hari kerja berikutnya. | | **RTGS** | Rp100.000.001 | Rp900.000.000 | Tersedia 24/7 | - | | **Cashout** | Rp50.000 | Rp1.000.000 | 00:40 WIB - 23:59 WIB | - | :::hint{type="info"} Silakan kunjungi [Produk & Biaya Layanan](docId:2deQYlDf8Az72oHGYaV7_) berikut untuk lebih lanjut tentang biaya . ::: # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Alur Pengiriman Dana Payout](docId\:L6lK9U1KCOmS-8PJZ6i4a) untuk mengetahui pada . ::: :::VerticalSplitItem [Integrasi & Testing Payout](docId\:LkYgPUsJyOVKICpo6yFHn) untuk mengetahui cara dan uji coba . ::: :::: [title] Integrasi & Testing Payout [path] Payout/ # Langkah Integrasi Beserta yang Digunakan *** 1. Lakukan Request ([Registration - API Payout (Disbursement) SNAP](docId\:SgtN0VBKPUWVOV62EVREB)). 2. Lakukan Approve ([Approve Transaction - API Payout (Disbursement) SNAP](docId\:Q5UEc9-eqJxtmhVJtMbV7)) dan mempersiapkan *disburse *ke akun tujuan. 3. Menerima *callback *dan *push notification *dari . 4. Lakukan Inquiry ([Inquiry - API Payout (Disbursement) SNAP](docId\:GkYB9CEm1x0EzRv_wCLre)) agar dapat memeriksa pesanan menggunakan Inquiry . 5. Tambahan: lakukan Cancel ([Cancel Transaction - API Payout (Disbursement) SNAP](docId:25Q_ooJlYAS8krNpg6bb3)) untuk membatalkan . :::hint{type="info"} Pastikan cukup sebelum membuat . kunjungi [Deposit Saldo](docId\:VdIDXX3uGz0y1dGVucMGp) untuk lebih lengkap mengenai deposit dana . ::: # Kredensial Untuk Tes Payout *** | **Lingkungan** | **Deskripsi** | | -------------- | --------------------------------------------------------------------- | | Development | Akun
* accountNo: 6030901753 * benefNm: John Doe * bankCd: BDIN | # Cara Uji Coba Payout *** | **Langkah Tes** | **Pilihan Metode Payout** | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | 1. Menggunakan asli atau Sandbox dengan `IONPAYTEST`. 2. akun ke dalam sisi dengan `accountNo`. 3. nama anggota atau nama pemilik akun dengan `benefNm`. | Set nilai `payoutMethod`:
* *Over Booking* -> `payoutMethod = 0` * *Online Trans* -> `payoutMethod = 1` * SKN -> `payoutMethod = 2` * RTGS -> `payoutMethod = 3` * -> `payoutMethod = 4` | **** # Alasan Peluang Transaksi Gagal *** 1. Terjadi *timeout* dari sisi . 2. Akun tidak valid. 3. Saldo tidak cukup. # Integration Checklist dan Test Case *** - [ ] Implementasi inquiry setelah mendapatkan *callback*. - [ ] Implementasi inquiry setelah mendapatkan apabila di-*setting *URL* notification* - [ ] Meninjau *log* . - [ ] Meninjau pengaturan *firewall* (eg. Cloudflare untuk pengaturan URL notif ). - [ ] Memeriksa implementasi `merchantToken`. - [ ] Menjalankan tes skenario pada *Development Environment*. - [ ] Menjalankan tes skenario pada *Production Environment*. [Get Sample Scenario](https://docs.google.com/spreadsheets/d/e/2PACX-1vQIaIMCM0vZ3L1cA-JkW3YxyIpjsB966fg1wTeT8qpFDowEvulIEWOoY6I4uJPL3A/pub?output=xlsx)**** - [ ] Meninjau *Error Handling* (*Timeout, Failed, Negative Case*). # Best Practice *** - Untuk uji coba pada sisi dapat menggunakan `IONPAYTEST` dan opsi transfer atur `payoutMethod`. - `reserved_dt` `reserved_tm` untuk *scheduling*. - *Request* dengan atau tidak dengan `reserved_dt` `reserved_tm` dapat Approve & Reject. - Setelah *approve,* tidak bisa *cancel* kalau tidak ada `reserved_dt` `reserved_tm` atau bisa *cancel *kalau ada `reserved_dt` `reserved_tm` (selama belum lewat `reserved_dt` `reserved_tm`). - Ketika diterima pada notif URL , sangat merekomendasikan untuk melakukan verifikasi menggunakan Inquiry . - `Notification Handling` berguna untuk meminimalisir aksi *Fraud*, sangat merekomendasikan untuk melakukan verifikasi `Notification Handling`. # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Alur Pengiriman Dana Payout](docId\:L6lK9U1KCOmS-8PJZ6i4a) untuk mengetahui pada . ::: :::VerticalSplitItem [Metode Payout](docId\:WBZdLVm1w_QrVjXtPZ_0J) untuk mengetahui metode pengiriman dana terdapat pada . ::: :::: [title] Panduan NICEPAY EDC [path] NICEPAY EDC/ # Melakukan Proses Transaksi *** ![NICEPAY EDC - Transaksi](https://api.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/1PUfEcW8bp_C9UlFVilMG-20260119-041112.png "NICEPAY EDC - Transaksi") Berikut adalah menggunakan EDC. 1. Buka aplikasi . 2. nominal pada aplikasi . 3. Halaman EDC akan segera teralihkan menuju aplikasi . 4. Pada aplikasi , pihak akan memilih sesuai permintaan Pengguna: - Jika Pengguna ingin melakukan dengan Kartu, maka: - gambar kartu. - Pembayaran dapat dilakukan dengan memasukkan kartu di bawah EDC atau dengan *tap *kartu di depan EDC. - Jika Pengguna ingin melakukan dengan , maka: - gambar QR. - EDC akan menampilkan untuk . - Pengguna memindai kode QR melalui media Banking/. 5. Status dapat dilihat melalui `Riwayat Transaksi`. # Melihat Riwayat Transaksi *** ::Image[]{src="https://api.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/dz1kAPyjpPsg33lZePPeQ-20260112-072433.png" size="56" width="2202" height="1729" position="center" caption="NICEPAY EDC - Riwayat Transaksi" alt="NICEPAY EDC - Riwayat Transaksi" showCaption="true"} Berikut adalah untuk melihat `Riwayat Transaksi` pada EDC. 1. Buka aplikasi . 2. `Riwayat Transaksi`. 3. Halaman akan menampilkan daftar telah dilakukan. 4. diinginkan dari daftar. 5. Halaman rincian akan muncul pada layar. 6. `Print Bukti Transaksi` untuk mencetak rincian tersebut. # Pengaturan *** ::Image[]{src="https://api.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/nQt7irQTsht93SAzgdQcK-20260112-072516.png" size="58" width="2524" height="2029" position="center" caption="NICEPAY EDC - Pengaturan" alt="NICEPAY EDC - Pengaturan" showCaption="true"} Berikut adalah untuk melihat `Pengaturan` pada EDC. 1. Buka aplikasi . 2. `Pengaturan`. 3. Halaman akan menampilkan pengaturan untuk masa berlaku . 4. Masukkan pengaturan waktu dalam satuan menit. Rentang waktu diperbolehkan adalah 5-19 menit. 5. Pengaturan akan tersimpan secara otomatis apabila terdapat perubahan. [title] LinkAja [path] Payment/E-Wallet/Panduan Bayar E-Wallet/ ::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/HGLUbcD9eZPkXef0KDc2x_logo-link-aja.png" size="50" width="400" height="300" caption="LinkAja" position="center" showCaption="true"} # Informasi Nomor Pembayaran *** :::hint{type="info"} Pastikan melakukan sebelum 5 menit. ::: | **Nomor Seluler** | `082-1851-XXX-XX` | | ------------------- | ------------------------------------- | | **Mitra E-Wallet** | LinkAja | | **Nominal** | Rp10.000 | | **Nama Penerima** | `billingNm` | | **Nomor Pemesanan** | Invoice-1234 | | **Masa Berlaku** | 16-06-2016 / 17:15:00
| # Pembayaran *** ## LinkAja Langkah dengan LinkAja. 1. melalui `LinkAja`. 2. `Nomor Seluler Anda yang terdaftar`, kemudian akan dialihkan ke `Halaman Pembayaran LinkAja`. 3. Masuk dengan akun . 4. kode verifikasi. 5. `Pay` untuk melanjutkan . 6. Setelah berhasil, akan kembali dialihkan ke `Payment Result page`. file format JSON Panduan Bayar LinkAja untuk operasi . ::File{src="https://archbee-doc-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/ySZQdnAMxyXixLlYhWQ3c_ewalletindlink.json" label="EWALLET_IND_LINK.json"} ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/ZuGf8rKcyI4FEbRvEEiNx_linkaja.png "Panduan Bayar - LinkAja 1") ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/eJ3VAfsK8qYipFh72nngK_8.png "Panduan Bayar - LinkAja 2") [title] Daftar Istilah GPN [path] Payment/GPN/ # GPN Gerbang Pembayaran Nasional, khusus untuk hanya di . # EDC *Electronic Data Capture *adalah mesin digunakan oleh untuk menerima dan melakukan kartu atau layanan lainnya dengan . # Bank Issuing menerbitkan Kartu Debit atau Kredit kepada . # Bank Acquiring menerima dari Kartu Debit atau Kredit milik . [title] Alur Pembayaran E-Wallet [path] Payment/E-Wallet/ # Alur Mitra E-Wallet *** ![](https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-_SWNxzPeNf9MV_i7u8D9z-20240821-034748.jpg "Alur E-Wallet Umum") Deskripsi alur setelah pesanan: 1. melakukan *request checkout* kepada . 2. mengirimkan *request checkout* menggunakan Registration kepada . 3. mengirimkan *response *order regist kepada . 4. mengirimkan kepada . 5. mengajukan kepada dan menyimpan . 6. melakukan *generate *pesanan. 7. Pada saat : - Jika menggunakan OVO, maka akan mengirimkan ke aplikasi terkait untuk melakukan . - Jika menggunakan lain (selain OVO dan AstraPay), maka akan mengalihkan menuju . Kemudian, harus melakukan *login *dengan akun terkait sebelum melakukan . 8. mengirimkan kepada . 9. menerima . 10. mengirimkan kepada . 11. menerima . 12. mengirimkan kepada . 13. menerima . 14. melakukan pemeriksaan kepada . 15. mengirimkan *response *dari pemeriksaan kepada . 16. menerima terakhir. 17. mengirimkan konfirmasi pesanan kepada . # Alur AstraPay *** ![](https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-T5by9bcJvmxK4Cc5TxDpL-20240821-034826.jpg "Alur E-Wallet AstraPay") Deskripsi alur saat melakukan : 1. Jika belum memiliki akun AstraPay: - melakukan *request* *checkout* kepada . - mengirimkan Registration ([nicepay/api/linkEnable.do](#)) kepada . - mengirimkan *account link request *kepada AstraPay. - AstraPay menerima pengajuan. - AstraPay mengirimkan *response *pengalihan URL menuju kepada . - mengirimkan *response *pengalihan URL kepada . - menampilkan pendaftaran kepada . - melakukan pendaftaran akun. - mengirimkan pendaftaran akun kepada AstraPay. - AstraPay melakukan validasi akun. - AstraPay mengirimkan kepada . - mengirimkan kepada . - mengirimkan bahwa akun sudah didaftarkan kepada . 2. melakukan *checkout *kepada . 3. mengajukan ([nicepay/api/linkInitiate.do](#)) kepada . 4. mengajukan kepada AstraPay. 5. AstraPay melakukan *generate *. 6. AstraPay mengirimkan *response *redirect URL kepada . 7. mengirimkan *response *redirect URL kepada . 8. mengalihkan pada AstraPay. 9. melakukan verifikasi . 10. melakukan kepada AstraPay. 11. AstraPay melakukan verifikasi . 12. AstraPay mengirimkan *callback *kepada . - mengirimkan *response *kepada . - menampilkan *response callback *kepada . 13. AstraPay mengirimkan kepada . - menerima . - mengirimkan kepada . - menerima . 14. mengirimkan *request* pemeriksaan menggunakan Status kepada . 15. mengirimkan *response *pemeriksaan kepada . 16. menerima terakhir. 17. memperbarui kepada . # See also ::::VerticalSplit :::VerticalSplitItem [Fitur E-Wallet](docId\:FltKp9kGyS4hkmOPZojoV) untuk mengetahui fitur pada . ::: :::VerticalSplitItem [Integrasi & Testing E-Wallet](docId\:b9HPduhC2MPMLaLHIjCbO) untuk mengetahui cara dan uji coba . ::: :::: ::::VerticalSplit :::VerticalSplitItem [Daftar Istilah E-Wallet](docId\:RtyOOpERogK7_PImzLfth) untuk mengetahui istilah khusus digunakan oleh . ::: :::VerticalSplitItem [FAQ E-Wallet](docId\:QyuY2tdI299dVSNUt9G-1) jika ingin mengetahui pertanyaan sering diajukan terkait . ::: :::: [title] Penyelesaian Transaksi Pada GPN [path] Payment/GPN/ # Settlement *** Proses menyelesaikan antara dan dilakukan setelah melakukan pesanan kepada dengan menggunakan kartu berlogo . Proses ini bertujuan memberikan kepada terkait pendapatan diterima dengan pembukuan apakah nominal diterima sesuai pada nominal tercatat pada . terkadang menerima *Void *atau *Refund * membuat tidak berhasil. # Void *** Pembatalan dapat diajukan jika tersebut sudah melakukan penuh (*full amount*) sudah berhasil dan belum melalui . # Refund *** *Refund *adalah pengembalian dana terjadi atas persetujuan dan tanpa adanya sanggahan di antara kedua belah pihak. Terdapat 2 jenis *Refund*, yaitu: ## Full Refund Pengembalian seluruh dana memungkinkan untuk mengajukan pengembalian dana untuk seluruh belanjaan dari daftar belanja pada dan mengakomodasi untuk dapat melakukan pengembalian dana pada sesuai dengan nominal diajukan. ## Partial Refund Pengembalian sebagian dana memungkinkan untuk mengajukan pengembalian dana untuk barang tertentu dari daftar belanja pada dan mengakomodasi untuk dapat melakukan pengembalian dana pada sesuai dengan nominal diajukan. ## Proses Refund ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/x6C7mmpqiHpuXiaVEplGT_nicepay-archbee-payment-proses-refund.png "Proses Refund") 1. mengajukan permohonan pengembalian dana kepada . 2. mengajukan permohonan pengembalian dana kepada . 3. mengajukan permohonan pengembalian dana kepada pihak *Acquiring.* 4. Pihak *Acquiring *mengajukan permohonan pengembalian dana kepada *Issuing.* 5. Pihak *Issuing *mengembalikan dana kepada . 6. Pihak *Issuing *melakukan perubahan biaya perlu dibayarkan pada . # Daftar Bank Issuer *** | **BANK** | **VOID** | **Manual Refund** | | -------- | -------- | ----------------- | | BNI | ❌ | ✅ | | BTN | ✅ | ✅ | # See also ::::VerticalSplit :::VerticalSplitItem [Model Bisnis dan Biaya GPN](docId\:XDwm-hvLYgDDcL-Ms5bi_) untuk mengetahui bagaimana selesai. ::: :::VerticalSplitItem [Aturan dan Limitasi GPN](docId\:WXmjJclMZvXWAAxSUHaPt) untuk mengetahui ketentuan khusus . ::: :::: ::::VerticalSplit :::VerticalSplitItem [Daftar Istilah GPN](docId\:QrpRszpmgc7DERhBS8nWQ) untuk mengetahui istilah khusus digunakan . ::: :::VerticalSplitItem [FAQ GPN](docId:38L5TBCuVolwnrv_C65Ft) jika ingin mengetahui pertanyaan sering diajukan terkait . ::: :::: [title] Daftar Istilah Paylater [path] Payment/Payloan/ # RTO *Request Time Out *terjadi karena terdapat gangguan koneksi dari sisi , contoh *Intermittent.* # MDR *Merchant Discount Rate, *tarif dikenakan kepada oleh . # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Alur Pembayaran Paylater](docId\:P9_ssNsvaBrA46UVq9bO_) untuk mengetahui pada saat melakukan dengan . ::: :::VerticalSplitItem [Fitur Paylater](docId\:B78u4Xq_3rXzfw_QPS4No) untuk mengetahui fitur pada . ::: :::: ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Integrasi & Testing Paylater](docId\:ZEuw_0d227R_LUPBI3ptN) untuk mengetahui cara dan uji coba . ::: :::VerticalSplitItem [FAQ Paylater](docId\:y88CwYlN6KTcATxOHbJYP) jika ingin mengetahui pertanyaan sering diajukan terkait . ::: :::: [title] Alur Pembayaran GPN [path] Payment/GPN/ # Redirect *** ![](https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-757Vo426kXpqwmw9KoPzr-20240821-035914.jpg "Alur Pembayaran Redirect GPN") Deskripsi langkah: 1. melakukan *checkout*. 2. mengirimkan data *checkout *kepada . 3. mengirim pengajuan *checkout *menggunakan Registration kepada . 4. melakukan pendaftaran *checkout*. 5. mengalihkan menuju . 6. menampilkan kepada . 7. memilih . 8. memasukkan data kartu. 9. mengirimkan data kartu menggunakan kepada . 10. mengajukan token kepada / *Issuing.* 11. / *Issuing *menerima pengajuan. 12. / *Issuing *mengirimkan token kepada . 13. menerima *response *verifikasi. 14. Pada waktu bersamaan: - mengalihkan menuju DAS* authentication.* - mengajukan OTP kepada / *Issuing.* 15. / *Issuing *mengirim OTP kepada . 16. menerima OTP. 17. memasukkan OTP dan mengirimkan kepada / *Issuing.* 18. / *Issuing *melakukan validasi OTP. 19. / *Issuing *mengirim *response *validasi kepada . 20. mengajukan *charge *kepada / *Issuing.* 21. / *Issuing *melakukan *charge amount.* 22. / *Issuing *mengirimkan kepada . 23. mengalihkan menuju `callbackUrl`. 24. menampilkan `callbackUrl` kepada . 25. mengirim kepada . 26. menerima . 27. mengajukan status inquiry kepada . 28. menerima pengajuan. 29. mengirim *response *status inquiry kepada . 30. menerima akhir. 31. mengirimkan hasil kepada . # Direct *** ![](https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-4GLaqnDAH6kqEdOmFXRZk-20240821-040001.jpg "Alur Pembayaran Direct GPN") Deskripsi langkah: 1. melakukan *checkout*. 2. mengirimkan data *checkout* kepada . 3. mengajukan *checkout *dengan menggunakan Registration kepada . 4. melakukan pendaftaran checkout. 5. mengirim *response *kepada . 6. menampilkan formulir data kartu kepada . 7. memasukkan data kartu. 8. mengajukan kepada . 9. mengirimkan data kartu menggunakan kepada . 10. mengajukan token kepada / *Issuing.* 11. / *Issuing *menerima pengajuan. 12. / *Issuing *mengirimkan token kepada . 13. menerima *response* verifikasi. 14. Pada waktu bersamaan: - mengajukan OTP kepada / *Issuing, *dan - mengalihkan menuju *DAS authentication.* 15. / *Issuing *mengirimkan OTP kepada . 16. memasukkan OTP dan mengirimkan kepada / *Issuing.* 17. / *Issuing *melakukan validasi OTP. 18. / *Issuing *mengirim *response *validasi kepada . 19. mengajukan *charge *kepada / *Issuing.* 20. / *Issuing *melakukan *charge amount.* 21. / *Issuing *mengirim kepada . 22. mengalihkan menuju `callbackUrl`. 23. menampilkan `callbackUrl` kepada . 24. mengirimkan kepada . 25. menerima . 26. mengajukan inquiry kepada . 27. menerima pengajuan. 28. mengirim *response * inquiry kepada . 29. menerima akhir. 30. mengirimkan hasil kepada . # See also ::::VerticalSplit :::VerticalSplitItem [Tipe Metode Pembayaran GPN](docId\:kEYekPeYstONiu2iJQVM0) untuk mengetahui jenis saat menggunakan kartu . ::: :::VerticalSplitItem [Integrasi & Testing GPN](docId\:LuCYNk98cX7upRb-xSZS3) untuk mengetahui cara dan uji coba kartu . ::: :::: ::::VerticalSplit :::VerticalSplitItem [Daftar Istilah GPN](docId\:QrpRszpmgc7DERhBS8nWQ) untuk mengetahui istilah khusus digunakan . ::: :::VerticalSplitItem [FAQ GPN](docId:38L5TBCuVolwnrv_C65Ft) jika ingin mengetahui pertanyaan sering diajukan terkait . ::: :::: [title] GPN [path] Payment/ ::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/Gmj5u4Ax6JjFfP-sdwZVv_jaringan-primagerbang-pembayaran-nasional0604.jpg" size="80" width="1875" height="1110" caption="GPN" position="center" showCaption="true"} # Tentang GPN *** **GPN** atau Gerbang Pembayaran Nasional adalah sebuah khusus dalam negeri dapat menerima kartu dari semua tanpa dipungut biaya administrasi tambahan. Pengguna ini harus memiliki kartu berlisensi GPN untuk dapat bertransaksi. Fitur dimiliki oleh ini memudahkan para untuk menerima dari berbagai kartu berlisensi GPN dari semua ada di . Sehingga, para tidak perlu menyediakan mesin EDC dalam jumlah banyak atau kompleks untuk menerima dari berbagai (GPN* Issuing*) ada di . # Tipe Merchant *** Terdapat 2 tipe saat menggunakan , yakni *Aggregator* dan *Facilitator*. ## Aggregator memiliki dengan menggunakan kredensial dari . tersebut dapat melakukan untuk semua secara langsung menggunakan satu akun berada pada . ## Facilitator memiliki dengan menggunakan kredensial sendiri. tersebut mendapatkan izin dari *payment facilitator *untuk melakukan dengan menggunakan mereka secara langsung tanpa menggunakan perantara. :::hint{type="info"} kunjungi [Proses Settlement](docId\:l04EuP_s604Oi2Ib3x_y6) untuk mengetahui lebih lanjut tentang *Aggregator* dan *Facilitator.* ::: # See also ::::VerticalSplit :::VerticalSplitItem [API GPN](docId\:l1MBNmABcGh-FgMfe2eig) untuk mengetahui rincian digunakan pada . ::: :::VerticalSplitItem [API Versi 1](docId\:wnppL9xOjt6As5a8Xe4LE) untuk mengetahui rincian digunakan pada Versi 1. ::: :::: [title] Integrasi & Testing E-Wallet [path] Payment/E-Wallet/ Sistem didukung oleh dari beberapa , antara lain OVO, DANA, LinkAja, ShopeePay, dan AstraPay. # Langkah Integrasi Dengan Menggunakan API *** 1. Lakukan Order Registration. - SNAP: [Registration - API E-Wallet (Direct Debit) SNAP](docId:66iE5aVXXL4uqw6hqFPVV). - Redirect: [E-Wallet - API Checkout](docId\:LsZ2xGeXUSGjm_tVrlbGI). 2. Lakukan Charge. - Redirect: [Payment - API Checkout](docId\:YnNFZr9aonpJ7ZIKAFYSx). 3. Menerima *callback *dan *push notification *dari . 4. Lakukan Check Status. - SNAP: [Check Status Transaction - API E-Wallet (Direct Debit) SNAP](docId\:vB63D8suaKPYP-4bIOWx9). - Redirect: [Status Inquiry - API Checkout](docId\:K9vBS87ev9_w5oJAU0et3). 5. Opsional: lakukan Cancel untuk membatalkan . - Redirect: [Cancel - API Checkout](docId\:MMmlusWDkyUsJxF421yKn). # Kredensial Untuk Tes E-Wallet *** | **Nama E-Wallet** | **Deskripsi** | | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | DANA | Phone: 081227619520
Pin: 159753 | | ShopeePay | [APK Shopee](https://drive.google.com/file/d/1gGE2-7OpBWXoz_KF7Kl0IThWtnAaQjCe/view) \| [APK ShopeePay](https://drive.google.com/file/d/13cYsNzcmoJwe4fiLjnrmhAT0Uc94w81K/view)
Username: nicepaytest01
Password: NicepayTest01
ShopeePay PIN: 142536 | :::hint{type="info"} wajib melakukan Whitelist IP pada perangkat digunakan untuk uji coba melalui aplikasi ShopeePay atau Shopee. hubungi Tim Integrasi untuk lebih lanjut. ::: # Uji Coba E-Wallet *** | **Nama e-Wallet** | **Langkah Tes** | **Aturan Pembatalan** | | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | OVO | 1. Menggunakan akun dan nomor telepon asli. 2. Konfirmasi melalui aplikasi OVO. 3. Mengumpulkan dan melanjutkan dan berhasil. 4. Waktu kedaluwarsa (*Default*) = 55 detik. | - Nominal sesuai tagihan pada hari sama => *Void.* - Nominal sesuai tagihan pada hari berbeda => Tidak dapat dilakukan. - Sebagian dari nominal => Tidak dapat dilakukan*.* | | DANA | 1. Menggunakan akun asli atau *dummy.* 2. Masuk akun. 3. OTP. 4. Mengumpulkan dan konfirmasi . 5. Transaksi berhasil. 6. Waktu kedaluwarsa (*Default*) = 24 jam. | - Nominal sesuai tagihan \< 24 jam => *Void.* - Nominal sesuai tagihan > 24 jam => *Refund Online.* - Pengajuan > 30 hari => *Block.* - Sebagian dari nominal => *Refund Online.* - Sebagian dari nominal jika *timeout *=> *Manual Refund.* - Tidak bisa mengajukan pada pukul 00.00 - 01.00 (tengah malam). | | LinkAja | 1. Menggunakan akun asli. 2. Masuk akun. 3. OTP. 4. Mengumpulkan . 5. Konfirmasi dan berhasil. 6. Waktu kedaluwarsa (*Default*) = 5 menit. | - Nominal sesuai tagihan \< 30 hari => *Void.* - Nominal sesuai tagihan > 30 hari => *Manual Refund.* - Sebagian dari nominal => *Manual Refund.* - *Checkout * LinkAja pada web => 5 menit. | | ShopeePay | 1. Menggunakan akun asli atau *dummy.* 2. Konfirmasi pada aplikasi Shopee. 3. PIN. 4. Transaksi berhasil. 5. Waktu kedaluwarsa (*Default*) = 5 menit. | - Nominal sesuai tagihan pada hari sama / sebelum pukul 24.00 => *Void.* - Nominal sesuai tagihan tidak pada hari sama namun di bawah 365 hari => *Refund.* - Nominal sesuai tagihan > 365 hari => *Manual Refund.* - Sebagian dari nominal => *Block Request.* - Tidak bisa mengajukan pada pukul 23.55 - 06.00. | | AstraPay | 1. Mendaftarkan nomor ponsel dan menghubungkan ke . 2. Menggunakan nomor ponsel sudah terhubung dengan . 3. Masuk akun. 4. Mengumpulkan dan konfirmasi . 5. Transaksi berhasil. 6. Waktu kedaluwarsa (*Default*) = 15 menit. | Tidak bisa *refund* | # Alasan Peluang Transaksi Gagal *** - Transaksi terkena waktu kedaluwarsa (*Expired Time).* - Jaringan pada sisi *Issuer *sedang tidak mendukung. - Ditolak oleh pihak / *Issuer */ terkait. - Nomor ponsel Pengguna belum terdaftar pada aplikasi . # Integration Checklist dan Test Case *** - [ ] Implementasi inquiry setelah mendapatkan *callback.* - [ ] Implementasi inquiry setelah mendapatkan di dalam `dbProcessUrl`. - [ ] Meninjau *log* . - [ ] Meninjau pengaturan firewall (eg. *Cloudflare* untuk pengaturan `dbprocessUrl`). - [ ] Memeriksa implementasi `merchantToken`. - [ ] Menjalankan tes skenario pada *Development* *Environment.* - [ ] Menjalankan tes skenario pada *Production Environment.* [Get Sample Scenario](https://docs.google.com/spreadsheets/d/e/2PACX-1vQIaIMCM0vZ3L1cA-JkW3YxyIpjsB966fg1wTeT8qpFDowEvulIEWOoY6I4uJPL3A/pub?output=xlsx) - [ ] Meninjau *Error Handling* (*Timeout, Failed, Negative Case*). # Best Practice *** - Ketika pada `dbProcessUrl` diterima, sangat merekomendasikan untuk melakukan verifikasi menggunakan Inquiry . - Informasi `cartData` wajib diisi. - Pada OVO, masuk melalui *push notification *dalam aplikasi ponsel. - Pada ShopeePay, dilakukan dengan metode *jump in* ke aplikasi *mobile *Shopee. - Pada LinkAja dan DANA, masuk ke . # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Alur Pembayaran E-Wallet](docId\:saeozIsJLLCkE5s4QVnHw) untuk mengetahui pada saat melakukan dengan . ::: :::VerticalSplitItem [Fitur E-Wallet](docId\:FltKp9kGyS4hkmOPZojoV) untuk mengetahui fitur pada . ::: :::: ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Daftar Istilah E-Wallet](docId\:RtyOOpERogK7_PImzLfth) untuk mengetahui istilah khusus digunakan oleh . ::: :::VerticalSplitItem [FAQ E-Wallet](docId\:QyuY2tdI299dVSNUt9G-1) jika ingin mengetahui pertanyaan sering diajukan terkait . ::: :::: [title] FAQ E-Wallet [path] Payment/E-Wallet/ ### Apa perbedaan pembayaran menggunakan E-Wallet dan QRIS? Pembayaran dengan membuat Pengguna bergantung pada masuk pada aplikasi untuk melakukan . Pembayaran dengan mengharuskan Pengguna untuk memindai QR diberikan oleh untuk melakukan . *** ### Mengapa transaksi menggunakan E-Wallet dapat gagal? 1. Transaksi terkena waktu kedaluwarsa (*expired time). * 2. Jaringan pada sisi *Issuer *sedang tidak mendukung. 3. Ditolak oleh pihak *Issuer * terkait. 4. Sinyal *provider *terputus saat sedang melakukan . *** ### Bagaimana cara Merchant memeriksa transaksi yang sudah berhasil dibayarkan dengan E-Wallet? dapat melihat riwayat dalam jangka waktu tertentu melalui [Merchant Back Office](docId\:VMD8YtiiJqku6H8dRhcS6) pada: - Menu [Transaction Data](docId\:iZwosih8r9HIc0UurgYMa) untuk memeriksa seluruh data , atau - Menu [Fail Transaction](docId\:Kw36Cm_cK3RzRNUHfzavQ) untuk memeriksa data gagal. *** ### Apakah terdapat proses ***refund ***pada Merchant Back Office untuk pembayaran dengan E-Wallet***?*** [Merchant Back Office](docId\:VMD8YtiiJqku6H8dRhcS6) menyediakan *refund *untuk dengan . kunjungi [Transaction Data](docId\:iZwosih8r9HIc0UurgYMa) untuk lebih lanjut. *** ### Bagaimana cara melakukan proses ***refund ***pada E-Wallet? kunjungi [Penyelesaian Transaksi Pada E-Wallet](docId\:FNmIW9eShnWs16wuIZzlR) untuk lebih lanjut. *** ### Mengapa Pelanggan belum menerima ***refund***? Waktu *refund * mengikuti waktu sudah ditentukan oleh ([Penyelesaian Transaksi Pada E-Wallet](docId\:FNmIW9eShnWs16wuIZzlR)). Apabila masih belum menerima *refund *setelah melewati ketentuan waktu, silakan hubungi terkait. *** ### Mengapa proses ***refund*** dapat gagal? - Pengajuan *refund *ditolak oleh . - Pengajuan *refund *tidak sesuai dengan ketentuan . *** ### Apa yang dimaksud dengan Settlement? adalah pembukuan suatu & pemindahan dana dari lembaga finansial ( atau ) ke suatu individu atau perusahaan dalam kasus ini akan disebut sebagai . kunjungi [Proses Settlement](docId\:l04EuP_s604Oi2Ib3x_y6) untuk lebih lanjut. *** ### Berapa lama waktu yang dibutuhkan untuk melakukan proses Settlement E-Wallet? H+3 pada hari kerja. *** ### Bagaimana cara Merchant melakukan proses ***refund ***E-Wallet melalui Merchant Back Office? ** ** dapat membantu melakukan *refund *dengan mengikuti panduan pada [Transaction Data](docId\:iZwosih8r9HIc0UurgYMa). *** ### Apa perbedaan `callBackUrl` dan `dbProcessUrl`? - `callBackUrl`: berisi tautan untuk kembali ke , berhasil atau gagal. - `dbProcessUrl`: berisi *destination address* untuk melakukan *push notification* dari kepada . *** ### Apa yang harus dilakukan oleh Merchant ketika tidak menerima notifikasi dari NICEPAY? dapat menghubungi tim IT dan membagikan rincian untuk dibantu pengiriman ulang. *** ### Apakah bisa melakukan `hit` payment API dari Backend? Bisa, hanya untuk OVO dan ShopeePay jika *request* menggunakan `returnJson=1`. *** ### Apakah bisa menambahkan waktu ***expired*** pada E-Wallet? Tidak bisa, waktu *expired* berjalan sesuai ketentuan setelah *hit* . [title] Release Information - Panduan Bayar [path] Payment/ *** :::Changelog{title="20240327 - Update Payment Guide Content Pages and Sub-Pages"} ::ChangelogItem{type="improved" description="Update Payloan page and sub-pages"} ::ChangelogItem{type="improved" description="Update VA page and sub-pages"} ::: :::Changelog{title="20240325 - Update Payment Guide Content Pages and Sub-Pages"} ::ChangelogItem{type="improved" description="Update GPN Page"} ::ChangelogItem{type="improved" description="Update Credit Card Page"} ::ChangelogItem{type="improved" description="Update Direct Debit page and sub-pages"} ::: :::Changelog{title="20240322 - Update Payment Guide Content Pages and Sub-Pages"} ::ChangelogItem{type="improved" description="Update QRIS Page"} ::ChangelogItem{type="improved" description="Update E-Wallet page and sub-pages"} ::ChangelogItem{type="improved" description="Update CVS page and sub-pages"} ::: :::Changelog{title="20231226 - Update VA Payment Guide Content Pages"} ::ChangelogItem{type="improved" description="Update Bank Mandiri page"} ::ChangelogItem{type="improved" description="Update Bank BNI page"} ::ChangelogItem{type="improved" description="Update Bank Maybank page"} ::ChangelogItem{type="improved" description="Update Bank Neo Commerce page"} ::ChangelogItem{type="improved" description="Update Bank Danamon page"} ::ChangelogItem{type="improved" description="Update Bank BJB page"} ::: :::Changelog{title="20230620 - Restructure Payment Guide"} ::ChangelogItem{type="improved" description="Restructure Payment Guide into Payment Method Sub Menu in NICEPAY Docs"} ::: :::Changelog{title="20220920 - Add E-Wallet Customer Journey"} ::ChangelogItem{type="added" description="AstraPay Customer Journey"} ::: :::Changelog{title="20220607 - Add Virtual Account Customer Journey"} ::ChangelogItem{type="added" description="Bank DKI Customer Journey"} ::: :::Changelog{title="20220120 - Update Virtual Account Customer Journey"} ::ChangelogItem{type="improved" description="Remove Livin by Mandiri Customer Journey"} ::: :::Changelog{title="20211130 - Update Virtual Account Customer Journey"} ::ChangelogItem{type="improved" description="Update Bank Mandiri Customer Journey"} ::ChangelogItem{type="improved" description="Update Bank BJB Customer Journey"} ::: :::Changelog{title="20220906 - Add E-Wallet Customer Journey"} ::ChangelogItem{type="added" description="ShopeePay Customer Journey"} ::: :::Changelog{title="20210823 - Add Virtual Account Customer Journey"} ::ChangelogItem{type="added" description="Bank BJB Customer Journey"} ::: :::Changelog{title="20210610 - Major Update"} ::ChangelogItem{type="improved" description="Update Bank Maybank Customer Journey"} ::ChangelogItem{type="added" description="E-Wallet > DANA Customer Journey"} ::: :::Changelog{title="20200313 - Major Update"} ::ChangelogItem{type="improved" description="UI Changes"} ::ChangelogItem{type="added" description="E-Wallet"} ::ChangelogItem{type="added" description="Pay Loan"} ::: :::Changelog{title="20181111 - Update Virtual Account Customer Journey"} ::ChangelogItem{type="improved" description="Update Bank BNI Customer Journey"} ::ChangelogItem{type="improved" description="Update Bank Danamon Customer Journey"} ::: :::Changelog{title="20180912 - Update Virtual Account Customer Journey"} ::ChangelogItem{type="added" description="PRIMA Customer Journey"} ::ChangelogItem{type="added" description="ALTO Customer Journey"} ::ChangelogItem{type="improved" description="Update ATM Bersama Customer Journey"} ::: :::Changelog{title="20180831 - Update Virtual Account Customer Journey"} ::ChangelogItem{type="added" description="Update CIMB Mobile Banking"} ::: :::Changelog{title="20180801 - Add Convenience Store Customer Journey"} ::ChangelogItem{type="added" description="Indomaret Customer Journey"} ::ChangelogItem{type="added" description="Alfa Group Customer Journey"} ::: :::Changelog{title="20170413 - Add Virtual Account Customer Journey"} ::ChangelogItem{type="added" description="Bank Danamon Customer Journey"} ::: :::Changelog{title="20170308 - Add Virtual Account Customer Journey"} ::ChangelogItem{type="added" description="Bank CIMB Niaga Customer Journey"} ::: :::Changelog{title="20161116 - Add Virtual Account Customer Journey"} ::ChangelogItem{type="added" description="Bank BRI Customer Journey"} ::: :::Changelog{title="20161103 - Add Virtual Account Customer Journey"} ::ChangelogItem{type="added" description="Bank BNI Customer Journey"} ::: :::Changelog{title="20160712 - Add Virtual Account Customer Journey"} ::ChangelogItem{type="added" description="Bank BNI SMS Banking"} ::ChangelogItem{type="added" description="Bank BNI Mobile Banking"} ::: [title] Aturan dan Limitasi QRIS [path] Payment/QRIS/ # Overview *** | **Jenis Aturan & Limitasi** | **QRIS** | | --------------------------- | ------------ | | Minimal Nominal Transaksi | Rp1 | | Maksimal Nominal Transaksi | Rp10.000.000 | # See also ::::VerticalSplit :::VerticalSplitItem [Model Bisnis dan Biaya QRIS](docId\:ZfWegzxJCohgPfZ2jJfJX) untuk mengetahui bagaimana selesai. ::: :::VerticalSplitItem [Penyelesaian Transaksi Pada QRIS](docId\:CyS-JVEzpPGTtYy62XdcB) untuk mengetahui macam-macam cara menyelesaikan . ::: :::: ::::VerticalSplit :::VerticalSplitItem [Daftar Istilah QRIS](docId:6BFA6ymPlc8HEHi6jXRO2) untuk mengetahui istilah khusus digunakan oleh . ::: :::VerticalSplitItem [FAQ QRIS](docId\:AHrsQb4knslavXU-aBiF4) jika ingin mengetahui pertanyaan sering diajukan terkait . ::: :::: [title] Daftar Istilah CVS [path] Payment/Convenience Store (CVS)/ # CVS Singkatan dari . # See also ::::VerticalSplit :::VerticalSplitItem [Alur Pembayaran CVS](docId\:Qb3J_IzkOf9DEI_8Zk32W) untuk mengetahui pada saat melakukan dengan . ::: :::VerticalSplitItem [Fitur CVS](docId\:iWIQWotO0vYXaBnkseJEA) untuk mengetahui fitur pada . ::: :::: ::::VerticalSplit :::VerticalSplitItem [Integrasi & Testing CVS](docId:6zSlSRyypvTgFXAKRIXHI) untuk mengetahui cara dan uji coba . ::: :::VerticalSplitItem [FAQ CVS](docId\:Bf4kvuVF_blHBxysENnWn) jika ingin mengetahui pertanyaan sering diajukan terkait . ::: :::: [title] Aturan dan Limitasi CVS [path] Payment/Convenience Store (CVS)/ :::hint{type="warning"} **Khusus Alfa Group**: apabila ingin melakukan lebih dari lima (5) kali, dapat melakukan pada toko gerai berbeda. ::: # Overview | **Jenis Aturan & Limitasi** | **Alfa Group **
(Alfamart, Alfamidi, Dan+Dan & Lawson) | **Indomaret** | | --------------------------- | ---------------------------------------------------------------- | ---------------- | | Minimal Nominal Transaksi | Rp10.000
| Rp10.000
| | Maksimal Nominal Transaksi | Rp2.500.000 (*Cash*)
Rp5.000.000 (/Debit) | Rp1.000.000 | | Maksimal Transaksi | 5 kali /toko/hari | Tidak ada batas | # See also ::::VerticalSplit :::VerticalSplitItem [Penyelesaian Transaksi Pada CVS](docId:0G-4HHJC4Mm1VaitMybnh) untuk mengetahui macam-macam cara menyelesaikan . ::: :::VerticalSplitItem [Daftar Istilah CVS](docId:-M-nZrtY-prU0aJjTYj9g) untuk mengetahui istilah khusus digunakan oleh . ::: :::: [title] Direct Debit [path] Payment/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/MvkkksM9EckEbfzZuMpI8_jeniuspay-02.png "Bank Direct Debit") **Direct Debit** merupakan memungkinkan untuk membayar tagihan dengan cara menghubungkan akun miliknya di dalam *website* atau aplikasi dari tanpa perlu mengisi data lengkap atau validasi memakan waktu lama terlebih dahulu seperti pada umumnya. Saat ini, sudah bekerja sama dengan populer di , yaitu Jenius Pay. # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [API E-Wallet (Direct Debit) SNAP](docId:24TJozvWeUtfoWWb2WN94) untuk mengetahui rincian digunakan pada . ::: :::VerticalSplitItem ::: :::: [title] Panduan Bayar CVS [path] Payment/Convenience Store (CVS)/ ::::LinkArray :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/iF18-2CrslhJMX9cTuntq_1.png"} [Alfa Group](docId\:Ywl1xxs9ZWFRsHaojRQRz) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/Izsa11sc7S1kIUXt8dfx5_indomaret.png"} [Indomaret](docId\:ucm8J3a8Mr0rYIKDaP0JW) ::: :::: # See also ::::VerticalSplit :::VerticalSplitItem [Panduan Bayar E-Wallet](docId:-v30F8TW2bUenjkPfjaX5) untuk mengetahui cara membayar menggunakan ::: :::VerticalSplitItem [Panduan Bayar Payloan](docId\:KMa4n6iBgx27LMi_OafvW) untuk mengetahui cara membayar menggunakan . ::: :::: ::::VerticalSplit :::VerticalSplitItem [Panduan Bayar QRIS](docId\:og8vGEkiCoG9mupWHrrJ0) untuk mengetahui cara membayar menggunakan . ::: :::VerticalSplitItem Daftar pembaharuan *log* panduan bayar dapat dilihat pada [Release Information - Panduan Bayar](docId\:oBJOho15Y6-A0JVj4JODP). ::: :::: [title] Penyelesaian Transaksi Pada E-Wallet [path] Payment/E-Wallet/ # Settlement *** Proses menyelesaikan antara dan dilakukan setelah melakukan pesanan kepada dengan menggunakan . Proses ini bertujuan memberikan kepada terkait pendapatan diterima dengan pembukuan apakah nominal diterima sesuai pada nominal tercatat pada . Terkadang, mengalami *void *atau *refund * membuat tidak berhasil. # Void *** Pembatalan dapat diajukan jika tersebut sudah melakukan penuh (*full amount*) sudah berhasil dan belum melalui . Berikut adalah waktu *void* dari pihak bekerja sama dengan . | **Nama Layanan** | **Waktu void** | **Keterangan** | | ---------------- | ----------------------- | -------------- | | OVO | Di hari yang sama | | | DANA | Sebelum 24 Jam | | | ShopeePay | Di hari yang sama | | | LinkAja | Sebelum 30 Hari | | | AstraPay | Tidak dapat di-*refund* | | # Refund *** *Refund *adalah pengembalian dana terjadi atas persetujuan dan tanpa adanya sanggahan di antara kedua belah pihak. Setelah mengajukan *refund *kepada , akan melaporkan *refund *kepada . Lalu, akan mengirimkan dana akan melalui *refund *kepada agar dapat melakukan *refund *secara manual kepada . ## Full Refund Pengembalian seluruh dana memungkinkan untuk mengajukan pengembalian dana untuk seluruh belanjaan dari daftar belanja pada dan mengakomodasi untuk dapat melakukan pengembalian dana pada sesuai dengan nominal diajukan. Berikut adalah waktu *full refund * sudah ditentukan dari pihak bekerja sama dengan . | **Nama Layanan** | **Waktu Refund** | **Keterangan** | | ---------------- | -------------------------------------- | -------------- | | OVO | *Different Day* = *Block* | | | DANA | Lebih 24 jam > *Manual Refund* | | | ShopeePay | *Different Day* \< 365 hari = *Refund* | | | LinkAja | Lebih 30 hari > *Manual Refund* | | | AstraPay | Tidak dapat di-*refund* | | ## Partial Refund Pengembalian sebagian dana memungkinkan untuk mengajukan pengembalian dana untuk barang tertentu dari daftar belanja pada dan mengakomodasi untuk dapat melakukan pengembalian dana pada sesuai dengan nominal diajukan. ## Proses Refund :::hint{type="warning"} Proses *refund* tidak termasuk *refund* untuk OVO. ::: ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/fSt6KoWqS69ln0FvbyzTt_nicepay-archbee-payment-proses-refund.png "Proses Refund ") 1. mengajukan permohonan pengembalian dana kepada . 2. mengajukan permohonan pengembalian dana kepada . 3. mengajukan permohonan pengembalian dana kepada pihak *Acquiring.* 4. Pihak *Acquiring *mengajukan permohonan pengembalian dana kepada *Issuing.* 5. Pihak *Issuing *mengembalikan dana kepada . 6. Pihak *Issuing *melakukan perubahan biaya perlu dibayarkan pada . # See also ::::VerticalSplit :::VerticalSplitItem [Model Bisnis dan Biaya E-Wallet](docId:-Lie76mLgpVV1KmPjodOL) untuk mengetahui bagaimana selesai. ::: :::VerticalSplitItem [Aturan dan Limitasi E-Wallet](docId\:cZza2J4bAdgxIZCyL1ag3) untuk mengetahui ketentuan khusus . ::: :::: ::::VerticalSplit :::VerticalSplitItem [Daftar Istilah E-Wallet](docId\:RtyOOpERogK7_PImzLfth) untuk mengetahui istilah khusus digunakan oleh . ::: :::VerticalSplitItem [FAQ E-Wallet](docId\:QyuY2tdI299dVSNUt9G-1) jika ingin mengetahui pertanyaan sering diajukan terkait . ::: :::: [title] Penyelesaian Transaksi Pada QRIS [path] Payment/QRIS/ # Settlement *** Proses menyelesaikan antara dan dilakukan setelah melakukan pesanan kepada dengan menggunakan . Proses ini bertujuan memberikan kepada terkait pendapatan diterima dengan pembukuan apakah nominal diterima sesuai pada nominal tercatat pada . # Pembatalan Transaksi *** ## Proses Alur Pembatalan Transaksi ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/fSt6KoWqS69ln0FvbyzTt_nicepay-archbee-payment-proses-refund.png "Proses Refund") 1. mengajukan permohonan pengembalian dana kepada . 2. mengajukan permohonan pengembalian dana kepada . 3. mengajukan permohonan pengembalian dana kepada pihak *Acquiring.* 4. Pihak *Acquiring *mengajukan permohonan pengembalian dana kepada *Issuing.* 5. Pihak *Issuing *mengembalikan dana kepada . 6. Pihak *Issuing *melakukan perubahan biaya perlu dibayarkan pada . ## Refund *** *Refund *adalah pengembalian dana terjadi atas persetujuan dan tanpa adanya sanggahan di antara kedua belah pihak. Setelah mengajukan *refund *kepada , akan melaporkan *refund* kepada . Lalu, akan mengirimkan pengajuan refund melalui instansi proses pembayaran QRIS seperti bank ataupun non-bank, sehingga pengembalian dana akan sampai kepada . ### Full Refund Dalam metode pembayaran QRIS, refund hanya bisa dilakukan secara penuh atau disebut juga dengan istilah Full Refund. Merchant mengajukan pengembalian dana untuk belanjaan yang sudah dibayarkan kepada dan akan di kembalikan dananya sesuai dengan nominal diajukan secara penuh. :::Iframe{iframeHeight="0" code="Silakan hubungi tim NICEPAY Customer Service apabila mengalami kendala dalam proses refund pada metode QRIS"} ::: # See also ::::VerticalSplit :::VerticalSplitItem [Model Bisnis dan Biaya QRIS](docId\:ZfWegzxJCohgPfZ2jJfJX) untuk mengetahui bagaimana selesai. ::: :::VerticalSplitItem [Aturan dan Limitasi QRIS](docId\:hKHhPw79NNP7hBJM8R9-v) untuk mengetahui ketentuan khusus . ::: :::: ::::VerticalSplit :::VerticalSplitItem [Daftar Istilah QRIS](docId:6BFA6ymPlc8HEHi6jXRO2) untuk mengetahui istilah khusus digunakan oleh . ::: :::VerticalSplitItem [FAQ QRIS](docId\:AHrsQb4knslavXU-aBiF4) jika ingin mengetahui pertanyaan sering diajukan terkait . ::: :::: [title] Jenius Pay [path] Payment/Direct Debit/Panduan Bayar Direct Debit (cloned with children)/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/Kxp98gvvNnUVvmV2QLmYd_jeniuspay-02.png "Jenius Pay") # Pembayaran *** :::hint{type="info"} Pastikan melakukan sebelum masa berlaku tagihan habis dan bayar dengan nominal tepat. ::: Cara Pembayaran: 1. melalui Jenius Pay. 2. `Cashtag` atau `Nama Akun Unik Jenius Pay` , lalu klik `Konfirmasi`. 3. Notifikasi dari Jenius Pay pun akan muncul di layar hp , silakan buka tagihannya pada aplikasi Jenius Pay . 4. akses aplikasi Jenius Pay menggunakan kredensial punya. 5. Ketika masuk, carilah tagihan ingin bayarkan di . 6. Detail tagihan pun akan muncul, pastikan tagihan bayarkan sudah sesuai. 7. klik `Bayar`. 8. Selesai. file format JSON Panduan Bayar Jenius Pay untuk operasi . ::File{src="https://archbee-doc-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/35ZUbqfNks1EXqWYuFNIt_direct-debitindjenius.json" label="DIRECT DEBIT_IND_JENIUS.json"} [title] Indodana [path] Payment/Payloan/Panduan Bayar Payloan/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/LV3uBwX1eKfoqw4X4ob8Y_indodana.png "Indodana") # Informasi Nomor Pembayaran *** :::hint{type="info"} Pastikan melakukan sebelum masa berlaku habis. ::: | **Mitra Paylater** | Indodana | | ------------------- | ------------------------------- | | **Nominal** | Rp100.000 | | **Nama Penerima** | `billingNm` | | **Nomor Pemesanan** | OrdNo-20230106150184 | | **Masa Berlaku** | 06-01-2023 / 15:14:21 | # Pembayaran *** Langkah dengan menggunakan Indodana: 1. Pengguna memilih dengan Indodana. 2. Pengguna akan diarahkan ke Indodana. 3. nomor *handphone*. 4. PIN. 5. `Bayar` pada rincian . 6. `Saya Setuju` pada *pop-up* `Perjanjian Peminjaman Indodana Paylater`. 7. PIN. 8. Muncul berhasil. 9. `Kembali` ke untuk dialihkan kembali ke atau . file format JSON Panduan Bayar Indodana untuk operasi . ::File{src="https://archbee-doc-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/TC5idIiFBdOIi0CGtQoKL_payloanindindodana.json" label="PAYLOAN_IND_INDODANA.json"} ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/snvbNX6NPzcha4PsmGC5h_indodana.png "Pembayaran dengan Indodana 1") ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/P2aOxIcHBldrl0qy9hnYt_19.png "Pembayaran dengan Indodana 2") [title] OVO [path] Payment/E-Wallet/Panduan Bayar E-Wallet/ ::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/Srkk2AfRVdpv_e627rah4_masterrgb-01.png" size="50" width="4500" height="1783" caption="OVO" position="center" showCaption="true"} # Informasi Nomor Pembayaran *** :::hint{type="info"} Pastikan melakukan sebelum 58 detik. ::: | **Nomor Seluler** | `082-1851-XXX-XX` | | ------------------- | ------------------------------------- | | **Mitra E-Wallet** | OVO | | **Nominal** | Rp10.000 | | **Nama Penerima** | `billingNm` | | **Nomor Pemesanan** | Invoice-1234 | | **Masa Berlaku** | 16-06-2016 / 17:15:00
| # Pembayaran *** Langkah dengan OVO: 1. melalui `OVO`. 2. nomor `OVO` Anda, lalu pilih . periksa dari aplikasi OVO pada *Handphone* . 3. tekan tersebut dan pun akan masuk ke konfirmasi . 4. Jika tidak mendapatkan , silakan periksa *icon* lonceng pada sisi kanan atas. 5. Pada konfirmasi , silakan tekan `Bayar`. 6. Setelah berhasil, akan dialihkan ke `Payment Result page`. file format JSON Panduan Bayar OVO untuk operasi . ::File{src="https://archbee-doc-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/Ju9qIVngr0zK3kXiftJjI_ewalletindovo.json" label="EWALLET_IND_OVO.json"} ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/15FjePtUirpmceZ6IEkkq_ovo.png "Panduan Bayar - OVO 1") ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/WmCtRlCa25s7bSgFQiM5E_10.png "Panduan Bayar - OVO 2") [title] ATM Bersama [path] Payment/Virtual Account (VA)/Panduan Bayar VA/ ::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/M4Sq5RUDRdSzhWZLQB3Qx_atm-bersama.jpg" size="50" width="500" height="500" caption="ATM Bersama" position="center" darkWidth="500" darkHeight="500" showCaption="true"} :::hint{type="info"} Pastikan melakukan transfer dana sebelum masa berlaku habis dan dengan nominal tepat. ::: | **Nomor Virtual Account** | `484XXXXXXXXXXXXX` | | ------------------------- | --------------------------- | | **Bank** | Keb Hana | | **Nominal** | Rp10.000 | | **Nama Penerima** | `Merchant Name - billingNm` | | **Nomor Order** | Invoice-1234 | | **Masa Berlaku** | 16-06-2016 / 17:15:00 | file format JSON Panduan Bayar ATM Bersama untuk operasi . ::File{src="https://archbee-doc-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/dGlHCKPBWkDebTk6jaHJ1_va-ind-atm-bersama.json" label="VA_IND_ATM_BERSAMA.json"} # ATM *** 1. nomor kartu `ATM`dan `PIN` Anda. 2. `Transfer`, kemudian pilih `Bank Lainnya`. 3. kode `Keb Hana Bank`: `484`. 4. `Virtual Account Number` diberikan, misal `484XXXXXXXXXXXXX`. 5. `Nominal` hendak dibayarkan, misal `10.000`. 6. Ikuti instruksi selanjutnya untuk menyelesaikan . # Mobile/Internet Banking *** 1. Masuk ke akun `Mobile/Internet Banking` Anda. 2. `Transfer` kemudian pilih `Keb Hana Bank` atau masukkan kode `Keb Hana Bank`: `484`. 3. `Virtual Account Number` diberikan, misal `484XXXXXXXXXXXXX`. 4. `Nominal` hendak dibayarkan, misal `10.000`. 5. Ikuti instruksi selanjutnya untuk menyelesaikan . [title] Integrasi & Testing Paylater [path] Payment/Payloan/ digunakan dalam dan didukung oleh Akulaku, Kredivo, dan Indodana sebagai . # Langkah Integrasi & API yang digunakan *** 1. Lakukan Order Registration. - Direct : [Registration - API Paylater](docId\:J65eZ7xTGGxvLYhQANT6D). - Redirect : [Paylater - API Checkout](docId\:nyRwPaWY8_BXWZ3HaWy49). 2. Lakukan Charge. - Direct : [Payment - API Paylater](docId:1jAr45oEk0lYZuXjyZb5c). - Redirect : [Payment - API Checkout](docId\:YnNFZr9aonpJ7ZIKAFYSx). 3. Menerima *callback *dan *push notification *dari . 4. Lakukan Check Status. - Direct : [Status Inquiry - API Paylater](docId\:r6YyG1qEKKLzWnVhazxCV). - Redirect : [Status Inquiry - API Checkout](docId\:K9vBS87ev9_w5oJAU0et3). 5. Opsional: lakukan Cancel untuk membatalkan . - Direct : [Cancel - API Paylater](docId\:GxDH-yDgXbTZTVLdJykDL). - Redirect : [Cancel - API Checkout](docId\:MMmlusWDkyUsJxF421yKn). # Kredensial Untuk Tes Paylater *** | **Nama Paylater** | **Deskripsi** | | ----------------- | ---------------------------------------------------------------------- | | Indodana | Nomor telepon: 62838499610
OTP: 999999
PIN: 123654 | # Cara Uji Coba Paylater *** | **Nama ** | **Langkah Tes** | **Aturan dan Kondisi** | | -------------- | --------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Akulaku | 1. Menggunakan dan masuk dengan akun asli. 2. Konfirmasi inquiry . 3. PIN . 4. OTP. 5. Transaksi berhasil. | Melakukan dengan *amount *kecil.
* Setelah menerima sukses, perlu lakukan Check Status terlebih dahulu, lalu langkah selanjutnya *hit* *Confirm Receipt* untuk dana ke sisi . | | Kredivo | 1. Menggunakan dan masuk dengan akun Kredivo. 2. Konfirmasi . 3. OTP. 4. Transaksi berhasil. | - Integrasi Kredivo diwajibkan pada setiap untuk melakukan pada *dev environment* dan melalui *review *pihak Kredivo terlebih dahulu. - Melakukan dengan *amount *kecil. - Setelah melakukan uji coba pada *environment dev*, dilanjutkan ke *prod environment*. Setelah berhasil, mohon segera dibatalkan. | | Indodana | 1. Menggunakan dan masuk dengan akun Indodana. 2. Konfirmasi rincian . 3. Lakukan . 4. PIN . 5. Transaksi berhasil. | - Integrasi Indodana diwajibkan pada setiap untuk melakukan pada *dev environment* dan melalui *review *pihak Indodana terlebih dahulu. - Melakukan dengan *amount *kecil. | # Alasan Peluang Transaksi Gagal *** - Tidak didukung oleh jaringan *Issuer.* - Transaksi ditolak dari . # Integration Checklist & Test Case *** - [ ] Implementasi inquiry setelah mendapatkan *callback.* - [ ] Implementasi inquiry setelah mendapatkan di dalam `dbProcessUrl`. - [ ] Meninjau *log *. - [ ] Meninjau pengaturan firewall (eg. cloudflare untuk pengaturan `dbprocessUrl`). - [ ] Memeriksa implementasi `merchantToken`. - [ ] Menjalankan tes skenario pada *Development Environment.* - [ ] Menjalankan tes skenario pada *Production Environment.* [Get Sample Scenario](https://docs.google.com/spreadsheets/d/e/2PACX-1vQIaIMCM0vZ3L1cA-JkW3YxyIpjsB966fg1wTeT8qpFDowEvulIEWOoY6I4uJPL3A/pub?output=xlsx) - [ ] Meninjau *Error Handling* (*Timeout, Failed, Negative Case*). # Cart Data *** | **Parameter** | **Deskripsi** | | ------------------------------ | ----------------------------------- | | `count` | Total jumlah keseluruhan cart data | | `item` | Parameter berisi rincian cart data | | `item` -> `goods_id` | ID Barang | | `item` -> `goods_detail` | Deskripsi Barang | | `item` -> `goods_name` | Nama Barang | | `item` -> `goods_amt` | Harga Barang | | `item` -> `goods_type` | Tipe Barang | | `item` -> `goods_url` | URL ke Halaman Barang | | `item` -> `goods_quantity` | Jumlah Barang | | `item` -> `goods_sellers_id` | ID Penjual | | `item` -> `goods_sellers_name` | Nama Penjual | # Best Practice *** - `cartData` tidak boleh kosong. - Menggunakan MID dev khusus . - Pastikan  `count` sesuai dengan jumlah jenis barang. Pastikan `goods_sellers_id` dan `goods_sellers_name` diisi sesuai dengan `sellers` di Registrasi. - Ketika diterima pada `dbProcessUrl` , sangat merekomendasikan untuk melakukan verifikasi menggunakan Inquiry . # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Alur Pembayaran Paylater](docId\:P9_ssNsvaBrA46UVq9bO_) untuk mengetahui pada saat melakukan dengan . ::: :::VerticalSplitItem [Fitur Paylater](docId\:B78u4Xq_3rXzfw_QPS4No) untuk mengetahui fitur pada . ::: :::: ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Daftar Istilah Paylater](docId\:Gu0PXWuHJFG-EwxUsoRfQ) untuk mengetahui istilah khusus digunakan oleh . ::: :::VerticalSplitItem [FAQ Paylater](docId\:y88CwYlN6KTcATxOHbJYP) jika ingin mengetahui pertanyaan sering diajukan terkait . ::: :::: [title] SPayLater [path] Payment/Payloan/Panduan Bayar Payloan/ ![](https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-ox8uhzkO7AuytjK0U4Shy-20250903-041516.png "SPayLater") # Informasi Nomor Pembayaran *** Pastikan Anda melakukan pembayaran sebelum masa berlaku habis. | **Mitra Paylater** | SPayLater | | ------------------- | --------------------- | | **Nominal** | Rp10.000 | | **Nama Penerima** | billingNm | | **Nomor Pemesanan** | Invoice-1234 | | **Masa Berlaku** | 16-06-2016 / 17:15:00 |  # Pembayaran *** Langkah pembayaran dengan menggunakan halaman pembayaran SPayLater: 1. Pada aplikasi Shopee, pilih barang yang ingin dibeli untuk membuat pesanan. 2. Pilih metode pembayaran dengan SPayLater. 3. Terdapat beberapa pilihan cicilan dengan SPayLater, pilih cicilan sesuai limit kredit dan kebutuhan Anda. 4. Klik 'Bayar Sekarang'. 5. Masukkan PIN ShopeePay Anda untuk mengonfirmasi pembayaran. 6. Pembayaran sudah Berhasil! Anda akan dipindahkan ke *result* *page*. [title] Prima [path] Payment/Virtual Account (VA)/Panduan Bayar VA/ ::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/EuLNHCS7M8XbfnP0NvmcR_prima.jpg" size="50" width="500" height="500" caption="Prima" position="center" darkWidth="500" darkHeight="500" showCaption="true"} :::hint{type="info"} Pastikan melakukan transfer dana sebelum masa berlaku habis dan dengan nominal tepat. ::: | **Nomor Virtual Account** | `484XXXXXXXXXXXXX` | | ------------------------- | --------------------------- | | **Bank** | CIMB | | **Nominal** | Rp10.000 | | **Nama Penerima** | `Merchant Name - billingNm` | | **Nomor Order** | Invoice-1234 | | **Masa Berlaku** | 16-06-2016 / 17:15:00 | file format JSON Panduan Bayar Prima untuk operasi . ::File{src="https://archbee-doc-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/1ImFAMqkNFZFctSEc5lch_va-ind-prima.json" label="VA_IND_PRIMA.json"} # ATM *** 1. kartu `ATM` dan `PIN` . 2. `Transfer`. 3. `Bank Lainnya`. 4. kode CIMB Niaga: `022`. 5. `Nomor Virtual Account`, misal `484XXXXXXXXXXXXX` sebagai kode bayar. 6. `Nominal`, misal `10.000`. 7. Ikuti instruksi selanjutnya untuk menyelesaikan . # Mobile/Internet Banking *** 1. Akses `Mobile/Internet Banking`. 2. `Transfer`. 3. `CIMB Niaga` atau masukkan kode CIMB Niaga: `022`. 4. `Nomor Virtual Account`, misal `484XXXXXXXXXXXXX` sebagai kode bayar. 5. `Nominal`, misal `10.000`. 6. Ikuti instruksi selanjutnya untuk menyelesaikan . [title] Integrasi & Testing Direct Debit [path] Payment/Direct Debit/ # Langkah Integrasi & API yang digunakan *** 1. Lakukan Order Registration. - SNAP: [Registration - API E-Wallet (Direct Debit) SNAP](docId:66iE5aVXXL4uqw6hqFPVV) - Redirect: [Direct Debit - API Checkout](docId\:xPtq3qNKi2AwqtTrDkXhX). 2. Lakukan Charge. - Redirect: [Payment - API Checkout](docId\:YnNFZr9aonpJ7ZIKAFYSx). 3. Menerima *callback *dan *push notification *dari . 4. Lakukan Check Status. - SNAP: [Check Status Transaction - API E-Wallet (Direct Debit) SNAP](docId\:vB63D8suaKPYP-4bIOWx9). - Redirect: [Status Inquiry - API Checkout](docId\:K9vBS87ev9_w5oJAU0et3). 5. Opsional: lakukan Cancel untuk membatalkan . - Redirect: [Cancel - API Checkout](docId\:MMmlusWDkyUsJxF421yKn). # Cara Uji Coba Direct Debit *** 1. Menggunakan MID milik atau Sandbox (`TNICECP041`). 2. Membuat pendaftaran Jenius Pay. 3. Melakukan *hit *menggunakan . 4. Memasukkan Cashtag ID dan `TXID` Jenius Pay. 5. Melakukan konfirmasi . # Alasan Peluang Transaksi Gagal *** 1. Mengalami c*onnection time out.* 2. Terdapat gangguan dasar pada . 3. Salah memasukkan Cashtag*.* # Integration Checklist & Test Case *** - [ ] Implementasi inquiry setelah mendapatkan *callback.* - [ ] Implementasi inquiry setelah mendapatkan di dalam `dbProcessUrl.` - [ ] Meninjau *log *. - [ ] Meninjau pengaturan *firewall* (eg. *cloudflare* untuk pengaturan `dbprocessUrl`). - [ ] Memeriksa implementasi `merchantToken`. - [ ] Menjalankan tes skenario pada *Development* *Environment.* - [ ] Menjalankan tes skenario pada *Production Environment. *[Get Sample Scenario](https://docs.google.com/spreadsheets/d/e/2PACX-1vQIaIMCM0vZ3L1cA-JkW3YxyIpjsB966fg1wTeT8qpFDowEvulIEWOoY6I4uJPL3A/pub?output=xlsx) - [ ] Meninjau *Error Handling* (*Timeout, Failed, Negative Case*). # Best Practice *** - Ketika diterima pada `dbProcessUrl` , sangat merekomendasikan untuk melakukan verifikasi menggunakan Inquiry &#xNAN;*.* - `Notification Handling` berguna untuk meminimalisir aksi *Fraud*, sangat merekomendasikan untuk melakukan verifikasi `Notification Handling`. # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Alur Pembayaran Direct Debit](docId\:e5Hsqs6VJRuvWqsAXCjIE) untuk mengetahui pada saat melakukan dengan . ::: :::VerticalSplitItem [Fitur Direct Debit](docId\:opy1X7V3Y2t4T1yGnSglF) untuk mengetahui fitur pada . ::: :::: [title] Indomaret [path] Payment/Convenience Store (CVS)/Panduan Bayar CVS (cloned with children)/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/n2rg6Kn2dqn9PCG5pg42v_indomaret-group.png "Indomaret") # Informasi Nomor Pembayaran *** :::hint{type="info"} Pastikan melakukan sebelum masa berlaku habis dan bayar dengan nominal tepat. ::: | **Nomor Pembayaran** | `123456789012XXXX` | | --------------------- | -------------------------- | | **Convenience Store** | INDOMARET | | **Nominal** | Rp10.000 | | **Nama Penerima** | `billingNm` | | **Nomor Pemesanan** | Invoice-1234 | | **Masa Berlaku** | 20-09-2027 / 17:15:00 | # Pembayaran *** ## Indomaret Cara : 1. Pilih melalui `Indomaret`. 2. Catat atau *print* `Kode Pembayaran`. 3. Bawa `Kode Pembayaran` tersebut ke gerai `Indomaret`. 4. Informasikan `Nama Merchant` ke kasir. 5. Berikan `Kode Pembayaran` ke kasir. 6. Kasir akan memasukkan `Kode Pembayaran`. 7. Bayar sesuai `Nominal`. 8. Ambil `Tanda Terima Pembayaran`. 9. Selesai. file format JSON Panduan Bayar Akulaku untuk operasi . ::File{src="https://archbee-doc-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/XYIVWP6Lh1w6vB9yuGokQ_cvsindindomaret.json" label="CVS_IND_INDOMARET.json"} [title] Fitur Paylater [path] Payment/Payloan/ # Transaksi Online *** Sistem mendukung pada hanya secara daring. menerima secara daring untuk e-Commerce atau platform daring lainnya. dapat membayar pesanan dan memilih jenis angsuran untuk melunasi pinjaman dari . Transaksi berhasil setelah mengonfirmasi pinjaman diajukan . # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Alur Pembayaran Paylater](docId\:P9_ssNsvaBrA46UVq9bO_) untuk mengetahui pada saat melakukan dengan . ::: :::VerticalSplitItem [Integrasi & Testing Paylater](docId\:ZEuw_0d227R_LUPBI3ptN) untuk mengetahui cara dan uji coba pada . ::: :::: ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Daftar Istilah Paylater](docId\:Gu0PXWuHJFG-EwxUsoRfQ) untuk mengetahui istilah khusus digunakan oleh . ::: :::VerticalSplitItem [FAQ Paylater](docId\:y88CwYlN6KTcATxOHbJYP) jika ingin mengetahui pertanyaan sering diajukan terkait . ::: :::: [title] FAQ Paylater [path] Payment/Payloan/ ### Bagaimana jika ingin bertransaksi dengan Paylater tetapi tidak memiliki akun pada Mitra Paylater yang bekerja sama dengan NICEPAY? harus membuat akun terlebih dahulu pada aplikasi milik akan digunakan. Karena setelah melakukan *checkout*, akan diarahkan menuju aplikasi untuk menyelesaikan . *** ### Bagaimana jika tidak memiliki limit yang cukup untuk melakukan transaksi dengan Mitra Paylater? - Jika memiliki tagihan, maka harus melunasi tagihan sebelumnya pada terlebih dahulu agar dapat kembali bertransaksi dengan limit cukup. - Jika tidak memiliki tagihan, maka harus mengajukan limit tambahan kepada terkait sebelum melakukan . *** ### Mengapa transaksi menggunakan Paylater dapat gagal? 1. Limit tidak mencukupi untuk menyelesaikan . 2. Sinyal *provider *terputus saat sedang melakukan . 3. Tidak didukung oleh jaringan *Issuer * 4. Transaksi ditolak dari . *** ### Bagaimana cara Merchant mengecek transaksi yang sudah berhasil dibayarkan dengan Paylater? dapat melihat riwayat dalam jangka waktu tertentu melalui [Merchant Back Office](docId\:VMD8YtiiJqku6H8dRhcS6) pada: - Menu [Transaction Data](docId\:iZwosih8r9HIc0UurgYMa) untuk memeriksa seluruh data , atau - Menu [Fail Transaction](docId\:Kw36Cm_cK3RzRNUHfzavQ) untuk memeriksa data gagal. *** ### Apakah pembayaran dengan Paylater terdapat proses ***refund ***pada Merchant Back Office***?*** [Merchant Back Office](docId\:VMD8YtiiJqku6H8dRhcS6) tidak menyediakan *refund *untuk dengan . dapat melakukan *refund *dengan menghubungi atau terkait untuk melakukan *refund.* *** ### Mengapa Pelanggan belum menerima ***refund***? Waktu *refund* mengikuti waktu sudah ditentukan oleh ([Penyelesaian Transaksi Pada Paylater](docId\:cQdqwni_Sfh7x9mSTCpt4)). Apabila masih belum menerima *refund *setelah melewati ketentuan waktu, silakan hubungi terkait. *** ### Mengapa proses ***refund*** dapat gagal? - Pengajuan *refund *ditolak oleh . - Pengajuan *refund *tidak sesuai dengan ketentuan . *** ### Apa yang dimaksud dengan Settlement? adalah pembukuan suatu & pemindahan dana dari lembaga finansial ( atau ) ke suatu individu atau perusahaan dalam kasus ini akan di sebut sebagai . kunjungi [Proses Settlement](docId\:l04EuP_s604Oi2Ib3x_y6) untuk lebih lanjut. *** ### Berapa lama waktu yang dibutuhkan untuk melakukan proses Settlement Paylater? kunjungi [Proses Settlement](docId\:l04EuP_s604Oi2Ib3x_y6) untuk lebih lanjut. *** ### Bagaimana cara melakukan ***cancel ***untuk metode pembayaran Paylater? - Untuk Akulaku dapat menggunakan Cancel . - Untuk Kredivo dan Indodana dapat melakukan *cancel *via *dashboard* . *** ### Apakah transaksi Paylater bisa dibuat ***expired***? Bisa, menggunakan `payValidDt` dan `payValidTm`. [title] Aturan dan Limitasi E-Wallet [path] Payment/E-Wallet/ # Overview *** | **Jenis Aturan & Limitasi** | **ShopeePay** | **OVO** | **DANA** | **LinkAja** | **AstraPay** | | ---------------------------------------------------------- | ------------------------------------------------------------------------------------ | --------------------------------------------------- | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------ | | Tampilan Pembayaran | Redirect URL | *Push Notification* | Redirect URL | Redirect URL | Redirect URL | | Waktu Kedaluwarsa Pembayaran (*Default*) | 5 Menit | 60 Detik | 24 Jam
| 5 Menit | 15 Menit | | Minimal Nominal Transaksi | Rp1 | Rp1 | Rp100 | Rp100 | Rp1 | | Maksimal Nominal Transaksi | Non Premium: Rp2.000.000
Premium: Rp20.000.000
Limit Bulanan: Rp40.000.000 | Rp20.000.000

Limit Bulanan: Rp40.000.000 | Non Premium: Rp2.000.000
Premium: Rp20.000.000
Limit Bulanan: Rp40.000.000 | Non Premium: Rp2.000.000
Premium: Rp20.000.000
Limit Bulanan: Rp40.000.000 | Non Premium: Rp2.000.000
Premium: Rp20.000.000
Limit Bulanan: Rp40.000.000 | | User membutuhkan PIN untuk | ✅ | ✅ | ✅ | ✅ | ✅ | | User membutuhkan OTP saat menghubungkan akun atau dengan | ❌ | ❌ | ❌ | ✅ | ✅ | # See also ::::VerticalSplit :::VerticalSplitItem [Model Bisnis dan Biaya E-Wallet](docId:-Lie76mLgpVV1KmPjodOL) untuk mengetahui model dan biaya harus dikeluarkan untuk menggunakan . ::: :::VerticalSplitItem [Penyelesaian Transaksi Pada E-Wallet](docId\:FNmIW9eShnWs16wuIZzlR) untuk mengetahui macam-macam cara menyelesaikan . ::: :::: ::::VerticalSplit :::VerticalSplitItem [Daftar Istilah E-Wallet](docId\:RtyOOpERogK7_PImzLfth) untuk mengetahui istilah khusus digunakan oleh . ::: :::VerticalSplitItem [FAQ E-Wallet](docId\:QyuY2tdI299dVSNUt9G-1) jika ingin mengetahui pertanyaan sering diajukan terkait . ::: :::: [title] Alur Pembayaran CVS [path] Payment/Convenience Store (CVS)/ Berikut alur melalui untuk Indomaret & Alfa Group. ![](https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-Kqmk-XkQinspo2q4EUZ3z-20240821-032925.jpg "Alur Pembayaran CVS") Deskripsi langkah pendaftaran pada CVS: 1. melakukan *checkout.* 2. mengirimkan data *checkout *kepada . 3. mendaftarkan *checkout *melalui Registration kepada . 4. melakukan validasi dan *generate *nomor . 5. mengirim nomor harus dibayarkan kepada . 6. mengirim nomor harus dibayarkan kepada . 7. menerima nomor CVS. 8. mengirim nomor kepada CVS. 9. CVS mengirim data inquiry ke . 10. memproses permintaan *inquiry.* 11. mengirim inquiry ke CVS. 12. melakukan . 13. melakukan pada CVS. 14. CVS memproses bukti . 15. CVS mengirim bukti ke . 16. CVS mengirimkan kepada . 17. memperbarui . 18. mengirim kepada . 19. mengajukan pemeriksaan kepada . 20. menerima pengajuan. 21. mengirimkan *response *kepada . 22. menerima terakhir. 23. mengirimkan hasil pemeriksaan kepada . # See also ::::VerticalSplit :::VerticalSplitItem [Fitur CVS](docId\:iWIQWotO0vYXaBnkseJEA) untuk mengetahui fitur pada . ::: :::VerticalSplitItem [Integrasi & Testing CVS](docId:6zSlSRyypvTgFXAKRIXHI) untuk mengetahui cara dan uji coba . ::: :::: ::::VerticalSplit :::VerticalSplitItem [Daftar Istilah CVS](docId:-M-nZrtY-prU0aJjTYj9g) untuk mengetahui istilah khusus digunakan oleh . ::: :::VerticalSplitItem [FAQ CVS](docId\:Bf4kvuVF_blHBxysENnWn) jika ingin mengetahui pertanyaan sering diajukan terkait . ::: :::: [title] Bank Jakarta [path] Payment/Virtual Account (VA)/Panduan Bayar VA/ ![](https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-pT-ZvDFWAXTzQsaOEPNjG-20250725-095104.png) :::hint{type="info"} Pastikan melakukan transfer dana sebelum masa berlaku habis dan dengan nominal tepat. ::: | **Nomor Virtual Account** | `995014XXXXXXXXXX` | | ------------------------- | --------------------------- | | **Bank** | Jakarta | | **Nominal** | Rp10.000 | | **Nama Penerima** | `Merchant Name - billingNm` | | **Nomor Order** | Invoice-1234 | | **Masa Berlaku** | 16-06-2016 / 17:15:00 | file format JSON Panduan Bayar Bank Jakarta untuk operasi . ::File{src="https://archbee-doc-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-Uk0KyHSYk2EtLgULuZWok-20250813-032110.json" label="va-ind-bdki.json"} # ATM *** 1. kartu . 2. Masuk ke utama ATM Jakarta. 3. `Pembayaran`. 4. `Virtual Account`. 5. kode `Virtual Account`, misal `995014XXXXXXXXXX` sebagai nomor verifikasi . 6. kode (opsional). 7. Verifikasi kebenaran data. - Jika sudah sesuai, tekan `Benar`. Sebaliknya, jika tidak sesuai, tekan `Salah`. 8. Menerima resi . # JakOne Mobile *** 1. Masuk ke utama `JakOne Mobile`. 2. `Pembayaran`. 3. `Virtual Account`. 4. kode `Virtual Account`, misal `995014XXXXXXXXXX` sebagai nomor verifikasi . 5. PIN. 6. Konfirmasi tagihan . - Jika sudah sesuai, tekan `Lanjut`. 7. Menerima resi . # EDC *** 1. Masuk ke utama `EDC Bank Jakarta`. 2. `Pembayaran VA`. 3. `Jenis Rekening`. 4. kode `Virtual Account`, misal `995014XXXXXXXXXX` sebagai nomor verifikasi . 5. PIN. 6. Konfirmasi tagihan . - Jika sudah sesuai, tekan `Lanjut`. 7. Menerima resi . # MPOS *** 1. Masuk ke utama `MPOS Bank Jakarta`. 2. `Pembayaran VA`. 3. kode `Virtual Account`, misal `995014XXXXXXXXXX` sebagai nomor verifikasi . 4. Konfirmasi tagihan . - Jika sudah sesuai, tekan `Lanjut`. 5. kartu. 6. PIN. 7. Menerima resi . # CMS *** ## User Maker 1. Masuk ke utama `CMS Bank Jakarta`. 2. `Pembayaran Tagihan`. 3. kode `Virtual Account`, misal `995014XXXXXXXXXX` sebagai nomor verifikasi . ## User Approval 1. Masuk ke utama *User* `Approval`. 2. `Tugas Tertunda`. 3. Cek Daftar `Tugas Tertunda`. - Jika data sudah sesuai, pilih `Menyetujui`. Sebaliknya jika data tidak sesuai, pilih `Tolak`. 4. Konfirmasi tagihan. # Teller *** ## Bayar Tunai 1. Siapkan uang tunai. 2. Informasikan kode `Tagihan Virtual Account`, misal `995014XXXXXXXXXX` sebagai nomor verifikasi . 3. Menerima bukti . ## Bayar Debet Rekening 1. Siapkan kartu ATM/buku rekening tabungan dan kartu identitas. 2. Informasikan kode `Tagihan Virtual Account`, misal `995014XXXXXXXXXX` sebagai nomor verifikasi kepada Petugas Teller. 3. Petugas Teller akan menggesek kartu ATM ke mesin EDC. 4. PIN. 5. Menerima resi . [title] Alur Pembayaran Direct Debit [path] Payment/Direct Debit/ Alur melalui untuk Jenius Pay. ![](https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-L-E2o5Psy0V0BUC6eQieo-20240821-033418.jpg "Alur Pembayaran Direct Debit") Deskripsi langkah: 1. mengajukan *checkout *kepada . 2. akan melakukan pendaftaran *checkout* menggunakan Registration kepada . 3. menyimpan *order regist*. 4. mengarahkan menuju . 5. menampilkan kepada . 6. memilih . 7. memasukkan data (Jenius Pay: Cashtag). 8. mengirimkan dipilih kepada . 9. mengajukan kepada . 10. melakukan *authentication.* 11. mengirimkan *authentication *kepada . 12. melakukan *authentication.* 13. mengajukan *charge *kepada . 14. melakukan . 15. mengirimkan hasil kepada . 16. mengirimkan *push notification *kepada . 17. melakukan validasi . 18. melakukan perubahan . 19. mengirimkan kepada . 20. mengajukan pemeriksaan menggunakan Status kepada . 21. mengirimkan *response * kepada . 22. menerima akhir 23. mengirim konfirmasi perubahan kepada . # See also ::::VerticalSplit :::VerticalSplitItem [Fitur Direct Debit](docId\:opy1X7V3Y2t4T1yGnSglF) untuk mengetahui fitur pada . ::: :::VerticalSplitItem [Integrasi & Testing Direct Debit](docId\:sHrV7hpVnWLt9ipNeCfE4) untuk mengetahui cara dan uji coba . ::: :::: [title] Fitur Direct Debit [path] Payment/Direct Debit/ Fitur verifikasi pada metode bergantung pada ketentuan . | **Mitra** | **Fitur Verifikasi Pelanggan** | **Deskripsi** | | --------- | ------------------------------ | --------------------------------------------------------------------------------------- | | Jenius | Cashtag | Identitas Pengguna seperti *username* digunakan sebagai pengganti nomor kartu atau PAN | # See also ::::VerticalSplit :::VerticalSplitItem [Alur Pembayaran Direct Debit](docId\:e5Hsqs6VJRuvWqsAXCjIE) untuk mengetahui pada saat melakukan dengan . ::: :::VerticalSplitItem [Integrasi & Testing Direct Debit](docId\:sHrV7hpVnWLt9ipNeCfE4) untuk mengetahui cara dan uji coba pada . ::: :::: [title] Panduan Bayar QRIS [path] Payment/QRIS/ Langkah dengan : 1. Buka aplikasi mendukung dengan . 2. fitur `QRIS / Pay / Bayar`. 3. Pindai kode QR diberikan oleh . 4. nominal harus dibayarkan. 5. `Konfirmasi`. 6. PIN untuk menyelesaikan . 7. Setelah berhasil, akan dialihkan ke `Payment Result Page`. file format JSON Panduan Bayar QRIS untuk operasi . ::File{src="https://archbee-doc-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/UzPZ3-gWreKX4gRH4CKm6_qrisind.json" label="QRIS_IND.json"} # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Panduan Bayar CVS](docId:_dY8vW1ygeXkx0NQ0J4GB) untuk mengetahui cara membayar melalui . ::: :::VerticalSplitItem [Panduan Bayar E-Wallet](docId:-v30F8TW2bUenjkPfjaX5) untuk mengetahui cara membayar menggunakan . ::: :::: ::::VerticalSplit :::VerticalSplitItem [Panduan Bayar Payloan](docId\:KMa4n6iBgx27LMi_OafvW) untuk mengetahui cara membayar menggunakan . ::: :::VerticalSplitItem Daftar pembaharuan *log* panduan bayar dapat dilihat pada [Release Information - Panduan Bayar](docId\:oBJOho15Y6-A0JVj4JODP). ::: :::: [title] Bank Neo Commerce [path] Payment/Virtual Account (VA)/Panduan Bayar VA/ ::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/4hYMf6m7q0juMaHrG9id2_bnc.png" size="50" width="500" height="500" caption="Bank Neo Commerce" position="center" darkWidth="500" darkHeight="500" showCaption="true"} :::hint{type="info"} Pastikan melakukan transfer dana sebelum masa berlaku habis dan dengan nominal tepat. ::: | **Nomor Virtual Account** | `99202XXXXXXXXXXX` | | ------------------------- | --------------------------- | | **Bank** | Bank Neo Commerce | | **Nominal** | Rp10.000 | | **Nama Penerima** | `Merchant Name - billingNm` | | **Nomor Order** | Invoice-1234 | | **Masa Berlaku** | 16-06-2016 / 17:15:00 | file format JSON Panduan Bayar Bank Neo Commerce untuk operasi . ::File{src="https://archbee-doc-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/vgEVrL4QRZB_ZIm-KD7RT_va-ind-bnc.json" label="VA_IND_BNC.json"} # Internet Banking *** 1. Masuk ke aplikasi Neobank. 2. `Pembayaran VA`. 3. `BNC` sebagai nama penerima. 4. `Nomor Virtual Account`, misal `99202XXXXXXXXXXX` sebagai kode bayar. 5. nominal . 6. Konfirmasi . 7. PIN. 8. Transaksi selesai. # Mobile Banking Non-BNC *** :::hint{type="info"} Panduan bayar ini **berlaku untuk metode transfer selain BI-FAST** ::: 1. Masuk ke aplikasi App. 2. `Transfer ke bank lain`. 3. `BNC` sebagai nama penerima. 4. `Nomor Virtual Account`, misal `99202XXXXXXXXXXX` sebagai kode bayar. 5. Konfirmasi transfer. 6. PIN. 7. Transaksi selesai. [title] Bank BJB [path] Payment/Virtual Account (VA)/Panduan Bayar VA/ ::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/dLoyowdpMu4HegQYXaf7b_bankbjblogo.png" size="50" width="1200" height="668" caption="Bank BJB" position="center" darkWidth="1200" darkHeight="668" showCaption="true"} :::hint{type="info"} Pastikan melakukan transfer dana sebelum masa berlaku habis dan dengan nominal tepat. ::: | **Nomor Virtual Account** | `1887XXXXXXXXXXXX ` | | ------------------------- | --------------------------- | | **Bank** | BJB | | **Nominal** | Rp10.000 | | **Nama Penerima** | `Merchant Name - billingNm` | | **Nomor Order** | Invoice-1234 | | **Masa Berlaku** | 16-06-2016 / 17:15:00 | file format JSON Panduan Bayar Bank BJB untuk operasi . ::File{src="https://archbee-doc-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/XNU5dlOxMwnicvstF7K7T_va-ind-bjb.json" label="VA_IND_BJB.json"} # ATM *** 1. kartu `ATM` dan `PIN` . 2. `Transaksi Lainnya`, kemudian pilih `Virtual Account`. 3. `Tabungan`. 4. `Nomor Virtual Account`, misal `1887XXXXXXXXXXXX` sebagai `Kode Bayar`. 5. `Lanjutkan`. 6. Layar akan menampilkan `Kode Bayar dan Data Pembayaran`. - Jika jenis tagihan ***open***, harus memasukkan kembali `Jumlah Bayar`. 7. `Ya` untuk melakukan . 8. Selesai. # Mobile Banking *** 1. Masuk ke akun `BJB Mobile App` . 2. `Virtual Account`. 3. `Nomor Virtual Account`, misal `1887XXXXXXXXXXXX` sebagai `Kode Bayar`. 4. Layar akan menampilkan `Kode Bayar dan Data Pembayaran`. - Jika jenis tagihan ***open***, harus memasukkan kembali `Nominal` yang harus dibayarkan. 5. PIN, kemudian klik `Lanjutkan` untuk melakukan . 6. Selesai. # BJB Net *** 1. Masuk ke akun `BJB Net App` . 2. `BJB Virtual Account`. 3. `Nomor Virtual Account`, misal `1887XXXXXXXXXXXX` sebagai `Kode Bayar`. 4. Layar akan menampilkan `Kode Bayar dan Data Pembayaran`. - Jika jenis tagihan ***open***, harus memasukkan kembali `Nominal` yang harus dibayarkan. 5. `Lanjutkan` untuk melakukan . 6. Selesai. # Transfer Bank Non-BJB *** :::hint{type="info"} Panduan bayar ini **berlaku untuk metode transfer selain BI-FAST** ::: 1. dapat membayar tagihan melalui pilihan *Channel* Bank Lain (Teller, ATM, atau Internet Banking). 2. Transfer antar . 3. kode BJB: `110`. 4. `Nomor Virtual Account`, misal `1101887XXXXXXXXXXXX`sebagai `Kode Bayar`. 5. Sistem akan menampilkan `Identitas dari nomor Virtual Account`. - Jika jenis tagihan ***open***, harus memasukkan kembali `Nominal` harus dibayarkan. 6. Selesai. # Transfer Antar Bank (Dompet Digital) *** :::hint{type="info"} Panduan bayar ini **berlaku untuk metode transfer selain BI-FAST** ::: 1. Pada Layanan Dompet Digital, pilih menu `Transfer` ke rekening . 2. `Kode Bank` dan `Nomor Virtual Account`. 3. Jika jenis tagihan ***open***, harus memasukkan kembali `Nominal` harus dibayarkan. 4. `Lanjutkan` untuk melakukan . 5. Selesai. # Teller Bank BJB *** 1. membawa nomor didapatkan dari aplikasi / *website */ institusi. 2. Teller BJB akan memasukkan nomor tersebut pada Aplikasi BJB Fast dan tergantung dengan jenis ditentukan institusi/*biller.* - akan membayarkan tagihan secara ***fix*** atau ***open payment***. 3. menerima bukti bayar dan tagihan pada *biller */ institusi \{\{ya}} akan otomatis berubah menjadi terbayar. 4. Selesai. [title] Akulaku [path] Payment/Payloan/Panduan Bayar Payloan/ ::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/_bjGT4LXUDvlKg6ySYU_Q_image.png" size="40" width="1174" height="1098" caption="Akulaku" position="center" darkWidth="1174" darkHeight="1098" showCaption="true"} # Informasi Nomor Pembayaran *** :::hint{type="info"} Pastikan melakukan sebelum masa berlaku habis. ::: | **Mitra Paylater** | Akulaku | | ------------------- | ------------------------------------- | | **Nominal** | Rp10.000 | | **Nama Penerima** | `billingNm` | | **Nomor Pemesanan** | Invoice-1234 | | **Masa Berlaku** | 16-06-2016 / 17:15:00
| # Pembayaran *** Langkah dengan menggunakan Akulaku: 1. Pilih Pembayaran melalui `Akulaku`. 2. akan dipindahkan ke `Halaman Pembayaran Akulaku`. 3. Masuk menggunakan akun dan OTP. 4. Pastikan `Credit Limit` cukup. 5. Lanjut dan Konfirmasi. 6. Pembayaran sudah `Berhasil`! akan dipindahkan ke *result* *page*. file format JSON Panduan Bayar Akulaku untuk operasi . ::File{src="https://archbee-doc-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/U8S6NtRjJAnT3_oCsAD6p_payloanindakulaku.json" label="PAYLOAN_IND_AKULAKU.json"} [title] Model Bisnis dan Biaya GPN [path] Payment/GPN/ # Model Bisnis *** hadir sebagai solusi kartu antar . Metode meringankan beban biaya administrasi saat bertransaksi menggunakan kartu berbeda dengan mesin EDC milik *Acquiring* maupun *Issuing*. Implementasi berfokus pada 3 poin utama, antara lain: 1. Menciptakan sebuah ekosistem saling interkoneksi, interoperabilitas, dan mampu melaksanakan mencakup Otorisasi, Kliring, dan secara domestik. 2. Meningkatkan perlindungan Konsumen, antara lain melalui pengamanan data Nasabah dalam setiap . 3. Meyakinkan ketersediaan dan integritas data nasional untuk mendukung efektivitas transmisi kebijakan moneter, efisiensi intermediasi, dan resiliensi keuangan. Selain itu, penerapan dalam di mampu mengurangi biaya pengadaan mesin EDC pada pihak *Acquiring*, *Issuing,* dan serta mengurangi melalui pihak asing (Visa dan Mastercard). # Biaya Untuk Menggunakan Layanan GPN *** hendak menggunakan dikenakan biaya Discount Rate untuk setiap menggunakan pada mesin EDC dikenakan sebesar 1% per . :::hint{type="info"} kunjungi [Produk & Biaya Layanan](docId:2deQYlDf8Az72oHGYaV7_) untuk lebih lanjut. ::: # See also ::::VerticalSplit :::VerticalSplitItem [Penyelesaian Transaksi Pada GPN](docId:0lY8aeJpdvnOGEnJVLj7u) untuk mengetahui macam-macam cara menyelesaikan . ::: :::VerticalSplitItem [Aturan dan Limitasi GPN](docId\:WXmjJclMZvXWAAxSUHaPt) untuk mengetahui ketentuan khusus . ::: :::: ::::VerticalSplit :::VerticalSplitItem [Daftar Istilah GPN](docId\:QrpRszpmgc7DERhBS8nWQ) untuk mengetahui istilah khusus digunakan . ::: :::VerticalSplitItem [FAQ GPN](docId:38L5TBCuVolwnrv_C65Ft) jika ingin mengetahui pertanyaan sering diajukan terkait . ::: :::: [title] Panduan Bayar Paylater [path] Payment/Payloan/ ::::LinkArray{contentSource="CUSTOM"} :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/IySpfHN3psL4kNE2gUCh9_1.png"} [Akulaku](docId\:I5IJNCNsv1yHlOdQ6ilIK) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/MneFKa06iwAHrQaZ1NSkL_kredivo1.png"} [Kredivo](docId\:pNqyCn7x10kvDVOyt6PTH) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/YsveSJB291siWdYrJr_01_indodana.png"} [Indodana](docId\:fmNJuQkrBk7bYaTrwe-V0) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-Ye3GbK0AjWhYOEK3l5ha1-20250903-041809.png"} [SPayLater](docId\:NCoUmleoVqATLBGjwWdiB) ::: :::: # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Panduan Bayar CVS](docId:_dY8vW1ygeXkx0NQ0J4GB) untuk mengetahui cara membayar menggunakan . ::: :::VerticalSplitItem [Panduan Bayar E-Wallet](docId:-v30F8TW2bUenjkPfjaX5) untuk mengetahui cara membayar menggunakan . ::: :::: ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Panduan Bayar QRIS](docId\:og8vGEkiCoG9mupWHrrJ0) untuk mengetahui cara membayar menggunakan . ::: :::VerticalSplitItem Daftar pembaharuan *log* panduan bayar dapat dilihat pada [Release Information - Panduan Bayar](docId\:oBJOho15Y6-A0JVj4JODP). ::: :::: [title] Tipe Metode Pembayaran GPN [path] Payment/GPN/ # Full Payment *** Tipe menggunakan kartu difokuskan untuk melakukan tanpa perlu mendaftarkan kartu kepada (*tokenization*). Metode *Full Payment* tidak disertai fitur Installment, sehingga harus membayar lunas (*full amount*) dari total . # Recurring *** ## Recurring Issue (Tokenization) Tipe menggunakan kartu dapat mendaftarkan data kartu dengan menggunakan tokenisasi (*tokenization*) agar dapat digunakan untuk bertransaksi secara berkala. Proses ini menghasilkan *recurring* *token* digunakan oleh dan untuk mengidentifikasi sebagai pengganti nomor kartu . *Recurring issue* terbagi menjadi dua jenis, yakni: 1. *Auto Void* - dapat mendaftarkan kartu terlebih dahulu tanpa perlu melakukan dengan . 2. *Regular Payment* - mendaftarkan kartu serta melakukan dengan dalam jangka waktu singkat. ## Recurring Payment Tipe menggunakan kartu melakukan menggunakan *recurring token* dari kartu sudah didaftarkan. *Recurring token* digunakan oleh dan untuk mengidentifikasi sebagai pengganti nomor kartu . # See also ::::VerticalSplit :::VerticalSplitItem [Alur Pembayaran GPN](docId\:ghiIyFFMv_ABDqf4cCF5Q) untuk mengetahui pada saat melakukan dengan . ::: :::VerticalSplitItem [Integrasi & Testing GPN](docId\:LuCYNk98cX7upRb-xSZS3) untuk mengetahui cara dan uji coba kartu . ::: :::: ::::VerticalSplit :::VerticalSplitItem [Daftar Istilah GPN](docId\:QrpRszpmgc7DERhBS8nWQ) untuk mengetahui istilah khusus digunakan . ::: :::VerticalSplitItem [FAQ GPN](docId:38L5TBCuVolwnrv_C65Ft) jika ingin mengetahui pertanyaan sering diajukan terkait . ::: :::: [title] Paylater [path] Payment/ ![Mitra Paylater](https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-2RrU1ZFiraN_MTXcqDawS-20250903-041718.jpg "Mitra Paylater") # Tentang Paylater *** **Paylater** adalah digital dengan jangka waktu telah ditentukan oleh pihak pemberi pinjaman (*Lender*) kepada pihak peminjam (*Borrower*). Layanan dengan prinsip **BNPL **(*Buy Now, Pay Later*) ini menargetkan Pengguna konsumtif membutuhkan dana tambahan untuk melakukan konsumtif namun tidak memiliki jaminan berupa barang untuk mengajukan pinjaman. Kelebihan dari ini adalah lebih ringannya persyaratan untuk pengajuan pembukaan akun dan pinjaman dibandingkan dengan . Pengguna dapat melakukan pengajuan dalam waktu kurang dari seminggu untuk dapat diterima sebagai peminjam. Dana tambahan diajukan kepada akan dilunasi Pengguna pada waktu jatuh tempo berlaku dengan tambahan suku bunga lebih tinggi dari umumnya. Jika terlambat atau melebihi waktu tenggat pinjaman sudah disepakati bersama, maka harus membayar denda. :::hint{type="info"} adalah pihak penyedia pinjaman sudah diakui secara resmi oleh OJK. ::: # Daftar Paylater Partner NICEPAY *** bekerja sama dengan beberapa untuk memudahkan dalam bertransaksi dan mendapatkan lebih banyak . Berikut adalah daftar sudah bekerja sama dengan . | **No** | **Nama Paylater Partner** | | ------ | --------------------------- | | 1 | Akulaku | | 2 | Indodana | | 3 | Kredivo | | 4 | SPayLater / Shopee PayLater | :::hint{type="info"} wajib melakukan pendaftaran dan integrasi ShopeePay terlebih dahulu agar dapat mengaktifkan fitur SPayLater. ::: # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [API Paylater](docId:5yKOH01P6iksF7kv727Cd) untuk mengetahui rincian digunakan pada . ::: :::VerticalSplitItem ::: :::: [title] Model Bisnis dan Biaya Paylater [path] Payment/Payloan/ # Model Bisnis *** Metode memudahkan peminjam (*Borrower*) untuk mengajukan pinjaman kepada pemberi pinjaman (*Lender*) dengan menggunakan identitas peminjam. Proses peminjaman pada lebih transparan dan lebih cepat dari kredit pada . Peminjam baik individu ataupun dapat mengajukan pinjaman kepada sesuai dengan kebutuhan. # Biaya Untuk Menggunakan Layanan Paylater *** ## Sisi Pelanggan tidak dikenakan biaya saat mendaftarkan diri pada . akan mendapatan limit sesuai *assessment/approval* dan mulai dikenakan biaya setelah menggunakan untuk melakukan . Biaya tersebut berupa beban bunga harus dibayarkan pada saat melunasi pinjaman. Selain itu, dapat dikenakan denda jika telat melakukan pelunasan pinjaman. ## Sisi Merchant akan dikenakan biaya MDR (%) + *Fix Rate* (*publish rate*). :::hint{type="info"} kunjungi [Produk & Biaya Layanan](docId:2deQYlDf8Az72oHGYaV7_) untuk rincian lebih lanjut. ::: # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Penyelesaian Transaksi Pada Paylater](docId\:cQdqwni_Sfh7x9mSTCpt4) untuk mengetahui macam-macam cara menyelesaikan . ::: :::VerticalSplitItem [Aturan dan Limitasi Paylater](docId\:AssO3UWjtG3j_pyf7l2Et) untuk mengetahui ketentuan khusus . ::: :::: ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Daftar Istilah Paylater](docId\:Gu0PXWuHJFG-EwxUsoRfQ) untuk mengetahui istilah khusus digunakan oleh . ::: :::VerticalSplitItem [FAQ Paylater](docId\:y88CwYlN6KTcATxOHbJYP) jika ingin mengetahui pertanyaan sering diajukan terkait . ::: :::: [title] Daftar Istilah E-Wallet [path] Payment/E-Wallet/ # Cashback Penawaran kembali sejumlah uang dari nominal suatu dalam , biasanya dalam bentuk kredit atau dapat digunakan kembali untuk lain. # Dompet Digital Layanan memungkinkan Pengguna menyimpan uang mereka secara digital dan melakukan keuangan menggunakan perangkat seluler mereka. Layanan ini dapat diakses melalui *smartphone* Pengguna, biasanya menggunakan nomor ponsel Pengguna sebagai ID pada , di *server* aplikasi, dan di . # Jump App Proses perpindahan aplikasi dari platform ke platform untuk melakukan . Umumnya, Pengguna melakukan *checkout* pada platform untuk pembelian barang/jasa, lalu Pengguna menggunakan , di mana ada beberapa mengharuskan konfirmasi pada platform terkait. # Linkage Penautan akun di *platform* (*app */*website*) untuk meningkatkan efisiensi dan kecepatan di platform . Setelah akun terhubung dengan platform , Pengguna dapat melakukan dengan cepat dan mudah, tanpa perlu memasukkan secara manual setiap kali melakukan pada platform tersebut. # Non-Premium Non-Premium dalam lingkup dapat diartikan sebagai level akun Pengguna, umumnya digunakan untuk Pengguna belum melakukan verifikasi identitas/KYC (*Know Your Customer*) pada aplikasi , sehingga Pengguna hanya mendapatkan fitur terbatas pada aplikasi , seperti hanya bisa melakukan dan ada limit tertentu untuk *top-up* akun . # OTP Singkatan dari *One-Time Password* atau kata sandi satu kali pakai, biasanya digunakan sebagai lapisan keamanan tambahan untuk memastikan dan melindungi identitas Pengguna sebelum memberikan akses ke akun atau melakukan . Setelah Pengguna menerima OTP, Pengguna harus memasukkannya ke dalam aplikasi sesuai dengan tenggat waktu sudah ditentukan (misal 30 detik atau 1 menit) untuk melakukan verifikasi identitas dan melanjutkan atau *login *pada aplikasi. OTP tidak dapat digunakan lagi setelah periode waktu tersebut berakhir. # PIN PIN (*Personal Identification Number*) adalah nomor rahasia atau kata sandi pribadi terdiri dari 4 hingga 6 digit angka digunakan sebagai metode keamanan Pengguna untuk mengakses akun atau melakukan terkait dengan akun mereka. Karena bersifat rahasia, PIN dianggap lebih aman daripada kata sandi terdiri dari huruf dan angka, karena sulit untuk ditebak atau dicuri. Namun, Pengguna juga harus berhati-hati dalam memilih dan menjaga kerahasiaan PIN mereka, serta menghindari mengungkapkan PIN kepada orang lain atau menggunakannya di tempat umum, karena hal ini dapat meningkatkan risiko keamanan dan kehilangan akses ke akun atau sensitif lainnya. # Premium Premium dalam lingkup dapat diartikan sebagai level akun Pengguna, umumnya digunakan untuk Pengguna sudah melakukan verifikasi identitas/KYC (*Know Your Customer*) pada aplikasi dan berhak untuk menggunakan fitur lebih lengkap dan terdepan selain fitur utama dipersiapkan oleh untuk para Pengguna . # Refund Pada merujuk pada pengembalian dana atau sudah dibayarkan atau ditransfer ke akun Pengguna sebelumnya. # Seamless Proses lancar dan tanpa hambatan. Artinya, Pengguna dapat melakukan dengan mudah, cepat, dan tanpa gangguan atau kesulitan teknis menghalangi . Sehingga dapat meningkatkan tingkat adopsi dan penggunaan sebagai alternatif lebih modern dan mudah digunakan. # Top Up Proses mengisi melalui transfer , , atau melalui Agen Penjual. # Timeout *Timeout* pada biasanya disebabkan oleh masalah teknis (jaringan), ataupun dapat disebabkan oleh tidak melakukan dalam waktu telah ditentukan oleh *Issuer* dalam 1 (satu) kali . # See also ::::VerticalSplit :::VerticalSplitItem [Alur Pembayaran E-Wallet](docId\:saeozIsJLLCkE5s4QVnHw) untuk mengetahui pada saat melakukan dengan . ::: :::VerticalSplitItem [Fitur E-Wallet](docId\:FltKp9kGyS4hkmOPZojoV) untuk mengetahui fitur pada . ::: :::: ::::VerticalSplit :::VerticalSplitItem [Integrasi & Testing E-Wallet](docId\:b9HPduhC2MPMLaLHIjCbO) untuk mengetahui cara dan uji coba . ::: :::VerticalSplitItem [FAQ E-Wallet](docId\:QyuY2tdI299dVSNUt9G-1) jika ingin mengetahui pertanyaan sering diajukan terkait . ::: :::: [title] Penyelesaian Transaksi Pada CVS [path] Payment/Convenience Store (CVS)/ # Cancellation Number *** Proses pembatalan CVS dapat dilakukan sebelum nomor `payNo` kedaluwarsa atau terbayar. Apabila jika CVS mengalami isu, maka tersebut akan diproses dengan skema *flagging*. # See also ::::VerticalSplit :::VerticalSplitItem [Aturan dan Limitasi CVS](docId:9MqUjFCPAc5JqvGE-ErKs) untuk mengetahui ketentuan khusus . ::: :::VerticalSplitItem [Daftar Istilah CVS](docId:-M-nZrtY-prU0aJjTYj9g) untuk mengetahui istilah khusus digunakan oleh . ::: :::: [title] FAQ VA [path] Payment/Virtual Account (VA)/ ### Mengapa transaksi menggunakan Virtual Account dapat gagal? 1. Nomor VA / nomor tagihan tidak ditemukan. 2. Kode perusahaan tidak terdaftar. 3. Memasukkan nomor VA salah. 4. Waktu sudah habis sehingga nomor VA sudah tidak bisa digunakan. 5. Pembayaran dengan nomor VA berhasil tetapi terkena *timeout *dari . *** ### Bagaimana cara Merchant mengecek transaksi yang sudah berhasil dibayarkan dengan Virtual Account? dapat melihat riwayat dalam jangka waktu tertentu melalui [Merchant Back Office](docId\:VMD8YtiiJqku6H8dRhcS6) pada: - Menu [Transaction Data](docId\:iZwosih8r9HIc0UurgYMa) untuk memeriksa seluruh data , atau - Menu [Fail Transaction](docId\:Kw36Cm_cK3RzRNUHfzavQ) untuk memeriksa data gagal. *** ### Apa yang dimaksud dengan Settlement? adalah pembukuan suatu pemindahan dana dari lembaga finansial ( atau ) ke suatu individu atau perusahaan dalam kasus ini akan disebut sebagai . kunjungi [Proses Settlement](docId\:l04EuP_s604Oi2Ib3x_y6) untuk lebih lanjut. *** ### Berapa lama waktu yang dibutuhkan untuk melakukan proses Settlement Virtual Account? kunjungi [Proses Settlement](docId\:l04EuP_s604Oi2Ib3x_y6) untuk lebih lanjut. *** ### Apakah terdapat proses ***refund ***pada Merchant Back Office pembayaran dengan Virtual Account***?*** [Merchant Back Office](docId\:VMD8YtiiJqku6H8dRhcS6) tidak menyediakan *refund *untuk dengan . dapat melakukan *refund *dengan menghubungi untuk melakukan *refund*. *** ### Apakah untuk VA Fix bisa close amount? Bisa, menyediakan tipe *VA Fixed dengan close amount,* yaitu *Fixed Close*. *** ### Kapan Merchant menerima notif? akan menerima setelah berhasil. *** ### Mengapa Merchant tidak menerima notif? Mohon pastikan URL notif yang digunakan apakah *valid* atau tidak. - Jika *valid*, mohon pastikan apakah menggunakan *firewall.* - Jika menggunakan *firewall*, mohon Whitelist IP terlebih dahulu. *** ### Apa yang harus dilakukan jika notif terganggu sehingga Merchant tidak menerima notif? menghubungi pihak agar dapat dibantu untuk mengirimkan ulang . *** ### Apa yang harus dilakukan jika VA Mandiri yang akan dibayarkan mengalami gangguan sehingga VA gagal untuk dibayar? Mohon dipastikan penyedia jasa apakah sesuai dengan *prefix* digunakan. - - 88049 - Transferpay - 70014 *** ### Berapa maksimal digit untuk membuat tipe VA Fix? Maksimal 8 digit. *** ### Apakah ***expired date*** dan ***expired time*** VA bisa diatur oleh Merchant? Bisa, dapat mengatur melalui parameter `vacctValidDt` dan `vacctValidTm` untuk penyesuaian waktu kedaluwarsa VA. *** ### Apa yang harus dilakukan jika VA yang sudah dibayarkan namun status transaksi masih ***unpaid***? bisa melakukan pengajuan kepada pihak , apakah tersebut ingin dilakukan FLAGGING MANUAL ( sukses secara manual) atau dilakukan REFUND. *** ### Mengapa saat regist VA mengalami ***error***? Kendala sering terjadi disebabkan oleh kesalahan pada dikirim. *** ### Apa yang harus dilakukan jika Merchant ingin melakukan simulasi ***payment*** ? bisa membagikan VA ingin dilakukan kepada pihak , kemudian pihak akan membantu simulasi pada VA tersebut. *** ### Bagaimana cara membuat merchantToken untuk regist VA? `merchantToken` dapat dibuat dengan menggunakan kombinasi *value* pada ( `timeStamp`+`iMid`+`referenceNo`+`amt`+`merchantKey` ) dengan `SHA256`. *** ### Apakah ***billing data*** dengan ***delivery data*** dapat disamakan? Bisa, *billing data* wajib untuk regist sedangkan *delivery data* bersifat opsional. *** ### Apakah Merchant bisa menggunakan 2 tipe VA? Misal, Merchant ingin menggunakan VA Normal dan VA Fix Bisa, tetapi membutuhkan 2 ID (MID) untuk kebutuhan tersebut. *** ### Pada VA Fix, apa yang akan terjadi jika Pelanggan melakukan proses ***checkout*** pertama (contoh sepatu) namun tidak bayar, kemudian Pelanggan melakukan proses ***checkout*** kembali dengan pesanan yang berbeda (contoh baju)? VA pada *checkout *pertama tidak dibayarkan akan otomatis berubah menjadi *expired *saat melakukan *checkout *kedua. [title] Model Bisnis dan Biaya E-Wallet [path] Payment/E-Wallet/ # Model Bisnis *** hadir sebagai berbasis aplikasi ini menjadi salah satu alternatif non-tunai selain menggunakan . Layanan non-tunai populer digunakan karena mampu menggantikan tunai dan mampu membayar tagihan dengan cepat. dapat menjangkau lebih banyak Pengguna, terutama bagi tidak memiliki akun rekening untuk menggunakan digital karena hanya perlu menggunakan nomor telepon saja. juga memudahkan untuk mendapatkan lebih banyak dan mempercepat . # Biaya Untuk Menggunakan Layanan E-Wallet *** ## Sisi Pelanggan dikenakan biaya tambahan saat akan menambahkan dana ke dalam aplikasi , mulai dari gratis hingga Rp2.000;. juga akan dikenakan biaya saat melakukan melalui aplikasi , seperti pembelian token listrik, pulsa, paket data, dan lain-lain, namun biaya ini hanya ditagihkan jika melalui aplikasi saja. Maksimal saat ini untuk Pengguna terbagi 2 (dua), yaitu : - Unregistered (non-KYC) maksimal Rp2.000.000 (Dua Juta Rupiah) - Registered (KYC) maksimal Rp20.000.000 (Dua Puluh Juta Rupiah) Selain itu, untuk limit per bulan untuk kedua klasifikasi Pengguna di atas maksimal Rp40.000.000 (Empat Puluh Juta Rupiah) dihitung dari penambahan dana. ## Sisi Merchant dapat bekerja sama dengan untuk menggunakan dari berbagai pihak penyelenggara dalam satu sudah terintegrasi dengan baik. Sehingga, tidak perlu menghubungi banyak pihak dalam menggunakan ini. :::hint{type="info"} kunjungi [Produk & Biaya Layanan](docId:2deQYlDf8Az72oHGYaV7_) untuk lebih lanjut. ::: # See also ::::VerticalSplit :::VerticalSplitItem [Penyelesaian Transaksi Pada E-Wallet](docId\:FNmIW9eShnWs16wuIZzlR) untuk mengetahui macam-macam cara menyelesaikan . ::: :::VerticalSplitItem [Aturan dan Limitasi E-Wallet](docId\:cZza2J4bAdgxIZCyL1ag3) untuk mengetahui ketentuan khusus . ::: :::: ::::VerticalSplit :::VerticalSplitItem [Daftar Istilah E-Wallet](docId\:RtyOOpERogK7_PImzLfth) untuk mengetahui istilah khusus digunakan oleh . ::: :::VerticalSplitItem [FAQ E-Wallet](docId\:QyuY2tdI299dVSNUt9G-1) jika ingin mengetahui pertanyaan sering diajukan terkait . ::: :::: [title] FAQ QRIS [path] Payment/QRIS/ ### Apa perbedaan pembayaran menggunakan E-Wallet dan QRIS? Pembayaran dengan membuat Pengguna bergantung pada masuk pada aplikasi untuk melakukan . Pembayaran dengan mengharuskan Pengguna untuk memindai QR diberikan oleh untuk melakukan . *** ### Apakah QRIS ShopeePay hanya menerima pembayaran melalui aplikasi Shopee saja? Meskipun menggunakan ShopeePay, namun dapat menerima dari lain mendukung dengan . *** ### Apakah Turis dapat membayar menggunakan QRIS? Aplikasi turis telah mengadopsi standar EMVCo dapat menggunakan di semua sudah menggunakan . *** ### Mengapa transaksi menggunakan QRIS dapat gagal? 1. Salah memindai QR pada aplikasi ShopeePay. 2. Pesanan tidak sesuai. 3. Transaksi sudah kedaluwarsa. 4. Sinyal provider terputus saat sedang melakukan . 5. *Background* QR warna hitam sehingga tidak dapat dipindai. *** ### Bagaimana cara Merchant mengecek transaksi yang sudah berhasil dibayarkan dengan QRIS? dapat melihat riwayat dalam jangka waktu tertentu melalui [Merchant Back Office](docId\:VMD8YtiiJqku6H8dRhcS6) pada: - Menu [Transaction Data](docId\:iZwosih8r9HIc0UurgYMa) untuk memeriksa seluruh data , atau - Menu [Fail Transaction](docId\:Kw36Cm_cK3RzRNUHfzavQ) untuk memeriksa data gagal. *** ### Apa yang dimaksud dengan Settlement? adalah pembukuan suatu & pemindahan dana dari lembaga finansial ( atau ) ke suatu individu atau perusahaan dalam kasus ini akan disebut sebagai . kunjungi [Proses Settlement](docId\:l04EuP_s604Oi2Ib3x_y6) untuk lebih lanjut. *** ### Berapa lama waktu yang dibutuhkan untuk melakukan proses Settlement QRIS? H+2 pada hari kerja. *** ### Apakah pembayaran dengan QRIS terdapat proses ***refund ***pada Merchant Back Office? [Merchant Back Office](docId\:VMD8YtiiJqku6H8dRhcS6) tidak menyediakan *refund* untuk dengan . Saat ini untuk melakukan *refund *hanya bisa dilakukan menggunakan disediakan oleh untuk . Apabila ada *refund*, dapat melakukan *refund *dengan menghubungi atau terkait untuk melakukan *refund*. *** ### Mengapa proses ***refund*** dapat gagal? - Pengajuan *refund *ditolak oleh . - Pengajuan *refund *tidak sesuai dengan ketentuan . *** ### Bagaimana cara Merchant mendapatkan `shopId` sebelum melanjutkan proses ***test production***? dapat konfirmasi ke PIC MA atau IT Integrator terkait. *** ### Berapa lama batas waktu pembayaran QRIS? *Default* 5 menit batas waktu bayar . *** ### Apakah API Checkout ***support*** QRIS? Untuk saat ini belum *support* . **** [title] Alfa Group [path] Payment/Convenience Store (CVS)/Panduan Bayar CVS (cloned with children)/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/qNM6qarRqVzObGfKKgQXu_1.png "Alfa Group") ## Informasi Nomor Pembayaran *** :::hint{type="info"} Pastikan melakukan sebelum masa berlaku habis dan bayar dengan nominal tepat. ::: | **Nomor Pembayaran** | `123456789012XXXX` | | --------------------- | -------------------------- | | **Convenience Store** | ALFAMART | | **Nominal** | Rp10.000 | | **Nama Penerima** | `billingNm` | | **Nomor Pemesanan** | Invoice-1234 | | **Masa Berlaku** | 20-09-2027 / 17:15:00 | # Pembayaran *** Cara : 1. melalui `Alfamart / Alfamidi / Dan+Dan / Lawson`. 2. Catat atau cetak `Kode Pembayaran`. 3. Bawa `Kode Pembayaran` tersebut ke gerai `Alfamart / Alfamidi / Dan+Dan / Lawson`. 4. Informasikan kepada kasir menggunakan `NICEPAY` + `Nama Merchant`. 5. Berikan `Kode Pembayaran` ke kasir. 6. Kasir akan memasukkan `Kode Pembayaran`. 7. Bayar sesuai `Nominal`. 8. Ambil `Tanda Terima Pembayaran`. 9. Selesai. file format JSON Panduan Bayar Alfa Group untuk operasi . ::File{src="https://archbee-doc-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/Yi7vRyDuqMSqf8_wOdFZY_cvsindalfa.json" label="CVS_IND_ALFA.json"} [title] Panduan Bayar E-Wallet [path] Payment/E-Wallet/ ::::LinkArray :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/zzVXu5xP5ypFCYKosVS29_astrapay1.png"} [AstraPay](docId:48xYDVsBINbWZIceojDfP) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/NIqZp60cRJfl7wKsNRWNt_dana1.png"} [DANA](docId:2RYDwghQPFO3Mm-UwRwY7) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/xrcE0f8RzriDswSJIUGiN_linkaja1.png"} [LinkAja](docId:2oPv-pL-Xl5Nx8qVxOZKH) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/KT8sPbJo6akhpXRh0LY24_ovo2.png"} [OVO](docId\:RpDvMdxJqc3oi8WkNRDZP) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/0ec58T6B70htAC2zX25se_shopeepay2.png"} [ShopeePay](docId\:qraFmx8p3zNBrQ9UDhPwU) ::: :::: # See also ::::VerticalSplit :::VerticalSplitItem [Panduan Bayar CVS](docId:_dY8vW1ygeXkx0NQ0J4GB) untuk mengetahui cara membayar menggunakan . ::: :::VerticalSplitItem [Panduan Bayar Payloan](docId\:KMa4n6iBgx27LMi_OafvW) untuk mengetahui cara membayar menggunakan . ::: :::: ::::VerticalSplit :::VerticalSplitItem [Panduan Bayar QRIS](docId\:og8vGEkiCoG9mupWHrrJ0) untuk mengetahui cara membayar menggunakan . ::: :::VerticalSplitItem Daftar pembaharuan *log* panduan bayar dapat dilihat pada [Release Information - Panduan Bayar](docId\:oBJOho15Y6-A0JVj4JODP). ::: :::: [title] Fitur E-Wallet [path] Payment/E-Wallet/ # E-Wallet Subscription *** Fitur hanya terdapat pada aplikasi DANA ini memudahkan para Pengguna untuk membayar tagihan secara berkala pada waktu tertentu (*recurring*) kepada menggunakan fitur ini. hanya perlu menyediakan cukup pada akun DANA-nya dan jumlah tagihan akan ditarik secara otomatis pada waktu tentukan. :::hint{type="warning"} Jika penarikan dana gagal, aplikasi akan memberikan melalui email atau pada aplikasi untuk segera melakukan penambahan untuk melanjutkan langganan . ::: :::hint{type="danger"} Jika penambahan dana tidak dilakukan hingga batas waktu ditentukan, maka langganan otomatis berakhir. ::: # See also ::::VerticalSplit :::VerticalSplitItem [Alur Pembayaran E-Wallet](docId\:saeozIsJLLCkE5s4QVnHw) untuk mengetahui pada saat melakukan dengan . ::: :::VerticalSplitItem [Integrasi & Testing E-Wallet](docId\:b9HPduhC2MPMLaLHIjCbO) untuk mengetahui cara dan uji coba . ::: :::: ::::VerticalSplit :::VerticalSplitItem [Daftar Istilah E-Wallet](docId\:RtyOOpERogK7_PImzLfth) untuk mengetahui istilah khusus digunakan oleh . ::: :::VerticalSplitItem [FAQ E-Wallet](docId\:QyuY2tdI299dVSNUt9G-1) jika ingin mengetahui pertanyaan sering diajukan terkait . ::: :::: [title] Integrasi & Testing QRIS [path] Payment/QRIS/ digunakan dalam dan berasal dari ShopeePay. Akan tetapi, ShopeePay juga dapat menerima dari lain, seperti OVO, DANA, LinkAja, dan *Mobile Banking * dapat melakukan dengan QR. # Urutan Integrasi API yang digunakan *** 1. Lakukan Order Registration. - SNAP: [Registration - API QRIS SNAP](docId\:n42BapM1t1eOiXNS-RA_d). - Redirect: [QRIS - API Checkout](docId\:YkjkZcCCOAmIwfmgMuVvI). 2. Menerima *callback *dan *push notification *dari . 3. Lakukan Status Inquiry. - SNAP: [Check Status Transaction - API QRIS SNAP](docId:3aXWe6p6cyHX_ZuN-bvgQ). - Redirect: [Status Inquiry - API Checkout](docId\:K9vBS87ev9_w5oJAU0et3). 4. Opsional: lakukan Cancel untuk membatalkan . - SNAP: [Refund Transaction - API QRIS SNAP](docId\:U1UpkNC78XEyuHGD4CxPD). - Redirect: [Cancel - API Checkout](docId\:MMmlusWDkyUsJxF421yKn). # Kredensial Untuk Tes QRIS *** | **Nama QRIS** | **Deskripsi** | | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ShopeePay | [APK Shopee ](https://drive.google.com/file/d/1gGE2-7OpBWXoz_KF7Kl0IThWtnAaQjCe/view)\| [APK ShopeePay](https://drive.google.com/file/d/13cYsNzcmoJwe4fiLjnrmhAT0Uc94w81K/view)**
Username: nicepaytest01
Password: NicepayTest01
ShopeePay PIN: 142536 | :::hint{type="info"} wajib melakukan Whitelist IP pada perangkat digunakan untuk uji coba melalui aplikasi ShopeePay atau Shopee. hubungi Tim Integrasi untuk lebih lanjut. ::: # Cara Uji Coba QRIS *** | **Nama QRIS** | **Langkah Tes** | **Aturan dan Kondisi** | | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | ShopeePay | 1. Menggunakan `iMid` asli atau Sandbox dengan `iMid = IONPAYTEST`. 2. Mengunduh aplikasi ShopeePay khusus untuk uji coba pada *Development Environment *atau aplikasi asli Shopee untuk uji coba pada *Staging/Production Environment.* 3. Memindai kode QR dan melakukan autentikasi untuk . 4. Mengumpulkan dan melanjutkan hingga berhasil. | Untuk kode QR:
* Aturan *default *batas waktu untuk `paymentExpTm` = 5 menit. * Jangka waktu pengaturan untuk `paymentExpTm` mulai dari 5 menit hingga 20 menit.

Untuk kondisi pembatalan , antara lain:
* Pembatalan sebelum akan menunjukkan kedaluwarsa atau tidak berlaku dengan `5`. * Pengembalian dana secara daring hanya dapat dilakukan sebelum dibuat mencapai 365 hari. * Proses pembatalan tidak dapat dilakukan pada pukul 00:00 - 05:00 WIB. * Transaksi *Off-Us *dapat melakukan pengembalian dana secara daring sebelum dibuat mencapai waktu 7 hari. Jika sudah lebih dari 7 hari, tetapi belum mencapai 365 hari, maka akan dialihkan menjadi **Manual Refund**. | **** # Alasan Peluang Transaksi Gagal *** 1. Salah memindai kode QR pada aplikasi ShopeePay. 2. Pesanan tidak sesuai. 3. Transaksi sudah kedaluwarsa. # Integration Checklist dan Test Case *** - [ ] Implementasi inquiry setelah mendapatkan *callback.* - [ ] Implementasi inquiry setelah mendapatkan di dalam `dbProcessUrl`. - [ ] Meninjau *log* . - [ ] Meninjau pengaturan *firewall* (eg. *Cloudflare* untuk pengaturan `dbprocessUrl`). - [ ] Memeriksa implementasi `merchantToken`. - [ ] Menjalankan tes skenario pada *Development* *Environment.* - [ ] Menjalankan tes skenario pada *Production Environment.* [Get Sample Scenario](https://docs.google.com/spreadsheets/d/e/2PACX-1vQIaIMCM0vZ3L1cA-JkW3YxyIpjsB966fg1wTeT8qpFDowEvulIEWOoY6I4uJPL3A/pub?output=xlsx) - [ ] Meninjau *Error Handling* (*Timeout, Failed, Negative Case*). # Best Practice *** - Untuk uji coba , dapat menggunakan `iMid = IONPAYTEST` dan pasang parameter `shopId = NICEPAY`. - Dukungan untuk pembatalan secara penuh dapat melalui kode tautan `cancelType`. - Ketika diterima pada `dbProcessUrl` , sangat merekomendasikan untuk melakukan verifikasi menggunakan Inquiry . - `Notification Handling` berguna untuk meminimalisir aksi *Fraud*, sangat merekomendasikan untuk melakukan verifikasi `Notification Handling`. # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Alur Pembayaran QRIS](docId\:m-HeeKLNLzY1G1thlaKy-) untuk mengetahui pada saat melakukan dengan . ::: :::VerticalSplitItem [Tipe QRIS](docId\:yxX3p9Itvvu6qTepCfjbU) untuk mengetahui jenis digunakan pada . ::: :::: ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Daftar Istilah QRIS](docId:6BFA6ymPlc8HEHi6jXRO2) untuk mengetahui istilah khusus digunakan oleh . ::: :::VerticalSplitItem [FAQ QRIS](docId\:AHrsQb4knslavXU-aBiF4) jika ingin mengetahui pertanyaan yang sering diajukan terkait QRIS. ::: :::: [title] FAQ GPN [path] Payment/GPN/ ### Apa perbedaan pembayaran dengan kartu berlogo GPN dan Kartu Kredit lain? Kartu berlogo hanya dapat digunakan untuk dalam negeri saja. Sedangkan, lain bekerja sama dengan American Express, Mastercard, VISA, dan JCB, sehingga dapat digunakan untuk dalam dan luar negeri. kunjungi [Kartu Kredit](docId:1pHQ_XU3Dpep4hzX41lqg) untuk lebih lanjut terkait . *** ### Mengapa transaksi menggunakan kartu GPN dapat gagal? 1. Kartu tidak aktif atau sudah kedaluwarsa. 2. Nomor kartu tidak berlaku. 3. Masa kedaluwarsa kartu tidak berlaku. 4. CVV pada kartu tidak berlaku. 5. Tidak didukung oleh jaringan *Issuer.* 6. Sudah mencapai batas kartu harian. *** ### Bagaimana cara Merchant mengecek transaksi yang sudah berhasil dibayarkan dengan kartu GPN? dapat melihat riwayat dalam jangka waktu tertentu melalui [Merchant Back Office](docId\:VMD8YtiiJqku6H8dRhcS6) pada: - Menu [Transaction Data](docId\:iZwosih8r9HIc0UurgYMa) untuk memeriksa seluruh data , atau - Menu [Fail Transaction](docId\:Kw36Cm_cK3RzRNUHfzavQ) untuk memeriksa data gagal. *** ### Apa yang dimaksud dengan Settlement? adalah pembukuan suatu & pemindahan dana dari lembaga finansial ( atau ) ke suatu individu atau perusahaan dalam kasus ini akan disebut sebaga . kunjungi [Proses Settlement](docId\:l04EuP_s604Oi2Ib3x_y6) untuk lebih lanjut. *** ### Berapa lama waktu yang dibutuhkan untuk melakukan proses Settlement kartu GPN? H+3 pada hari kerja. *** ### Apakah pembayaran dengan kartu GPN terdapat proses ***Refund ***pada Merchant Back Office? [Merchant Back Office](docId\:VMD8YtiiJqku6H8dRhcS6) tidak menyediakan *refund *untuk dengan . dapat melakukan *refund *dengan menghubungi atau terkait untuk melakukan *refund.* *** ### Mengapa Pelanggan belum menerima ***Refund***? Waktu *refund * mengikuti waktu sudah ditentukan oleh ([Penyelesaian Transaksi Pada GPN](docId:0lY8aeJpdvnOGEnJVLj7u)). Apabila masih belum menerima *refund *setelah melewati ketentuan waktu, silakan hubungi terkait. *** ### Mengapa proses ***Refund*** dapat gagal? - Pengajuan *Refund *ditolak oleh . - Pengajuan *Refund *tidak sesuai dengan ketentuan . [title] E-Wallet [path] Payment/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/juKz8QyM_Qlq2kkzNxDD4_header-23.png "Mitra E-Wallet") # Tentang E-Wallet *** Dompet digital atau lebih dikenal dengan **E-Wallet** adalah sebuah elektronik berupa digital menggunakan perangkat modern, seperti laptop atau umumnya ponsel untuk melakukan tanpa menggunakan kartu maupun uang tunai. Layanan ini dapat digunakan oleh semua segmen masyarakat karena lebih efisien dalam melakukan dan dapat diakses lebih mudah tanpa perlu membuat rekening terlebih dahulu. # Daftar E-Wallet yang Bekerja Sama Dengan NICEPAY *** bekerja sama dengan beberapa pihak penyedia untuk memudahkan dalam bertransaksi dan mendapatkan lebih banyak . Berikut adalah daftar sudah bekerja sama dengan . | **No** | **E-Wallet Service Name** | | ------ | ------------------------- | | 1 | OVO | | 2 | DANA | | 3 | ShopeePay | | 4 | LinkAja | | 5 | AstraPay | # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [API E-Wallet (Direct Debit) SNAP](docId:24TJozvWeUtfoWWb2WN94) untuk mengetahui rincian digunakan pada . ::: :::VerticalSplitItem ::: :::: [title] AstraPay [path] Payment/E-Wallet/Panduan Bayar E-Wallet/ ::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/kW6mRgDYmXhLJ5FvgcdMV_astrapay.png" size="50" width="3631" height="883" caption="AstraPay" position="center" showCaption="true"} # Informasi Nomor Pembayaran *** :::hint{type="info"} Pastikan Akun AstraPay sudah terhubung dengan . ::: | **Nomor Seluler** | `082-1851-XXX-XX` | | ------------------------ | -------------------------- | | **Mitra E-Wallet** | AstraPay | | **Nominal** | Rp10.000 | | **Nama Penerima ** | `billingNm` | | **Nomor Pemesanan ** | Invoice-1234 | | **Masa Berlaku ** | 20-09-2027 / 17:15:00 | # Pembayaran *** ## AstraPay Application Cara Pembayaran: 1. Pastikan akun `AstraPay` sudah terhubung dengan `NICEPAY`. 2. melalui `AstraPay`. 3. akan dipindahkan ke `AstraPay`. 4. Pastikan `Saldo AstraPay` mencukupi. 5. `Bayar` dan masukkan PIN `AstraPay` . 6. Pembayaran berhasil! akan dipindahkan ke *result* *page*. file format JSON Panduan Bayar AstraPay untuk operasi . ::File{src="https://archbee-doc-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/MaN6svoKGAWRXo4yMmw0n_ewalletindastra.json" label="EWALLET_IND_ASTRA.json"} # Registration ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/5jsZRSWfbvCLyRyFSApHq_astrapay-1.png "Panduan Registrasi - AstraPay 1") ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/R26SMBaRS6FppyIeEmeIx_6.png "Panduan Registrasi - AstraPay 2") *** # Payment ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/OYzK7FvA8SfEva_9LeBZ5_background-template-panduan-bayar-8.png "Panduan Bayar - AstraPay") *** [title] Daftar Istilah QRIS [path] Payment/QRIS/ # QRIS *Quick Response Code Indonesia Standard *adalah standar kode QR digunakan untuk semua QR di . # Mitra QRIS Pihak menerbitkan agar bisa digunakan oleh , , dan pihak lain bersangkutan. # NMID Nomor ID dikeluarkan oleh pihak *Acquiring *dan terdapat pada QR MPM. # SATU QRIS UNTUK SEMUA Slogan terdapat pada QR MPM. # PJSP Perusahaan Penyelenggara Jasa Sistem Pembayaran. # Kode NNS *National Number System*, 8 digit angka untuk mengidentifikasikan pihak mengeluarkan CPAN terdapat pada QR MPM. # CPAN *Consumer Primary Account Number*, nomor kartu untuk melakukan dikeluarkan oleh pihak *Issuing * terdapat pada QR MPM. # See also ::::VerticalSplit :::VerticalSplitItem [Alur Pembayaran QRIS](docId\:m-HeeKLNLzY1G1thlaKy-) untuk mengetahui pada saat melakukan dengan . ::: :::VerticalSplitItem [Tipe QRIS](docId\:yxX3p9Itvvu6qTepCfjbU) untuk mengetahui jenis digunakan pada . ::: :::: ::::VerticalSplit :::VerticalSplitItem [Integrasi & Testing QRIS](docId\:tCFbU7--Xd0Sm5_rQ00_w) untuk mengetahui cara dan uji coba . ::: :::VerticalSplitItem [FAQ QRIS](docId\:AHrsQb4knslavXU-aBiF4) jika ingin mengetahui pertanyaan sering diajukan terkait . ::: :::: [title] Model Bisnis dan Biaya QRIS [path] Payment/QRIS/ # Model Bisnis *** hadir sebagai salah satu cepat dan aman dengan menggunakan cara memindai kode QR melalui aplikasi atau Perbankan dimiliki oleh *Acquiring*. Metode ini memudahkan para untuk bertransaksi menggunakan aplikasi ponsel, sehingga dapat menerima dari seluruh pihak maupun Non- (). mampu menjangkau semua lapisan masyarakat ; baik dari sisi Pengusaha mikro hingga besar dan dari berbagai latar belakang ekonomi. Metode ini juga membantu Pemerintah untuk mengayomi masyarakat tidak memiliki akun untuk turut aktif dalam melakukan digital. memiliki standarisasi dari para regulator baik sehingga individu atau institusi melakukan investasi pada ini mendapatkan hasil baik. # Biaya Untuk Menggunakan QRIS *** :::hint{type="info"} kunjungi [Produk & Biaya Layanan](docId:2deQYlDf8Az72oHGYaV7_) untuk lebih lanjut. ::: ## Sisi Pelanggan tidak dikenakan biaya tambahan setiap melakukan dengan . Minimal nominal mulai dari Rp1 – Rp1.000. ## Sisi Merchant dapat mendaftarkan diri kepada pihak *Acquiring*, baik maupun Non-, untuk menggunakan . Biaya pembuatan berbeda-beda untuk masing-masing *Acquiring*. Untuk lanjut terkait biaya pengajuan, dapat menghubungi pihak *Acquiring* terkait. dapat bekerja sama dengan untuk menggunakan dari berbagai *Acquiring* dalam satu sudah terintegrasi dengan baik. Sehingga, tidak perlu menghubungi banyak pihak dalam menggunakan ini. # See also ::::VerticalSplit :::VerticalSplitItem [Penyelesaian Transaksi Pada QRIS](docId\:CyS-JVEzpPGTtYy62XdcB) untuk mengetahui macam-macam cara menyelesaikan . ::: :::VerticalSplitItem [Aturan dan Limitasi QRIS](docId\:hKHhPw79NNP7hBJM8R9-v) untuk mengetahui ketentuan khusus . ::: :::: ::::VerticalSplit :::VerticalSplitItem [Daftar Istilah QRIS](docId:6BFA6ymPlc8HEHi6jXRO2) untuk mengetahui istilah khusus digunakan oleh . ::: :::VerticalSplitItem [FAQ QRIS](docId\:AHrsQb4knslavXU-aBiF4) jika ingin mengetahui pertanyaan sering diajukan terkait . ::: :::: [title] Integrasi & Testing CVS [path] Payment/Convenience Store (CVS)/ # Langkah Integrasi & API yang digunakan *** 1. Lakukan Call Transaction Registration. - Direct: [Registration - API Convenience Store](docId\:p4bRL6dsnS-wppv5hFuLU). - Redirect: [Convenience Store - API Checkout](docId:18WjzOk7UMtB1vuL_hFsi). 2. Menerima *callback *dan *push notification *dari . 3. Lakukan Status Inquiry. - Direct: [Status Inquiry - API Convenience Store](docId\:WMITrWcw3j9ChajRg-o1D). - Redirect: [Status Inquiry - API Checkout](docId\:K9vBS87ev9_w5oJAU0et3). 4. Opsional: lakukan Cancel untuk membatalkan . - Direct: [Cancel - API Convenience Store](docId\:L-DtvJzQTenDps30WbyMC). - Redirect: [Cancel - API Checkout](docId\:MMmlusWDkyUsJxF421yKn). # Cara Uji Coba CVS *** | **Langkah Tes** | **Aturan dan Kondisi** | | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 1. Menggunakan MID atau MID sandbox (`IONPAYTEST`) AutoPaid. 2. Membuat pendaftaran (CVS). 3. Catat atau cetak `payment code`. 4. Membawa `payment code` menuju Indomaret atau Alfamart / Alfamidi / Dan+Dan / Lawson. 5. Memeriksa inquiry* payment *. 6. Membayar sesuai dengan nominal tercantum. 7. Ambil *payment* *receipt* . 8. Transaksi berhasil. 9. Periksa (`dbProcessUrl`) . | 1) Memberitahu kasir ada dibuat menggunakan + nama . 2) CVS bisa dibatalkan dan dikembalikan setelah , tetapi hanya bisa dilakukan secara manual atau masa berlaku nomor `payNo` sudah berakhir. Tidak bisa dilakukan melalui . 3) Nomor (`payNo`) dapat kedaluwarsa secara *default* dalam hari ke-7 tetapi juga bergantung pada preferensi , pengaturan dapat disesuaikan ( paling umum adalah 24 jam, 3 hari, dsb). 4) Ketentuan berdasarkan CVS: - Alfamart & Alfamidi: tidak bisa dilakukan setelah pukul 10 malam dan dapat digunakan kembali setelah pukul 1 pagi pada hari berikutnya. - Indomaret: tidak bisa dilakukan setelah jam 11 malam dan dapat digunakan kembali setelah pukul 1 pagi pada hari berikutnya. | # Alasan Peluang Transaksi Gagal *** 1. Salah memasukkan `payNo`. 2. `payNo` sudah kedaluwarsa atau tidak berlaku. 3. Ditolak dari . # Integration Checklist dan Test Case *** - [ ] Implementasi inquiry setelah mendapatkan *callback.* - [ ] Implementasi inquiry setelah mendapatkan di dalam `dbProcessUrl`. - [ ] Meninjau *log* . - [ ] Meninjau pengaturan *firewall* (eg. *cloudflare* untuk pengaturan `dbprocessUrl`) - [ ] Memeriksa implementasi `merchantToken`. - [ ] Menjalankan tes skenario pada *Development Environment.* - [ ] Menjalankan tes skenario pada *Production Environment.* [Get Sample Scenario](https://docs.google.com/spreadsheets/d/e/2PACX-1vQIaIMCM0vZ3L1cA-JkW3YxyIpjsB966fg1wTeT8qpFDowEvulIEWOoY6I4uJPL3A/pub?output=xlsx) - [ ] Meninjau *Error Handling* (*Timeout, Failed, Negative Case*) # Best Practice *** - `payValidDt` dan `payValidTm` digunakan untuk *set *batas waktu bayar pada menggunakan tersebut. - Ketika diterima pada `dbProcessUrl` , sangat merekomendasikan untuk melakukan verifikasi menggunakan Inquiry &#xNAN;*.* - `Notification Handling` berguna untuk meminimalisir aksi *Fraud, * sangat merekomendasikan untuk melakukan verifikasi `Notification Handling`*.* # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Alur Pembayaran CVS](docId\:Qb3J_IzkOf9DEI_8Zk32W) untuk mengetahui pada saat melakukan dengan . ::: :::VerticalSplitItem [Fitur CVS](docId\:iWIQWotO0vYXaBnkseJEA) untuk mengetahui fitur pada . ::: :::: ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Daftar Istilah CVS](docId:-M-nZrtY-prU0aJjTYj9g) untuk mengetahui istilah khusus digunakan oleh . ::: :::VerticalSplitItem [FAQ CVS](docId\:Bf4kvuVF_blHBxysENnWn) jika ingin mengetahui pertanyaan sering diajukan terkait . ::: :::: [title] QRIS [path] Payment/ ::Image[]{src="https://api.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/OSDdzirHKldqsU2VLBdRK-20260121-064214.jpg" size="82" width="500" height="200" position="center" caption="Logo QRIS" alt="Logo QRIS" darkWidth="500" darkHeight="200" showCaption="true"} # Tentang QRIS *** **Quick Response Code Indonesia Standard** atau lebih dikenal dengan adalah sebuah digital dengan standar kode QR Nasional dengan menyatukan berbagai macam QR dari berbagai Penyelenggara Jasa Sistem Pembayaran (PJSP) dapat digunakan oleh masyarakat dalam melakukan sehari-hari. Sistem diluncurkan oleh **Bank Indonesia dan Asosiasi Sistem Pembayaran Indonesia (ASPI)** pada 17 Agustus 2019 ini menjadi *trend* baru dalam *cashless *pasca pandemi COVID-19 berakhir. Untuk mengikuti perkembangan teknologi semakin canggih, cepat, dan dinamis, menyediakan dapat digunakan melalui PJSP ( dan Non-) sudah terdaftar di ASPI. Dengan hanya menggunakan satu kode QR, akan diberikan kemudahan untuk memilih berbagai macam aplikasi akan digunakan untuk bertransaksi dengan . Dengan mengaktifkan di , dapat menerima *cashless* melalui . Kode QR akan tampil pada aplikasi ataupun *website* dapat digunakan langsung oleh untuk dibayarkan oleh dengan cara memindai dengan aplikasi /. Setelah berhasil, akan menerima secara *real-time* berisi rincian dan tersimpan dalam riwayat pada aplikasi / digunakan. # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [API QRIS SNAP](docId:2fWhBt1oPDQeRmQJBODlU) untuk mengetahui rincian digunakan pada . ::: :::VerticalSplitItem ::: :::: [title] Bank BSI [path] Payment/Virtual Account (VA)/Panduan Bayar VA/ ![Bank BSI](https://api.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/SA0KSbJ5_1m2uhWmtVlKZ-20260309-074423.png "Bank BSI") :::hint{type="info"} Pastikan melakukan transfer dana sebelum masa berlaku habis dan dengan nominal tepat. ::: | **Nomor Virtual Account** | `1749XXXXXXXXXXXX` | | ------------------------- | --------------------------- | | **Bank** | BSI | | **Nominal** | Rp10.000 | | **Nama Penerima** | `Merchant Name - billingNm` | | **Nomor Order** | Invoice-1234 | | **Masa Berlaku** | 16-06-2016 / 17:15:00 | file format JSON Panduan Bayar Bank BSI untuk operasi . ::File{src="https://archbee-doc-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/rW3F1jwxklRsYNH5WQzHg-20260313-083246.json" label="VA_IND_BSI.json"} # ATM *** 1. kartu `ATM` dan `PIN` . 2. `Tarik Tunai/Transaksi Lainnya`. 3. `Main Menu`. 4. `Pembayaran/Pembelian`. 5. `4 Digit Kode Biller + Nomor Virtual Account/Nomor Bayar`, lalu pilih `Lanjut` jika sudah sesuai. 6. Layar akan menampilkan validasi tagihan, pilih `Benar` jika sudah sesuai. 7. Selesai. # Mobile Banking *** 1. Akses aplikasi `BYOND by BSI`. 2. `Bayar & Beli`. 3. fitur `Akademik/Lembaga/PDAM/Angsuran/Asuransi/IPL-Properti`. 4. `NICEPAY 1749` pada bagian pencarian. 5. `Nomor Virtual Account/Nomor Bayar` **tanpa 4 digit awal (**`1749`**)**. 6. Layar akan menampilkan validasi tagihan. 7. `Konfirmasi` dan masukkan `PIN` . 8. Selesai. # Non-BSI Mobile Banking & E-Wallet *** 1. `Transfer`. 2. `Bank Syariah Indonesia` sebagai nama penerima. 3. nomor rekening penerima dengan format `900 + 4 Digit Kode Biller + Nomor Virtual Account/Nomor Bayar`. 4. `Lanjutkan`. 5. `Nominal`. 6. metode transfer `Transfer Online Rp6.500` (bukan BI Fast, SKN, atau RTGS). 7. Layar akan menampilkan validasi tagihan, lalu klik `Selanjutnya`. 8. `PIN` . 9. Selesai. [title] Integrasi & Testing GPN [path] Payment/GPN/ # Langkah Integrasi & API yang digunakan *** 1. Lakukan Order Registration. - Direct: [Registration - API GPN](docId\:eO11RylC9Mj5bFM2oMWfM). - Redirect: [GPN - API Checkout](docId:8_77Hv9V9v1Wi9njED2a4). 2. Lakukan Charge. - Direct: [Payment - API GPN](docId\:bdPMTihmuf7P9W6KhQDoJ). - Redirect: [Payment - API Checkout](docId\:YnNFZr9aonpJ7ZIKAFYSx). 3. Menerima *callback *dan *push notification *dari . 4. Lakukan Status Inquiry. - Direct: [Status Inquiry - API GPN](docId\:XF3Gyd2RzjUw2VPCiT0L9). - Redirect: [Status Inquiry - API Checkout](docId\:K9vBS87ev9_w5oJAU0et3). 5. Opsional: lakukan Cancel untuk membatalkan . - Direct: [Cancel - API GPN](docId\:yif3ys7qvm1sjxvw9TfmH). - Redirect: [Cancel - API Checkout](docId\:MMmlusWDkyUsJxF421yKn). # Cara Uji Coba GPN *** | **Langkah Tes** | **Aturan dan Kondisi** | | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | | 1. Menggunakan kartu asli atau kartu *dummy *mulai `45xxxx` atau `54xxxxx`. 2. kartu kepada sisi di bawah pilihan "*Credit Card/Debit Card*". - 16 digit nomor kartu. - *expiry date *(`MM/YY`). - CVV. 3. Kumpulkan dan lanjutkan dan berhasil. | Kode : `09`

Tipe :
* *Full Payment*: sekali jalan. * *Recurring Payment*: berkala dengan token. | # Alasan Peluang Transaksi Gagal *** 1. Kartu tidak aktif atau sudah kedaluwarsa. 2. Nomor kartu tidak berlaku. 3. Masa kedaluwarsa kartu tidak berlaku. 4. CVV pada kartu tidak berlaku. 5. Tidak didukung oleh jaringan *Issuer. * 6. Sudah mencapai batas kartu harian. # Integration Checklist & Test Case *** - [ ] Implementasi status inquiry setelah mendapatkan *callback.* - [ ] Implementasi status inquiry setelah mendapatkan di dalam `dbProcessUrl`. - [ ] Meninjau *log* . - [ ] Meninjau pengaturan firewall (eg. *Cloudflare* untuk pengaturan `dbprocessUrl`). - [ ] Memeriksa implementasi `merchantToken`. - [ ] Menjalankan tes skenario pada *Development Environment.* - [ ] Menjalankan tes skenario pada *Production Environment.* [Get Sample Scenario](https://docs.google.com/spreadsheets/d/e/2PACX-1vQIaIMCM0vZ3L1cA-JkW3YxyIpjsB966fg1wTeT8qpFDowEvulIEWOoY6I4uJPL3A/pub?output=xlsx) - [ ] Meninjau *Error Handling* (*Timeout, Failed, Negative Case*). # Best Practice *** - Untuk uji coba dapat memasang `recurrOpt` *automatic* pada Cancel ([Recurring Type Code](docId:7huicmz14lpUcQs_mVmFs)). - Cancel pada mendukung untuk membatalkan penuh dan sebagian ([Cancel Type Code](docId\:Mq9xE7wdOPR8OkZ3v-pVc)). - Ketika diterima pada `dbProcessUrl` , sangat merekomendasikan untuk melakukan verifikasi menggunakan Inquiry . - `Notification Handling` berguna untuk meminimalisir aksi *Fraud*, sangat merekomendasikan untuk melakukan verifikasi `Notification Handling`. # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Alur Pembayaran GPN](docId\:ghiIyFFMv_ABDqf4cCF5Q) untuk mengetahui pada saat melakukan dengan . ::: :::VerticalSplitItem [Tipe Metode Pembayaran GPN](docId\:kEYekPeYstONiu2iJQVM0) untuk mengetahui jenis saat menggunakan kartu . ::: :::: ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Daftar Istilah GPN](docId\:QrpRszpmgc7DERhBS8nWQ) untuk mengetahui istilah khusus digunakan . ::: :::VerticalSplitItem [FAQ GPN](docId:38L5TBCuVolwnrv_C65Ft) jika ingin mengetahui pertanyaan sering diajukan terkait . ::: :::: [title] Kustomisasi Halaman Pembayaran [path] Checkout/ ![Default Payment Page](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/ohh_r6otn4iPQSs_4RfL1_image-id-nicepay-secure-payment-page-main-dashboard.jpg "Default Payment Page") menyediakan fitur kustomisasi untuk produk Checkout sehingga dapat menyesuaikan sesuai dengan identitas brand; termasuk logo, berbagai komponen desain dan warna. ::::hint{type="info"} :::Iframe{iframeHeight="0" code="Silakan menghubungi Tim Sales dan Tim Integrasi NICEPAY untuk informasi lebih lanjut."} ::: :::: ![Custom Payment Page - Desktop Version](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/BP6jD0BE3OYqsb7zS3ZvB_image-id-custom-payment-page-desktop-version.jpg "Custom Payment Page - Desktop Version") ![Custom Payment Page - Mobile Version](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/velapIm5cUrBT-MpMhzw9_image-id-custom-payment-page-mobile-version.jpg "Custom Payment Page - Mobile Version") [title] Checkout [path] / ![Checkout](https://api.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/FrwNeXLU3XHWSld0-SW6R_checkout.jpg "Checkout") **Checkout** merupakan memungkinkan untuk dapat membayar dengan menggunakan *payment page* dari . Dengan demikian, pun tidak perlu membuat *payment page* rumit untuk dapat menjalankan dengan . Percayakan tersebut kepada , maka dengan pun akan lancar, cepat, dan aman. ![NICEPAY Payment Page](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/ohh_r6otn4iPQSs_4RfL1_image-id-nicepay-secure-payment-page-main-dashboard.jpg "NICEPAY Payment Page") Selain itu, Halaman Pembayaran dibuka melalui tautan pada perangkat *mobile* kini tersedia tampilan khusus untuk meningkatkan pengalaman lebih jelas dan responsif*.* ![Payment Page - Mobile Version](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/iaExy_g8wXlo0ZoeV9jnO_image-id-halaman-pembayaran-mobile.jpg "Payment Page - Mobile Version") :::hint{type="info"} adalah istilah baru untuk Redirect/Professional. ::: :::hint{type="success"} kunjungi halaman [Payment Link](docId\:ChpAc7d9l0s9A8mai3itC) untuk mengetahui informasi lebih lanjut terkait *non-code checkout page integration *atau halaman [API Checkout](docId\:Djp90D-rlCNeDCzKwGC-d) untuk melihat lengkap terkait teknikal dan daftar tautan pada setiap yang tersedia pada layanan Checkout milik . ::: | **Metode Pembayaran** | **Tautan** | | --------------------- | ------------------------------------------------------- | | | [Kartu Kredit](docId:1pHQ_XU3Dpep4hzX41lqg) | | | [Virtual Account (VA)](docId:9tV3ro3_Lj1f-guZ2gark) | | | [Convenience Store (CVS)](docId\:lyQ0ppG9p7aGo6vQwvTp5) | | | [Direct Debit](docId\:uNFXkAwzKTCzlss__2PUt) | | | [E-Wallet](docId\:iJbzxzkxCTRitCCMseIKB) | | | [Paylater](docId\:a7Zm1Frn9z7QiG0lc-Sr2) | | | [QRIS](docId\:KRBNuRjoReOW1YejZS3_Q) | # Demo Checkout Pelajari lebih lanjut melalui demo dengan menekan gambar di bawah ini. :::Iframe{iframeHeight="0" code=" "Demo "} ::: # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem Temukan penjelasan terkait dan kustomisasi pada [Payment](docId\:cN5a57Nq9RzMUjE9FDnWm). ::: :::VerticalSplitItem [NICEPAY API](docId:6qGtFCV3tHP1B_wS9zEqd) untuk mengetahui rincian terkait . ::: :::: [title] Alur Pengiriman Dana Payout [path] Payout/ # Disbursement ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/_XwpYsNmBNdBqKHl8y4cv_nicepay-archbee-payment-payout-2.png "Alur Pengiriman Dana Payout - Disbursement") Deskripsi langkah: 1. mengajukan data menggunakan Registration kepada . 2. mengumpulkan data. 3. melakukan *generate *TXID. 4. mengirim *response *berupa TXID kepada . 5. menyimpan TXID. 6. mengajukan akun kepada . 7. melakukan validasi akun. 8. mengirim *response *kepada . 9. menyimpan *response.* 10. mengirimkan data membutuhkan persetujuan menggunakan Approve kepada . 11. mengumpulkan data diajukan. 12. mengirimkan *response *sebagai *processing *kepada . 13. mengirimkan *batch process *kepada . 14. melakukan *Bank Process Payroll.* 15. mengirimkan *response *data kepada . 16. mendapatkan *response.* 17. mengirimkan pesan kepada . 18. mengajukan pemeriksaan data kepada . 19. mengirimkan pemeriksaan kepada . 20. melakukan *Bank Process Check.* 21. mengirim *response data *kepada . 22. mengirim *response data *kepada . 23. melakukan validasi . # Cashout ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/oqAZiC-OFxZjgPGkq0Ri4_nicepay-archbee-payment-flow-cashout-1.png "Alur Pengiriman Dana Payout - Cashout") Deskripsi langkah: 1. melakukan *checkout* kepada . 2. mengajukan pendaftaran kepada . 3. melakukan validasi untuk memeriksa ketersediaan . 4. membuat TXID dan memotong . 5. mengirimkan *response* kepada . 6. menerima *response* yang dikirimkan oleh . 7. meminta persetujuan kepada . 8. menyetujui kepada . 9. memeriksa dan melakukan *generate* token. 10. mengirimkan *response* kepada . 11. menampilkan token kepada . 12. mengirimkan token kepada kasir CVS. 13. Kasir CVS memasukkan token. 14. CVS mengajukan kepada . 15. melakukan validasi token. 16. mengirimkan *response* kepada CVS. 17. CVS mengirimkan *response*. 18. CVS mengirimkan uang kepada . 19. menerima uang. 20. CVS mengirimkan \{\{noti}} kepada . 21. melakukan validasi . 22. memeriksa dan memperbaharui . 23. mengirimkan kepada . 24. menerima . # See also ::::VerticalSplit :::VerticalSplitItem [Metode Payout](docId\:WBZdLVm1w_QrVjXtPZ_0J) untuk mengetahui metode pengiriman dana terdapat pada . ::: :::VerticalSplitItem [Integrasi & Testing Payout](docId\:LkYgPUsJyOVKICpo6yFHn) untuk mengetahui cara dan uji coba . ::: :::: [title] Metode Payout [path] Payout/ Metode ini memungkinkan untuk melakukan tarik tunai (Cashout) dengan jumlah antara 50 ribu sampai dengan 1 juta per di toko retail populer di Indonesia, yaitu Indomaret. Layanan Indomaret memiliki biaya sebesar Rp5.000 (lima ribu rupiah) tidak termasuk pajak. # Metode Pengiriman Uang (Disbursement) *** Pada metode ini dapat mengirimkan sejumlah dana ke Penerima dana dituju. :::hint{type="info"} Silakan kunjungi [Produk & Biaya Layanan](docId:2deQYlDf8Az72oHGYaV7_) untuk melihat daftar biaya metode pengiriman dana . ::: # Metode Penarikan Uang (Cashout) *** Hal ini membuat tidak perlu datang ke ATM untuk mengambil uang, sehingga akan meningkatkan kenyamanan dalam mengambil uang dari mereka miliki pada toko . # See also ::::VerticalSplit :::VerticalSplitItem [Alur Pengiriman Dana Payout](docId\:L6lK9U1KCOmS-8PJZ6i4a) untuk mengetahui pada . ::: :::VerticalSplitItem [Integrasi & Testing Payout](docId\:LkYgPUsJyOVKICpo6yFHn) untuk mengetahui cara dan uji coba . ::: :::: [title] Deposit Saldo [path] Operasi Bisnis/ # Overview *** wajib untuk melakukan deposit pada [Payout](docId:_tBoQGqS-T6sk-ziXQl55) dan [SMS](docId\:jNixDDXA2UQM43_-bEXmO) terlebih dahulu sebelum menggunakannya pada . Jika tidak mencukupi, maka tidak bisa menjalankan tersebut. ::::hint{type="warning"} Terdapat 2 cara untuk melakukan deposit pada , yakni: 1. Deposit melalui Top-Up VA. 2. Deposit melalui dana . Dana sudah dideposit dalam bisa ditarik kembali sesuai dengan syarat dan ketentuan berlaku sudah disetujui dalam PKS. Namun untuk , tersebut tidak bisa ditarik kembali dan memiliki waktu kedaluwarsa tergantung dari jangka waktu awal deposit dilakukan dan jumlah *amount* dideposit. :::Iframe{iframeHeight="0" code="Apabila Anda memiliki pertanyaan seputar deposit saldo Payout maupun SMS, silakan hubungi tim NICEPAY Customer Service."} ::: :::: # Cara Deposit Saldo Payout *** ## Melalui Top-Up VA ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/hjtY65pDU1bZonWX9MBzE_1.png "Cara Deposit Dana Payout") 1. Akses melalui tautan [https://bo.nicepay.co.id/logIn.do](https://bo.nicepay.co.id/logIn.do) . 2. [Merchant Data](docId:7IhkFtaIHOX62F21vl8Bq). 3. *tab* `Service Info - Payout`. 4. `View` untuk mengetahui biaya . 5. `Payout VA` untuk mengetahui nomor VA digunakan untuk melakukan penambahan . 6. Transfer dana melalui salah satu nomor VA tertera pada *pop-up * VA . 7. Dana akan berubah menjadi beberapa menit (maksimal 5 menit) setelah . 8. [Payout Balance](docId\:g9JdFsDXboWzf2TEHzkrC), lalu tekan `Search` untuk mengetahui terakhir dimiliki. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/hZfZpBECdlbb6szi6gKTi_2.png "Payout VA Tujuan") :::hint{type="info"} Nomor VA dapat diketahui setelah merchant menerima akses Merchant Back Office dan memiliki wewenang untuk melakukan . ::: ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/SdwfOJaARzZuBdo7DMkOF_3.png "Transaction - Payout Balance") ## Melalui Dana Settlement dapat melakukan top-up secara otomatis dengan melakukan konversi dana menjadi dana . Proses ini memudahkan para dalam melakukan deposit tanpa mengharuskan top-up secara manual melalui nomor VA. ::::hint{type="info"} :::Iframe{iframeHeight="0" code="Apabila Merchant tertarik untuk menggunakan dan mengaktifkan fitur ini, silakan menghubungi Tim Sales atau Tim Customer Service kami melalui e-mail."} ::: :::: # Cara Deposit Saldo SMS *** ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/jaQxqMNSdTuDvUs-GRC6o_service-sms-top-up-unduh-excel.png "SMS Top Up Registration") 1. Akses melalui tautan [https://bo.nicepay.co.id/logIn.do ](https://bo.nicepay.co.id/logIn.do). 2. `ID` dan `Email`. 3. [SMS Top Up](docId\:ubOKZmYWQRYzfqeK6lFeK) pada utama **Merchant Back Office**. 4. `Register Date`, lalu klik `Request Top Up`. 5. `provider` dan masukkan jumlah `token SMS` yang inginkan. 6. `Request`. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/AmmdqgQbP7IDXfDi5p4KT_service-sms-top-up-unduh-excel-1.png "Top Up Request SMS Top Up") 7\. `Search` pada tanggal `Register Date` untuk melakukan **Request Top Up Token SMS** dibuat. Lalu, akan dialihkan pada bagian **Search Result **. 8\. `Confirm Payment` untuk melanjutkan **Request Top Up Token SMS **. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/k7GQ_soxMcKbq5LfTAPgK_service-sms-top-up-payment-confirm.png "Confirmation Payment SMS Top Up") 9\. Halaman `Confirmation Payment` akan muncul dan menampilkan daftar beserta nomor . 10\. Lakukan pembayaran sesuai dengan diinginkan. :::Iframe{code="11. Kirim bukti pembayaran ke email NICEPAY Merchant Support setelah berhasil melakukan pembayaran." iframeHeight="0"} ::: 12\. **Request Top Up SMS Token** akan ditangani lebih lanjut oleh tim . ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/kroXnqvGTXzsAelWhOCZK_service-sms-top-up-payment-confirm-tf.jpg "Transfer Payment SMS Top Up ") :::hint{type="info"} juga dapat mempelajari lebih lengkap mengenai fitur lainnya dari pada melalui [SMS Top Up](docId\:ubOKZmYWQRYzfqeK6lFeK). ::: # See also ::::VerticalSplit :::VerticalSplitItem [Produk & Biaya Layanan](docId:2deQYlDf8Az72oHGYaV7_) untuk mengetahui rincian terkait dimiliki ::: :::VerticalSplitItem [Back Office](docId\:NeiD6RfBV4EDRspHb2BPD) untuk mengetahui mendukung operasi . ::: :::: ::::VerticalSplit :::VerticalSplitItem [Reconcile](docId\:O90KkHXe895FMVFotNceL) untuk mengetahui cara memeriksa data terkait operasi . ::: :::VerticalSplitItem [Invoice & Receipt](docId\:XM0SqUaTFWCjls6vYo8Pi) untuk mengetahui terkait bukti dalam operasi . ::: :::: [title] Reconcile [path] Operasi Bisnis/ *Reconcile *atau disebut juga dengan rekonsiliasi adalah memeriksa data keuangan antar perusahaan, dan terlibat dalam berdasarkan laporan keuangan sama. Hal tersebut dilakukan untuk membandingkan catatan keuangan agar menjadi akurat. Proses rekonsiliasi umumnya perlu dilakukan secara berkala dan mencakup semua jenis , baik masih berjalan maupun sudah selesai. wajib melakukan pengecekan melalui Inquiry pada tautan terlampir untuk memeriksa setiap sudah terjadi di dalam . Berikut adalah daftar tautan untuk Status Inquiry pada . | **Produk** | **Metode Pembayaran** | **Tautan API Status Inquiry** | | ---------- | --------------------- | --------------------------------------------------------------------------------------------- | | | Semua | [Status Inquiry - API Checkout](docId\:K9vBS87ev9_w5oJAU0et3) | | | | [Status Inquiry - API Credit Card](docId\:voJ9rhAQRLcF-_74cYrFi) | | | | [Check Status Transaction - API Virtual Account SNAP](docId\:xaW0SxwKv9j7b5zLbtVpR) | | | | [Status Inquiry - API Convenience Store](docId\:WMITrWcw3j9ChajRg-o1D) | | | | [Status Inquiry - API Direct Debit](docId\:TvyS0QCC6pqcXX8NulLFr) | | | | [Check Status Transaction - API E-Wallet (Direct Debit) SNAP](docId\:vB63D8suaKPYP-4bIOWx9) | | | | [Status Inquiry - API Paylater](docId\:r6YyG1qEKKLzWnVhazxCV) | | | | [Status Inquiry - API GPN](docId\:XF3Gyd2RzjUw2VPCiT0L9) | | | | [Check Status Transaction - API QRIS SNAP](docId:3aXWe6p6cyHX_ZuN-bvgQ) | # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Produk & Biaya Layanan](docId:2deQYlDf8Az72oHGYaV7_) untuk mengetahui rincian terkait dimiliki . ::: :::VerticalSplitItem [Back Office](docId\:NeiD6RfBV4EDRspHb2BPD) untuk mengetahui yang mendukung operasi . ::: :::: ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Deposit Saldo](docId\:VdIDXX3uGz0y1dGVucMGp) untuk mengetahui cara menggunakan beberapa khusus . ::: :::VerticalSplitItem [Invoice & Receipt](docId\:XM0SqUaTFWCjls6vYo8Pi) untuk mengetahui terkait bukti dalam operasi . ::: :::: [title] Proses Settlement [path] Operasi Bisnis/ # Overview *** *Settlement *adalah pembukuan suatu & pemindahan dana dari lembaga finansial ( atau ) ke perorangan atau perusahaan (). Dalam praktiknya, terdapat dua tipe *settlement model*, yaitu **Fasilitator** dan **Aggregator**. :::hint{type="info"} Merchant dapat melakukan konversi dana dari dana settlement menjadi saldo payout. Silakan kunjungi halaman [Deposit Saldo](docId\:VdIDXX3uGz0y1dGVucMGp) untuk rincian lebih lanjut. ::: # Tipe Settlement *** Pada tipe **Fasilitator**, dana akan langsung masuk ke rekening setelah selesai. Dalam skenario ini, akan mewakili untuk melakukan pembukuan sudah selesai dan akan melakukan rekonsiliasi dengan untuk validasi data, memotong biaya layanannya serta biaya sebagai *payment gateway*. ::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/PZE1LaVpwT1BbqZ2DQ2o0_facilitator-page-2drawio.png" size="68" width="429" height="161" caption="Settlement - Facilitator" position="center" darkWidth="429" darkHeight="161" showCaption="true"} Pada tipe **Aggregator**, akan melakukan dana melalui rekening setelah selesai. Dalam skenario ini, akan mewakili dalam termasuk pemotongan biaya dari dan bersangkutan. akan menerima jumlah dana sudah terpotong tersebut dari pada rekening pilihannya. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/RbgFSp_RJdKGi3-svO1bK_facilitator-aggregatordrawio.png "Settlement - Aggregator") # Waktu Settlement *** Waktu biasanya berbeda-beda dari satu lembaga ke lainnya. Hal tersebut tergantung dari metode dipakai, metode serta ataupun -nya. Berikut perbedaan waktu dari masing-masing . | **Metode Pembayaran** | **Mitra** | **Tipe Settlement** | **Durasi** | | --------------------- | -------------------------------------------------------------------------------------------------------- | ------------------------------------- | -------------------------- | | **** | Visa, Mastercard, JCB, American Express untuk Mandiri, BCA, BNI, BRI | , | H+3 pada hari kerja | | **** | BCA | (BCA), (ALTO) | H+1 pada hari kerja | | **** | BRI, Mandiri, BNI, Permata, Maybank, KEB Hana, CIMB Niaga, Danamon, Permata Syariah,
BJB, BNC, DKI | ,

saja (CIMB, BNC, DKI) | H+3 pada hari kerja | | **** | ATM Bersama, Prima, Alto | . | H+3 pada hari kerja | | **** | Indomaret | | H+5 pada hari kerja | | **** | Alfa Group (Alfamart, Alfamidi, Dan+Dan, Lawson) | | H+7 pada hari kerja | | **** | JeniusPay | | H+2 pada hari kerja | | **** | OVO, Dana, ShopeePay, LinkAja, dan AstraPay | | H+3 pada hari kerja | | **** | Kredivo | | Setiap hari Selasa & Jumat | | **** | Akulaku Paylater | | H+4 pada hari kerja | | **** | Indodana | | H+3 pada hari kerja | | **** | Semua tipe QR sudah terintegrasi dengan | | H+2 pada hari kerja | | **** | BNI, BTN |
| H+3 pada hari kerja | # Same Day Settlement (Instant Settlement) *** *Same Day Settlement* atau disebut juga dengan SDS merupakan fitur inovasi terbaru dengan tujuan untuk memenuhi kebutuhan dalam mendapatkan dana hasil dengan waktu relatif cepat yaitu H+0. ::::hint{type="info"} :::Iframe{iframeHeight="0" code="Silakan menghubungi Tim Sales atau Tim Customer Service kami melalui e-mail untuk mengaktifkan fitur SDS."} ::: :::: # Cut-Off *Cut-Off* adalah pencatatan waktu dari akan di-*stop* atau di-*pending*. | **Metode Pembayaran** | **Nama Bank/Mitra** | **Waktu Layanan** | **Catatan** | | --------------------- | ------------------- | ----------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | | 22:00 - 24:00 | - *Settlement* mengikuti waktu *batch* *Settlement* antara pukul 22:00 hingga 24:00 - *Settlement* berlaku untuk *Sale/Purchase*, *Refund*, dan *Capture* - Laporan *Settlement* dapat dilihat dan diunduh melalui *dashboard* | | | OVO | 23:59 | | | | BCA | * 20:50 WIB - 02:00 WIB * 20:50 WIB - 04:00 WIB | - Senin - Sabtu dan Minggu - Senin - Sabtu = Minggu | | | BRI | 22:00 WIB - 23:20 WIB | Setiap hari | | | DBS | 23:00 WIB - 00:00 WIB | Setiap hari | | | lain | Tidak terdapat waktu terjadwal | Mengikuti jadwal | # Keuntungan dan Kekurangan *** | **Tipe Settlement** | **Keuntungan** | **Kekurangan** | | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- | | | - Proses *on-boarding* lebih cepat dan fokus hanya pada satu - Cocok untuk ukuran menengah hingga besar - Menyediakan MID khusus untuk dan cabang | * Membutuhkan rekening khusus untuk diajak bekerja sama | | | - Tidak perlu membuka rekening lain - Dapat menggunakan berbagai macam dalam satu - Cocok untuk ukuran kecil hingga menengah | * Menggabungkan MID untuk dan cabang | # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Reconcile](docId\:O90KkHXe895FMVFotNceL) untuk mengetahui cara memeriksa data terkait operasi . ::: :::VerticalSplitItem [Cancel Payment](docId:_fVpAc1b3FRIAOE8Tj56q) untuk mengetahui cara membatalkan dalam . ::: :::: ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Invoice & Receipt](docId\:XM0SqUaTFWCjls6vYo8Pi) untuk mengetahui terkait bukti dalam operasi . ::: :::VerticalSplitItem [Pajak](docId\:dR7m2aSPVC5vwz-HV2lql) untuk mengetahui informasi terkait dalam operasi . ::: :::: [title] Back Office [path] Operasi Bisnis/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/p6DDhTpeGj5sQk1dIMOyU_back-office-mms-laptop.png "NICEPAY Merchant Back Office") Untuk dapat memantau dan menganalisa operasi dengan mudah dan terkini, menyediakan portal *dashboard* khusus dikenal sebagai [Merchant Back Office](docId\:VMD8YtiiJqku6H8dRhcS6). menggunakan portal untuk memantau secara terkini, melihat laporan , mengatur akses akun, hingga mengelola manajemen diskon dan . periksa [Merchant Back Office](docId\:VMD8YtiiJqku6H8dRhcS6) untuk mengetahui penjelasan lebih rinci terkait dan fitur *dashboard * disediakan . # See also ::::VerticalSplit :::VerticalSplitItem [Produk & Biaya Layanan](docId:2deQYlDf8Az72oHGYaV7_) untuk mengetahui rincian terkait dimiliki . ::: :::VerticalSplitItem [Deposit Saldo](docId\:VdIDXX3uGz0y1dGVucMGp) untuk mengetahui cara untuk menggunakan beberapa khusus . ::: :::: ::::VerticalSplit :::VerticalSplitItem [Reconcile](docId\:O90KkHXe895FMVFotNceL) untuk mengetahui cara memeriksa data terkait operasi . ::: :::VerticalSplitItem [Invoice & Receipt](docId\:XM0SqUaTFWCjls6vYo8Pi) untuk mengetahui terkait bukti dalam operasi . ::: :::: [title] Cancel Payment [path] Operasi Bisnis/ # Void Pembatalan dilakukan di hari sama atau berbeda dan belum dilakukan. # Refund *Refund* merupakan pengembalian dana atas sudah berhasil diselesaikan antara dan . Apabila terjadi *refund* pada , maka akan tetap melakukan *charge *biaya kepada . Dana di-*refund *akan dikembalikan kepada . # See also ::::VerticalSplit :::VerticalSplitItem [Reconcile](docId\:O90KkHXe895FMVFotNceL) untuk mengetahui cara memeriksa data terkait operasi . ::: :::VerticalSplitItem [Proses Settlement](docId\:l04EuP_s604Oi2Ib3x_y6) untuk mengetahui cara menyelesaikan terkait operasi . ::: :::: ::::VerticalSplit :::VerticalSplitItem [Invoice & Receipt](docId\:XM0SqUaTFWCjls6vYo8Pi) untuk mengetahui terkait bukti dalam operasi . ::: :::VerticalSplitItem [Pajak](docId\:dR7m2aSPVC5vwz-HV2lql) untuk mengetahui terkait dalam operasi . ::: :::: [title] FAQ Direct Debit [path] Payment/Direct Debit/ ### Bagaimana jika ingin bertransaksi dengan Direct Debit tetapi tidak memiliki akun pada Partner yang bekerja sama dengan NICEPAY? harus membuat akun terlebih dahulu pada aplikasi milik akan digunakan. Karena setelah melakukan *checkout*, akan mendapatkan *push notification *pada aplikasi untuk menyelesaikan . *** ### Mengapa transaksi menggunakan Direct Debit dapat gagal? 1. Mengalami *Connection Time Out.* 2. Terdapat gangguan dasar pada . 3. Salah memasukkan *Cashtag.* *** ### Bagaimana cara Merchant mengecek transaksi yang sudah berhasil dibayarkan dengan Direct Debit? dapat melihat riwayat dalam jangka waktu tertentu melalui [Merchant Back Office](docId\:VMD8YtiiJqku6H8dRhcS6) pada: - Menu [Transaction Data](docId\:iZwosih8r9HIc0UurgYMa) untuk memeriksa seluruh data , atau - Menu [Fail Transaction](docId\:Kw36Cm_cK3RzRNUHfzavQ) untuk memeriksa data gagal. *** ### Apakah terdapat proses ***refund ***pada Merchant Back Office untuk pembayaran dengan Direct Debit? [Merchant Back Office](docId\:VMD8YtiiJqku6H8dRhcS6) tidak menyediakan *refund *untuk dengan . dapat melakukan *refund *dengan menghubungi atau terkait untuk melakukan *refund.* *** ### Mengapa Pelanggan belum menerima ***refund***? Waktu *refund * mengikuti waktu sudah ditentukan oleh ([Penyelesaian Transaksi Pada Direct Debit](docId\:Q1PAefVtNESlg13MVALgI)). Apabila masih belum menerima *refund *setelah melewati ketentuan waktu, silakan hubungi terkait. *** ### Mengapa proses ***refund*** dapat gagal? - Pengajuan *refund *ditolak oleh . - Pengajuan *refund *tidak sesuai dengan ketentuan /. *** ### Apa yang dimaksud dengan Settlement? adalah pembukuan suatu dan pemindahan dana dari lembaga finansial ( atau ) ke suatu individu atau perusahaan dalam kasus ini akan disebut sebagai . kunjungi [Proses Settlement](docId\:l04EuP_s604Oi2Ib3x_y6) untuk lebih lanjut. *** ### Berapa lama waktu yang dibutuhkan untuk melakukan proses Settlement Direct Debit? kunjungi [Proses Settlement](docId\:l04EuP_s604Oi2Ib3x_y6) untuk lebih lanjut. [title] Seller Settlement [path] Merchant Back Office/Settlement/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/bWyiNW9GBWA4cpMUr2t3-_settlement-seller-settlement.png "Seller Settlement") Sub-menu ini membantu untuk melihat rangkuman kepada Seller, terkait semua masing-masing Seller dengan semua tersedia. Halaman ini terbagi menjadi 2 , yaitu: `Search Option` dan `Search Result`. ::embed[]{url="https://youtu.be/yu2IV0gZZ9o"} Bagian `Search Option` adalah formulir digunakan untuk memasukkan kriteria pencarian data . Setiap *field* terdapat pada formulir ini bersifat opsional, namun hasil pencarian dicari bergantung pada *data type* dipilih. Terdapat 2 pilihan tipe data, yakni *Settlement Date* dan *Approval/Request*. Admin dapat melakukan pencarian data untuk ditampilkan pada `Search Result` atau meng data dalam format Excel. Bagian `Search Result` adalah menampilkan hasil pencarian data berdasarkan kriteria dimasukkan pada `Search Option`. Data pada ini akan muncul setelah mengonfirmasi pencarian data dengan menekan `Search`. Hasil pencarian data ditampilkan berbeda-beda sesuai dengan dipilih pada `Search Option`. # Seller Settlement *** ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/n3iUD3-6pg3fuNkCKAOwq_back-office-mms-46.png "Settlement - Seller Settlement") Bagian `Search Option` berisi formulir pencarian digunakan untuk mencari semua data . Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ------------------ | ----------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | | Data Type | Tipe data | *Default*: Date | | Date | Waktu dilakukan dalam format tanggal dan jam | *Default*: tanggal hari ini dan jarak waktu 24 jam | | Date (Within) | Jarak waktu dilakukan

Pengaturan waktu bisa langsung ditentukan antara hari ini, 1 minggu, atau 1 bulan | *Default*: *Today* | | Search | Tombol untuk memproses kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Excel | Tombol untuk mem kata kunci dimasukkan untuk *file* akan di | Format *file* akan di dalam format Excel | | Excel Details List | Tombol untuk mem kata kunci dimasukkan untuk *file* akan di Pengguna

*File* berisi rincian data per | Format *file* akan di dalam format Excel | | Excel Details (SP) | Tombol untuk mem kata kunci dimasukkan untuk *file* akan di

*File* berisi rincian data *switch* *point* per | Format *file* akan di dalam format Excel

\*khusus untuk tertentu | Bagian `Search Result` menampilkan rangkuman berjalan sesuai dengan ketentuan dari `Search Option`. Jika memilih *tipe data Settlement Date*, maka akan menampilkan data berdasarkan *Settlement date* dari seluruh dari berhasil melalui pada jarak tanggal tertentu. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/ZhcOWhA5EE3KzawhqoUk__settlement-date.png "Seller Settlement - Settlement Date") Jika memilih *tipe data Approval/Request*, maka akan menampilkan data berdasarkan *transaction date* dari seluruh dari masih menunggu pada jarak tanggal tertentu. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/UGK8zUKivMPaF5g7A_MnD_approval-purchase.png "Seller Settlement - Approval / Request") # Tutorial *** ## Mencari Data Seller Settlement Berikut panduan untuk mencari data Seller . 1. Buka *sidebar*. 2. `Settlement`. 3. `Seller Settlement`. 4. ketentuan pencarian pada `Search Option`. 5. `Search` untuk melakukan pencarian data. 6. Data dicari akan muncul pada `Search Result.` ## Mengunduh Data Seller Settlement Berikut panduan untuk meng data Seller . 1. Buka *sidebar*. 2. `Settlement`. 3. `Seller Settlement`. 4. ketentuan pencarian pada `Search Option`. 5. `Excel` untuk meng rangkuman data dalam bentuk format Excel. 6. `Excel Details (List)` untuk meng rincian data dalam bentuk format Excel. 7. `Excel Details (SP)` untuk meng rincian data dalam bentuk format Excel. 8. Data dicari akan ter secara otomatis. # See also ::::VerticalSplit :::VerticalSplitItem [Settlement Report](docId:9ESDQYwVyCq3ce254IC3B) untuk mengetahui laporan . ::: :::VerticalSplitItem [Pending Settlement](docId\:yba25yJeOhoGQUIBWWyYi) untuk mengetahui cara melihat riwayat data *pending*. ::: :::: [title] Contact CS [path] Merchant Back Office/Notice & Help/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/1QAV44Jjb_Z52jq83An1B_back-office-mms-31.png "Contact Customer Service") Sub-menu `Contact Customer Service` digunakan untuk melihat riwayat daftar pertanyaan pernah diajukan beserta jawabannya. Pada ini, juga dapat mendaftarkan pertanyaan baru lalu akan mendapatkan balasan melalui internal tim secara sistematis. ::embed[]{url="https://youtu.be/gq4ZykNBaXQ"} Terdapat 3 pada `Contact CS` , yaitu `Search Option`, `Search Result`, dan `Registrasi`. Bagian `Search Option` adalah formulir digunakan untuk memasukkan kriteria pencarian data. Bagian `Search Result` untuk menampilkan hasil pencarian berdasarkan kriteria dimasukkan. Bagian `Registrasi` adalah untuk mendaftarkan pertanyaan ingin diajukan. # Contact Customer Service *** ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/rNNV2X2Kli7oj_uObQleW_back-office-mms-2022-10-24t223047011.png "Notice & Help - Contact CS") Bagian `Search Option` berisi formulir pencarian digunakan untuk mencari semua data. Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ------------ | ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------- | | Inquiry Type | Jenis pertanyaan sering diajukan | *Default*: Total -> semua tipe *inquiry*

Isi *dropdown*:
* Total * Terminate * * * IT * Other | | Title | Judul topik pertanyaan | | | Search | Tombol untuk mencari data berdasarkan kata kunci dimasukkan | | | Register | Tombol menavigasi User untuk mendaftarkan pertanyaan baru | | Bagian `Search Result` menampilkan hasil pencarian data sesuai dengan kata kunci diisi pada `Search Option`. Bagian ini berisi riwayat daftar pertanyaan dan jawaban. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/K4_23tZB5Ij6pkJE2wFF3_back-office-mms-2022-10-24t224152674.png "Contact CS - Search Result") Daftar topik pertanyaan biasanya digunakan untuk mencari pertanyaan spesifik terdapat pada kolom `Title` . ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/YbJLUuyL7aL61oT3eDVpU_back-office-mms-2022-10-24t225904352.png "Contact CS - Search Result - Title") ## View ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/veGUvphMoI3elyWh8ds-T_image.png "Contact CS - View") Bagian `View` berisi rincian data pertanyaan beserta jawaban balasan dari CS . Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ----------------- | ----------------------------- | -------------------------------------------------------------------------------------- | | MID | ID | | | Inquiry Type | Nomor ID antrian tipe inquiry | *Default*: Total

Isi *dropdown*:
* Total * Terminate * * * IT * Other | | Title | Judul dari topik diajukan | | | Information | Isi dari topik ditanyakan | | | Answer | Jawaban atas topik diajukan | | | Requester | Pengirim pertanyaan | | ## Registrasi ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/ikFAkUC46btSV41zVHiKe_image.png "Contact CS - Regist") dapat mengajukan pertanyaan dengan mendaftarkan pertanyaan terlebih dahulu. `Save` untuk mengirimkan pengajuan pada internal SMS dan pertanyaan akan otomatis muncul ke dalam antrian. Setelah menekan `Save`, tampilan akan muncul seperti berikut. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/APeM4eWUBR44k16VIusoX_image.png "Contact CS - Search Result After Regist") # Tutorial *** ## Mencari Data Pertanyaan ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/5coBl9BsZqC6YfJjqKPma_back-office-mms-2022-10-25t102930021.png "Contact CS - Search Result") Berikut panduan untuk mencari daftar pertanyaan. 1. Buka *sidebar*. 2. `Notice and Help`. 3. `Contact CS`. 4. ketentuan pencarian pada `Search Option`. 5. bisa mencari berdasarkan kustomisasi `Inquiry Type` dan `Title`, atau; 6. `Search` untuk melakukan pencarian data. 7. Data dicari akan muncul pada `Search Result`. ## Mengajukan Pertanyaan Kepada CS ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/spiNJElK5EB5x7fPP52fP_image.png "Contact CS - Regist") Berikut panduan untuk mengajukan pertanyaan kepada CS. 1. Buka *sidebar*. 2. `Notice and Help`. 3. `Contact CS`. 4. `Registrasi`. 5. Isi formulir pada `Regist` muncul di atas `Search Option`. 6. `Save`. 7. Form tersimpan akan langsung terkirim kepada CS untuk ditindaklanjuti. # See also ::::VerticalSplit :::VerticalSplitItem [Notice](docId\:aXtwALglhPwRuNzaNRuMP) untuk mengetahui cara membaca pengumuman. ::: :::VerticalSplitItem [FAQ](docId\:miTf4W3FwvNrMQ_uUHv7e) untuk mengetahui cara mencari jawaban atas pertanyaan umum. ::: :::: [title] Noti History [path] Merchant Back Office/Transaction/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/LD8FqkJ2P4pyxjAryaVwG_back-office-mms-18.png "Noti History") # Noti History *** Sub-menu `Noti History` digunakan oleh untuk dapat melakukan ulang terhadap berhasil namun notifikasinya gagal. Halaman ini terbagi menjadi 2 , yaitu `Search Option` dan `Search Result`. ::embed[]{url="https://youtu.be/QOwpTDVU9eE"} Bagian `Search Option` adalah formulir digunakan untuk memasukkan kriteria pencarian data . Setiap *field* terdapat pada formulir ini bersifat opsional. Akan tetapi, hasil pencarian dicari bergantung pada dipilih. Terdapat 10 pilihan untuk ; yakni Total, , , Click Pay, , , , , dan kartu . Admin dapat melakukan pencarian data untuk ditampilkan pada `Search Result` atau meng data dalam format Excel. Bagian `Search Result` adalah menampilkan hasil pencarian data berdasarkan kriteria dimasukkan pada `Search Option`. Data pada ini akan muncul setelah mengonfirmasi pencarian data dengan menekan `Search`. Hasil pencarian data ditampilkan berbeda-beda sesuai dengan dipilih pada `Search Option`. ## All Payment Method ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/ZCjWCkEJ7v-D3UNWgG3pM_11.png "Transaction - Noti History - All") Bagian `Search Option` pada *metode pembayaran: Total* berisi formulir pencarian *general * digunakan untuk mencari semua data . Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | -------------------------- | ---------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | | | Daftar terdaftar pada | *Default*: Total -> semua | | Payment Method | Daftar terdapat pada | *Default*: Total -> semua

Isi *dropdown*:
* Total * * * CVS * Click Pay * * * * * Card | | Name | Nama digunakan untuk | *Default*: Total -> semua | | Status | Status | *Default*: All -> semua

Isi *dropdown*:
* All * Success * Fail | | Date of Deposit | Waktu berhasil masuk dalam format tanggal dan jam | *Default*: tanggal hari ini dan jarak waktu 24 jam | | Date of Deposit (*Within*) | Waktu berhasil masuk langsung ditentukan antara hari ini, 1 minggu, atau 1 bulan | *Default*: *Today* | | TXID | ID | Opsional | | Search | Tombol untuk mem kata kunci dimasukkan pengguna untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Excel | Tombol untuk mem kata kunci dimasukkan pengguna untuk *file* akan di | Format *file* akan di dalam format Excel | Bagian `Search Result` pada *metode pembayaran: Total* menampilkan rincian data per . dapat melakukan pengiriman ulang dengan memilih menggunakan `checkbox` kemudian tekan `resend`. Bagian ini terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ---------------------------------- | ------------------------------------------------------------------ | ------------------------------------- | | Records per page | *Dropdown* untuk menampilkan data dalam jumlah tertentu pada tabel | | | Payment Method | Metode digunakan pada saat | | | I-MID | ID | | | Brand Name | Nama merek melakukan | | | Deposit Amount | Nominal uang dalam | | | Date of Deposit | Tanggal | | | Last Noti | Waktu terakhir berjalan | | | Noti Count | Jumlah pengiriman dilakukan | | | / | Nama / mengeksekusi | | | VA / Card / Phone / Payment Number | Nomor digunakan dalam | | | Status | Status | Pilihan status:
* Fail * Success | | Checkbox | Untuk memilih akan melalui pengiriman ulang | | | Resend | Tombol untuk melakukan pengiriman ulang | | | Pagination | Jumlah untuk melihat riwayat | | ## Credit Card ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/8_67UPoepLGCiTSbn00bK_4.png "Transaction - Noti History - Credit Card") Bagian `Search Option` pada *metode pembayaran: Credit Card* berisi formulir pencarian spesifik khusus untuk mencari data *Credit Card*. Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | | | Daftar terdaftar pada | *Default*: Total -> semua | | Payment Method | Daftar terdapat pada | *Default*:

Isi *dropdown*:
* Total * * * CVS * Click Pay * * * * * Card | | Name | Nama digunakan untuk | *Default*: Total -> semua | | Status | Status | *Default*: All -> semua

Isi *dropdown*:
* All * Success * Fail | | Date of Deposit | Waktu berhasil masuk dalam format tanggal dan jam

Pengaturan waktu bisa langsung ditentukan antara hari ini, 1 minggu, atau 1 bulan | *Default*: tanggal hari ini dan jarak waktu 24 jam, *Today* | | Card Number | Nomor kartu digunakan pada saat | Opsional | | TXID | ID | Opsional | | Search | Tombol untuk mem kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Excel | Tombol untuk mem kata kunci dimasukkan untuk *file* yang akan di | Format *file* akan di dalam format Excel | Bagian `Search Result` pada *metode pembayaran: Credit Card* menampilkan rincian data per . dapat melakukan pengiriman ulang dengan memilih menggunakan `checkbox` kemudian tekan `resend`. Bagian ini terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ---------------- | ------------------------------------------------------------------ | ------------------------------------- | | Records per page | *Dropdown* untuk menampilkan data dalam jumlah tertentu pada tabel | | | Payment Method | Metode digunakan pada saat | *Default*: CC | | I-MID | ID | | | Brand Name | Nama merek melakukan | | | Deposit Amount | Nominal uang dalam | | | Date of Deposit | Tanggal | | | Last Noti | Waktu terakhir berjalan | | | Noti Count | Jumlah pengiriman dilakukan | | | Bank | Nama mengeksekusi | | | Card Number | Nomor kartu digunakan dalam | | | Status | Status | Pilihan status:
* Fail * Success | | Checkbox | Untuk memilih akan melalui pengiriman ulang | | | Resend | Tombol untuk melakukan pengiriman ulang | | | Pagination | Jumlah untuk melihat riwayat | | ## Virtual Account ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/QkolYrcGyXq66SfvmlFcT_12.png "Transaction - Noti History - Virtual Account") Bagian `Search Option` pada *metode pembayaran: Virtual Account* berisi formulir pencarian spesifik khusus untuk mencari data . Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | | | Daftar terdaftar pada | *Default*: Total -> semua | | Payment Method | Daftar terdapat pada | *Default*: VA

Isi *dropdown*:
* Total * * * CVS * Click Pay * * * * * Card | | Name | Nama digunakan untuk | *Default*: Total -> semua | | Status | Status | *Default*: All -> semua

Isi *dropdown*:
* All * Success * Fail | | Date of Deposit | Waktu berhasil masuk dalam format tanggal dan jam

Pengaturan waktu bisa langsung ditentukan antara hari ini, 1 minggu, atau 1 bulan | *Default*: tanggal hari ini dan jarak waktu 24 jam, *Today* | | Number | Nomor digunakan pada saat | Opsional | | TXID | ID | Opsional | | Search | Tombol untuk mem kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Excel | Tombol untuk mem kata kunci dimasukkan untuk *file* akan di | Format *file* akan di dalam format Excel | Bagian `Search Result` pada *metode pembayaran: Virtual Account* menampilkan rincian data per . dapat melakukan pengiriman ulang dengan memilih menggunakan `checkbox` kemudian tekan `resend`. Bagian ini terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ---------------- | ------------------------------------------------------------------ | ------------------------------- | | Records per page | *Dropdown* untuk menampilkan data dalam jumlah tertentu pada tabel | | | Payment Method | Metode digunakan pada saat | Default: VA | | I-MID | ID | | | Brand Name | Nama merek melakukan | | | Deposit Amount | Nominal uang dalam | | | Date of Deposit | Tanggal | | | Last Noti | Waktu terakhir berjalan | | | Noti Count | Jumlah pengiriman dilakukan | | | | Nama mengeksekusi | | | Number | Nomor digunakan dalam | | | Status | Status | Pilihan :
* Fail * Success | | Checkbox | Untuk memilih akan melalui pengiriman ulang | | | Resend | Tombol untuk melakukan pengiriman ulang | | | Pagination | Jumlah untuk melihat riwayat | | ## Convenience Store ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/I1l3MW-VtWGYvC43FVfnz_13.png "Transaction - Noti History - CVS") Bagian `Search Option` pada *metode pembayaran: Convenience Store* berisi formulir pencarian spesifik khusus untuk mencari data . Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | | | Daftar terdaftar pada | *Default*: Total -> semua | | Payment Method | Daftar terdapat pada | *Default*: Total -> CVS

Isi *dropdown*:
* Total * * * CVS * Click Pay * * * * * Card | | Name | Nama digunakan untuk | *Default*: Total -> semua | | Date of Deposit | Waktu berhasil masuk dalam format tanggal dan jam

Pengaturan waktu bisa langsung ditentukan antara hari ini, 1 minggu, atau 1 bulan | *Default*: tanggal hari ini dan jarak waktu 24 jam, *Today* | | Payment Number | Nomor digunakan pada saat | Opsional | | TXID | ID | Opsional | | Search | Tombol untuk mem kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Excel | Tombol untuk mem kata kunci dimasukkan untuk *file* akan di | Format *file* akan di dalam format Excel | Bagian `Search Result` pada *metode pembayaran: Convenience Store* menampilkan rincian data per . dapat melihat rincian terkait dari *hyperlink *dan rincian dari *pop-up * tersedia. Bagian ini terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ---------------- | ------------------------------------------------------------------ | ------------------------------------- | | Records per page | *Dropdown* untuk menampilkan data dalam jumlah tertentu pada tabel | | | Payment Method | Metode digunakan pada saat | Default: CVS | | I-MID | ID | | | Brand Name | Nama merek melakukan | | | Deposit Amount | Nominal uang dalam | | | Date of Deposit | Tanggal | | | Last Noti | Waktu terakhir berjalan | | | Noti Count | Jumlah pengiriman dilakukan | | | Mitra | Nama mengeksekusi | | | Payment Number | Nomor digunakan dalam | | | Status | Status | Pilihan status:
* Fail * Success | | Checkbox | Untuk memilih akan melalui pengiriman ulang | | | Resend | Tombol untuk melakukan pengiriman ulang | | | Pagination | Jumlah untuk melihat riwayat | | ## Click Pay ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/PYR19ucIop9zDIWYpNdV4_5.png "Transaction - Noti History - Click Pay") Bagian `Search Option` pada *metode pembayaran: Click Pay* berisi formulir pencarian spesifik khusus untuk mencari data Click Pay. Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | | | Daftar terdaftar pada | *Default*: Total -> semua | | Payment Method | Daftar terdapat pada | *Default*: Click Pay

Isi *dropdown*:
* Total * * * CVS * Click Pay * * * * * Card | | Name | Nama digunakan untuk | *Default*: Total -> semua | | Status | Status | *Default*: All -> semua

Isi *dropdown*:
* All * Success * Fail | | Date of Deposit | Waktu berhasil masuk dalam format tanggal dan jam

Pengaturan waktu bisa langsung ditentukan antara hari ini, 1 minggu, atau 1 bulan | *Default*: tanggal hari ini dan jarak waktu 24 jam, *Today* | | Card Number | Nomor kartu digunakan pada saat | Opsional | | TXID | ID | Opsional | | Search | Tombol untuk mem kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Excel | Tombol untuk mem kata kunci dimasukkan untuk *file* akan di | Format *file* akan di dalam format Excel | Bagian `Search Result` pada *metode pembayaran: Click Pay* menampilkan rincian data per . dapat melakukan pengiriman ulang dengan memilih menggunakan `checkbox` kemudian tekan `resend`. Bagian ini terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ---------------- | ------------------------------------------------------------------ | ------------------------------------- | | Records per page | *Dropdown* untuk menampilkan data dalam jumlah tertentu pada tabel | | | Payment Method | Metode digunakan pada saat | Default: Click Pay | | I-MID | ID | | | Brand Name | Nama merek melakukan | | | Deposit Amount | Nominal uang dalam | | | Date of Deposit | Tanggal | | | Last Noti | Waktu terakhir berjalan | | | Noti Count | Jumlah pengiriman dilakukan | | | | Nama mengeksekusi | | | Card Number | Nomor kartu digunakan dalam | | | Status | Status | Pilihan status:
* Fail * Success | | Checkbox | Untuk memilih akan melalui pengiriman ulang | | | Resend | Tombol untuk melakukan pengiriman ulang | | | Pagination | Jumlah untuk melihat riwayat | | ## E-Wallet ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/t88SzLcMmPJiK_Q5W6yv3_6.png "Transaction - Noti History - -Wallet") Bagian `Search Option` pada *metode pembayaran: E-Wallet* berisi formulir pencarian spesifik khusus untuk mencari data . Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | | | Daftar terdaftar pada | *Default*: Total -> semua | | Payment Method | Daftar terdapat pada | *Default*:

Isi *dropdown*:
* Total * * * CVS * Click Pay * * * * * Card | | Name | Nama digunakan untuk | Default: Total -> semua | | Status | Status | *Default*: All -> semua

Isi *dropdown*:
* All * Success * Fail | | Date of Deposit | Waktu berhasil masuk dalam format tanggal dan jam

Pengaturan waktu bisa langsung ditentukan antara hari ini, 1 minggu, atau 1 bulan | *Default*: tanggal hari ini dan jarak waktu 24 jam, *Today* | | Phone Number | Nomor ponsel digunakan pada saat | Opsional | | TXID | ID | Opsional | | Search | Tombol untuk mem kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Excel | Tombol untuk mem kata kunci dimasukkan untuk *file* akan di | Format *file* akan di dalam format Excel | Bagian `Search Result` pada *metode pembayaran: e-Wallet* menampilkan rincian data per . dapat melakukan pengiriman ulang dengan memilih menggunakan `checkbox` kemudian tekan `resend`. Bagian ini terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ---------------- | ------------------------------------------------------------------ | ------------------------------- | | Records per page | *Dropdown* untuk menampilkan data dalam jumlah tertentu pada tabel | | | Payment Method | Metode digunakan pada saat | Default: | | I-MID | ID | | | Brand Name | Nama merek melakukan | | | Deposit Amount | Nominal uang dalam | | | Date of Deposit | Tanggal | | | Last Noti | Waktu terakhir berjalan | | | Noti Count | Jumlah pengiriman dilakukan | | | | Nama mengeksekusi | | | Phone Number | Nomor ponsel digunakan dalam | | | Status | Status | Pilihan :
* Fail * Success | | Checkbox | Untuk memilih akan melalui pengiriman ulang | | | Resend | Tombol untuk melakukan pengiriman ulang | | | Pagination | Jumlah untuk melihat riwayat | | ## Paylater ![Transaction - Noti History - Paylater](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/tTQL4Y3QDJdLgwahm-Ogt_image-merchant-back-office-noti-history-paylater.png "Transaction - Noti History - Paylater") Bagian `Search Option` pada *metode pembayaran: Paylater* berisi formulir pencarian spesifik khusus untuk mencari data . Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | | | Daftar terdaftar pada | *Default*: Total -> semua | | Payment Method | Daftar terdapat pada | *Default*:

Isi *dropdown*:
* Total * * * CVS * Click Pay * * * * * Card | | Name | Nama digunakan untuk | Default: Total -> semua | | Status | Status | *Default*: All -> semua

Isi *dropdown*:
* All * Success * Fail | | Date of Deposit | Waktu berhasil masuk dalam format tanggal dan jam

Pengaturan waktu bisa langsung ditentukan antara hari ini, 1 minggu, atau 1 bulan | *Default*: tanggal hari ini dan jarak waktu 24 jam,

*Default*:*Today* | | Phone Number | Nomor ponsel digunakan pada saat | Opsional | | TXID | ID | Opsional | | Search | Tombol untuk mem kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Excel | Tombol untuk mem kata kunci dimasukkan untuk *file* akan di | Format *file* akan di dalam format Excel | Bagian `Search Result` pada *metode pembayaran: Paylater* menampilkan rincian data per . dapat melakukan pengiriman ulang dengan memilih menggunakan `checkbox` kemudian tekan `resend`. Bagian ini terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ---------------- | ------------------------------------------------------------------ | ------------------------------- | | Records per page | *Dropdown* untuk menampilkan data dalam jumlah tertentu pada tabel | | | Payment Method | Metode digunakan pada saat | *Default*: | | I-MID | ID | | | Brand Name | Nama merek melakukan | | | Deposit Amount | Nominal uang dalam | | | Date of Deposit | Tanggal | | | Last Noti | Waktu terakhir berjalan | | | Noti Count | Jumlah pengiriman dilakukan | | | | Nama mengeksekusi | | | Phone Number | Nomor ponsel digunakan dalam | | | Status | Status | Pilihan :
* Fail * Success | | Checkbox | Untuk memilih akan melalui pengiriman ulang | | | Resend | Tombol untuk melakukan pengiriman ulang | | | Pagination | Jumlah untuk melihat riwayat | | ## Payout ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/87K98yXvbxjmLvQxy-dYQ_8.png "Transaction - Noti History - Payout") Bagian `Search Option` pada *metode pembayaran: Payout* berisi formulir pencarian spesifik khusus untuk mencari data . Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | | | Daftar terdaftar pada | *Default*: Total -> semua | | Payment Method | Daftar terdapat pada | *Default*:

Isi *dropdown*:
* Total * * * CVS * Click Pay * * * * * Card | | Name | Nama digunakan untuk | Default: Total -> semua | | Status | Status | *Default*: All -> semua

Isi *dropdown*:
* All * Success * Fail | | Date of Deposit | Waktu berhasil masuk dalam format tanggal dan jam

Pengaturan waktu bisa langsung ditentukan antara hari ini, 1 minggu, atau 1 bulan | *Default*: tanggal hari ini dan jarak waktu 24 jam, *Default*: *Today* | | Card Number | Nomor kartu digunakan pada saat | Opsional | | TXID | ID | Opsional | | Search | Tombol untuk mem kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Excel | Tombol untuk mem kata kunci dimasukkan untuk *file* akan di | Format *file* akan di dalam format Excel | Bagian `Search Result` pada *metode pembayaran: Payout* menampilkan rincian data per . dapat melakukan pengiriman ulang dengan memilih menggunakan `checkbox` kemudian tekan `resend`. Bagian ini terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ---------------- | ------------------------------------------------------------------ | ------------------------------- | | Records per page | *Dropdown* untuk menampilkan data dalam jumlah tertentu pada tabel | | | Payment Method | Metode digunakan pada saat | *Default*: | | I-MID | ID | | | Brand Name | Nama merek melakukan | | | Deposit Amount | Nominal uang dalam | | | Date of Deposit | Tanggal | | | Last Noti | Waktu terakhir berjalan | | | Noti Count | Jumlah pengiriman dilakukan | | | | Nama mengeksekusi | | | Card Number | Nomor kartu digunakan dalam | | | Status | Status | Pilihan :
* Fail * Success | | Checkbox | Untuk memilih akan melalui pengiriman ulang | | | Resend | Tombol untuk melakukan pengiriman ulang | | | Pagination | Jumlah untuk melihat riwayat | | ## QRIS ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/CdjlU0Qo6Ej2hl6hOv0nf_9.png "Transaction - Noti History - QRIS") Bagian `Search Option` pada *metode pembayaran: QRIS* berisi formulir pencarian spesifik khusus untuk mencari data . Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | | | Daftar terdaftar pada | *Default*: Total -> semua | | Payment Method | Daftar terdapat pada | *Default*:

Isi *dropdown*:
* Total * * * CVS * Click Pay * * * * * Card | | Name | Nama digunakan untuk | *Default*: Total -> semua | | Status | Status | Pilihan :
* All * Fail * Success | | Date of Deposit | Waktu berhasil masuk dalam format tanggal dan jam

Pengaturan waktu bisa langsung ditentukan antara hari ini, 1 minggu, atau 1 bulan | *Default*: tanggal hari ini dan jarak waktu 24 jam, *Today* | | Payment Number | Nomor digunakan pada saat | Opsional | | TXID | ID | Opsional | | Search | Tombol untuk mem kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Excel | Tombol untuk mem kata kunci dimasukkan untuk *file* akan di | Format *file* akan di dalam format Excel | Bagian `Search Result` pada *metode pembayaran: QRIS* menampilkan rincian data per . dapat melihat rincian terkait dari *hyperlink *dan rincian dari *pop-up * tersedia. Bagian ini terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ---------------- | ------------------------------------------------------------------ | ------------------------------------------------------------------------- | | Records per page | *Dropdown* untuk menampilkan data dalam jumlah tertentu pada tabel | | | Payment Method | Metode digunakan pada saat | *Default*: | | I-MID | ID | | | Brand Name | Nama merek melakukan | | | Deposit Amount | Nominal uang dalam | | | Date of Deposit | Tanggal | | | Last Noti | Waktu terakhir berjalan | | | Noti Count | Jumlah pengiriman dilakukan | | | | Nama mengeksekusi | | | Phone Number | Nomor ponsel digunakan dalam | | | Status | Status | *Default*: All -> semua

Pilihan :
* All * Fail * Success | | Checkbox | Untuk memilih akan melalui pengiriman ulang | | | Resend | Tombol untuk melakukan pengiriman ulang | | | Pagination | Jumlah untuk melihat riwayat | | ## GPN Card ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/7SUKoPsZpSlwsDNIUF-5l_10.png "Transaction - Noti History - GPN Card") Bagian `Search Option` pada *metode pembayaran: GPN Card* berisi formulir pencarian spesifik khusus untuk mencari data Card. Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | | | Daftar terdaftar pada | *Default*: Total -> semua | | Payment Method | Daftar terdapat pada | *Default*: Card

Isi *dropdown*:
* Total * * * CVS * Click Pay * * * * * Card | | Name | Nama yang digunakan untuk | *Default*: Total -> semua | | Status | Status | *Default*: All -> semua

Isi *dropdown*:
* All * Success * Fail | | Date of Deposit | Waktu berhasil masuk dalam format tanggal dan jam

Pengaturan waktu bisa langsung ditentukan antara hari ini, 1 minggu, atau 1 bulan | *Default*: tanggal hari ini dan jarak waktu 24 jam

*Default: Today* | | Card Number | Nomor kartu digunakan pada saat | Opsional | | TXID | ID | Opsional | | Search | Tombol untuk mem kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Excel | Tombol untuk mem kata kunci dimasukkan untuk *file* akan di | Format *file* akan di dalam format Excel | Bagian `Search Result` pada *metode pembayaran: GPN Card* menampilkan rincian data per . dapat melakukan pengiriman ulang dengan memilih menggunakan `checkbox` kemudian tekan `resend`. Bagian ini terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ---------------- | ------------------------------------------------------------------ | ------------------------------- | | Records per page | *Dropdown* untuk menampilkan data dalam jumlah tertentu pada tabel | | | Payment Method | Metode digunakan pada saat | *Default*: GPN Card | | I-MID | ID | | | Brand Name | Nama merek melakukan | | | Deposit Amount | Nominal uang dalam | | | Date of Deposit | Tanggal | | | Last Noti | Waktu terakhir berjalan | | | Noti Count | Jumlah pengiriman dilakukan | | | Bank | Nama mengeksekusi | | | Card Number | Nomor kartu digunakan dalam | | | Status | Status | Pilihan :
* Fail * Success | | Checkbox | Untuk memilih akan melalui pengiriman ulang | | | Resend | Tombol untuk melakukan pengiriman ulang | | | Pagination | Jumlah untuk melihat riwayat | | # Tutorial *** ## Mencari Data Transaksi Berikut panduan untuk mencari data . 1. Buka *sidebar*. 2. `Transaction`. 3. `Noti History`. 4. ketentuan pencarian pada `Search Option`. 5. `Search` untuk melakukan pencarian data. 6. Data dicari akan muncul pada `Search Result`. ## Mengunduh Data Transaksi Berikut panduan untuk mengunduh data transaksi. 1. Buka *sidebar*. 2. `Transaction`. 3. `Noti History`. 4. ketentuan pencarian pada `Search Option`. 5. `Excel` untuk mengunduh data dalam bentuk format Excel. 6. Data dicari akan terunduh secara otomatis. # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Transaction Data](docId\:iZwosih8r9HIc0UurgYMa) untuk mengetahui cara memeriksa data . ::: :::VerticalSplitItem [Fail Transaction](docId\:Kw36Cm_cK3RzRNUHfzavQ) untuk mengetahui cara memeriksa gagal. ::: :::: [title] FAQ [path] Merchant Back Office/Notice & Help/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/1GE_CjdSfv0rX6tFmpufF_back-office-mms-30.png "FAQ") Sub-menu `FAQ` berisi kumpulan baru sering ditanyakan oleh selain pernah diberitahu oleh tim . Fitur ini disediakan oleh tim untuk memudahkan penyebaran baru kepada semua secara bersamaan. ::embed[]{url="https://youtu.be/7wGG-fpR0OI"} # Frequently Ask Question *** ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/k1cOG58QIN4CLRsDqnsyP_back-office-mms-50.png "Notice & Help - FAQ") Halaman `FAQ` terbagi menjadi 2 , yaitu `Search Option` dan `Search Result`. Bagian `Search Option` adalah formulir digunakan untuk memasukkan kriteria pencarian data. Bagian `Search Result` untuk menampilkan hasil pencarian berdasarkan kriteria telah dimasukkan pada `Search Option`. Data akan ditampilkan setelah melakukan konfirmasi pencarian data dengan menekan `Search`. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/hXj_YlQFCEr9nQs25QbZS_back-office-mms-2022-10-25t113116181.png "FAQ - Search Result") | **Nama** | **Deskripsi** | **Keterangan** | | -------- | -------------------------- | -------------- | | Type | Tipe jenis pertanyaan | | | Title | Judul topik | | | Search | Tombol navigasi pencarian | | # Tutorial *** ## Mencari Data FAQ Berikut panduan untuk mencari data FAQ. 1. `Notice & Help`. 2. `FAQ`. 3. ketentuan pencarian pada `Search Option`. 4. `Search` untuk melakukan pencarian data. 5. Data dicari akan muncul pada `Search Result`. ## Melihat Rincian Data FAQ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/mmPJSHOHXrMjl7NGuadtm_faq-view.png "FAQ - View") Berikut panduan untuk mencari data . 1. `Notice & Help`. 2. `FAQ`. 3. \{\{masuk}} ketentuan pencarian pada `Search Option`. 4. `Search` untuk melakukan pencarian data. 5. Data dicari akan muncul pada `Search Result`. 6. *hyperlink *pada baris data dalam kolom Title. 7. Bagian `View` akan muncul di atas `Search Option` akan menampilkan rincian data FAQ. # See also ::::VerticalSplit :::VerticalSplitItem [Notice](docId\:aXtwALglhPwRuNzaNRuMP) untuk mengetahui cara membaca pengumuman. ::: :::VerticalSplitItem [Contact CS](docId\:QYQF9kWzsJKLceF9l8POE) untuk mengetahui cara menghubungi CS. ::: :::: [title] SMS Top Up [path] Merchant Back Office/Service/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/XozGe5h_xrPmnK9nmDoG5_service-sms-top-up.jpg "SMS Top Up") # SMS Top Up Sub-menu `SMS Top Up` berfungsi untuk melakukan isi ulang dana/token agar dapat menikmati pengiriman kepada untuk membagikan terkait promo, OTP, , dan lain-lain. ::embed[]{url="https://youtu.be/k2usT1iQ1gw"} Sub-menu `SMS Top Up` terbagi menjadi 2 , yaitu `Search Option` dan `Search Result`. Bagian `Search Option` adalah formulir digunakan untuk memasukkan kriteria pencarian data. Bagian `Search Result` untuk menampilkan hasil pencarian berdasarkan kriteria pencarian. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/6ReXJbERO4s7tkk6HiyTZ_back-office-mms-2022-11-07t163001133.png "SMS Top Up - Search Option") Pada `Search Option` terdapat formulir sebagai kriteria pencarian data. Selain itu, juga dapat mengajukan penambahan token untuk menggunakan dan meng data riwayat pemesanan token . Formulir `Search Option` terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | -------------- | -------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ | | Register Date | Tanggal terdaftar

Pengaturan waktu juga bisa langsung ditentukan antara hari ini, 1 minggu, atau 1 bulan | *Default selection*: tanggal hari ini dan jarak waktu 24 jam | | Search | Tombol untuk mem kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Excel | Tombol untuk mem kata kunci dimasukkan untuk *file* yang di | Format *file* akan di dalam format Excel (.XLS) | | Request Top Up | Tombol untuk *request* token | Harga akan dikalikan dengan jumlah token diinginkan | Bagian `Search Result` menampilkan riwayat data pembelian token berdasarkan waktu pemesanan terakhir. dapat mengonfirmasi jika baru diajukan. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/-gzmEbKg46vrAE_TNKfFC_back-office-mms-2022-11-07t163425986.png "Search Result SMS Top Up") ## Request Top Up ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/ALMt01aM0o8CjruB-Fbj6_back-office-mms-2022-11-07t163615015.png "Top Up Request") Pada bagian `Search Result`, terdapat `Request Top Up` digunakan untuk mengajukan pembelian token agar dapat melakukan pengiriman dengan menggunakan . Formulir `Top Up Request` terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | --------------------------------- | ------------------------------------ | ----------------------------------------------------------------------------- | | Enter Top Up Token (provider) | Pilih provider jaringan diinginkan | Isi *dropdown*:
* XL AXIATA * Indosat * SMARTFREN * Telkomsel * 3 | | Enter Top Up Token (jumlah token) | Input jumlah token diinginkan | Jumlah token terkalkulasi otomatis dengan biaya per token | | Request | Tombol untuk mengajukan top-up | | | Cancel | Tombol untuk membatalkan top-up | | Pada tab *pop up* tampil, jumlah token dan biaya akan terkalkulasi secara otomatis. dapat melihat jumlah tagihan perlu dibayarkan pada nominal rupiah tampil. ::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/5fh15ixZsOZ44Eb_6YfvE_image.png" size="80" width="954" height="659" caption="Top Up Request Token" position="center" showCaption="true"} # Tutorial *** ## Mencari Data SMS Top Up ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/eVScoDzILdiDRU9YvyUgw_back-office-mms-2022-11-07t163425986.png "SMS Top Up - Search Result") Berikut panduan untuk mencari data riwayat . 1. Buka *sidebar*. 2. `Service`. 3. `SMS Top Up`. 4. ketentuan pencarian pada `Search Option`. 5. `Search` untuk melakukan pencarian data. 6. Data dicari akan muncul pada `Search Result`. ## Mengunduh Data SMS Top Up ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/UIEiQTPUQKiPHMfINjvW0_back-office-mms-2022-11-07t170842297.png "SMS Top Up - Search Option") Berikut panduan untuk mengunduh data riwayat . 1. Buka *sidebar*. 2. `Service`. 3. `SMS Top Up`. 4. ketentuan pencarian pada `Search Option`. 5. `Excel` untuk mengunduh data dalam bentuk format Excel. 6. Data dicari akan terunduh secara otomatis. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/GGq0APEL8wQNgLqtDhV7d_back-office-mms-2022-11-07t171335572.png "SMS Top Up - Downloaded File") ## Mengajukan Token SMS Top Up Berikut panduan untuk mengajukan token SMS Top Up. 1. Buka *sidebar*. 2. `Service`. 3. `SMS Top Up`. 4. ketentuan pencarian pada `Search Option`. 5. `Request TopUp` untuk melakukan permintaan *request* token untuk dapat menggunakan . 6. jumlah token diinginkan pada `Top Up Request Token` dan pilih provider jaringan. Harga akan terkalkulasi secara otomatis berdasarkan harga per token dikali dengan total token dimasukkan. 7. `Payment` untuk melanjutkan ke . 8. Data akan langsung muncul di tabel data pada `Search Result`. 9. `Confirm Payment` untuk melanjutkan . 10. *Pop-up *`Confirmation Payment` akan muncul dan berisi daftar nomor rekening untuk melakukan . ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/AMq7SpMOmL30JJ5XANiDW_back-office-mms-2022-11-07t192916316.png "Nomor Top Up Token Tutorial") ::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/9oXRQDsaNPPN_uQTV_Wo0_image.png" size="80" width="950" height="666" caption="Klik Request untuk Melanjutkan" position="center" showCaption="true"} ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/Zj93v2p4DMc9lLJOfDnVN_back-office-mms-2022-11-07t194509008.png "Melihat Data pada Search Result, klik Request Payment") ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/9I7QaIW0uIZdD-bxlhbll_service-sms-top-up-payment-confirm-tf.jpg "Confirmation Payment") # See also ::::VerticalSplit :::VerticalSplitItem Temukan terkait pengiriman pesan pada [SMS](docId\:jNixDDXA2UQM43_-bEXmO). ::: :::VerticalSplitItem [SMS History Log](docId\:iEREuK7SKBxL6YfUaFgQT) untuk mengetahui cara mengecek riwayat terkirim. ::: :::: [title] Profile [path] Merchant Back Office/ Menu `Profile` digunakan oleh untuk melihat profil secara rinci, mengatur akses Admin/Pengguna , dan mengatur limit pada . ::::LinkArray :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-zDnVzxx6nM6iiarD4Cv86-20240731-095554.jpg"} [Merchant Data](docId:7IhkFtaIHOX62F21vl8Bq) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-azCQJamibiG_r62pI0afx-20240731-095608.jpg"} [User ID](docId\:Tjd1p8wHGH1E-QVsS8XJ0) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-x1kKiv8QtmoF-yDcPJsTy-20240731-095621.jpg"} [Transaction Limit](docId\:TFslgr1ys133jJKPqEoer) ::: :::: # See also ::::VerticalSplit :::VerticalSplitItem [Merchant Back Office](docId\:VMD8YtiiJqku6H8dRhcS6) untuk mempelajari platform disediakan . ::: :::VerticalSplitItem [Login](docId\:E06mj1OMQy3XDodSVlY31) untuk cara akses ke dalam platform. ::: :::: ::::VerticalSplit :::VerticalSplitItem [Dashboard](docId\:ca0Tnj_-gHDF6qjwmjzi1) untuk mempelajari khusus memantau secara *real-time*. ::: :::VerticalSplitItem [Notice & Help](docId\:jZ2Nclue19F_w41Vx_PIS) untuk mengetahui khusus pengumuman dan bantuan. ::: :::: [title] Discount Event Enroll [path] Merchant Back Office/Discount Event/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/TnihyP__OhZyivh5yPxl-_back-office-mms-23.png "Discount Event Enroll") Sub-menu ini membantu membuat dan mengatur *event *diskon. Halaman ini terbagi menjadi 2 , yaitu `Search Option` dan `Discount Event List`. ::embed[]{url="https://youtu.be/X2PlRm1-eMY"} Bagian `Search Option` adalah formulir digunakan untuk memasukkan kriteria pencarian data . Setiap *field* terdapat pada formulir ini bersifat opsional. dapat melakukan pencarian data untuk ditampilkan pada `Discount Event List` atau mengunduh data dalam format Excel. Bagian `Discount Event List` adalah menampilkan hasil pencarian data berdasarkan kriteria dimasukkan pada `Search Option`. Data pada ini akan muncul setelah mengonfirmasi pencarian data dengan menekan `Search`. # Discount Event Enroll *** ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/0G1wHBc7YANNeN7tJU7w4_discount-event-enroll.png "Discount Event - Discount Event Enroll") Bagian `Search Option` berisi formulir pencarian digunakan untuk mencari semua data *event* sedang dibuat. Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | --------------- | --------------------------------------------------------------- | ----------------------------------------------------------- | | | Daftar terdaftar pada | *Default*: Total -> semua | | Event Date Time | Waktu dalam format tanggal dan jam | *Default*: tanggal hari ini dan jarak waktu 24 jam | | Search | Tombol untuk mem kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Excel | Tombol untuk mem kata kunci dimasukkan untuk *file* akan di | Format *file* akan di dalam format Excel | | New Event | Tombol untuk menampilkan formulir pembuatan *event* baru | Formulir akan ditampilkan dalam bentuk *pop-up* | Bagian `Discount Event List` menampilkan daftar *discount event *sesuai dengan ketentuan dari bagian `Search Option`. Daftar tersebut berisi rincian masing-masing *event* sudah dibuat. # Tutorial *** ## Mencari Data Discount Event Enroll Berikut panduan untuk mencari data Discount Event. 1. Buka *sidebar*. 2. `Discount Event`. 3. `Discount Event Enroll`. 4. ketentuan pencarian pada `Search Option`. 5. `Search` untuk melakukan pencarian data. 6. Data dicari akan muncul pada `Search Result`. ## Mengunduh Data Discount Event Enroll Berikut panduan untuk mengunduh data Discount Event. 1. Buka *sidebar*. 2. `Discount Event`. 3. `Discount Event Enroll`. 4. ketentuan pencarian pada `Search Option`. 5. `Excel` untuk mengunduh data dalam bentuk format Excel. 6. Data dicari akan terunduh secara otomatis. ## Membuat Event Baru ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/VrBNhqB6HvTxQMCHKm9No_new-discount-event.png "Discount Event Enroll - New") Berikut panduan untuk membuka *pop-up* membuat data Discount Event baru. 1. Buka *sidebar*. 2. `Discount Event`. 3. `Discount Event Enroll`. 4. ketentuan pencarian pada `Search Option`. 5. `New Event` untuk membuat *event* baru. 6. Isi form pada *pop-up * muncul. - Pada **Event Detail of Exception Date**, waktu *event* dapat ditambahkan lebih dari satu dengan menekan `Add`. - Pada **Discount Event Rule**, ketentuan diskon dapat ditambahkan lebih dari satu dengan menekan `Add`. 7. `Save` untuk menyimpan. Sebaliknya, tekan `Cancel` untuk membatalkan pembuatan Discount Event baru. # See also ::::VerticalSplit :::VerticalSplitItem [Card Event History](docId\:EZbQsGUb8c02JifEDobHt) untuk mengetahui cara melihat riwayat data kartu saat *event *berlangsung. ::: :::VerticalSplitItem [Discount Event Transaction](docId\:S0LDFXlG5jHeF0tRTp9-y) untuk mengetahui cara memeriksa jumlah saat *event *berlangsung. ::: :::: [title] SMS History Log [path] Merchant Back Office/Service/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/RawlyJhuo2krsZ1K0zm4p_service-sms-history-log.jpg "SMS History Log") Sub-menu `SMS History Log` membantu untuk melihat riwayat pengiriman ke nomor para , baik sebagai OTP maupun notifikasi lainnya (promo atau ). juga dapat meng data laporan History Log, selanjutnya data akan terunduh dalam format XLS. ::embed[]{url="https://youtu.be/F57uf7pp9gM"} Sub-menu `SMS History Log` terbagi menjadi 2 ; yaitu `Search Option` dan `Search Result`. Bagian `Search Option` digunakan untuk memasukkan kriteria pencarian data. Bagian `Search Result` untuk menampilkan hasil pencarian berdasarkan kriteria pencarian data. # SMS History Log *** ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/91ixF9mdLZ58pM3EKIzMH_back-office-mms-2022-11-03t153640134.png "SMS History Log - Search Option") Bagian `Search Option` berisi formulir pencarian khusus digunakan untuk mencari riwayat log berdasarkan kriteria tertentu. Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ---------------- | -------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Merchant Name | Nama | | | Date Range | Periode waktu terkirim

Pengaturan waktu juga bisa langsung ditentukan antara hari ini, 1 minggu, atau 1 bulan | *Default Selection*: tanggal hari ini dan jarak waktu 24 jam | | SMS Type | Tipe | *Default*: OTP

Isi *dropdown*:
* Promo * Notifikasi * OTP | | Status | Status | *Default*: Total -> semua

Isi *dropdown*:
* Total * *Sent* * *Delivered* * *Undelivered* * *Waiting* * *Failed* * *Attempt* * dan lain-lain | | Operator Name | Nama operator | *Default*: Total -> semua nama operator

Isi *dropdown*:
* Total * Telkomsel * XL Axiata * dan lain-lain | | Recipient Number | Nomor telepon Penerima | Opsional | | TXID | Nomor | Opsional | | Search | Tombol untuk memproses kata kunci yang dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Excel | Tombol untuk mem kata kunci dimasukkan untuk *file* akan di | Format *file* akan di dalam format Excel (.XLS) | Bagian `Search Result` menampilkan riwayat data *log* berdasarkan kriteria pencarian. dapat melihat dan rincian dari terkirim. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/Wy5FpnO35yT7vk29SqOdG_back-office-mms-2022-11-03t155802504.png "SMS History Log - Search Result") ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/yTLLoI0gNQ8aVGt84DYJV_back-office-mms-2022-11-03t161703618.png "SMS History Log - Search Result - Detail SMS History Log") # Tutorial *** ## Mencari Data SMS History Log ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/OkesXwR7EMAUDInLpJBFi_back-office-mms-2022-11-03t155802504.png "SMS History Log - Search Result") Berikut panduan untuk mencari data . 1. Buka *sidebar*. 2. `Service`. 3. `SMS History Log`. 4. ketentuan pencarian pada `Search Option`. 5. `Search` untuk melakukan pencarian data. 6. Data dicari akan muncul pada `Search Result`. ## Mengunduh Data SMS History Log ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/kCmNxkva1B4wtXlRtAUW8_back-office-mms-2022-11-03t163951687.png "Unduh SMS History Log") Berikut panduan untuk mengunduh data . 1. Buka *sidebar*. 2. `Service`. 3. `SMS History Log`. 4. ketentuan pencarian pada `Search Option`. 5. `Excel` untuk mengunduh data dalam bentuk format Excel. 6. Data dicari akan terunduh secara otomatis. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/eLvSpVQV4J3beBOl7WSi__back-office-mms-2022-11-03t170206720.png "File XLS SMS Log History") # See also ::::VerticalSplit :::VerticalSplitItem Temukan terkait pengiriman pesan pada [SMS](docId\:jNixDDXA2UQM43_-bEXmO). ::: :::VerticalSplitItem [SMS Top Up](docId\:ubOKZmYWQRYzfqeK6lFeK) untuk mengetahui cara mengatur kredit . ::: :::: [title] Keamanan [path] / # Tentang Keamanan Layanan NICEPAY *** Sebagai penyedia di , telah memenuhi standar keamanan berstandar internasional serta terus melakukan upaya meningkatkan standar terbaru secara berkala dalam ber agar terhindar dari aktivitas mencurigakan dapat merugikan berbagai pihak, baik maupun . Berikut adalah terkait keamanan terdapat pada . ## Standar dan Regulasi Keamanan ### Fitur Keamanan memiliki [FDS](docId:2AiAtHqlp0XvXFeyxwLxp) dan [3Ds](docId\:K2kAIdgQyEqmJVoC4f6ul) sebagai fitur keamanan dalam menjaga keamanan menggunakan . ### Compliance telah memiliki lisensi dan sertifikasi keamanan secara lokal, seperti PJP (Penyedia Jasa Pembayaran) kategori izin 2 terkait *Payment Gateway* dan 3 terkait PTD (Penyelenggara Transfer Dana) dari , PSE Domestik dari Kominfo serta sertifikasi kepatuhan internasional, yaitu PCI DSS Level 1 dan PCI 3DS. ## Peran dan Tanggung Jawab Menjaga Keamanan Menjaga keamanan menjadi tanggung jawab dan peran semua pihak, tidak hanya . bertanggung jawab dalam menjaga keamanan transmisi data, melakukan identifikasi pengguna, dan autentikasi akses pada komponen . Berikut adalah daftar hal merupakan tanggung jawab dalam menjaga keamanan . 1. Menjaga data pemegang kartu dengan kriptografi terkuat ketika transmisi terbuka pada jaringan publik. - Melakukan dan mekanisme untuk melindungi data pemegang karu dengan kriptografi terkuat ketika melakukan transmisi secara terbuka pada jaringan publik secara terdefinisi dan terdokumentasi. - PAN dilindungi oleh kriptografi terkuat pada saat transmisi. - Kriptografi terkuat dan protokol keamanan terimplementasi mengikuti penjagaan PAN pada saat transmisi terbuka pada jaringan publik: - Hanya *keys *dan sertifikat-sertifikat terpercaya diterima. - Sertifikat-sertifikat digunakan untuk menjaga PAN pada transmisi terbuka, jaringan publik dikonfirmasi berlaku dan tidak kedaluwarsa atau dicabut; mengarah pada catatan *applicability *di bawah untuk lebih rinci. - Protokol digunakan dalam mendukung hanya versi-versi atau konfigurasi-konfigurasi aman dan tidak mendukung *fallback to*, atau menggunakan versi, algoritma, *key sizes*, atau implementasi-implementasi tidak aman. - Kekuatan enkripsi tepat untuk metodologi enkripsi digunakan. - Inventaris pada entiti *keys *dan sertifikat-sertifikat terpercaya digunakan untuk melindungi PAN pada penjagaan transmisi. 2. Identifikasi pengguna dan autentikasi akses menuju komponen-komponen . - Identifikasi pengguna dan akun-akun terkait untuk para pengguna dan administrator diatur secara ketat melalui sebuah *account's lifecycle.* - Seluruh pengguna diberikan sebuah ID unik sebelum mengakses komponen-komponen atau data pengguna kartu diperbolehkan. - Autentikasi kelompok, berbagi, atau akun generik atau autentikasi kredensial berbagi lainnya hanya digunakan ketika dibutuhkan oleh dasar pengecualian, dan diatur sebagai berikut: - Penggunaan akun dilarang kecuali dibutuhkan untuk keadaan tidak terduga. - Penggunaan terbatas untuk waktu dibutuhkan untuk keadaan tidak terduga. - Justifikasi untuk penggunaan terdokumentasi. - Pengunaan eksplisit disetujui oleh manajemen. - Identitas pengguna individu dikonfirmasi sebelum melakukan akses kepada akun diberikan. - Setiap aksi diambil dapat diatribusikan untuk pengguna individu. ## Keamanan Produk NICEPAY ### Transmisi Data telah menggunakan enkripsi TLS versi 1.2 dan 1.3 pada seluruh *endpoint *melalui protokol HTTPS dalam menjaga keamanan transmisi data dalam bertransaksi baik antara dengan , dengan maupun pihak lain terhubung dengan . ### Autentikasi memiliki autentikasi khusus dalam melakukan verifikasi data dalam untuk SNAP dan non-SNAP. Pada SNAP, autentikasi menggunakan [Request Access Token API - SNAP](docId\:GcGqBIYXG1Etcd0Ji9cHX) dengan mengikuti ketentuan dari Asosiasi Sistem Pembayaran . Sementara pada non-SNAP, autentikasi menggunakan [Merchant Token](docId\:N1Tlg7ZLqifvsLrHQcIbg). ### Callback Handling Callback Handling digunakan oleh untuk melakukan verifikasi kepada . ### Whitelist IP :::Iframe{iframeHeight="0" code="Para Merchant dapat melakukan Whitelist IPs untuk meningkatkan keamanan sistem mereka jika dibutuhkan. Silakan menghubungi NICEPAY Customer Service untuk mendapatkan daftar IP NICEPAY."} ::: ### Notifikasi dan Status Transaksi Setiap berjalan pada memiliki otomatis berisi dan berbeda-beda sesuai dengan tahapan suatu . disarankan untuk memeriksa menggunakan Status Inquiry secara berkala agar terhindar dari *notification injection *dari pihak tidak bertanggung jawab. Daftar Status Inquiry : | **Versi API** | **Tautan API ** | | ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Versi SNAP | - [Check Status Transaction - API Virtual Account SNAP](docId\:xaW0SxwKv9j7b5zLbtVpR) - [Check Status Transaction - API QRIS SNAP](docId:3aXWe6p6cyHX_ZuN-bvgQ) - [Check Status Transaction - API E-Wallet (Direct Debit) SNAP](docId\:vB63D8suaKPYP-4bIOWx9) - [Inquiry - API Payout (Disbursement) SNAP](docId\:GkYB9CEm1x0EzRv_wCLre) - [Inquiry History - API SNAP Provider](docId\:Olc0B9o2WVLn4oNRwn5Gg) - [Inquiry - API NICEPAY Inquiry Virtual Account SNAP](docId\:vI_LyF6ua8mD2Z0jOpB4g) | | Versi 2 | * [Status Inquiry - API Checkout](docId\:TSmZvN-UlKa6HNMBKk5Wl) * [Status Inquiry - API Credit Card](docId:9ivqI-i4yka9S1oz6S-Ha) * [Status Inquiry - API Virtual Account](docId\:GQrExfRFyFx9oFuEGUAp4) * [Status Inquiry - API Convenience Store](docId\:yPIvnUMvfvrKIKzInNq48) * [Status Inquiry - API Direct Debit](docId\:rbnsw-OyLCHGzx9NQIuJG) * [Status Inquiry - API E-Wallet](docId:_S9ys-JjpQYZt9varBhsB) * [Status Inquiry - API Payloan](docId\:OQCkFXNuWKspkGDkFmJb5) * [Status Inquiry - API GPN](docId\:zIr5HZgz6QsfBwJhGmOlz) * [Status Inquiry - API QRIS](docId\:jCWrYGsjVJ1sGUu6dxMFJ) * [Inquiry - API Payout (Disbursement)](docId\:Pakr5IhyUSelmt0RZG8qt) | | Versi 1 | [V1 Check Transaction Status](docId\:o_8baHmPHnOgVNe8gMqCy) | :::hint{type="info"} *Notification Injection *adalah salah satu kerentanan keamanan di mana *attacker *mengirim tidak seharusnya ke dalam suatu . ::: ## Pemeliharaan Keamanan ### Program *Bug Bounty* mengapresiasi segala bentuk terkait masalah keamanan disampaikan. Akan tetapi, tidak memiliki program *Bug Bounty* dan tidak menyediakan hadiah apapun. Meskipun saat ini tidak memiliki program Bug Bounty untuk partisipasi publik, kami mungkin akan mempertimbangkan hal tersebut di masa mendatang. akan terus mengevaluasi dan meningkatkan keamanan kami berdasarkan standar nasional dan internasional sebagai prioritas utama untuk melindungi kerahasiaan setiap berjalan dalam kami. Untuk lebih lanjut terkait program *Bug Bounty *dan keamanan di masa mendatang, silakan kunjungi [situs web](https://nicepay.co.id/) dan akun media sosial resmi . [title] Syarat dan Ketentuan [path] Operasi Bisnis/ # Syarat dan Ketentuan Penggunaan NICEPAY DOCS *** Syarat dan Ketentuan Penggunaan (**"Situs"**) ini, mengakui bahwa telah membaca, memahami, dan setuju terhadap ketentuan dalam Situs ini serta setuju untuk terikat dengan Kebijakan *Privacy* milik ([Syarat dan Ketentuan](docId\:CDMCL8tEDbzhRRyU5VPaW)) dan seluruh ketentuan sebagaimana tercantum dalam Situs ini. ## A. Ketentuan Umum PT IONPay Networks () menetapkan bahwa setiap dibagikan pada portal ini dipublikasikan dengan itikad baik dan bertujuan untuk membagikan umum sesuai kebutuhan berbagai pihak terkait. Situs ini bertujuan untuk memberikan dan gambaran penggunaan kepada Pengguna Layanan atau calon Pengguna Layanan sebelum menggunakan disediakan oleh . berhak untuk mengubah ketentuan dalam ini tanpa pemberitahuan terlebih dahulu. Oleh karena itu, menyarankan agar dapat mengunjungi Situs ini secara berkala. ## B. Definisi 1. **NICEPAY** adalah perusahaan bergerak dibidang penyedia jasa telah mendapatkan izin dari dalam hal ini menyediakan sebagaimana dipublikasikan dalam Situs ini. 2. **Pengguna Layanan** adalah pihak mengunjungi Situs ini atau menggunakan Konten sebagaimana dipublikasikan dalam Situs ini. 3. **NICEPAY DOCS** adalah *website * menyediakan dan panduan mengenai , cara mengintegrasikan atau *payment gateway* ke dalam sebuah aplikasi, situs web, atau lainnya. 4. **Konten** adalah semua termasuk gambar, perincian, data, ilustrasi, desain, foto, klip video, teks, perangkat lunak, grafik, tulisan, logo atau merek dagang, dan materi lain merupakan bagian dari Situs ini dimiliki oleh atau dimiliki oleh pemilik Hak Kekayaan Intelektualnya termasuk namun tidak terbatas pada Canva dan Freepik. ## C. Ketentuan Berbagi Informasi 1. Pengguna Layanan wajib mencantumkan nama dan tautan sebagai sumber jika hendak membagikan Konten pada situs lain. 2. Untuk umum, Pengguna Layanan harus melakukan penulisan ulang dan tidak menyalin Konten secara utuh. 3. Pengguna Layanan tidak diperbolehkan untuk mengubah Konten dengan cara apapun, termasuk namun tidak terbatas pada menghilangkan atau mengubah pemberitahuan mengenai hak cipta atau tanda kepemilikan Hak atas Kekayaan Intelektual (HAKI) lainnya, memodifikasi, menerjemahkan, atau membuat karya turunan dari Konten. ## D. Pengakuan dan Persetujuan Pengguna Layanan 1. Pengguna Layanan bertanggung jawab penuh atas penggunaan Konten sebagaimana diatur dalam Situs ini serta membebaskan dari segala bentuk tanggung jawab terhadap segala risiko mungkin timbul di sisi Pengguna Layanan.  2. berhak untuk melakukan pembaharuan, penambahan, pengembangan, koreksi serta penghapusan terkait dan isi Konten pada Situs ini tanpa pemberitahuan sebelumnya kepada Pengguna Layanan.  ## E. Pembatasan dan Larangan 1. Setiap Pengguna Layanan hendak menggunakan fitur dan terkait dengan Konten pada Situs dilarang untuk:  - Menyebarkan konten pada portal lain tanpa melakukan izin maupun kredit kepada ; - Menambahkan maupun mengubah format telah tersedia dan akan digunakan atau dikirimkan kepada ; - Menggunakan Konten sebagai alat kejahatan termasuk namun tidak terbatas pada penipuan, penyebaran virus, pencantuman, dan penyebaran tidak wajar atau hal lainnya bertentangan dengan hukum (**"Tindakan Melawan Hukum"**).  2. Berikut ini adalah kategori usaha dan kegiatan dilarang untuk menggunakan : - Perjudian; - Produk Tembakau; - Minuman beralkohol; - Pornografi; - Obat Terlarang; - Melakukan kegiatan usaha menjadikan BitCoin (*Digital Gold*) sebagai alat selain untuk kegiatan usaha jual beli aset kripto sebagaimana diatur serta sepanjang diperbolehkan dalam peraturan perundang-undangan yang berlaku; - Senjata api dan senjata tajam; - Uang tunai dimuka; - Barang-barang artifisial yang melanggar HAKI; - Barang atau jasa melanggar hukum, perundang-undangan, dan/atau ketertiban umum; - Barang atau jasa melanggar norma-norma sosial, agama, dan/atau moral; - Dompet digital dapat diisi oleh melalui ; - Tidak bergerak dalam bidang *multi-level marketing* memiliki skema *money games* atau skema ponzi atau skema lain sejenis dibuktikan dengan sertifikat asosiasi penjual langsung (APLI) atau hasil *on-site*. ## F. Lisensi dan HAKI Segala hal melekat pada Konten baik pada Situs ataupun merupakan milik . Pengguna Layanan tidak diperkenankan untuk mengalihkan, melakukan sub-lisensi, dan menyalahgunakan informasi terkait Konten pada Situs ini. berhak untuk menuntut ganti rugi dan/atau melakukan tindakan hukum atas segala pelanggaran HAKI dilakukan oleh Pengguna Layanan. Tidak ada ketentuan dalam Situs ini memberikan, mengalihkan atau melepaskan, atau mengisyaratkan pemberian, pengalihan atau pelepasan, HAKI dimiliki oleh atau pemegang HAKI lainnya kepada Pengguna Layanan. ## G. Penyalahgunaan Nama dan Konten 1. Segala bentuk penyalahgunaan Konten atau menggunakan nama akan melalui hukum sesuai dengan peraturan berlaku di . 2. Segala bentuk perubahan atau Konten pada Situs  ini dilakukan oleh individu maupun kelompok tanpa izin dari akan melalui hukum sesuai dengan ketentuan berlaku di . 3. tidak bertanggung jawab atas segala hal merugikan Pengguna Layanan dan/atau pihak lain baik secara langsung maupun tidak langsung disebabkan Tindakan melawan Hukum dan atau kelalaian Pengguna Layanan terhadap Konten. ## H. Lain-lain 1. Ketentuan pada ini mengikat selama Pengguna Layanan melakukan akses terhadap Situs ini dan/atau selama menggunakan . 2. menyediakan Konten "sebagaimana adanya" dan "sebagaimana tersedia" tanpa jaminan apapun. Sepanjang diizinkan oleh hukum berlaku, menyangkal setiap dan seluruh jaminan lain ( secara tegas, tersirat atau lainnya), tidak adanya pelanggaran, atau ketepatan tujuan tertentu.    3. tidak menjamin bahwa perangkat lunak maupun disediakan bebas dari cacat hukum atau bersifat aktual termasuk tapi tidak terbatas pada stabilitas, akurasi, keandalan, kelengkapan, keabsahan, kesesuaian maupun keamanan dan gangguan.  4. tidak akan bertanggung jawab untuk setiap kehilangan atau kerugian Pengguna Layanan timbul dari terdapat pada Situs ini.  [title] Discount Event [path] Merchant Back Office/ Menu `Discount Event` digunakan oleh untuk mengatur manajemen diskon mulai dari membuat *event *diskon hingga memantau terjadi selama *event *diskon berlangsung. ::::LinkArray :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-39w-pi82Jb4k8dC8GABm1-20240731-091328.jpg"} [Discount Event Enroll](docId\:HS9L9Cw20M4tp83N3v1bR) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-s7_IM7Oc0iG8jC-fASp7_-20240731-091338.jpg"} [Discount Event Transaction](docId\:S0LDFXlG5jHeF0tRTp9-y) ::: :::: # See also ::::VerticalSplit :::VerticalSplitItem [Merchant Back Office](docId\:VMD8YtiiJqku6H8dRhcS6) untuk mempelajari platform disediakan . ::: :::VerticalSplitItem [Transaction](docId:7oUXdgyOx1PqOQBm9caDt) untuk mempelajari khusus mengatur dan memantau . ::: :::: ::::VerticalSplit :::VerticalSplitItem [Settlement](docId\:klbWMmAVT2ne0Y8OcP0F_) untuk mempelajari khusus untuk memantau . ::: :::VerticalSplitItem [Statistic](docId\:uBklBxrtiCfVe6SdoEl7B) untuk mempelajari khusus melihat rangkuman . ::: :::: [title] Statistic [path] Merchant Back Office/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/xD9PXKp4qpVcG_-MfMmgn_back-office-mms-61.png "Statistic") Menu `Statistic` membantu untuk melihat data laporan dalam bentuk tabel berdasarkan kriteria pencarian dipilih. Halaman ini terbagi menjadi 2 , yaitu `Search Option` dan `Search Result`. ::embed[]{url="https://youtu.be/KxZR2pwiAmQ"} Bagian `Search Option` adalah formulir digunakan untuk memasukkan kriteria pencarian data . Setiap *field* pada formulir `Search Option` bersifat opsional. dapat memilih tipe pencarian berdasarkan Layanan, , , maupun dengan periode waktu juga dapat disesuaikan. Bagian kedua pada ini adalah `Search Result` menampilkan hasil pencarian data berdasarkan kriteria dimasukan pada `Search Option`. Data akan ditampilkan setelah mengonfirmasi pencarian data dengan menekan `Search`. Hasil pencarian bergantung dan menyesuaikan *field* dipilih. # Statistic *** ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/CiBh2i5B7eobQELrmuGVL_back-office-mms-67.png "Statistic - Statistic") Bagian `Search Option` berisi formulir pencarian digunakan untuk mencari semua data. Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ----------------- | --------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | | Search Type | Tipe laporan statistik data ingin dicari | *Default*: By Service

Isi *dropdown*:
* By Service (berdasarkan *Service* ) * By (berdasarkan ) | | By | Pencarian data statistik secara spesifik berdasarkan tertentu | Dapat memilih total ataupun spesifik tertentu | | By | Pencarian data statistik secara spesifik berdasarkan tertentu | Dapat memilih total ataupun spesifik tertentu | | | dipilih | *Default*: Total -> semua | | Trx Date | Waktu dalam format tanggal dan jam | *Default*: tanggal hari ini dan jarak waktu 24 jam | | Trx Date (Within) | Jarak waktu

Pengaturan waktu bisa langsung ditentukan antara hari ini, 1 minggu, atau 1 bulan | *Default*: *Today* | | Excel | Tombol untuk memproses kata kunci dimasukkan untuk *file* akan diunduh | Data diminta akan terunduh dalam bentuk *file* Excel | | Search | Tombol untuk memproses kata kunci dimasukkan untuk mencari data | Format Data diminta akan tampil secara *online* pada `Search Result` | # Tutorial *** ## Mencari Data Transaksi ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/E0SOIbZ7JujRtwCUOW1zr_back-office-mms-71.png "Statistic") Berikut panduan untuk mencari data transaksi. 1. Buka *sidebar*. 2. `Statistic`. 3. `Statistic`. 4. ketentuan pencarian pada `Search Option`. 5. `Search` untuk melakukan pencarian data. 6. Data dicari akan muncul pada `Search Result`. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/f1SWQKOwA8f4FdlnjYAID_back-office-mms-70.png "Result Option Statistic Back Office (BO)") ## Mengunduh Data Transaksi ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/RexnHwJX83fc3X1K76nzE_back-office-mms-74.png "Hasil Unduh Data Transaksi") Berikut panduan untuk mengunduh data . 1. Buka *sidebar*. 2. `Statistic`. 3. `Statistic`. 4. ketentuan pencarian pada `Search Option`. 5. `Excel` untuk mengunduh data dalam bentuk format Excel. 6. Data dicari akan terunduh secara otomatis. # See also ::::VerticalSplit :::VerticalSplitItem [Merchant Back Office](docId\:VMD8YtiiJqku6H8dRhcS6) untuk mempelajari platform disediakan . ::: :::VerticalSplitItem [Transaction](docId:7oUXdgyOx1PqOQBm9caDt) untuk mempelajari khusus mengatur dan memantau . ::: :::: ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Discount Event](docId:2qa-RAoG00FVzWNpoW_ec) untuk mempelajari khusus mengatur *event*. ::: :::VerticalSplitItem [Settlement](docId\:klbWMmAVT2ne0Y8OcP0F_) untuk mempelajari khusus untuk memantau . ::: :::: [title] WooCommerce [path] NICEHub/ ::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/TZfMBLtHE5yEC6fpqh3Vn_biteship-woo.png" size="50" width="1925" height="489" position="center" caption="WooCommerce" showCaption="true"} *plugin* melalui di bawah ini. :::Iframe{iframeHeight="0" code=" Woocommerce Plugin at NICEPAY Github"} ::: # Langkah *Install Plugin* WooCommerce *** 1. `Woocommerce Plugin at NICEPAY Github` di atas. 2. dan *plugin* akan digunakan dari daftar *plugin* ada. 3. `Plugin`. 4. `Tambah Baru`. 5. `instal / unggah Plugin`. 6. `Choose File`, kemudian pilih *file* *plugin* sudah diunduh sebelumnya. 7. `Aktifkan Plugin` untuk menggunakan *plugin.* ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/UANjLN27Dee3YcT-ODlWk_1679282891695.jpg "Plugin > Tambah Baru") ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/fl_nYn9osZSFTNzug4tIc_1679283108675.jpg "Tambahkan Plugin - Choose File") ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/X0RGVUdVG6jqEbmEFQs9K_1679283185786.jpg "Aktifkan Plugin") # Langkah Integrasi *** 1. Akses ke `Admin`. 2. `Plugin`. 3. `Tambah Baru`. 4. Unggah modul dalam format `.zip`. 5. `Plugin > Plugin Terpasang` untuk mengecek apakah modul sudah aktif atau belum setelah unggahan modul selesai. 6. *tab* `Aktif`. 7. `WooCommerce` untuk menambahkan di . 8. `Setting`. 9. *tab* `Checkout`. 10. `NICEPAY`. 11. `MID` dan `NICEPAY Merchant Key`. 12. centang `Enable`. 13. `Save Changes`. 14. sudah siap digunakan. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/8QVs2uzZqzgClb6wfhmg8_1.png "Plugin > Tambah Baru") ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/mneGHzMeV1s0IVspkx0UT_2.png "Plugin > Plugin Terpasang") ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/yJJ3JsP-FV21-aUKvzI2W_3.png "WooCommerce > Settings > Checkout") ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/431KFqvFPRTY18QaY4WPW_4.png "Checkout Tab") # See also ::::VerticalSplit :::VerticalSplitItem [WHMCS](docId\:NO4ygU907fgBPmulTICpC) untuk mengetahui cara dengan *platform* lain. ::: :::VerticalSplitItem [FAQ NICEHub & General](docId\:OYV7icLzDqtFeiCqYv2KO) jika ingin mengetahui pertanyaan sering diajukan terkait dan . ::: :::: [title] Pending Settlement [path] Merchant Back Office/Settlement/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/MzCfpGk_8HkBMk5mLrK6J_settlement-pending-settlement.png "Pending Settlement") Sub-menu ini membantu untuk mencari sedang *pending *untuk di-*settle* ke . Halaman ini terbagi menjadi 2 , yaitu `Search Option` dan `Search Result`. ::embed[]{url="https://youtu.be/R6VQezcpwxM"} Bagian `Search Option` adalah formulir digunakan untuk memasukkan kriteria pencarian data . Setiap *field* yang terdapat pada formulir ini bersifat opsional. Namun, hasil pencarian yang dicari bergantung pada yang dipilih. dapat melakukan pencarian data untuk ditampilkan pada `Search Result` atau meng data dalam format Excel. Bagian `Search Result` adalah menampilkan hasil pencarian data berdasarkan kriteria dimasukkan pada `Search Option`. Data pada ini akan muncul setelah mengkonfirmasi pencarian data dengan menekan `Search`. Hasil pencarian data ditampilkan berbeda-beda sesuai dengan dipilih pada `Search Option`. # Pending Settlement *** ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/4G_Fw3clRF8ynz5Wa8hFy_back-office-mms-43.png "Reconcile - Pending Settlement") Bagian `Search Option` berisi formulir pencarian digunakan untuk mencari semua data *pending*. Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ------------- | ----------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- | | | Daftar terdaftar pada | *Default*: Total -> semua | | Date | Waktu *Pending Settlement *dalam format tanggal dan jam | *Default*: tanggal hari ini dan jarak waktu 24 jam | | Date (Within) | Jarak waktu *Pending Settlement*

Pengaturan waktu bisa langsung ditentukan antara hari ini, 1 minggu, atau 1 bulan | *Default*: *Today* | | Search | Tombol untuk mem kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Excel | Tombol untuk mem kata kunci dimasukkan untuk *file* akan di | Format *file* akan di dalam format Excel | Bagian `Search Result` menampilkan daftar Pending Settlement sesuai dengan ketentuan dari `Search Option`. Daftar tersebut berisi rincian masing-masing *Pending Settlement.* ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/FO2013gZOu6HktOOr7gZ1_main.png "Pending Settlement - Search Result") dapat melihat rincian terkait dari `Search` untuk menampilkan rincian dari *pop-up * tersedia. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/aa6ccm1v817fPwKHbnhFP_detil.png "Pending Settlement - Rincian per data") # Tutorial *** ## Mencari Data Pending Settlement Berikut panduan untuk mencari data Pending . 1. Buka *sidebar*. 2. `Settlement`. 3. `Pending Settlement`. 4. ketentuan pencarian pada `Search Option`. 5. `Search` untuk melakukan pencarian data. 6. Data dicari akan muncul pada `Search Result`. ## Mengunduh Data Pending Settlement Berikut panduan untuk mengunduh data Pending . 1. Buka *sidebar*. 2. `Settlement`. 3. `Pending Settlement`. 4. ketentuan pencarian pada `Search Option`. 5. `Excel` untuk mengunduh data dalam bentuk format Excel. 6. Data dicari akan terunduh secara otomatis. # See also ::::VerticalSplit :::VerticalSplitItem [Settlement Report](docId:9ESDQYwVyCq3ce254IC3B) untuk mengetahui laporan . ::: :::VerticalSplitItem [Seller Settlement](docId\:g4YT2vmfgxssUWbcUojuX) untuk mengetahui riwayat Penjual*.* ::: :::: [title] Preauth Data [path] Merchant Back Office/Transaction/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/mejYb5XppN9D6sI53MxGR_transaction-preauth-data.png "Preauth Data") Sub-menu `Preauth Data` berfungsi untuk melihat seluruh data Pre-Auth, Capture & Cancel. Halaman ini terbagi menjadi 2 , yaitu `Search Option` dan `Search Result`. ::embed[]{url="https://youtu.be/HST64HfilGM"} Bagian `Search Option` adalah formulir digunakan untuk memasukkan kriteria pencarian data . dapat melakukan pencarian data untuk ditampilkan pada `Search Result` atau meng data dalam format Excel. Bagian `Search Result` adalah menampilkan hasil pencarian data berdasarkan kriteria dimasukkan pada `Search Option`. Data pada ini akan muncul setelah mengonfirmasi pencarian data dengan menekan `Search`. # Preauth Data *** ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/FosGxaYm50jwx4QDj27eI_1.png "Transaction - Preauth Data") Bagian `Search Option` berisi formulir pencarian digunakan untuk mencari semua data. Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ------------------- | --------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | Daftar terdaftar pada | *Default*: Total -> semua | | Trx Time | Waktu dalam format tanggal dan jam | *Default*: tanggal hari ini dan jarak waktu 24 jam | | Trx Time (*Within*) | Jarak waktu

Pengaturan waktu bisa langsung ditentukan antara hari ini, 1 minggu, atau 1 bulan | *Default*: *Today* | | Name | Nama Pelanggan | Opsional | | Order Number | Nomor pesanan | Opsional | | Trx Amount | Batas minimum (*From*) dan maksimum (*To*) | Opsional | | Preauth Status | Status | *Default*: Total -> semua status trx

Isi *dropdown*:
* Total * Preauth: cek disahkan oleh pembayar di muka * Capture: cek digunakan * Cancel: dibatalkan | | Acquire | Daftar nama *Acquire* | *Default*: Total -> semua *Acquire* | | Issuer | Daftar nama *Issuer* | *Default*: Total -> semua *Issuer* | | Approval Code | Kode persetujuan Pelanggan | Opsional | | Email | Email Pelanggan | Opsional | | Contract Number | Nomor kontrak Pelanggan | Opsional | | TXID | ID | Opsional | | Search | Tombol untuk mem kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Excel | Tombol untuk mem kata kunci dimasukkan untuk *file* akan di | Format *file* akan di dalam format Excel | Bagian `Search Result` terbagi menjadi dua tabel. Tabel pertama menampilkan ringkasan terdapat pada . Tabel kedua menampilkan rincian data per . Admin dapat melihat rincian terkait dari *hyperlink *dan rincian dari *pop-up * tersedia. # Tutorial *** ## Mencari Data Transaksi Berikut panduan untuk mencari data . 1. Buka *sidebar.* 2. `Transaction`. 3. `Preauth Data`. 4. ketentuan pencarian pada `Search Option`. 5. `Search` untuk melakukan pencarian data. 6. Data dicari akan muncul pada `Search Result`. ## Mengunduh Data Transaksi Berikut panduan untuk mengunduh data . 1. Buka *sidebar*. 2. `Transaction`. 3. `Preauth Data`. 4. ketentuan pencarian pada `Search Option`. 5. `Excel` untuk mengunduh data dalam bentuk format Excel. 6. Data dicari akan terunduh secara otomatis. # See also ::::VerticalSplit :::VerticalSplitItem [Beneficiary Account](docId\:UX7TnX6wKsQFy_kXIvDbD) untuk mengetahui cara memeriksa data akun penerima. ::: :::VerticalSplitItem [Payout Balance](docId\:g9JdFsDXboWzf2TEHzkrC) untuk mengetahui cara memeriksa . ::: :::: [title] User ID [path] Merchant Back Office/Profile/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/Rt6YfVi-EyFCCgergGVJ4_back-office-mms-66.png "User ID") # User ID *** Sub-menu `User ID` berfungsi untuk mengatur akses Pengguna seperti menambahkan Pengguna baru, mengatur ulang *password*, dan mengubah pengaturan Pengguna. ::embed[]{url="https://youtu.be/4Zeuqo5Gqwo"} Halaman ini terbagi menjadi 3 , yaitu `Search Option`, `Search Result`, dan `Regist`. Bagian `Search Option` adalah berisi formulir digunakan untuk memasukkan kriteria pencarian data. Bagian `Search Result` adalah menampilkan hasil pencarian data berdasarkan kriteria dimasukkan. Bagian `Regist`adalah laman untuk melanjutkan prosedur pendaftaran data ke dalam Whitelist. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/cfvfUO0DBouZ29at8WNAg_back-office-mms-56.png "Profile - User ID") Formulir dalam ini terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ------------------- | ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | | User ID | ID Pengguna | | | User Name | Nama pemilik Pengguna | | | User Authority Name | Jenis otoritas Pengguna | *Default*: Total -> semua data

Isi *dropdown*:
* Total * CP Super Admin * CP Read Only * Transaction - Edit * dll | | Status | Status keaktifan Pengguna | Default: Total -> semua data

Isi *dropdown*:
* Total * In Use * Pause | | Search | Tombol untuk menampilkan hasil pencarian | | | Registrasi | Tombol untuk mendaftarkan Pengguna baru | | ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/ZSOjsl3rYgfNjMjOc0CXh_back-office-mms-2022-10-26t132850767.png "User ID - Search Result") Formulir dalam ini terdiri dari: | **Nama** | **Deskripsi ** | **Keterangan** | | ------------- | ------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | | User ID | ID Pengguna | | | User Name | Nama pemilik Pengguna | | | User Type | Tipe Pengguna | | | User Role | Peran Pengguna | | | Phone Number | Nomor telepon Pengguna | | | E-mail | E-mail Pengguna | | | Register Date | Tanggal akses Pengguna didaftarkan | | | Status | Status akses Pengguna | | | Work | Kolom berisi untuk mengatur data Pengguna | *Reset* -> untuk mengatur ulang *password *Pengguna

*Edit* -> untuk mengubah data Pengguna | ## Register ::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/A589ymjipHtYB6jD2sV6__profile-user-register.png" size="60" width="597" height="878" caption="User ID - Register" position="center" showCaption="true"} Bagian *pop-up *`User Register` akan muncul setelah menekan `Register` pada `Search Option`. Bagian ini digunakan untuk mendaftarkan Pengguna baru akan mengakses portal . Formulir pada ini terdiri dari: | **Nama** | **Deskripsi ** | **Keterangan** | | --------------- | ------------------------------------------------- | -------------- | | User ID | ID Pengguna | | | User Name | Nama Pemilik Pengguna | | | Phone Number | Nomor telepon Pengguna | | | E-mail | E-mail Pengguna | | | User Authority | Otoritas Pengguna | | | User Authority | Otoritas Pengguna | | | - All | Untuk memberi Pengguna akses ke semua terdaftar | | | - List | Daftar | | | - Selected | Daftar dapat diakses oleh Pengguna | | | User Status | Status keaktifan Pengguna | | | Save | Menyimpan data Pengguna | | | Cancel | Membatalkan penambahan data | | # Tutorial *** ## Mencari Data User ID Berikut panduan untuk mencari data ID Pengguna. 1. Buka *sidebar*. 2. `Profile`. 3. `User ID`. 4. ketentuan pencarian pada `Search Option`. 5. `Search` untuk melakukan pencarian data. 6. Data dicari akan muncul pada `Search Result`. ## Registrasi User ID Berikut panduan untuk mendaftarkan ID Pengguna. 1. Buka *sidebar*. 2. `Profile`. 3. `User ID`. 4. metode sortir Whitelist dan tekan `Register` pada *bar* `Search Option.` 5. Secara otomatis akan tampil bar `Regist`, jangan lupa untuk menyamakan metode dipilih dari *bar* `Search Option` dan `Blacklist By` ada di *bar* `Regist`. 6. Isikan data pada formulir beserta periode waktu `Blacklist`, lalu tekan `Register`. 7. Data akan secara otomatis terdaftarkan dan akan muncul pada `Search Result`. ## Mengatur Ulang Kata Sandi :::hint{type="warning"} Tutorial ini **hanya **tersedia untuk *role *super admin. ::: Berikut panduan untuk mengatur ulang kata sandi. 1. Buka *sidebar*. 2. `Profile`. 3. `User ID`. 4. ketentuan pencarian pada `Search Option`. 5. `Search` untuk melakukan pencarian data. 6. Data dicari akan muncul pada `Search Result`. 7. Tekan tombol `Reset` pada baris pengguna yang akan di proses. 8. *Pop-up* konfirmasi akan muncul pada layar. 9. Tekan `Okay` untuk menjalankan pengaturan ulang kata sandi. Sebaliknya, tekan `Cancel` untuk membatalkan . 10. Buka email terkait untuk mengikuti instruksi berikutnya. # See also ::::VerticalSplit :::VerticalSplitItem [Merchant Data](docId:7IhkFtaIHOX62F21vl8Bq) untuk mengetahui cara melihat terkait data . ::: :::VerticalSplitItem [Transaction Limit](docId\:TFslgr1ys133jJKPqEoer) untuk mengetahui cara memeriksa data limit kartu terdaftar. ::: :::: [title] Merchant Back Office [path] / ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/p6DDhTpeGj5sQk1dIMOyU_back-office-mms-laptop.png "Merchant Back Office") menyediakan (MMS) sebagai portal untuk digunakan oleh . Melalui *dashboard* ini, dapat mengatur dan memantau aktivitas untuk semua jenis dengan lebih mudah, aman, aktual, dan lengkap melalui berbagai fitur telah disiapkan oleh . # Fitur MMS (Merchant Management System) *** ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/dh8WfuJVwa0Tv2CQeUzex_back-office-mms-tab-kelola-mms.png "Fitur MMS") dapat mengakses MMS pada tautan [Back Office MMS NICEPAY.](https://bo.nicepay.co.id/logIn.do) cek daftar berikut untuk mendapatkan lebih lanjut mengenai fitur MMS. ::::LinkArray :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-mLCizPnSnR_TXa61OqALX-20240731-082959.jpg"} [Login](docId\:E06mj1OMQy3XDodSVlY31) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-Fj-TLHuOQcyyny1WgQFRX-20240731-083026.jpg"} [Dashboard](docId\:ca0Tnj_-gHDF6qjwmjzi1) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-n-Nwgh6g6xjx5lSYRRsBE-20240731-083042.jpg"} [Transaction](docId:7oUXdgyOx1PqOQBm9caDt) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-97feWrgS_OwSSHbEsQvGT-20240731-083058.jpg"} [Discount Event](docId:2qa-RAoG00FVzWNpoW_ec) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-96T2Kuo3zK1y94NP3uIVb-20240731-083109.jpg"} [Settlement](docId\:klbWMmAVT2ne0Y8OcP0F_) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-F0BWIWqmIZoVKep7eCBTh-20240731-083237.jpg"} [Service](docId\:wJN9n07xZh_Esj9CeANSK) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-4fYGo4C5ShMd6kr5lIK4C-20240731-083251.jpg"} [Profile](docId\:BabGGtWurVs0v13RqGnyS) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-A-Df8MG9LfzG6YewDWPEW-20240731-083303.jpg"} [Notice & Help](docId\:jZ2Nclue19F_w41Vx_PIS) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-cWoJqJUhdPVYnhziP4OST-20240731-083313.jpg"} [Risk Management](docId\:VNOQ2Bc8WEEktAw0vdM76) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-ClZUA3AUi5HJxkl2q7Thq-20240731-083331.jpg"} [Statistic](docId\:uBklBxrtiCfVe6SdoEl7B) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-tkQpuLp9c8bKQoJiRCfv2-20240731-083349.jpg"} [Working Capital Loan](docId\:she8toB85pw04adtHNMMW) ::: :::: # Informasi Lain Terkait Merchant Back Office *** Berikut adalah daftar berisi selain fitur . ::::LinkArray :::LinkArrayItem{headerType="COLOR" headerColor="#12b76a"} [Daftar Istilah Pada File Laporan](docId\:SFXq1rB9dTh50ZAo5N-JC) ::: :::LinkArrayItem{headerType="COLOR" headerColor="#12b76a"} [FAQ Merchant Back Office](docId\:xyeHaaKY_ZUDWSIsH_ezT) ::: :::: # See also ::::VerticalSplit :::VerticalSplitItem [NICEHub](docId\:LhDLrrC4HO1GT8pM-YRhZ) untuk mempelajari pada CMS. ::: :::VerticalSplitItem [Operasi Bisnis](docId:8r87f_pn_ZI8LtKK3kq-K) untuk mendapatkan seputar menjalankan . ::: :::: [title] Email Payment [path] Merchant Back Office/Service/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/0j3Kq_2iH8twKQ0FWWp45_back-office-mms-2022-10-25t101238278.png "Email Payment") Sub-menu `Email Payment` digunakan oleh untuk mengirim *invoice* harus dibayarkan melalui e-mail agar dapat melakukan sesuai dengan yang diinginkan. Sub-menu pada Back Office MMS ini membantu untuk mengirimkan kepada melalui e-mail dan melihat daftar riwayat . ::embed[]{url="https://youtu.be/F57uf7pp9gM"} Halaman `Email Payment` terbagi menjadi 3 , yaitu `Search Option`, `Search Result`, dan `Regist`. Bagian `Search Option` adalah formulir digunakan untuk memasukkan kriteria pencarian data. Bagian `Search Result` untuk menampilkan hasil pencarian berdasarkan kriteria dingin dicari. Bagian `Regist` untuk mendaftarkan dan melakukan dengan [Payment Link](docId\:ChpAc7d9l0s9A8mai3itC) yang dikirim melalui e-mail. # Email Payment *** ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/p6tUdxLX3EKmBFh_5xHGr_back-office-mms-2022-11-03t104351999.png "Email Payment - Search Option") Bagian `Search Option` berisi formulir pencarian digunakan untuk mencari semua data *email payment*. Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Register Date | Periode waktu terdaftar

Pengaturan waktu juga bisa langsung ditentukan antara hari ini, 1 minggu, 1 bulan, 2 bulan, atau 3 bulan | *Default* *selection*: tanggal hari ini dan jarak waktu 24 jam | | Status | Status dari *payment* tersebut | *Default*: Total -> semua

Isi *dropdown* :
* Total * *Information Registration* * *Payment Request* * *Delete* * *Expired* * *Payment Completed* | | Search | Tombol untuk mem kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Excel | Tombol untuk mem kata kunci dimasukkan untuk akan di | Format *file* akan di dalam format Excel (.XLS) | | Register | Tombol untuk menampilkan formulir pendaftaran untuk data akan dibayarkan | Formulir akan muncul di atas `Search Option` | Bagian `Search Result` menampilkan riwayat data berdasarkan hasil pencarian pada `Search Option`. Data akan tersortir berdasarkan *order number *terbaru hingga terlama. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/-nQhkKbe2ZxIizhGtG-O3_back-office-mms-2022-11-03t111417506.png "Email Payment - Search Result") Pada ini, Admin dapat menambahkan data , menghapus , dan mengajukan TXID. Formulir `Search Result` terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ------------------ | --------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | | Payment Method | Metode | | | Customer Name | Nama | | | Order Number | Nomor pesanan | | | Amount | Total nominal | | | Expiry Date | Masa berlaku

Pengaturan waktu juga bisa langsung ditentukan antara hari ini, 1 minggu, 1 bulan, 2 bulan, atau 3 bulan | *Default selection*
Pengaturan *default*: tanggal hari ini dan jarak waktu 24 jam | | Status | Status | | | Detail | Rincian | | | Delete (checkbox) | Untuk menghapus | Opsional | | Request (checkbox) | Untuk mengajukan ID | Opsional | | Txid | ID | Opsional

Tombol `TXID` akan muncul setelah Merchant mengajukan | # Tutorial *** ## Mencari Data Email Payment Berikut panduan untuk mencari data . 1. Buka *sidebar*. 2. `Service`. 3. `Email Payment`. 4. ketentuan pencarian pada `Search Option`. 5. `Search` untuk melakukan pencarian data. 6. Data dicari akan muncul pada `Search Result`. 7. `Detail` untuk melihat rincian dari salah satu pada kolom Details. 8. `TXID` dapat melihat nomor `txID` pada terdapat pada kolom txID. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/a5apdNgAQOROcCx6vS1jP_back-office-mms-2022-11-03t104351999.png "Email Payment - Search Option") ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/e4oi9qcT11wx_3rLkUnar_back-office-mms-2022-11-03t110223431.png "Email Payment - Search Result") ## Mengunduh Data Email Payment ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/xP3l2_xk16lT7iu912oYW_back-office-mms-2022-11-03t133614258.png "Otomatis Unduh Data XLS") Berikut panduan untuk mengunduh data . 1. Buka *sidebar*. 2. `Service`. 3. `Email Payment`. 4. ketentuan pencarian pada `Search Option`. 5. `Excel` untuk mengunduh data dalam bentuk format Excel. 6. Data dicari akan terunduh secara otomatis. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/xC8hou2tZyBWb5YiGrKRP_back-office-mms-2022-11-03t133925410.png "Email File ") ## Mendaftarkan Email Payment ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/t7hKr3QYiSyzA8PLn1wYi_back-office-mms-2022-11-03t135155814.png "Register Payment") Berikut panduan untuk mendaftarkan data . 1. Buka *sidebar*. 2. `Service`. 3. `Email Payment`. 4. data untuk mendaftarkan melalui formulir. 5. `Register`. 6. Periksa kembali formulir data pada Registrasi. 7. `Save`. 8. Data akan otomatis masuk ke dalam daftar tabel untuk dengan Email . ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/jMvxmxjEfa3_lVdDQqlUJ_back-office-mms-2022-11-03t140800206.png "Contoh Pengisian Formulir Register Email Payment") ## Transaksi Dengan Email Payment ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/elLrQCd9HM21AKDfZQKmt_back-office-mms-2022-11-03t145809846.png) Berikut panduan untuk melakukan menggunakan Email . 1. Buka *sidebar*. 2. `Service`. 3. `Email Payment`. 4. kriteria data ingin di. 5. `Search`. 6. Tabel Email berisi data telah terdaftar akan muncul di `Search Option`. 7. Centang kotak `Request` pada yang ingin dilanjutkan. `Request` dilakukan untuk melakukan *generate* ID Transaksi (TXID) supaya bisa di. 8. `Process` untuk melanjutkan *generate* ID . 9. Data telah melalui pengajuan kemudian akan mendapat hasil *generate *ID . Diketahui dengan muncul `TXID` pada kolom TXID. 10. `Detail` untuk melihat lebih lengkap atau klik `TXID` melihat lengkap berdasarkan ID . Tabel daftar menggunakan Email . ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/RJT91LODeWaDZTJiWimA1_back-office-mms-2022-11-03t162830330.png "Search Result - Detail Email Payment") ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/p7wRI2C-isJfiRJ55bZh8_back-office-mms-2022-11-03t163044853.png "Search Result - TXID") ## Menghapus Data Email Payment ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/elLrQCd9HM21AKDfZQKmt_back-office-mms-2022-11-03t145809846.png "Email Payment - Search Result") Berikut panduan untuk menghapus data . 1. Buka *sidebar*. 2. `Service`. 3. `Email Payment`. 4. kriteria data ingin di. 5. `Search`. 6. Tabel Email berisi data telah terdaftar akan muncul di `Search Option`. 7. Centang kotak `Delete` pada ingin dihapus. 8. `Process` untuk melanjutkan penghapusan data. 9. Data akan hilang dari tabel pada `Search Result`. # See also ::::VerticalSplit :::VerticalSplitItem Temukan penjelasan terkait pada [Payment Link](docId\:ChpAc7d9l0s9A8mai3itC). ::: :::VerticalSplitItem [Key-in Payment](docId\:fUgLoAivcwKrKToavX6Ow) untuk mengetahui cara langsung menggunakan [Merchant Back Office](docId\:VMD8YtiiJqku6H8dRhcS6). ::: :::: [title] NICEPAY Academy [path] / Academy berisi konten edukasi seputar dan yang disediakan oleh . Halaman ini bertujuan untuk meningkatkan keterampilan teknis dan non-teknis bagi dalam memahami serta mengimplementasikan berbasis sesuai standar telah ditetapkan. # Video Tutorial SNAP *** Berdasarkan Surat Keputusan Gubernur No.23/10/KEP.GBI/2021 tanggal 16 Agustus 2021 tentang Penetapan Standar Open Application Programming Interface () Pembayaran, pelaku industri wajib menerapkan Standar Nasional Open Pembayaran () ditetapkan oleh secara bertahap dalam setiap Open Pembayaran. Kebijakan ini bertujuan untuk menciptakan digital lebih terstandarisasi, aman, dan efisien. Oleh karena itu, perlu memahami cara melakukan terhadap mereka agar tetap sesuai dengan peraturan berlaku. Sebagai dari upaya mendukung penerapan standar ini, menyediakan berbagai solusi teknis mempermudah dalam melakukan . Salah satu metode dapat digunakan adalah menggunakan Java, dijelaskan melalui video berikut. ## Integrasi API SNAP BI Menggunakan Java ::embed[]{url="https://youtu.be/B2I4W_7Xjqg"} Video ini akan menjelaskan panduan langkah demi langkah BI menggunakan Java, mulai dari persiapan hingga implementasi, sehingga dapat memahami dengan jelas setiap tahapan diberikan. 1. Install Library/Dependency 2. Setting Credentials 3. Request Access Token 4. Request Create VA 5. Notification ## Integrasi API SNAP BI Menggunakan Laravel ::embed[]{url="https://youtu.be/p6eZ2JBcZpA"} Video ini akan menjelaskan panduan langkah demi langkah BI menggunakan Laravel, mulai dari persiapan hingga implementasi, sehingga dapat memahami dengan jelas setiap tahapan diberikan dan memastikan berjalan dengan aman dan valid. 1. Install Library/Dependency 2. Setting Credentials 3. Request Access Token 4. Generate 5. Check Status 6. Refund 7. Notification :::hint{type="info"} kunjungi [API SNAP](docId\:Rz9KHBT6vz0PGg0jszAgn) untuk selengkapnya. ::: [title] Release Information [path] / :::Changelog{title="2026-06-25 | NICEPAY API & Term Changes from Payloan to Paylater"} ::ChangelogItem{type="improved" description="Change API Version 2 (V2) to API Non-SNAP"} ::ChangelogItem{type="improved" description="Change API Non-SNAP Section Structure"} ::ChangelogItem{type="broken" description="Remove API Virtual Account, API E-Wallet and API QRIS from API Non-SNAP section"} ::ChangelogItem{type="improved" description="Change Payloan term to Paylater"} ::ChangelogItem{type="broken" description="Remove API Version 1 (V1) Section"} ::: :::Changelog{title="2025-02-24 | NICEPAY Academy"} ::ChangelogItem{type="added" description="NICEPAY Academy page"} ::: :::Changelog{title="2024-08-29 | NICEPAY Library & Merchant Back Office"} ::ChangelogItem{type="added" description="NICEPAY Library page and sub-pages"} ::ChangelogItem{type="added" description="Term List on Report File > MMS - File Fail Transaction page"} ::: :::Changelog{title="2024-07-31 | NICEPAY API"} ::ChangelogItem{type="added" description="API Business Report page and sub-pages"} ::ChangelogItem{type="fixed" description="API SNAP BI > Payment API > Virtual Account - Notification page"} ::ChangelogItem{type="fixed" description="API SNAP BI > Payment API > QRIS - Notification page"} ::ChangelogItem{type="fixed" description="API SNAP BI > Payment API > E-Wallet - Notification page"} ::ChangelogItem{type="fixed" description="API SNAP BI > Payment API > Payout - Notification page"} ::: :::Changelog{title="2024-02-26 | Merchant Back Office"} ::ChangelogItem{type="improved" description="Term List on Report File > MMS - Settlement Report page"} ::ChangelogItem{type="improved" description="FAQ Merchant Back Office page"} ::: :::Changelog{title="2024-02-21 | API SNAP BI"} ::ChangelogItem{type="fixed" description="Payment API - SNAP sub-pages"} ::ChangelogItem{type="fixed" description="Payout API (Dishbursment) SNAP sub-pages"} ::ChangelogItem{type="fixed" description="Inquiry History - API SNAP Provider sub-pages"} ::ChangelogItem{type="fixed" description="Advance API - SNAP sub-pages"} ::: :::Changelog{title="2023-11-29 | Merchant Back Office"} ::ChangelogItem{type="added" description="Term List on Report File page"} ::ChangelogItem{type="added" description="Term List on Report File > MMS - Settlement Report page"} ::ChangelogItem{type="added" description="FAQ Merchant Back Office page"} ::: :::Changelog{title="2023-11-01 | API SNAP BI & NICEHub"} ::ChangelogItem{type="improved" description="API SNAP BI > SNAP Library informations"} ::ChangelogItem{type="improved" description="NICEHub > OpenCart Plugin SNAP informations"} ::: :::Changelog{title="2023-10-25 | API SNAP BI"} ::ChangelogItem{type="added" description="Interactive API Test Tools"} ::: :::Changelog{title="2023-10-12 | API SNAP BI"} ::ChangelogItem{type="added" description="API SNAP BI pages "} ::ChangelogItem{type="improved" description="API Versi 2 structure"} ::: :::Changelog{title="2023-10-06 | Update Checkout API > Registration section"} ::ChangelogItem{type="added" description="QRIS - Checkout API page "} ::: :::Changelog{title="2023-08-08 | NICEPAY Docs Public Launch"} ::ChangelogItem{type="added" description="Initial Release"} ::: [title] Reconcile [path] Merchant Back Office/Settlement/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/SPDj8nWfAB2W9HQmd-W8s_settlement-reconcile-result.png "Reconcile") # Reconcile *** Sub-menu ini membantu untuk melihat riwayat Reconcile . Halaman ini terbagi menjadi 2 , yaitu `Search Option` dan `Search Result`. ::embed[]{url="https://youtu.be/UTrbH7vMwYk"} Bagian `Search Option` adalah formulir digunakan untuk memasukkan kriteria pencarian data . Setiap *field* terdapat pada formulir ini bersifat opsional. Namun hasil pencarian dicari bergantung pada dipilih. Terdapat 3 pilihan ; yakni , , dan . dapat melakukan pencarian data untuk ditampilkan pada `Search Result` atau meng data dalam format Excel. Bagian `Search Result` adalah menampilkan hasil pencarian data berdasarkan kriteria dimasukkan pada `Search Option`. Data pada ini akan muncul setelah mengonfirmasi pencarian data dengan menekan `Search`. Hasil pencarian data ditampilkan berbeda-beda sesuai dengan dipilih pada `Search Option`. ## Vacct Account ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/B7SKxcuCFcFU2Hbh2m4ql_back-office-mms-42.png "Reconcile - Vacct Account") Bagian `Search Option` pada *metode pembayaran Virtual Account* berisi formulir pencarian spesifik khusus untuk mencari data . Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ------------------------- | -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | | | Daftar yang terdaftar pada
*Default*: Total -> semua | *Default*: Total -> semua | | Pay Method | Daftar yang terdapat pada | *Default*: Vacct Account

Isi *dropdown*:
* Vaact Account * * | | Refund Date | Waktu berhasil di-*refund* dalam format tanggal dan jam | *Default selection*
Pengaturan *default*: tanggal hari ini dan jarak waktu 24 jam | | Refund Date (Within) | Waktu langsung ditentukan antara hari ini, 1 minggu, atau 1 bulan | *Default*: *Today* | | Transaction Date | Waktu berhasil dalam format tanggal dan jam | Opsional

*Default* *selection*
Pengaturan *default*: tanggal hari ini dan jarak waktu 24 jam | | Transaction Date (Within) | Waktu langsung ditentukan antara hari ini, satu minggu, atau 1 bulan | *Default*: *Today* | | | Daftar nama | *Default*: Total -> semua nama | | Reconcile Result | Hasil Reconcile | *Default*: Total

Isi *dropdown*:
* Total * *Refund* * *Flagging* | | Journal Number | Nomor jurnal | Opsional | | V.A. Number | Nomor | Opsional | | TXID | ID | Opsional | | Search | Tombol untuk mem kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Excel | Tombol untuk mem kata kunci dimasukkan untuk *file* akan di | Format *file* akan di dalam format Excel | Bagian `Search Result` pada *metode pembayaran: Virtual Account* terbagi menjadi dua tabel. Tabel pertama menampilkan data statistik dari seluruh . Tabel kedua menampilkan rincian data per . ## E-Wallet ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/gnaKEPtMpgpR_pEQY_p9x_ewallet.png "Reconcile - E-Wallet") Bagian `Search Option` pada *metode pembayaran: E-Wallet* berisi formulir pencarian spesifik khusus untuk mencari data . Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- | | | Daftar yang terdaftar pada
*Default*: Total -> semua | *Default*: Total -> semua | | Pay Method | Daftar yang terdapat pada | *Default*:

Isi *dropdown*:
* Vaact Account * * | | Refund Date | Waktu berhasil di-*refund* dalam format tanggal dan jam

Pengaturan waktu bisa langsung ditentukan antara hari ini, satu minggu, atau satu bulan | Default selection
Pengaturan default: tanggal hari ini dan jarak waktu 24 jam, Today | | Transaction Date | Waktu berhasil dalam format tanggal dan jam

Pengaturan waktu bisa langsung ditentukan antara hari ini, satu minggu, satu bulan, tiga bulan, atau enam bulan | Opsional

*Default* *selection*
Pengaturan *default*: tanggal hari ini dan jarak waktu 24 jam, *Today* | | | Nama | Opsional | | Reconcile Result | Hasil Reconcile | *Default*: Total

Isi *dropdown*:
* Total * *Refund* * *Flagging* | | TXID | ID | Opsional | | Search | Tombol untuk mem kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Excel | Tombol untuk mem kata kunci dimasukkan untuk *file* akan di *User* | Format *file* akan di dalam format Excel | Bagian `Search Result` pada *metode pembayaran: E-Wallet* terbagi menjadi 2 tabel. Tabel pertama menampilkan data statistik dari seluruh . Tabel kedua menampilkan rincian data per . ## QRIS ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/54NA8kXYYQ-Z3lyQwvm-H_qris.png "Reconcile - QRIS") Bagian `Search Option` pada *metode pembayaran: QRIS* berisi formulir pencarian spesifik khusus untuk mencari data . Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | | | Daftar terdaftar pada
*Default*: Total -> semua | *Default*: Total -> semua | | Pay Method | Daftar terdapat pada | *Default*:

Isi *dropdown*:
* Vaact Account * * | | Refund Date | Waktu berhasil di*refund* dalam format tanggal dan jam

Pengaturan waktu bisa langsung ditentukan antara hari ini, 1 minggu, atau 1 bulan | *Default selection*
Pengaturan *default*: tanggal hari ini dan jarak waktu 24 jam, *Today* | | Transaction Date | Waktu berhasil dalam format tanggal dan jam

Pengaturan waktu bisa langsung ditentukan antara hari ini, 1 minggu, atau 1 bulan | Opsional

*Default selection*
Pengaturan default: tanggal hari ini dan jarak waktu 24 jam, *Today* | | | Nama | Opsional | | Reconcile Result | Hasil Reconcile | *Default*: Total

Isi *dropdown*:
* Total * *Refund* * *Flagging* | | TXID | ID | Opsional | | Search | Tombol untuk mem kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Excel | Tombol untuk mem kata kunci dimasukkan untuk *file* akan di | Format *file* akan di dalam format Excel | Bagian `Search Result` pada *metode pembayaran: QRIS* terbagi menjadi dua tabel. Tabel pertama menampilkan data statistik dari seluruh . Tabel kedua menampilkan rincian data per . # Tutorial *** ## Mencari Data Reconcile Berikut panduan untuk mencari data Reconcile. 1. Buka *sidebar*. 2. `Reconcile`. 3. `Reconcile Result`. 4. ketentuan pencarian pada `Search Option`. 5. `Search` untuk melakukan pencarian data. 6. Data dicari akan muncul pada `Search Result`. ## Mengunduh Data Reconcile Berikut panduan untuk mengunduh data Reconcile. 1. Buka *sidebar*. 2. `Reconcile`. 3. `Reconcile Result`. 4. ketentuan pencarian pada `Search Option`. 5. `Excel` untuk meng data dalam bentuk format Excel. 6. Data dicari akan ter secara otomatis. # See also ::::VerticalSplit :::VerticalSplitItem [Calendar](docId\:SKnGsVbD-3xg6Acn3Ojkr) untuk mengetahui cara memeriksa kalendar untuk . ::: :::VerticalSplitItem [Disbursement Report](docId:9O4NDwWma2rgYfwkNWOOi) untuk mengetahui cara melihat riwayat . ::: :::: [title] OpenCart [path] NICEHub/ ::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/4T_SBQZrCh53qH8g6JK4-_opencart-gambar.png" size="50" width="678" height="369" caption="Opencart" position="center" showCaption="true"} :::hint{type="info"} OPENCART versi 3.0 ::: *plugin* melalui di bawah ini. :::Iframe{iframeHeight="0" code=" OpenCart SNAP Plugin at NICEPAY Github"} ::: ::::hint{type="info"} :::Iframe{iframeHeight="0" code="ℹ️ Silakan menghubungi IT NICEPAY untuk bantuan terkait Plugin non-SNAP."} ::: :::: # Langkah Integrasi *** 1. Salin modul *extension* OpenCart 3.0 NICEPAY ke folder . - **Harap perhatikan struktur folder yang disalin!** 2. Akses `Admin OpenCart`. 3. `Extensions > Extentions`. 4. `Payment` di *combo box*. 5. Layar akan menampilkan daftar . 6. `Enable`. 7. Unduh . 8. `Edit` (ikon pensil). 9. *tab* `General` 10. `MID` dan `NICEPAY Merchant Key`. 11. sudah siap digunakan. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/lNEUO6K9ND8BbOYi9tqvi_1.png "Extensions > Payments") ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/-rM8AAimy38RTZVpB45XK_2.png "Daftar Metode Pembayaran") ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/jcSSUJPaoGIP_r3Sn__Od_3.png "MID dan NICEPAY Merchant Key") # See also ::::VerticalSplit :::VerticalSplitItem [Magento](docId\:BYvpNZCw4c0Pe1dWSNcEY) untuk mengetahui cara dengan *platform* lain. ::: :::VerticalSplitItem [PrestaShop](docId\:N9cfZAEg0CUaDq1ghajue) untuk mengetahui cara dengan *platform* lain. ::: :::: [title] PrestaShop [path] NICEHub/ ::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/S8zyu7Zu6GzobvQQp-jVO_prestashopcom.png" size="50" width="797" height="333" caption="PrestaShop" position="center" showCaption="true"} :::hint{type="info"} - PrestaShop versi 1.6 - menghubungi tim IT untuk mendapatkan bantuan terkait PrestaShop. ::: # Langkah Integrasi *** 1. Salin modul `Prestashop 1.6 NICEPAY` ke folder `modules` di Prestashop . 2. Akses ke `Admin Prestashop`. 3. `Modules and Services`. 4. `Payment`. - Jika `NICEPAY Payment` belum muncul, klik `View All Available Payments Solutions`. 5. `NICEPAY Payment`. 6. `Install`. 7. `MID` dan `Merchant Key`. 8. Simpan data sudah ditambahkan. 9. sudah siap digunakan. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/fqy-DC3cKgLLK6lIQL2qQ_1.png "Modules and Services") ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/lZ-KWlG2HxcY_oKwwCewR_2.png "MID dan API Key") # See also ::::VerticalSplit :::VerticalSplitItem [Magento](docId\:BYvpNZCw4c0Pe1dWSNcEY) untuk mengetahui cara dengan *platform* lain. ::: :::VerticalSplitItem [OpenCart](docId\:JyRSJ48GeEPA7JRKwDXfm) untuk mengetahui cara dengan *platform* lain. ::: :::: [title] MMS - File Settlement Report [path] Merchant Back Office/Daftar Istilah Pada File Laporan/ # Tentang MMS - File Settlement Report *** File Report digunakan oleh untuk memeriksa laporan secara *offline* hingga waktu tertentu. File Report didapatkan dengan cara mengunduh *file* pada [MMS - Settlement - Settlement Report](docId:9ESDQYwVyCq3ce254IC3B). # MMS - File Settlement Report *** Pada Report, terdapat 2 berbeda untuk mengunduh *file* report. Tombol tersebut adalah `Excel` dan `Excel(Details)`. *File* berhasil diunduh dari masing-masing berisi format berbeda. ## Excel ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/A8muY8iZR_NIoQnmENwIO_image.png "Settlement Report - Excel") *File* yang diunduh melalui `Excel` berisi rangkuman keseluruhan . Berikut tabel dan video berisi penjelasan tentang isi *file*. ::embed[]{url="https://youtu.be/IZ6hgs9tO4Y"} | **Nama Header** | **Penjelasan Header** | **Catatan** | | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | | `Brand Name` | Nama merek dimiliki | | | `I-MID` | ID | | | `Type` | Tipe | | | `Transaction` | Informasi | | | `Transaction.Transaction` | Jumlah dilakukan untuk masing-masing | | | `Transaction.Amount` | Jumlah nominal dilakukan untuk masing-masing | | | `Fee` | Biaya wajib dibayar kepada | | | `Fee.NICEPAY` | Perhitungan dari sisi | Jika tipe | | `NICEPAY.Fee` | Biaya MDR | | | `NICEPAY.Installment Fee` | Biaya MDR | | | `NICEPAY.FDS Fee` | Biaya pemeriksaan FDS | | | `NICEPAY.VAT` | PPN | 11% | | `NICEPAY.Total` | Total biaya wajib dibayar kepada | | | `Fee.Bank/Mitra.Fee` | Biaya wajib dibayar kepada / | | | `Scheduled Settlement Amount` | Nominal amount akan diterima oleh setelah | | | `Scheduled Settlement Amount.From NICEPAY` | Perhitungan dari sisi | Jika tipe | | `From NICEPAY.Scheduled Settlement Amount` | Nominal amount akan melalui | | | `From NICEPAY.Hold On` | Amount terhutang belum bisa dilakukan | Total amount adalah minus biasanya berasal dari Fee atas , sehingga dana tertahan sebagai hutang dan tidak dapat diproses kepada | | `From NICEPAY.Hold Off` | Pelepasan amount tertahan pada periode selanjutnya (Pelepasan Hold On) terjadi jika total amount mencukupi | Hold Off akan mengurangi total Amount(Scheduled) | | `From NICEPAY.Setoff` | Penambahan atau pengurangan Scheduled Amount terjadi sesuai penyelesaian isu-isu tertentu | Khusus | | `From NICEPAY.Refund` | Nominal amount mengalami pengembalian | | | `From NICEPAY.Settlement Confirmation Amount` | Nominal amount akhir akan diterima oleh | | | `Scheduled Settlement Amount.From Bank/Mitra` | Perhitungan dari sisi / | Jika tipe | | `From Bank/Mitra.Settlement Amount` | Jumlah biaya akhir akan diterima dari total | | ## Excel Detail ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/vE1KeiCDgPcrk-NKHkHjV_3.png "Settlement Report - Excel(Detail)") File diunduh melalui `Excel(Detail)` berisi rangkuman keseluruhan dan rincian setiap dimiliki oleh . ::embed[]{url="https://youtu.be/02iKZwaJ9BA"} Berikut adalah tabel penjelasan tersebut. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/dpgxkq9NR9nwb9KORVYK3_1.png "Settlement Report - Excel") | **Nama Header** | **Penjelasan Header** | **Catatan** | | ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | | `Brand Name` | Nama merek dimiliki | | | `I-MID` | ID | | | `Type` | Tipe | | | `From NICEPAY` | Perhitungan dari sisi | Jika tipe | | `From NICEPAY.Transaction` | Informasi | | | `Transaction.Number` | Jumlah dilakukan untuk masing-masing | | | `Transaction.Amount` | Jumlah nominal dilakukan untuk masing-masing | | | `From NICEPAY.Fee` | Biaya wajib dibayar kepada | | | `Fee.Full Payment` | Biaya MDR | | | `Fee.Installment` | Biaya MDR | | | `Fee.NICEPAY` | Biaya MDR | | | `Fee.VAT` | PPN | 11% | | `Fee.Total` | Total biaya wajib dibayar kepada | | | `From NICEPAY.Settlement Amount(Scheduled)` | Nominal amount akan melalui | | | `Settlement Amount(Scheduled).Scheduled Amount` | Nominal amount akan diterima oleh setelah | | | `Settlement Amount(Scheduled).Hold On` | Amount terhutang belum bisa dilakukan | Total amount adalah minus biasanya berasal dari Fee atas , sehingga dana tertahan sebagai hutang dan tidak dapat diproses kepada | | `Settlement Amount(Scheduled).Hold Off` | Pelepasan amount tertahan pada periode selanjutnya (Pelepasan Hold On) terjadi jika total amount mencukupi | Hold Off akan mengurangi total Amount(Scheduled) | | `Settlement Amount(Scheduled).Setoff` | Penambahan atau pengurangan Amount(Scheduled) terjadi sesuai penyelesaian isu-isu tertentu | | | `Settlement Amount(Scheduled).Refund` | Nominal amount mengalami pengembalian | | | `From NICEPAY.Settlement Amount(Scheduled)` | Nominal amount akhir akan diterima oleh | Rumus=
nominal Scheduled Amount – nominal Hold On + nominal Hold off + nominal Set off + nominal Refund | | `From Bank/Mitra` | Perhitungan dari sisi / | Jika tipe | | `From Bank/Mitra.Transaction` | Rincian terkait berjalan | | | `Transaction.Transaction` | Total berjalan | | | `Transaction.Amount` | Total amount dibayarkan oleh Pelanggan | | | `From Bank/Mitra.Fee` | Biaya wajib dibayar kepada | | | `Fee.Full Payment` | Biaya MDR | | | `Fee.Installment (Onus)` | Biaya MDR | | | `Fee.Installment (Offus)` | Biaya MDR | | | `From Bank/Mitra.Settlement Amount` | Jumlah biaya akhir akan diterima dari total | | ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/KTWVTSJVIqh-ZbEoFrxE-_2.png "Settlement Report - Excel(Detail) - Rincian per Transaksi") Berikut tabel dan video berisi penjelasan tentang rincian . | **Nama Header** | **Penjelasan Header** | **Catatan** | | --------------------------------- | ----------------------------------------------------------------------- | ------------------------------------------------ | | `Date` | Kumpulan data pada suatu | | | `Date.Settlement` | Tanggal melalui | | | `Date.Approved` | Tanggal disetujui | | | `Date.Purchase` | Tanggal barang terbayarkan | | | `Date.Cancelled` | Tanggal dibatalkan | | | `Merchant Information` | Kumpulan pada suatu | | | `Merchant Information.Brand Name` | Nama merek | | | `Merchant Information.I-MID` | ID | | | `Type` | Kumpulan tipe pada suatu | | | `Type.Settlement` | Tipe | | | `Type.Payment Method` | Metode pada suatu | - MA - - PG - /Direct | | `Type.Status` | Status | | | `Type.Month` | Untuk mengetahui bulan sedang berlangsung hingga berhasil | | | `From NICEPAY` | Perhitungan dari sisi | Jika tipe | | `From NICEPAY.Transaction` | Transaksi dilakukan oleh pengguna dari sisi | | | `Transaction.Amount` | Nominal amount dibayarkan oleh pengguna dari sisi pada suatu rincian | Amount sudah dikurangi dengan Fee dan PPN 11% | | `From NICEPAY.Fee` | Biaya wajib dibayar kepada | | | `Fee.Full Payment` | Fee channel milik atas | | | `Fee.Installment` | Biaya MDR | | | `Fee.NICEPAY` | Biaya MDR | | | `Fee.VAT` | PPN | 11% | | `Fee.Total` | Jumlah biaya wajib dibayarkan kepada | | | `From NICEPAY.Settlement` | Informasi amount akan melalui | | | `Settlement.Amount` | Amount sudah dikurangi Fee dan PPN 11% | | | `From Bank/Mitra` | Perhitungan dari sisi / | Jika tipe | | `From Bank/Mitra.Transaction` | Transaksi dilakukan oleh pengguna dari sisi | | | `Transaction.Amount` | Nominal amount dibayarkan oleh pengguna dari sisi pada suatu rincian | | | `From Bank/Mitra.Fee` | Biaya wajib dibayar kepada | | | `Fee.Full Payment` | Biaya | | | `Fee.Installment (Onus)` | Biaya | | | `Fee.Installment (Offus)` | Biaya | | | `From Bank/Mitra.Settlement` | Informasi amount akan melalui | | | `Settlement.Amount` | Nominal amount akan diterima oleh | | | `Bank/Mitra Type` | Tipe / digunakan pada | | | `Bank/Mitra Type.Acquire` | Nama / digunakan dalam | | | `Bank/Mitra Type.Issuer` | Nama / digunakan dalam | Khusus | | `Approval Code/Account No` | Nomor akun/kode persetujuan dari suatu rincian berjalan | | | `Order Number` | Nomor pesanan berjalan | | | `Buyer` | Nama pengguna melakukan | | | `Product Name` | Nama produk dari data | | | `TID` | ID | | | `Batch No` | Nomor batch untuk mengidentifikasi masuk ke dalam *batch* | | [title] Login [path] Merchant Back Office/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/NZUGfaCcTDpf1pizeRC7u_back-office-mms.png "Halaman Login") dapat mengakses ke laman (MMS) hanya sudah terdaftar ke dalam . akan mendapatkan ID serta *Password* khusus untuk menggunakan MMS. akses di bawah ini untuk mengunjungi MMS. :::CtaButton{label="Merchant Management System" externalHref="https://bo.nicepay.co.id/logIn.do" openInNewTab="true"} ::: # Akses Merchant Management System *** :::hint{type="info"} baru pertama kali login akan disarankan untuk mengganti *password.* ::: ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/8eIzAjYQkOnEZS-3za-GG_image.png "Ganti Password") Berikut adalah langkah untuk mengakses MMS (): 1. Akses laman *login* ke [Back Office MMS NICEPAY](https://bo.nicepay.co.id/logIn.do). 2. *Login page* MMS akan langsung ditampilkan. 3. `UserID`. 4. `Password`. 5. `Login`. 6. pertama kali *login* akan ada *popup* untuk *change password*. 7. Tampilan beralih menjadi `Dashboard`. :::hint{type="info"} [Daftar Sebagai Merchant](docId\:S2CT_wXC_zW5ypUcweI8k) untuk lebih lanjut terkait *Username* dan *Password.* ::: # Aturan dan Keamanan Akun *** Untuk memaksimalkan keamanan pada akun , terdapat beberapa peraturan perlu diperhatikan: 1. *Automatic expired timeout session,* membuat akun secara otomatis *log out* setelah 15 menit tidak ada aktivitas. 2. Akun terkunci jika memasukkan ID dan *password* salah sebanyak 5 kali. Jika hal ini terjadi, silakan mengikuti panduan pergantian kata kunci pada bagian [Tutorial Perubahan Kata Sandi](docId\:E06mj1OMQy3XDodSVlY31). 3. Permintaan pembaharuan *password* terjadi setiap 90 hari. 4. *Password* harus terdiri dari huruf besar, huruf kecil, angka, simbol dan minimal 12 karakter. # Tutorial Perubahan Kata Sandi *** ## Melalui Pengaturan Merchant Management System ![](https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-baTUZde-nBFk8Kv4Sen9t-20250811-070532.jpg "Setting - Change Password") Berikut adalah langkah untuk mengubah kata sandi melalui pengaturan MMS (): 1. Akses laman *login* ke [Back Office MMS NICEPAY](https://bo.nicepay.co.id/logIn.do). 2. Masuk ke Dashboard. 3. `Pengaturan` pada pojok kanan atas. 4. `Change Password`. 5. Isi formulir pada *pop-up *yang tersedia. 6. `Save` untuk menyimpan perubahan. Sebaliknya, tekan `Cancel` untuk membatalkan . ![](https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-D1zErXxTIw9jso9_6takf-20250811-091134.png "Setting") ## Melalui Halaman *Login* ![](https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-Zc_LCVjt6mHVlxZ_dKJOr-20250811-070613.png "Forgot Password") Berikut adalah langkah untuk mengubah kata sandi melalui *login* MMS (): 1. Akses laman *login* ke [Back Office MMS NICEPAY](https://bo.nicepay.co.id/logIn.do). 2. `By Previous Password`. 3. Formulir *pop-up *`Forgot Password` akan muncul. 4. email, username dan salah satu dari 5 kata sandi terakhir. 5. `Request` untuk melanjutkan perubahan kata sandi. Sebaliknya, tekan `Cancel` untuk membatalkan pengajuan. - Jika data kredensial sesuai, maka akan muncul *pop-up alert *`Reset Password Has Success. Please check your E-mail` pada layar. Kemudian, silakan ikuti petunjuk dikirim pada email terdaftar. - Jika data kredensial tidak sesuai, maka akan muncul *pop-up alert *`Check Your Username, Email and Old Password` pada layar. ## Melalui Halaman Sub-menu User ID Silakan kunjungi bagian [Profile > User ID > Mengatur Ulang Kata Sandi](docId\:Tjd1p8wHGH1E-QVsS8XJ0) untuk informasi lebih lanjut. # See also ::::VerticalSplit :::VerticalSplitItem [Merchant Back Office](docId\:VMD8YtiiJqku6H8dRhcS6) untuk mempelajari platform disediakan . ::: :::VerticalSplitItem [Dashboard](docId\:ca0Tnj_-gHDF6qjwmjzi1) untuk mempelajari khusus memantau secara *real-time*. ::: :::: ::::VerticalSplit :::VerticalSplitItem [Profile](docId\:BabGGtWurVs0v13RqGnyS) untuk mempelajari pengaturan data dan Pengguna. ::: :::VerticalSplitItem [Notice & Help](docId\:jZ2Nclue19F_w41Vx_PIS) untuk mengetahui khusus pengumuman dan bantuan. ::: :::: [title] NICEHub [path] / ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/VwMloizOvtn82UIGz9vB2_nicehub.jpg "NICEHub") merupakan dapat membantu untuk dengan sekaligus dengan menggunakan CMS (Content Management System) pilihan . telah menyiapkan sebuah servis terintegrasi dengan berbagai macam *multiparty 3rd platform* populer seperti Magento, OpenCart, PrestaShop, WHMCS, dan WooCommerce. Para pengguna [Payment API](docId\:s8NDuJUS6A9bOvN8lf9BC) hanya membutuhkan dan dari dan menambahkan pengaturan khusus untuk menggunakan . Berikut adalah beberapa *platfom* *open-source* terintegrasi dengan beserta cara menggunakan pada CMS . ::::LinkArray{contentSource="CUSTOM"} :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/BWKqhLJ0e0sZIvsYHt7kQ_magento-logo2-1-scaled.png"} [Magento](docId\:BYvpNZCw4c0Pe1dWSNcEY) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/b6uUC8C_DS4y9XZ2j2bLe_opencart-gambar.png"} [OpenCart](docId\:JyRSJ48GeEPA7JRKwDXfm) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/BtT7d7xwRtlQLIaL4PRYL_prestashopcom.png"} [PrestaShop](docId\:N9cfZAEg0CUaDq1ghajue) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/F4xtmsjczI_bsLGXmm8Y5_whmcs-logo-module-for-opennebula-enterprise-edition.png"} [WHMCS](docId\:NO4ygU907fgBPmulTICpC) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/7XmYQum_Gm2oep24QGcZk_woo.png"} [WooCommerce](docId\:HxBFxjA-h4JAJOq3Txg-5) ::: :::: Temukan Library lain dimiliki pada di bawah ini. :::Iframe{iframeHeight="0" code=" Library at NICEPAY Github"} ::: # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Operasi Bisnis](docId:8r87f_pn_ZI8LtKK3kq-K) untuk mendapatkan seputar menjalankan . ::: :::VerticalSplitItem [Merchant Back Office](docId\:VMD8YtiiJqku6H8dRhcS6) untuk mempelajari *platform* disediakan . ::: :::: [title] FAQ NICEHub & General [path] NICEHub/ ### Apa yang harus dilakukan setelah proses integrasi dengan NICEHub berhasil? lakukan dan uji coba pada didukung oleh . Berikut adalah daftar referensi untuk setiap . | **Metode Pembayaran** | **Referensi** | | --------------------- | ---------------------------------------------------------------- | | | [Integrasi & Testing Kartu Kredit](docId\:ZA5d5J-5w_gT44qGTxB5n) | | | [Integrasi & Testing VA](docId\:sts64cm0VYN3Q8_quNq23) | | | [Integrasi & Testing CVS](docId:6zSlSRyypvTgFXAKRIXHI) | | | [Integrasi & Testing Direct Debit](docId\:sHrV7hpVnWLt9ipNeCfE4) | | | [Integrasi & Testing E-Wallet](docId\:b9HPduhC2MPMLaLHIjCbO) | | | [Integrasi & Testing Paylater](docId\:ZEuw_0d227R_LUPBI3ptN) | | | [Integrasi & Testing GPN](docId\:LuCYNk98cX7upRb-xSZS3) | | | [Integrasi & Testing QRIS](docId\:tCFbU7--Xd0Sm5_rQ00_w) | *** [title] WHMCS [path] NICEHub/ ::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/QDsACKx_GQf3SIBnw5Mt6_whmcs-logo-module-for-opennebula-enterprise-edition.png" size="50" width="900" height="500" caption="WHMC" position="center" showCaption="true"} :::hint{type="info"} - WHMCS versi 6.3.1 - menghubungi tim IT untuk mendapatkan bantuan terkait WHMCS. ::: # Langkah Integrasi *** 1. Salin modul WHMCS ke folder . - **Harap perhatikan struktur folder yang akan disalin, salin *****file***** satu per satu per folder!** 2. Akses ke `WHMCS admin`. 3. `Setup`. 4. `Payment > Payment Gateways`. 5. Cari dan klik modul `NICEPAY VA`. 6. `MID and NICEPAY Merchant Key` 7. `Setup > Product & Services` untuk menambahkan `NICEPAY Payment` pada pilihan . 8. Edit pada nama grup akan ditambahkan . 9. centang di *checkbox* . 10. `Save Changes` 11. sudah siap digunakan. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/x5bylv_AGzYrVmb8oMtQU_1.png "Payment > Payment Gateways") ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/XVBYCv0aHtTdOru5WER0o_2.png "Modul Pembayaran NICEPAY VA") ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/62gjGV81fqkHBUOgTYp6B_3.png "MID and NICEPAY Merchant Key") ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/T2Rnu8L_n5ylI63FPNSMT_4.png "NICEPAY VA") # See also ::::VerticalSplit [WooCommerce](docId\:HxBFxjA-h4JAJOq3Txg-5) untuk mengetahui cara dengan *platform* lain. :::VerticalSplitItem [FAQ NICEHub & General](docId\:OYV7icLzDqtFeiCqYv2KO) jika ingin mengetahui pertanyaan sering diajukan terkait dan . ::: :::: [title] Magento [path] NICEHub/ ::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/uu-0b-6M1Bhb1RVpLFq3Q_magento-logo2-1-scaled.png" size="50" width="2560" height="1221" caption="Magento" position="center" showCaption="true"} :::hint{type="info"} Magento versi 1.9 ::: *plugin* melalui di bawah ini. :::Iframe{iframeHeight="0" code=" Magento Plugin at NICEPAY Github"} ::: # Langkah Integrasi *** 1. Salin modul *extension* Magento ke folder . - **Harap perhatikan struktur folder yang akan disalin!** 2. Pastikan modul sudah tampil di daftar . - Buka Magento/admin . - `System > Configuration`. - `Sales > Payment Methods`. 3. `MID dan API (Merchant) Key` dari . 4. `Save Config`. 5. `System > Cache Management`. 6. `Select All > Submit`. 7. Tunggu sampai otomatis *refresh*. 8. `Flush Cache Storage`. 9. Tunggu sampai otomatis *refresh*. 10. `Flush Magento Cache`. 11. Tunggu sampai otomatis *refresh*. 12. Buka `System > Index Management`. 13. `Select All` lalu `Submit`. 14. Buka depan untuk mengecek instalasi . 15. `Checkout` 16. baru ditambahkan. 17. Ikuti hingga selesai. 18. Akses `admin/Magento > menu Sales > Order` untuk melihat data telah masuk. 19. Pembayaran menggunakan sudah siap digunakan. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/e8ZsewqvIlK3LU8357hLc_1.png "Konfigurasi metode pembayaran ") ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/HGEqiG7sbYUTA10mGAJ-h_2.png "Cache Storage Management") ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/V7WpJM3aWJej28df-T04p_3.png "Index Management") # See also ::::VerticalSplit :::VerticalSplitItem [OpenCart](docId\:JyRSJ48GeEPA7JRKwDXfm) untuk mengetahui cara dengan *platform* lain. ::: :::VerticalSplitItem [PrestaShop](docId\:N9cfZAEg0CUaDq1ghajue) untuk mengetahui cara dengan *platform* lain. ::: :::: [title] MMS - File Fail Transaction Report [path] Merchant Back Office/Daftar Istilah Pada File Laporan/ # Tentang MMS - File Fail Transaction Report *** File Fail Transaction Report digunakan oleh untuk memeriksa data gagal agar dapat mengetahui alasan mengapa suatu gagal ter. File Fail Transaction Report didapatkan dengan cara mengunduh *file *pada [MMS - Transaction - Fail Transaction](docId\:Kw36Cm_cK3RzRNUHfzavQ). # MMS - File Fail Transaction Report *** Pada Fail Transaction, terdapat `Excel` untuk mengunduh *file report*. *File * berhasil diunduh memiliki isi format berbeda berdasarkan dari dipilih. ::embed[]{url="https://youtu.be/GXAjxXl2sfE"} ## Excel - Credit Card | **Nama** | **Penjelasan Header** | **Catatan** | | ---------------- | -------------------------------------------------------------------------------------------------- | ----------- | | `Payment Method` | Metode pada berjalan | | | `Company Name` | Nama perusahaan pemilik | | | `I-MID` | ID | | | `Trx Time` | Waktu berlangsung | | | `Fail Amount` | Nominal amount dari gagal | | | `Acquire Bank` | Kode Acquire | | | `Issuer Bank` | Kode Issuer | | | `Card Number` | Nomor kartu melakukan | | | `Installment` | Periode cicilan berlangsung | | | `Fail Message` | Pesan gagal | | | `RRN` | *Retrieval Reference Number*; 12 angka unik di-*generate *untuk menyimpan data setiap | | ## Excel - Direct Debit | **Nama** | **Penjelasan Header** | **Catatan** | | ---------------- | -------------------------- | ----------- | | `Payment Method` | Metode pada berjalan | | | `Company Name` | Nama perusahaan pemilik | | | `I-MID` | ID | | | `Trx Time` | Waktu berlangsung | | | `Fail Amount` | Nominal amount dari gagal | | | `Mitra Name` | Nama tempat berlangsung | | | `Fail Message` | Pesan gagal | | ## Excel - E-Wallet | **Nama** | **Penjelasan Header** | **Catatan** | | ---------------- | -------------------------- | ----------- | | `Payment Method` | Metode pada berjalan | | | `Company Name` | Nama perusahaan pemilik | | | `I-MID` | ID | | | `Trx Time` | Waktu berlangsung | | | `Billing Phone` | Nomor telepon penagihan | | | `Fail Amount` | Nominal amount dari gagal | | | `Mitra Name` | Nama tempat berlangsung | | | `Fail Message` | Pesan gagal | | ## Excel - Payloan | **Nama** | **Penjelasan Header** | **Catatan** | | ---------------- | -------------------------- | ----------- | | `Payment Method` | Metode pada berjalan | | | `Company Name` | Nama perusahaan pemilik | | | `I-MID` | ID | | | `Trx Time` | Waktu berlangsung | | | `Fail Amount` | Nominal amount dari gagal | | | `Mitra Name` | Nama tempat berlangsung | | | `Fail Message` | Pesan gagal | | ## Excel - Payout | **Nama** | **Penjelasan Header** | **Catatan** | | ---------------- | -------------------------- | ----------- | | `Payment Method` | Metode pada berjalan | | | `Merchant Name` | Nama tempat berlangsung | | | `I-MID` | ID | | | `Trx Time` | Waktu berlangsung | | | `Billing Phone` | Nomor telepon penagihan | | | `Fail Amount` | Nominal amount dari gagal | | | `Bank` | Kode asal berlangsung | | | `Fail Message` | Pesan gagal | | | `TXID` | ID | | ## Excel - GPN | **Nama** | **Penjelasan Header** | **Catatan** | | ---------------- | -------------------------- | ----------- | | `Payment Method` | Metode pada berjalan | | | `Company Name` | Nama perusahaan pemilik | | | `I-MID` | ID | | | `Trx Time` | Waktu berlangsung | | | `Fail Amount` | Nominal amount dari gagal | | | `Acquire Bank` | Kode Acquire | | | `Issuer Bank` | Kode Issuer | | | `Card Number` | Nomor kartu melakukan | | | `Fail Message` | Pesan gagal | | [title] Discount Event Transaction [path] Merchant Back Office/Discount Event/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/FNiW-Epm_7Mg618hy1OlW_back-office-mms-24.png "Discount Event Transaction") Sub-menu ini membantu untuk memantau terdapat diskon sesuai dengan *event *diskon sedang berjalan. Halaman ini terbagi menjadi 2 , yaitu `Search Option` dan `Search Result`. ::embed[]{url="https://youtu.be/tcFu8P2v4kU"} Bagian`Search Option` adalah formulir digunakan untuk memasukkan kriteria pencarian data . Setiap *field* terdapat pada formulir ini bersifat opsional. dapat melakukan pencarian data untuk ditampilkan pada `Search Result` atau meng data dalam format Excel. Bagian `Search Result` adalah menampilkan hasil pencarian data berdasarkan kriteria dimasukkan pada `Search Option`. Data pada ini akan muncul setelah mengonfirmasi pencarian data dengan menekan `Search`. # Discount Event Transaction *** ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/Y-K7LHB2H8cT0QTuv0cQH_discount-event-transaction.png "Discount Event Transaction") Bagian `Search Option` berisi formulir pencarian digunakan untuk mencari semua data *event* sedang dibuat. Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ----------------- | --------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- | | | Daftar terdaftar pada | *Default*: Total -> semua | | Trx Time | Waktu dalam format tanggal dan jam | *Default*: tanggal hari ini dan jarak waktu 24 jam | | Trx Time (Within) | Jarak waktu

Pengaturan waktu bisa langsung ditentukan antara hari ini, 1 minggu, atau 1 bulan | *Default*: *Today* | | Discount TXID | ID diskon | Opsional | | TXID | ID | Opsional | | Trx Amount | Batas minimum (*From*) dan maksimum (*To*) | Opsional | | Search | Tombol untuk mem kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Excel | Tombol untuk mem kata kunci dimasukkan untuk *file* akan di | Format *file* akan di dalam format Excel | Bagian `Search Result` menampilkan daftar diskon sesuai dengan ketentuan dari `Search Option`. Daftar tersebut berisi rincian masing-masing diskon terjadi pada saat *event *tertentu. # Tutorial *** ## Mencari Data Discount Event Transaction Berikut panduan untuk mencari data saat *event *diskon terjadi. 1. Buka *sidebar*. 2. `Discount Event`. 3. `Discount Event Transaction`. 4. ketentuan pencarian pada `Search Option`. 5. `Search` untuk melakukan pencarian data. 6. Data dicari akan muncul pada `Search Result`. ## Mengunduh Data Discount Event Transaction Berikut panduan untuk mengunduh data saat *event *diskon terjadi. 1. Buka *sidebar*. 2. `Discount Event`. 3. `Discount Event Transaction`. 4. ketentuan pencarian pada `Search Option`. 5. `Excel` untuk mengunduh data dalam bentuk format Excel. 6. Data dicari akan terunduh secara otomatis. # See also ::::VerticalSplit :::VerticalSplitItem [Card Event History](docId\:EZbQsGUb8c02JifEDobHt) untuk mengetahui cara melihat riwayat data kartu saat *event *berlangsung. ::: :::VerticalSplitItem [Discount Event Enroll](docId\:HS9L9Cw20M4tp83N3v1bR) untuk mengetahui cara membuat *event*. ::: :::: [title] Fail Transaction [path] Merchant Back Office/Transaction/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/oipKV72bqNwUdmBNHqSoN_transaction-fail-transaction.png "Fail Transaction") # Fail Transaction *** Sub-menu ini membantu untuk memeriksa data pada seluruh gagal. Halaman ini terbagi menjadi 2 , yaitu `Search Option` dan `Search Result`. ::embed[]{url="https://youtu.be/3O2-Kq0kG8o"} Bagian `Search Option` adalah formulir digunakan untuk memasukkan kriteria pencarian data . Setiap *field* terdapat pada formulir ini bersifat opsional. Akan tetapi, hasil pencarian dicari bergantung pada dipilih. Terdapat 7 pilihan ; yakni , , , , , , dan . dapat melakukan pencarian data untuk ditampilkan pada `Search Result` atau mengunduh data dalam format Excel. Bagian `Search Result` adalah menampilkan hasil pencarian data berdasarkan kriteria dimasukkan pada `Search Option`. Data pada ini akan muncul setelah mengonfirmasi pencarian data dengan menekan `Search`. Hasil pencarian data ditampilkan berbeda-beda sesuai dengan dipilih pada `Search Option`. ## Credit Card ![](https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-MJmId43XLZjx59A5HZjtC-20240813-073623.png "ransaction - Fail Transaction - Credit Card") Bagian `Search Option` pada *metode pembayaran: Credit Card* berisi formulir pencarian spesifik khusus untuk mencari data . Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ------------------- | --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | Daftar terdaftar pada | *Default*: Total -> semua | | Method | Daftar terdapat pada | *Default*:

Isi *dropdown*:
* * * * * * * | | Acquire | Daftar nama *Acquire * | *Default*: Total -> semua

Isi *dropdown*:
* Total * Mandiri * BNI * BCA * Maybank | | Issuer | Daftar nama *Issuer * | *Default*: Total -> semua

Isi *dropdown*:
* Total * ANZ, BCA, BNI, BRI, CITIBANK, Danamon, HSBC, Maybank, MEGA, Mandiri, Permata, Stanchart, UOB, SHINHAN.ID * Other | | Trx Time | Waktu dalam format tanggal dan jam | *Default*: tanggal hari ini dan jarak waktu 24 jam | | Trx Time (*Within*) | Jarak waktu

Pengaturan waktu bisa langsung ditentukan antara hari ini, 1 minggu, atau 1 bulan | *Default*: *Today* | | Card Number | Nomor kartu Pelanggan | Opsional | | Trx Amount | Saldo | Opsional | | RRN | | Opsional | | TXID | ID | Opsional | | Search | Tombol untuk memproses kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Excel | Tombol untuk memproses kata kunci dimasukkan untuk *file* akan diunduh | Format *file* akan diunduh dalam format Excel | Bagian `Search Result` menampilkan rincian data per . dapat melihat rincian terkait dari *hyperlink * tersedia. Pada tabel ini, terdapat tambahan kolom selain data berasal dari `Search Option`. | **Nama** | **Deskripsi ** | **Keterangan** | | ------------ | ---------------------------------------------------- | -------------- | | Fail Amount | Nominal amount yang gagal pada transaksi | | | Installment | Waktu cicilan yang berlangsung pada suatu transaksi | | | Fail Message | Pesan alasan transaksi gagal | | ## Direct Debit ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/z7qyIWHQXk8P4-IToFrFN_2.png "Transaction - Fail Transaction - Direct Debit") Bagian `Search Option` pada *metode pembayaran: Direct Debit* berisi formulir pencarian spesifik khusus untuk mencari data . Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- | | | Daftar terdaftar pada | *Default*: Total -> semua | | Payment Method | Daftar terdapat pada | *Default*:

Isi *dropdown*:
* * * * * * * | | Name | Nama melakukan | Opsional | | Trx Time | Waktu dalam format tanggal dan jam

Pengaturan waktu juga bisa langsung ditentukan antara hari ini, 1 minggu, atau 1 bulan | *Default*: tanggal hari ini dan jarak waktu 24 jam, *Today* | | Trx Amount(From) | Saldo minimal | Opsional | | Trx Amount(To) | Saldo maksimal | Opsional | | TXID | ID | Opsional | | Search | Tombol untuk memproses kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Excel | Tombol untuk memproses kata kunci dimasukkan untuk *file* akan diunduh | Format *file* akan diunduh dalam format Excel | Bagian `Search Result` menampilkan rincian data per . dapat melihat rincian terkait dari *hyperlink * tersedia. Pada tabel ini, terdapat tambahan kolom selain data berasal dari `Search Option`. | **Nama** | **Deskripsi ** | **Keterangan** | | ------------ | ---------------------------------------- | -------------- | | Fail Amount | Nominal amount yang gagal pada transaksi | | | Fail Message | Pesan alasan transaksi gagal | | ## E-Wallet ![](https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-u7GGZy-uW55B78OpSLtj7-20240813-075726.png "Old - Transaction - Fail Transaction - E-Wallet") Bagian `Search Option` pada *metode pembayaran: E-Wallet* berisi formulir pencarian spesifik khusus untuk mencari data . Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- | | | Daftar terdaftar pada | *Default*: Total -> semua | | Method | Daftar terdapat pada | *Default*:

Isi *dropdown*:
* * * * * * * | | Name | Nama melakukan | Opsional | | Trx Time | Waktu dalam format tanggal dan jam

Pengaturan waktu juga bisa langsung ditentukan antara hari ini, 1 minggu, atau 1 bulan | *Default*: tanggal hari ini dan jarak waktu 24 jam, *Today* | | Trx Amount(From) | Saldo minimal | Opsional | | Trx Amount(To) | Saldo maksimal | Opsional | | TXID | ID | Opsional | | Search | Tombol untuk memproses kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Excel | Tombol untuk memproses kata kunci dimasukkan untuk *file* akan diunduh | Format *file* akan diunduh dalam format Excel | Bagian `Search Result` menampilkan rincian data per . dapat melihat rincian terkait dari *hyperlink * tersedia. Pada tabel ini, terdapat tambahan kolom selain data berasal dari `Search Option`. | **Nama** | **Deskripsi ** | **Keterangan** | | ------------- | ---------------------------------------- | -------------- | | Billing Phone | Nomor telepon untuk melakukan penagihan | | | Fail Amount | Nominal amount yang gagal pada transaksi | | | Fail Message | Pesan alasan transaksi gagal | | ## Paylater ![Transaction - Fail Transaction - Paylater](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/jUa7IWWkn91z8IwzJsVP1_image-merchant-back-office-fail-transaction-paylater.png "Transaction - Fail Transaction - Paylater") Bagian `Search Option` pada *metode pembayaran: Paylater* berisi formulir pencarian spesifik khusus untuk mencari data . Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- | | | Daftar terdaftar pada | *Default*: Total -> semua | | Payment Method | Daftar terdapat pada | *Default*:

Isi *dropdown*:
* * * * * * * | | Name | Nama melakukan | Opsional | | Trx Time | Waktu dalam format tanggal dan jam

Pengaturan waktu juga bisa langsung ditentukan antara hari ini, 1 minggu, atau 1 bulan | *Default*: tanggal hari ini dan jarak waktu 24 jam, *Today* | | Trx Amount(From) | Saldo minimal | Opsional | | Trx Amount(To) | Saldo maksimal | Opsional | | TXID | ID | Opsional | | Search | Tombol untuk memproses kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Excel | Tombol untuk memproses kata kunci dimasukkan untuk *file* akan diunduh | Format *file* akan diunduh dalam format Excel | Bagian `Search Result` menampilkan rincian data per . dapat melihat rincian terkait dari *hyperlink * tersedia. Pada tabel ini, terdapat tambahan kolom selain data berasal dari `Search Option`. | **Nama** | **Deskripsi ** | **Keterangan** | | ------------ | ---------------------------------------- | -------------- | | Fail Amount | Nominal amount yang gagal pada transaksi | | | Fail Message | Pesan alasan transaksi gagal | | ## Payout ![](https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-Z58G2AjQCIWV-gtu9WxyL-20240813-084653.png "Transaction - Fail Transaction - Payout") Bagian `Search Option` pada *metode pembayaran Payout* berisi formulir pencarian spesifik khusus untuk mencari data . Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- | | | Daftar terdaftar pada | *Default*: Total -> semua Merchant | | Payment Method | Daftar terdapat pada | *Default*:

Isi *dropdown*:
* * * * * * * | | Name | Daftar nama | *Default*: Total -> semua | | Trx Time | Waktu dalam format tanggal dan jam

Pengaturan waktu juga bisa langsung ditentukan antara hari ini, 1 minggu, atau 1 bulan | *Default*: tanggal hari ini dan jarak waktu 24 jam, *Today* | | Trx Amount(From) | Saldo minimal | Opsional | | Trx Amount(To) | Saldo maksimal | Opsional | | TXID | ID | Opsional | | Search | Tombol untuk memproses kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Excel | Tombol untuk memproses kata kunci dimasukkan untuk *file* akan diunduh | Format *file* akan diunduh dalam format Excel | Bagian `Search Result` menampilkan rincian data per . dapat melihat rincian terkait dari *hyperlink * tersedia. Pada tabel ini, terdapat tambahan kolom selain data berasal dari `Search Option`. | **Nama** | **Deskripsi ** | **Keterangan** | | ------------- | ---------------------------------------- | -------------- | | Billing Phone | Nomor telepon untuk melakukan penagihan | | | Fail Amount | Nominal amount yang gagal pada transaksi | | | Fail Message | Pesan alasan transaksi gagal | | ## QRIS ![](https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-3EoLuZTM7r7cR-hctXPe2-20240814-064151.png "Transaction - Fail Transaction - QRIS") Bagian `Search Option` pada *metode pembayaran: QRIS* berisi formulir pencarian spesifik khusus untuk mencari data . Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- | | | Daftar terdaftar pada | *Default*: Total -> semua | | Method | Daftar terdapat pada | *Default*:

Isi *dropdown*:
* * * * * * * | | Name | Nama melakukan | Opsional | | Trx Time | Waktu dalam format tanggal dan jam

Pengaturan waktu juga bisa langsung ditentukan antara hari ini, satu minggu, atau satu bulan | *Default*: tanggal hari ini dan jarak waktu 24 jam, *Today* | | Trx Amount(From) | Saldo minimal | Opsional | | Trx Amount(To) | Saldo maksimal | Opsional | | TXID | ID | Opsional | | Search | Tombol untuk memproses kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Excel | Tombol untuk memproses kata kunci dimasukkan untuk *file* akan diunduh | Format *file* akan diunduh dalam format Excel | Bagian `Search Result` menampilkan rincian data per . dapat melihat rincian terkait dari *hyperlink * tersedia. Pada tabel ini, terdapat tambahan kolom selain data berasal dari `Search Option`. | **Nama** | **Deskripsi ** | **Keterangan** | | ------------- | ---------------------------------------- | -------------- | | Billing Phone | Nomor telepon untuk melakukan penagihan | | | Fail Amount | Nominal amount yang gagal pada transaksi | | | Fail Message | Pesan alasan transaksi gagal | | ## GPN ![](https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-Mw7eDbohUQ4tMp09dDrB0-20240814-064240.png "Transaction - Fail Transaction - GPN Card") Bagian `Search Option` pada *metode pembayaran GPN* berisi formulir pencarian spesifik khusus untuk mencari data . Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ | | | Daftar terdaftar pada | *Default*: Total -> semua | | Method | Daftar terdapat pada | *Default*: GPN

Isi *dropdown*:
* * * * * * * | | Acquire | Daftar *Acquire * | *Default*: Total -> semua | | Issuer | Daftar *Issuer * | *Default*: Total -> semua | | Trx Time | Waktu dalam format tanggal dan jam

Pengaturan waktu juga bisa langsung ditentukan antara hari ini, 1 minggu, atau 1 bulan | *Default*: tanggal hari ini dan jarak waktu 24 jam, *Today* | | Card Number | Nomor kartu Pelanggan | Opsional | | Trx Amount(From) | Saldo minimal | Opsional | | Trx Amount(To) | Saldo maksimal | Opsional | | TXID | ID | Opsional | | Search | Tombol untuk memproses kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Excel | Tombol untuk memproses kata kunci dimasukkan untuk *file* akan diunduh | Format *file* akan diunduh dalam format Excel | Bagian `Search Result` menampilkan rincian data per . dapat melihat rincian dari *hyperlink * tersedia. Pada tabel ini, terdapat tambahan kolom selain data berasal dari `Search Option`. | **Nama** | **Deskripsi ** | **Keterangan** | | ------------ | ---------------------------------------- | -------------- | | Fail Amount | Nominal amount yang gagal pada transaksi | | | Fail Message | Pesan alasan transaksi gagal | | # Tutorial *** ## Mencari Data Transaksi Berikut panduan untuk mencari data . 1. Buka *sidebar*. 2. `Transaction`. 3. `Fail Transaction`. 4. ketentuan pencarian pada `Search Option`. 5. `Search` untuk melakukan pencarian data. 6. Data dicari akan muncul pada `Search Result`. ## Mengunduh Data Transaksi Berikut panduan untuk mengunduh data . 1. Buka *sidebar*. 2. `Transaction`. 3. `Fail Transaction`. 4. ketentuan pencarian pada `Search Option`. 5. `Excel` untuk mengunduh data dalam bentuk format Excel. 6. Data dicari akan terunduh secara otomatis. # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Transaction Data](docId\:iZwosih8r9HIc0UurgYMa) untuk mengetahui cara memeriksa data . ::: :::VerticalSplitItem [Noti History](docId\:wn_8Dv5FNJLiqhW4cfx3g) untuk mengetahui cara memeriksa riwayat . ::: :::: [title] Calendar [path] Merchant Back Office/Settlement/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/Ku4Cc7bGidiUhkobsHhDD_settlement-calendar.png "Calendar") Sub-menu ini membantu dalam memantau jumlah nominal akan melalui . Halaman ini terbagi menjadi 2 , yaitu `Search Option` dan `Search Result`. ::embed[]{url="https://youtu.be/ZmgyT6qtZd4"} Bagian `Search Option` adalah formulir digunakan untuk memasukkan kriteria pencarian data . Setiap *field* terdapat pada formulir ini bersifat opsional. dapat melakukan pencarian data untuk ditampilkan pada `Search Result` atau mencetak data dalam format PDF. Bagian `Search Result` adalah menampilkan hasil pencarian data berdasarkan kriteria dimasukkan pada `Search Option`. Data pada ini akan muncul secara otomatis mengikuti bulan sedang berjalan. # Calendar *** ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/KpCyslmShSMB4uYtqZUbD_main.png "Settlement - Calendar") Bagian `Search Option` berisi formulir pencarian digunakan untuk mencari data pada bulan tertentu dalam bentuk kalender. Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | -------- | --------------------------------------------------------------------- | ----------------------------------------------------------- | | Merchant | Daftar terdaftar pada | *Default*: Total -> semua | | Month | Waktu dalam format tanggal dan jam | *Default*: tanggal hari ini dan jarak waktu 24 jam | | Search | Tombol untuk memproses kata kunci yang dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Print | Tombol untuk melakukan mencetak kalender | *File* akan langsung dicetak | Bagian `Search Result` menampilkan kalender berisi data jumlah nominal akan melalui . Klik angka pada tanggal tertentu untuk melihat rincian per hari. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/rRiU4rSNMdDAJbsrurUTY_detail.png "Settlement - Calendar - Detail") # Tutorial *** ## Mencari Data Kalender Berikut panduan untuk mencari data kalender. 1. Buka *sidebar*. 2. `Settlement`. 3. `Calendar`. 4. Ganti ketentuan pencarian pada `Search Option`. 5. `Search` untuk melakukan pencarian data. 6. Data kalender dicari akan muncul pada `Search Result`. ## Mencetak Kalender ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/YegYRJD8wayThSUvCUuxo_print-pop-out.png "Settlement - Calendar - Print") Berikut panduan untuk mencetak kalender. 1. Buka *sidebar*. 2. `Settlement.` 3. `Calender.` 4. `Print` untuk melakukan cetak kalender pada bulan tertentu. 5. *Pop-out* untuk mencetak kalender akan muncul. 6. `Print` untuk melanjutkan mencetak kalender. Sebaliknya, tekan `Cancel` untuk membatalkan mencetak kalender. # See also ::::VerticalSplit :::VerticalSplitItem [Reconcile](docId\:AHK2dHdorKc5gVz8BDRkt) untuk mengetahui cara melihat riwayat data Reconcile. ::: :::VerticalSplitItem [Disbursement Report](docId:9O4NDwWma2rgYfwkNWOOi) untuk mengetahui cara melihat riwayat . ::: :::: [title] Risk Management [path] Merchant Back Office/ Menu `Risk Management` digunakan oleh untuk mengatur kartu dengan melakukan pengecualian atau pemblokiran kartu melalui . ::::LinkArray :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-1i4XK5g7v4wNcTDtYsFnu-20240731-095908.jpg"} [Blacklist Card](docId\:lZtL08rIq_1baQ_CXDie2) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-OmjvpCFTgSWymx_d2knps-20240731-095920.jpg"} [Whitelist Card](docId\:YjMgv80ZV587bRoP4JLh5) ::: :::: # See also ::::VerticalSplit :::VerticalSplitItem [Service](docId\:wJN9n07xZh_Esj9CeANSK) untuk mengetahui progres pengiriman pesan. ::: :::VerticalSplitItem [Working Capital Loan](docId\:she8toB85pw04adtHNMMW) untuk mengajukan pinjaman khusus . ::: :::: [title] Dashboard [path] Merchant Back Office/ Menu `Dashboard` pada MMS bertujuan untuk menampilkan ringkasan dalam kategori dan kurun waktu tertentu. Halaman ini terbagi menjadi 3 bagian, yakni; `Transaction Summary`, `Transaction Chart`, dan `Transaction Widget Chart`. ::embed[]{url="https://youtu.be/ENg1qiMztZ8"} # Transaction Summary *** ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/MPo5YETquf600PuVIlBqf_back-office-mms-28.png "Transaction Summary") Bagian `Transaction Summary` adalah bagian menampilkan untuk setiap dan dalam bentuk kartu dengan warna berbeda-beda. Transaction Summary terbagi menjadi 2 jenis kategori, yaitu **Payment & Message Channel** dan **Settlement**. ## Payment & Message Channel ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/FwkU18Vr_R_7KCfpNzawt_nicepay-dashboard-mms-2.png "NICEPAY Payment and Message Channel") **Payment & Message Channel** adalah rangkuman dari dan mengirim pesan dimiliki oleh dan ditampilkan dalam bentuk kartu. Terdapat 8 dan 1 layanan mengirim pesan ditampilkan pada Dashboard, yaitu: 1. . 2. (VA). 3. . 4. Click Pay (). 5. . 6. . 7. . 8. . 9. . ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/7JhZDykThMPIQkvn2-kyZ_back-office-mms-1.png "Dashboard - Payment Channel") Kategori ditampilkan pada setiap kartu, yaitu jumlah dan total nominal . Masing-masing kategori terbagi ke dalam 2 bagian, yakni hari ini dan bulan ini. ## Settlement ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/IH4VHJBk9AlsCTg9JB1_0_nicepay-dashboard-mms-11.png "Settlement Dashboard") **Settlement **adalah rangkuman dimiliki oleh ditampilkan dalam bentuk kartu. Informasi ditampilkan pada kartu adalah **Amount (Transfer)** dan **Amount (Setoff)**. # Transaction Chart *** ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/6fyeewUcxrSr7Ekn5ZZmC_nicepay-dashboard-mms-5.png "NICEPAY Transaction Chart Payment") Bagian `Transaction Chart` adalah bagian menampilkan pergerakan dalam bentuk diagram garis untuk setiap terbagi ke dalam beberapa kategori. dapat melihat pergerakan berdasarkan *status transaksi* *(*Success**, **Fail**, **Void**, dan **Refund*), *kemudian terbagi kembali menjadi *2 bagian* *(jumlah nominal transaksi dan jumlah total transaksi)*. # Transaction Widget Chart *** ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/jGufb4lcDxQymCps1CYo1_back-office-mms-5.png "Transaction Widget Chart") Bagian `Transaction widget chart` adalah bagian terdiri dari beberapa *widget* fokus menampilkan rangkuman harian dalam bentuk diagram lingkaran untuk setiap tipe . Setiap *widget* memiliki beberapa filter, yakni tanggal , jumlah nominal , dan jumlah total . Rincian pada setiap *widget* ditampilkan dalam bentuk persentase. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/jPoYXDacBnJ-H6QM8FQAx_nicepay-dashboard-mms-9.png "Widget Structure") ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/OPkqQnJEYzuhczjCR2etM_nicepay-dashboard-mms-8.png) ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/KneRrDKqk-GfSdYn0pvzZ_nicepay-dashboard-mms-10.png "Dashboard Widget Top Transaction") Bagian `transaction widget chart` terdiri dari 9 *widget* *chart* fokus menampilkan data berbeda-beda. *Widget* tersebut, antara lain: - *Payment Type*, menampilkan statistik untuk melihat tipe paling banyak digunakan oleh . - *Top Bank Credit Card*, menampilkan statistik mengenai paling banyak digunakan pada dengan . - *Top Bank Transfer*, menampilkan statistik mengenai *Issuer* paling banyak digunakan oleh . - *Top Mitra Convenience Store*, menampilkan statistik mengenai paling banyak digunakan pada oleh . - *Top Mitra Click-pay*, menampilkan statistik mengenai ClickPay paling banyak digunakan oleh . - *Top Mitra E-Wallet*, menampilkan statistik mengenai paling banyak digunakan oleh . - *Top Mitra Payloan*, menampilkan statistik mengenai paling banyak digunakan oleh . - *Top Bank Payout*, menampilkan statistik mengenai paling banyak digunakan dalam . - *Top Mitra QRIS*, menampilkan statistik mengenai paling banyak digunakan oleh . # See also ::::VerticalSplit :::VerticalSplitItem [Merchant Back Office](docId\:VMD8YtiiJqku6H8dRhcS6) untuk mempelajari platform disediakan . ::: :::VerticalSplitItem [Login](docId\:E06mj1OMQy3XDodSVlY31) untuk cara akses ke dalam platform. ::: :::: ::::VerticalSplit :::VerticalSplitItem [Profile](docId\:BabGGtWurVs0v13RqGnyS) untuk mempelajari pengaturan data dan Pengguna. ::: :::VerticalSplitItem [Notice & Help](docId\:jZ2Nclue19F_w41Vx_PIS) untuk mengetahui khusus pengumuman dan bantuan. ::: :::: [title] Credential Management [path] Merchant Back Office/Profile/ # Credential Management *** Menu `Credential Management` digunakan oleh telah memiliki atau Client ID untuk melihat kredensial pada saat menggunakan . Saat ini, menyediakan fitur membantu memantau kredensial pada saat menggunakan berbasis untuk . ## SNAP Credential Management *** ![Credential Management - SNAP Credential Management - Search](https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-vqGxxEB830WrfHe40bdFi-20250227-035729.png "Credential Management - SNAP Credential Management - Search") Sub-menu `SNAP Credential Management` berisikan kredensial pada saat menggunakan berbasis . Melalui ini, dapat memeriksa dari akses kredensial dimiliki. Sehingga, dapat memeriksa dan memantau kredensial dalam jumlah banyak secara bersamaan. Halaman ini terbagi menjadi 2 , yaitu `Search Option` dan `Search Result`. Bagian `Search Option` adalah formulir digunakan untuk memasukkan kriteria pencarian data. Bagian `Search Result` untuk menampilkan hasil pencarian berdasarkan kriteria ingin dicari. Formulir pada `Search Option` terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | --------------- | ------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------- | | Client ID | ID Klien yang dimiliki . | Client ID = ID / IMid | | Credential ID | ID Kredensial . | Credential ID = iMid - createDt -UUID.randomUUID

Example :
IONPAYTEST-20241111091930-c94134c1 | | Credential Name | Nama Kredensial . | IONPAYTEST (Kredensial Utama) | | Status | Status Kredensial . | - Inactive - Active | | Search | Tombol untuk melakukan kata kunci dimasukkan pada saat mencari kredensial. | Hasil pencarian data akan ditampilkan pada `Search Result`. | *Field * terdapat pada hasil pencarian formulir dalam ini terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ----------------- | ------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | | Brand Name | Nama Merek dimiliki . | | | Client ID | ID Klien yang dimiliki . | Client ID = ID / IMid | | Credential ID | ID Kredensial . | Credential ID = iMid - createDt -UUID.randomUUID

Example:
IONPAYTEST-20241111091930-c94134c1 | | Credential Name | Nama Kredensial . | IONPAYTEST (Kredensial Utama) | | ID | ID . | ID = ID / IMid | | Registration Date | Waktu Kredensial Dibuat oleh . | 07-02-2026 | | Last Update Date | Waktu Kredensial Terakhir Diperbarui oleh . | 07-02-2026 | | Key | Key. | - Standard - Additional | | Status | Status Kredensial . | * Inactive * Active | ### Rincian Kredensial ![Credential Management - Detail](https://api.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/jl9OiZsmcUNJRtUnYTSS0-20260108-005625.png "Credential Management - Detail") | **Nama** | **Deskripsi** | **Keterangan** | | ------------------- | ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Client Type
| Tipe Klien . | | | Code | Nomor Random Unik . | - | | Client ID | ID Klien yang dimiliki . | Client ID = ID / IMid | | ID | ID . | ID = ID / IMid | | Brand Name | Nama Merek dimiliki . | | | Credential ID | ID Kredensial . | Credential ID = iMid - createDt -UUID.randomUUID

Example:
IONPAYTEST-20241111091930-c94134c1 | | Credential Name | Nama Kredensial . | IONPAYTEST Kredential Utama | | Channel ID | Nomor Unik Kredensial Channel. | IONPAYTEST01 | | Client Secret | Client Secret Key. | - | | External Public Key | Public Key. | - | | NICEPAY Public Key | Untuk verifikasi *response* dari dan validasi data yang ditandatangani dengan aman oleh . | - | | Basepath | URL *path* hanya dibutuhkan pada NIVA & NICO. | wajib menyediakan *path* ini agar dapat melakukan *inquire *mengenai rincian .

hubungi Tim Integrasi untuk mendapat bantuan lebih lanjut. | | Notif Type | Tipe untuk Transaksi . | dapat memilih untuk menggunakan spesifikasi antara Non- atau untuk mendapatkan terakhir. | | Status | Status Kredensial . | - Inactive - Active | | Registration Date | Waktu Kredensial dibuat oleh . | 07-02-2026 | | Last Update Date | Waktu Kredensial Terakhir diperbarui oleh . | 07-02-2026 | | Role Setting | Rincian Informasi Kredential Role. | - | | Setting | Tombol untuk mem pengaturan kredensial akan dijalankan. | Pengaturan kredensial akan menyesuaikan spesifikasi dibuat. | ### Rincian Setting ![Credential Management - Setting Detail](https://api.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/d1Mfg6FTicTGHeFHDlxh7-20260108-005654.png "Credential Management - Setting Detail") | **Nama** | **Deskripsi** | **Keterangan** | | -------------------------------------- | -------------------------------------------------------------------------------------------- | -------------- | | Role | Akses dimiliki kredensial. | - | | s | Role kredensial pada bagian s. | - | | `Payments` Registration Authorization | Role kredensial pada bagian s untuk mengatur otorisasi pada saat melakukan registrasi . | Write | | `Payments` Authorization | Role kredensial pada bagian s untuk mengatur otorisasi pada saat melakukan . | Write | | `Payments` Inquiry Authorization | Role kredensial pada bagian s untuk mengatur otorisasi pada saat memeriksa . | Read | | `Payments` Cancel Authorization | Role kredensial pada bagian s untuk mengatur otorisasi pada saat membatalkan . | Write | | | Role kredensial pada . | - | | `Payout` Registration Authorization | Role kredensial pada bagian untuk mengatur otorisasi pada saat melakukan registrasi . | Write | | `Payout` Approval/Reject Authorization | Role kredensial pada untuk mengatur otorisasi pada saat menyetujui/membatalkan pengajuan . | Write | | `Payout` Inquiry Authorization | Role kredensial pada untuk mengatur otorisasi pada saat memeriksa . | Write | # Tutorial *** ## Melihat Informasi Kredensial Merchant ![Credential Management - SNAP Credential Management - Search Result](https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-hWDZflGau61C-3rK0XCp6-20250227-035943.png "Credential Management - SNAP Credential Management - Search Result") Berikut panduan untuk melihat kredensial . 1. Buka *sidebar*. 2. `Profile`. 3. `Credential Management`, lalu klik `SNAP Credential Management`. 4. ketentuan pencarian pada `Search Option`. 5. `Search` untuk melakukan pencarian data. 6. Data kredensial dicari akan muncul pada `Search Result`. ## Melihat Rincian Informasi Kredensial Merchant Berikut panduan untuk melihat rincian kredensial . 1. Buka *sidebar*. 2. `Profile`. 3. `Credential Management`, lalu klik `SNAP Credential Management`. 4. ketentuan pencarian pada `Search Option`. 5. `Search` untuk melakukan pencarian data. 6. `Client ID` pada suatu baris data. 7. Rincian data kredensial dipilih akan muncul pada `View`. ## Melihat Rincian Pengaturan Credential Role ![Credential Management - Credential Role](https://api.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/d1Mfg6FTicTGHeFHDlxh7-20260108-005654.png "Credential Management - Credential Role") Berikut panduan untuk melihat rincian pengaturan . 1. Buka *sidebar*. 2. `Profile`. 3. `Credential Management`, lalu klik `SNAP Credential Management`. 4. ketentuan pencarian pada `Search Option`. 5. `Search` untuk melakukan pencarian data. 6. `Client ID` pada suatu baris data. 7. `Setting` pada `View`. 8. *Pop-up *`Credential Role` akan muncul pada layar. # See also ::::VerticalSplit :::VerticalSplitItem [Merchant Data](docId:7IhkFtaIHOX62F21vl8Bq) untuk mengetahui cara melihat terkait data . ::: :::VerticalSplitItem [User ID](docId\:Tjd1p8wHGH1E-QVsS8XJ0) untuk mengetahui cara mengatur akses Pengguna. ::: :::: [title] Whitelist Card [path] Merchant Back Office/Risk Management/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/Odh2mcgLU1tEyJJPUD8SJ_back-office-mms-2022-11-02t100227247.png "Whitelist Card") # Whitelist Card *** Sub-menu `Whitelist Card` digunakan untuk membantu dalam melakukan pencarian maupun mendaftarkan identitas tertentu sebagai Whitlelist pada agar tidak terdeteksi sebagai identitas mengganggu atau *spam*. Tipe Whitelist terbagi menjadi 3 tipe, yaitu by Card Number, Email, dan Card Bin Number. Dengan mendaftarkan identitas tertentu sebagai Whitelist, maka dapat mengamankan identitas tidak mengganggu tersebut. Contoh: e-mail A sering digunakan untuk mengirim pesan masif kepada banyak Penerima sebagai dari fungsi . Supaya pesan-pesan dikirim ke banyak e-mail Pengguna tidak masuk ke dalam *spam* oleh , maka perlu diatur sebagai Whitelist. ::embed[]{url="https://youtu.be/bsxHbI9HdGk"} Halaman `Whitelist Card` terbagi menjadi 3 , yaitu `Search Option`, `Search Result`, dan `Regist`. Bagian `Search Option` adalah formulir digunakan untuk memasukkan kriteria pencarian data. Bagian `Search Result` untuk menampilkan hasil pencarian berdasarkan kriteria ingin dicari. Bagian `Regist` adalah untuk melanjutkan prosedur pendaftaran data ke dalam Whitelist. ## Pencarian Whitelist Berdasarkan Nomor Kartu ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/Q7nq4MzBXK1eyiRTgP9So_back-office-mms-75.png "Whitelist Card - Search Option - By Card Number") Bagian `Search Option` pada *Whitelist by: Card Number* berisi formulir pencarian khusus digunakan untuk mencari riwayat data Whitelist berdasarkan nomor kartu. Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ------------ | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ | | | Nama | | | Status | Status Whitelist | *Default*: Total -> semua

Isi *dropdown*:
* Total * Active * Inactive | | Whitelist By | Metode Whitelist dipilih | *Default*: Card Number

Isi *dropdown*:
* Card Number * Email * Card Bin Number | | Card Number | Nomor kartu | | | Card Name | Nama Pemilik kartu | | | Search | Tombol untuk memproses kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Register | Tombol untuk menampilkan formulir pendaftaran untuk data akan di-*whitelist* | Formulir akan muncul di atas `Search Option` | Bagian `Search Result` pada *Whitelist by: Card Number* menampilkan riwayat data Whitelist berdasarkan nomor kartu. dapat mengubah data dengan menekan `Edit` dan melepaskan data kartu dengan menekan `Release` terdapat pada kolom Option. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/Vl8UE_6TwR1X-hiC9gLMf_back-office-mms-79.png "Whitelist Card - Search Result - By Card Number") ## Registrasi Whitelist Card Berdasarkan Nomor Kartu ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/oXo0PL6DjkY2hPct0gpvz_back-office-mms-80.png "Whitelist Card - Registration - By Card Number") Selain itu, juga dapat mendaftarkan kartu akan di-*whitelist *untuk ditambahkan ke dalam riwayat. Data berhasil didaftarkan akan ditampilkan pada `Search Result` dengan menekan `Register` pada `Search Option`. Formulir `Regist` terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | | | Nama berdasarkan Total/ ID | | | Permission Option | *Flag *terkait izin Whitelist | Pilihan *flagging:*
* Allow ECI 06/01 * Bypass FDS * Bypass Max Transaction Count | | Whitelist By | Metode Whitelist dipilih | *Default*: Card Number

Isi *dropdown*:
* Card Number * Email * Card Bin Number | | Card Number | Nomor kartu | | | Card Name | Nama Pemilik kartu | | | Whitelist Reason | Alasan kartu didaftarkan ke Whitelist | | | Memo | Catatan tambahan dimasukkan oleh | | | Whitelist Period | Periode waktu Whitelist kartu berlaku
**
Pengaturan waktu juga bisa langsung ditentukan antara hari ini, satu minggu, satu bulan, tiga bulan, atau enam bulan | *Default selection*
Pengaturan *default*: tanggal hari ini dan jarak waktu 24 jam | | Save | Tombol untuk menyimpan data *whitelist card by card number* | | ## Pencarian Whitelist Berdasarkan Customer Email ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/mO4sM_I5GmTa5cPrYHI1M_back-office-mms-83.png "Whitelist Card - Search Option - By Customer Email") Bagian `Search Option` pada *Whitelist by: Customer Email* berisi formulir pencarian khusus digunakan untuk mencari riwayat data Whitelist berdasarkan e-mail . Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ------------ | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | | | Nama | | | Status | Status Whitelist | *Default*: Total -> semua

Isi *dropdown*:
* Total * Active * Inactive | | Whitelist By | Metode sortir Whitelist dipilih | *Default*: Card Number

Isi *dropdown*:
* Card Number * Email * Card Bin Number | | Email | Data e-mail | | | Search | Tombol untuk mem kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Register | Tombol untuk menampilkan formulir pendaftaran untuk data akan di-*whitelist* | Formulir akan muncul di atas `Search Option` | Bagian `Search Result` pada *Whitelist by: Customer Email* menampilkan riwayat data Whitelist berdasarkan e-mail . dapat mengubah data dengan menekan `Edit` dan melepaskan data dengan menekan `Release` terdapat pada kolom Option. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/wjYHGNB8NGT-mefglDJQd_back-office-mms-84.png "Whitelist Card - Search Result - By Customer Email") ## Registrasi Whitelist Card Berdasarkan Email ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/YItKBwd4I3IYePgQVh3OK_back-office-mms-91.png "Whitelist Card - Registration - By Customer Email") Selain itu, juga dapat mendaftarkan kartu akan di-*whitelist *untuk ditambahkan ke dalam riwayat. Data berhasil didaftarkan akan ditampilkan pada `Search Result` dengan menekan `Register` pada `Search Option`. Formulir `Regist` terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | | Merchant | Nama | | | Permission Option | *Flag *terkait izin Whitelist | Pilihan *flagging:*
* Bypass FDS * Bypass Max Transaction Count | | Whitelist By | Metode Whitelist dipilih | *Default*: Card Number

Isi *dropdown*:
* Card Number * Email * Card Bin Number | | Email | E-mail Pemilik kartu | | | Whitelist Reason | Alasan kartu didaftarkan ke Whitelist | | | Memo | Catatan tambahan dimasukkan oleh | | | Whitelist Period | Periode waktu Whitelist berlaku
**
Pengaturan waktu juga bisa langsung ditentukan antara hari ini, satu minggu, satu bulan, tiga bulan, atau enam bulan | *Default selection*
Pengaturan *default*: tanggal hari ini dan jarak waktu 24 jam | | Save | Tombol untuk menyimpan data *whitelist card by customer email* | | ## Pencarian Whitelist Berdasarkan Nomor BIN Kartu ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/PJJFRjGiFTVkmEUIOrW21_back-office-mms-87.png "Whitelist Card - Search Option - By Card Bin Number") Bagian `Search Option` pada *Whitelist by: Card Bin Number* berisi formulir pencarian khusus digunakan untuk mencari riwayat data Whitelist berdasarkan nomor kartu Bin. Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | --------------- | ----------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | | | Nama | | | Status | Status Whitelist | *Default*: Total -> semua

Isi *dropdown*:
* Total * Active * Inactive | | Card Type | Tipe kartu | *Default*:

Isi *dropdown*:
* * Debit Card | | Whitelist By | Metode sortir Whitelist dipilih | *Default*: Card Number

Isi dropdown:
* Card Number * Email * Card Bin Number | | Card Bin Number | Nomor Kartu Bin | | | Name | Nama | Default: Total -> semua

Isi *dropdown*:
* Total * BPD Bali * SCB * AGRIS * BRI AGRO * AIA * dll | | Search | Tombol untuk mem kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Register | Tombol untuk menampilkan formulir pendaftaran untuk data akan di-*whitelist * | Formulir akan muncul di atas `Search Option` | Bagian `Search Result` pada *Whitelist by: Card Bin Number* menampilkan riwayat data Whitelist berdasarkan nomor kartu Bin. dapat mengubah data dengan menekan `Edit` dan melepaskan data kartu dengan menekan `Release` terdapat pada kolom Option. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/i3VYLS4ULFSbyFUb-_vpZ_back-office-mms-89.png "Whitelist Card - Search Result - By Card Bin Number") ## Registrasi Whitelist Card Berdasarkan Nomor BIN Kartu ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/Fkk25iGvYB_p7lO6g-YGx_back-office-mms-90.png "Whitelist Card - Registration - By Card Bin Number") Selain itu, juga dapat mendaftarkan kartu akan di-*whitelist *untuk ditambahkan ke dalam riwayat. Data berhasil didaftarkan akan ditampilkan pada `Search Result` dengan menekan `Register` pada `Search Option`. Formulir `Regist` terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | | | Nama | | | Card Type | Tipe kartu | *Default*:

Isi *dropdown*:
* * Debit Card | | Permission Option | *Flag *terkait izin Whitelist | Pilihan *flagging:*
* Allow ECI 06/01 * Bypass FDS | | Whitelist By | Dasar yang di-*whitelist * | *Default*: Card Number

Isi *dropdown*:
* Card Number * Email * Card Bin Number | | Card Bin Number | Nomor Kartu Bin | | | Name | Nama | *Default*: Total -> semua

Isi *dropdown*:
* Total * BPD Bali * SCB * AGRIS * BRI AGRO * AIA * dll | | Whitelist Reason | Alasan kartu didaftarkan ke Whitelist | | | Memo | Catatan tambahan dimasukkan oleh | | | Whitelist Period | Periode waktu Whitelist berlaku
**
Pengaturan waktu juga bisa langsung ditentukan antara hari ini, satu minggu, satu bulan, tiga bulan, atau enam bulan | *Default selection*
Pengaturan *default*: tanggal hari ini dan jarak waktu 24 jam | | Save | Tombol untuk menyimpan data *whitelist card by card bin number* | | # Tutorial *** ## Mencari Data Whitelist ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/AvNVXu-S7EQx8iO74TuaZ_back-office-mms-93.png "Risk Management - Whitelist Card - Search Result") Berikut panduan untuk mencari data Whitelist. 1. Buka *sidebar*. 2. `Risk Management`. 3. `Whitelist Card`. 4. \{\{mas}} ketentuan pencarian pada `Search Option`. 5. `Search` untuk melakukan pencarian data. 6. Data dicari akan muncul pada `Search Result`. ## Mendaftarkan Data Whitelist ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/LjQQ7HRsBClZM7y_yIbpi_back-office-mms-94.png "Risk Management - Whitelist Card - Search Option") Berikut panduan untuk mendaftarkan untuk di-*whitelist*. 1. Buka *sidebar*. 2. `Risk Management`. 3. `Whitelist Card`. 4. metode sortir Whitelist pada *bar* `Search Option`. 5. `Register`. 6. Bagian`Regist` akan muncul di atas `Search Option`. 7. Isi formulir ada di `Regist`. 8. `Register`. 9. Data akan secara otomatis terdaftar dan akan muncul pada `Search Result`. # See also ::::VerticalSplit :::VerticalSplitItem [Risk Management](docId\:VNOQ2Bc8WEEktAw0vdM76) untuk mempelajari khusus Blacklist dan Whitelist*.* ::: :::VerticalSplitItem [Blacklist Card](docId\:lZtL08rIq_1baQ_CXDie2) untuk mengetahui cara melakukan Blacklist. ::: :::: [title] Beneficiary Account [path] Merchant Back Office/Transaction/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/tGxZ1QBuv0SZ2RyoMPsFe_transaction-beneficiary-account.png "Beneficiary Account") Sub-menu `Beneficiary Account` digunakan untuk menampilkan data riwayat nomor rekening penerima dana pernah digunakan dalam . Halaman ini terbagi menjadi dua , yaitu `Search Option` dan `Search Result`. ::embed[]{url="https://youtu.be/gq2FspRjtxE"} Bagian `Search Option` adalah formulir digunakan untuk memasukkan kriteria pencarian data . dapat melakukan pencarian data untuk ditampilkan pada `Search Result` atau meng data dalam format Excel. Bagian `Search Result` adalah menampilkan hasil pencarian data berdasarkan kriteria dimasukkan pada `Search Option`. Data pada ini akan muncul setelah mengonfirmasi pencarian data dengan menekan `Search`. # Beneficiary Account *** ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/P28WrCeJFuyiEsIkPd2lh_1.png "Transaction - Beneficiary Account") Bagian `Search Option` berisi formulir pencarian digunakan untuk mencari semua data. Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ------------------ | ----------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | Daftar terdaftar pada | *Default*: Total -> semua | | Beneficiary Name | Nama pemilik akun rekening | Opsional | | Account No | Nomor akun rekening Pengguna | Opsional | | Beneficiary Status | Daftar Beneficiary | *Default*: Total -> semua

Isi *dropdown*:
* Total * *Resident* = Pemilik akun berstatus Warga Negara Indonesia (WNI) * *Non Resident* = Pemilik Akun Berstatus Warga Negara Asing (WNA) | | Beneficiary Type | Daftar jenis kepemilikan akun | Default: Total -> semua jenis kepemilikan akun

Isi *dropdown*:
* Total * *Individual* = Akun yang sifatnya Perorangan * *Company* = Akun yang sifatnya Perusahaan * *Government* = Akun yang sifatnya Pemerintahan * *Remittance* = Akun yang sifatnya Perorangan, Perusahaan, maupun Pemerintahan yang Berstatus Warga Negara Asing (WNA) | | Name | Daftar nama | *Default*: Total -> semua | | Search | Tombol untuk mem kata kunci yang dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Excel | Tombol untuk mem kata kunci yang dimasukkan untuk *file* yang akan di | Format *file* akan di dalam format Excel | Bagian `Search Result` menampilkan rincian data per . dapat melihat rincian terkait melalui *hyperlink* dan Beneficiary dari *pop-up*. # Tutorial *** ## Mencari Data Transaksi Berikut panduan untuk mencari data . 1. Buka *sidebar*. 2. `Transaction`. 3. `Beneficiary Account`. 4. ketentuan pencarian pada `Search Option`. 5. `Search` untuk melakukan pencarian data. 6. Data dicari akan muncul pada `Search Result`. ## Mengunduh Data Transaksi Berikut panduan untuk mengunduh data \{\{tr}} . 1. Buka *sidebar*. 2. `Transaction`. 3. `Beneficiary Account`. 4. ketentuan pencarian pada `Search Option`. 5. `Excel` untuk meng data dalam bentuk format excel. 6. Data dicari akan ter secara otomatis. # See also ::::VerticalSplit :::VerticalSplitItem [Preauth Data](docId\:PZyq9ecr_CqxGUh_oGJLZ) untuk mengetahui cara memeriksa data kartu Pre-Auth. ::: :::VerticalSplitItem [Payout Balance](docId\:g9JdFsDXboWzf2TEHzkrC) untuk mengetahui cara memeriksa . ::: :::: [title] Transaction [path] Merchant Back Office/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/9O-oMLU8d9YZ-lq5XQVja_back-office-mms-7.png "MMS Transaction") Menu `Transaction` digunakan untuk melakukan pencarian riwayat data untuk setiap pada . Admin dapat mendapatkan data secara keseluruhan hingga rincian per . ::::LinkArray :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-UC583c7LuEP8GzKotJjBT-20240731-083852.jpg"} [Transaction Data](docId\:iZwosih8r9HIc0UurgYMa) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-yyTw5sMsMn3jnWs6gOnWF-20240731-084022.jpg"} [Preauth Data](docId\:PZyq9ecr_CqxGUh_oGJLZ) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-rfgDuOTOy2ciCHz62U8hQ-20240731-084050.jpg"} [Noti History](docId\:wn_8Dv5FNJLiqhW4cfx3g) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-wf0D1JyPTF76sh9MWWYiQ-20240731-084103.jpg"} [Card Event History](docId\:EZbQsGUb8c02JifEDobHt) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-S55GQo6D_FqZ4Fv1IGaG2-20240731-084116.jpg"} [Fail Transaction](docId\:Kw36Cm_cK3RzRNUHfzavQ) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-F6-zVszRdCQkN-jTV-f1j-20240731-084127.jpg"} [Beneficiary Account](docId\:UX7TnX6wKsQFy_kXIvDbD) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-gv3J1Uer3XD9ywz-9Z9GI-20240731-084143.jpg"} [Payout Balance](docId\:g9JdFsDXboWzf2TEHzkrC) ::: :::: # See also ::::VerticalSplit :::VerticalSplitItem [Merchant Back Office](docId\:VMD8YtiiJqku6H8dRhcS6) untuk mempelajari platform disediakan . ::: :::VerticalSplitItem [Discount Event](docId:2qa-RAoG00FVzWNpoW_ec) untuk mempelajari khusus mengatur *event*. ::: :::: ::::VerticalSplit :::VerticalSplitItem [Settlement](docId\:klbWMmAVT2ne0Y8OcP0F_) untuk mempelajari khusus untuk memantau . ::: :::VerticalSplitItem [Statistic](docId\:uBklBxrtiCfVe6SdoEl7B) untuk mempelajari khusus melihat rangkuman . ::: :::: [title] Notice [path] Merchant Back Office/Notice & Help/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/4fU8UYesl2HFjkY7QdSLZ_back-office-mms-29.png "Notice") Sub-menu `Notice` membantu untuk melihat riwayat termasuk dalam kategori Insiden (Incident), Maintenance, dan Pemberitahuan lain (Notice). # Notice *** ::embed[]{url="https://youtu.be/ZoH9nDtSLI4"} Halaman pada `Notice` terbagi menjadi 2 , yaitu `Search Option` dan `Search Result`. Bagian `Search Option` adalah formulir digunakan untuk memasukkan kriteria pencarian data. Terdapat 3 tipe data untuk `Notice`, yaitu; Incident, Maintenance, dan Notice. Bagian `Search Result` digunakan untuk menampilkan hasil pencarian berdasarkan kriteria dinginkan. ## Notice ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/wej6ZYnKQsGQDxC7uMyzw_back-office-mms-2022-10-25t133650102.png "Notice - Search Option - Type: Notice") Bagian `Search Option` pada tipe *Notice* berisi formulir pencarian khusus digunakan untuk mencari riwayat data pengumuman. Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Type | Tipe jenis Notice | | | Classification | Klasifikasi jenis Notice | *Default*: Total -> semua klasifikasi

Isi *dropdown*:
* Total * 0% Installment * Notice Network Error * Notice Maintenance * Event * Change/Add * Other | | Title | Judul Notice | | | Time | Waktu *Notice* dibuat dalam format tanggal dan jam.

Pengaturan waktu juga bisa langsung ditentukan antara hari ini, 1 minggu, atau 1 bulan | *Default* *selection*
Pengaturan *default*: tanggal hari ini dan jarak waktu 24 jam | | Search | Tombol untuk mem kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | Bagian `Search Result` pada tipe *Notice* menampilkan riwayat data Notice pada . dapat melihat rincian terkait dari *hyperlink *pada kolom Title. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/wupPlH5QICN4mhM1UFf-i_back-office-mms-2022-10-25t135129827.png "Notice - Search Result - Type: Notice") ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/HKoPaAJklNED76HK363AW_image.png "Notice - View - Type: Notice") ## Incident ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/jyCHuvF92M2CCgR4SUESl_back-office-mms-2022-10-25t133657666.png "Notice - Search Option - Type: Incident") Bagian `Search Option` pada tipe *Incident* berisi formulir pencarian khusus digunakan untuk mencari riwayat kendala terjadi pada atau mengalami masalah internal. Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | | Type | Tipe jenis pertanyaan | | | Time | Waktu I*ncident* dibuat dalam format tanggal dan jam

Pengaturan waktu juga bisa langsung ditentukan antara hari ini, 1 minggu, atau 1 bulan | *Default selection*
Pengaturan *default*: tanggal hari ini dan jarak waktu 24 jam | | Search | Tombol untuk mem kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | Bagian `Search Result` pada tipe *Incident* menampilkan riwayat data `Notice` pada . dapat melihat rincian terkait dari *hyperlink *pada kolom Title. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/7brXikLk9J2A9S1KPRl01_back-office-mms-2022-10-25t140640421.png "Notice - Search Result - Type: Incident") ## Maintenance ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/MWRgcXlmGo51Hp0HmgqB7_back-office-mms-2022-10-25t133638984.png "Notice - Search Option - Type: Maintenance") Bagian `Search Option` pada tipe *Maintenance* berisi formulir pencarian khusus digunakan untuk mencari riwayat sedang dalam perbaikan. Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | | Type | Tipe jenis pertanyaan | | | Time | Waktu informasi *Maintenance* dibuat dalam format tanggal dan jam.

Pengaturan waktu juga bisa langsung ditentukan antara hari ini, 1 minggu, atau 1 bulan | *Default selection*
Pengaturan *default*: tanggal hari ini dan jarak waktu 24 jam | | Search | Tombol untuk mem kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/riDu_ZmNKuGtQQVI3mZv5_back-office-mms-2022-10-25t140640421.png "Notice - Search Result - Type: Maintenance") # Tutorial *** ## Mencari Data Notice, Incident, dan Maintenance ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/f7WPIXNg7o9jmUX928CaY_back-office-mms-2022-10-25t135129827.png "Notice Data in Search Result") Berikut panduan untuk mencari data Notice. 1. `Notice & Help`. 2. `Notice`. 3. Masukkan ketentuan pencarian pada `Search Option`. 4. tipe Notice akan dicari serta masukkan kriteria lain pada formulir. 5. `Search` untuk melakukan pencarian data. 6. Data dicari akan muncul pada `Search Result`. ## Melihat Rincian Data Notice ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/azv0ojij-T937GtEc_5ur_image.png "View Detail Result") Berikut panduan untuk mencari data Notice. 1. Buka *sidebar*. 2. `Notice & Help`. 3. `Notice`. 4. Masukkan ketentuan pencarian pada `Search Option`. 5. tipe Notice akan dicari serta masukkan kriteria lain pada formulir. 6. `Search` untuk melakukan pencarian data. 7. Data dicari akan muncul pada `Search Result`. 8. *hyperlink *pada baris data di dalam kolom *Title.* 9. Bagian `View` akan muncul di atas `Search Option`. # See also ::::VerticalSplit :::VerticalSplitItem [FAQ](docId\:miTf4W3FwvNrMQ_uUHv7e) untuk mengetahui cara mencari jawaban atas pertanyaan umum. ::: :::VerticalSplitItem [Contact CS](docId\:QYQF9kWzsJKLceF9l8POE) untuk mengetahui cara menghubungi CS. ::: :::: [title] Service [path] Merchant Back Office/ Menu `Service` digunakan oleh pada saat melakukan secara *online *melalui e-mail, serta mengatur dan memantau aktivitas pengiriman melalui . ::::LinkArray :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-vsCz87td8f5qCmk5flObs-20240731-094901.jpg"} [Key-in Payment](docId\:fUgLoAivcwKrKToavX6Ow) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-ulKiJX7cVBVjFopaU581D-20240731-094932.jpg"} [Email Payment](docId\:XAVz9EU950MGIr08PvjzL) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-2y2KaSGg3e5gl0OqKvpAD-20240731-094945.jpg"} [SMS History Log](docId\:iEREuK7SKBxL6YfUaFgQT) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-khwjGCcEpj0AU9XXRUbwc-20240731-094912.jpg"} [SMS Top Up](docId\:ubOKZmYWQRYzfqeK6lFeK) ::: :::: # See also ::::VerticalSplit :::VerticalSplitItem [Risk Management](docId\:VNOQ2Bc8WEEktAw0vdM76) untuk mempelajari khusus Blacklist dan Whitelist*.* ::: :::VerticalSplitItem [Working Capital Loan](docId\:she8toB85pw04adtHNMMW) untuk mengajukan pinjaman khusus . ::: :::: [title] Card Event History [path] Merchant Back Office/Transaction/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/TMyUFgDVYBei1N1r8eSSE_transaction-card-event-history.png "Card Event History") Sub-menu `Card Event History` membantu untuk mengecek seluruh data sudah terjadi. Halaman ini terbagi menjadi 2 , yaitu `Search Option` dan `Search Result`. ::embed[]{url="https://youtu.be/_Tu9VbJ7T_E"} Bagian `Search Option` adalah formulir digunakan untuk memasukkan kriteria pencarian data . dapat melakukan pencarian data untuk ditampilkan pada `Search Result` atau mengunduh data dalam format Excel. Bagian `Search Result` adalah menampilkan hasil pencarian data berdasarkan kriteria dimasukkan pada `Search Option`. Data pada ini akan muncul setelah mengonfirmasi pencarian data dengan menekan `Search`. # Card Event History *** ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/G5lmRHgNOr2igGlkHkYUX_1.png "Transaction - Card Event History") Bagian `Search Option` berisi formulir pencarian digunakan untuk mencari semua data. Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ------------------- | --------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | Daftar terdaftar pada | *Default*: Total -> semua | | Trx Time | Waktu dalam format tanggal dan jam | *Default*: tanggal hari ini dan jarak waktu 24 jam | | Trx Time (*Within*) | Jarak waktu

Pengaturan waktu bisa langsung ditentukan antara hari ini, 1 minggu, atau 1 bulan | *Default*: Today | | Acquire | Daftar nama *Acquire* | *Default*: Total -> semua *Acquire*

Isi *dropdown*:
* Total * Mandiri * BNI * BCA * Maybank | | Issuer | Daftar nama *Issuer* | *Default*: Total -> semua *Issuer*

Isi *dropdown*:
* Total * ANZ, BCA, BNI, BRI, CITIBANK, Danamon, HSBC, Maybank, MEGA, Mandiri, Permata, Stanchart UOB, SHINHAN.ID * Other | | Installment Type | Daftar tipe Installment | *Default*: Total -> semua tipe Installment

Isi *dropdown*:
* Total * Charge On Customer: Biaya dibebankan kepada * Charge On : Biaya di tanggung oleh | | Event Type | Daftar tipe *event* | *Default*: Total -> semua tipe *event*

Isi *dropdown*:
* Total * OFFUS * CASHBACK | | TXID | ID | Opsional | | Search | Tombol untuk memproses kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Excel | Tombol untuk memproses kata kunci dimasukkan untuk *file* akan diunduh | Format *file* akan diunduh dalam format Excel | Bagian `Search Result` menampilkan rincian data per . dapat melihat rincian terkait dari *hyperlink *dan melakukan pengajuan . # Tutorial *** ## Mencari Data Transaksi Berikut panduan untuk mencari data . 1. Buka *sidebar*. 2. `Transaction`. 3. `Card Event History`. 4. ketentuan pencarian pada `Search Option`. 5. `Search` untuk melakukan pencarian data. 6. Data dicari akan muncul pada `Search Result`. ## Mengunduh Data Transaksi Berikut panduan untuk mengunduh data . 1. Buka *sidebar*. 2. `Transaction`. 3. `Card Event History`. 4. ketentuan pencarian pada `Search Option`. 5. `Excel` untuk mengunduh data dalam bentuk format Excel. 6. Data dicari akan terunduh secara otomatis. # See also ::::VerticalSplit :::VerticalSplitItem [Discount Event Transaction](docId\:S0LDFXlG5jHeF0tRTp9-y) untuk mengetahui cara memeriksa jumlah saat *event *berlangsung. ::: :::VerticalSplitItem [Discount Event Enroll](docId\:HS9L9Cw20M4tp83N3v1bR) untuk mengetahui cara membuat *event*. ::: :::: [title] Transaction Limit [path] Merchant Back Office/Profile/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/7doViaWxxNlsJ1VuZilqF_back-office-mms-2022-11-03t155037499.png "Transaction Limit") Sub-menu `Transaction Limit` berfungsi untuk menampilkan terkait limit terhadap penggunaan . ::embed[]{url="https://youtu.be/LYTLQEC_w58"} Pada `Transaction Limit` terdapat 3 , yaitu `Search Option`, `Search Result` dan `View Detail`. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/6p-ogfGTWbPrXYmAWJrqp_back-office-mms-2022-11-01t150638281.png "Profile - Transaction Limit") # Transaction Limit *** ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/z9jqhAOq6LLekad_SUp9J_back-office-mms-2022-11-01t151101496.png "Transaction Limit - Search Option") Bagian `Search Option` adalah formulir digunakan untuk memasukkan kriteria pencarian data. Formulir dalam ini terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | -------- | ------------------------------------------------------------------- | ----------------------------------------------------------- | | | Daftar nama akan dipilih | | | Search | Tombol untuk mem kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Excel | Tombol untuk mem kata kunci dimasukkan untuk *file* akan di User | Format *file* akan di dalam format Excel (.xslx) | Bagian `Search Result` menampilkan hasil pencarian data berdasar pada kriteria dimasukan pada `Search Option`. Data akan ditampilkan setelah melakukan konfirmasi pencarian data dengan menekan `Search`. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/MWHWYCbtMFlPTsKYp5dGG_back-office-mms-2022-11-01t150649505.png "Transaction Limit - Search Result") Hasil pencarian pada `Search Result` bergantung pada kriteria pencarian dipilih. Formulir dalam ini terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ------------------------ | ------------------------------- | ----------------------- | | Company Name | Nama Perusahaan | | | I-MID | ID | | | Limit Type | Status tipe limit | Macam :
* Approved | | Block Transaction | Status limit | Macam :
* Block | | Limit Calculation Period | Batas periode kalkulasi | | | Limit Period | Batas periode | | | Applied Date | Tanggal pengajuan/aplikasi | | | View | Tombol navigasi melihat detail | | ## View Detail ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/7p6a4y6F_tZK9r4HVYEKb_image.png "Transaction Limit - View") Bagian `View` akan muncul setelah Pengguna menekan `View` terdapat pada baris data berasal dari `Search Result`. Bagian ini memuat rincian limit suatu . Formulir dalam ini terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ------------------------ | --------------------------------------------- | ----------------------- | | | Nama | | | Limit Type | ID | Macam :
* Approved | | Block Transaction | Status limit | Macam :
* Block | | Limit Calculation Period | Batas periode kalkulasi | | | Limit Period | Batas dapat dilakukan pada periode berjalan | | | Alarm Status | Status alarm | | | E-mail | Alamat e-mail | | | Register Reason | Alasan registrasi | | | Applied Date | Tanggal pengajuan/aplikasi | | | Close | Tombol navigasi menutup *tab* | | # Tutorial *** ## Mencari Data Transaction Limit ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/uygevhY34w0tvAv5d5dOe_back-office-mms-2022-11-01t163343140.png "Transaction Limit - Search Option") Berikut panduan untuk mencari data Transaction Limit: 1. Buka *sidebar*. 2. `Profile`. 3. `Transaction Limit`. 4. kriteria pencarian pada `Search Option`. 5. `Search` untuk melanjutkan pencarian. 6. Kriteria dicari akan muncul pada laman `Search Result`. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/kAA2c394W3Kki2swo1Mxp_back-office-mms-2022-11-01t163356372.png "Transaction Limit - Search Result") ## Melihat Rincian Informasi Merchant ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/7p6a4y6F_tZK9r4HVYEKb_image.png "Transaction Limit - View") Berikut panduan untuk melihat rincian pada profil Transaction Limit. 1. Buka *sidebar*. 2. `Profile`. 3. `Transaction Limit`. 4. kriteria pencarian diinginkan pada `Search Option`. 5. `Search`. 6. `View`pada detail ingin dipilih pada `Search Result`. 7. Data kolom dicari akan muncul pada `View`. 8. Rincian akan muncul di atas `Search Option`. ## Mengunduh Data Transaction Limit ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/Gajnm6zn7N7M-hAA5OmcQ_back-office-mms-2022-11-01t164642240.png "Transaction Limit - Excel") Berikut panduan untuk meng data pada Transaction Limit. 1. Buka *sidebar*. 2. `Profile`. 3. `Transaction Limit`. 4. kriteria an diinginkan pada `Search Option`. 5. `Excel` untuk meng data dalam format Excel. 6. *File* akan ter secara otomatis. # See also ::::VerticalSplit :::VerticalSplitItem [Merchant Data](docId:7IhkFtaIHOX62F21vl8Bq) untuk mengetahui cara melihat terkait data . ::: :::VerticalSplitItem [User ID](docId\:Tjd1p8wHGH1E-QVsS8XJ0) untuk mengetahui cara mengatur akses Pengguna. ::: :::: [title] Settlement Report [path] Merchant Back Office/Settlement/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/4kNvM3Tdm_4WrYKzzp0wG_settlement-settlement-report.png "Settlement Report") Sub-menu ini membantu untuk melihat laporan untuk semua yang terdapat pada . Halaman ini terbagi menjadi 2 , yaitu `Search Option` dan `Search Result`. ::embed[]{url="https://www.youtube.com/watch?v=s6BwQe82erU"} Bagian `Search Option` adalah formulir digunakan untuk memasukkan kriteria pencarian data . Setiap *field* terdapat pada formulir ini bersifat opsional, namun hasil pencarian dicari bergantung pada dipilih. dapat melakukan pencarian data untuk ditampilkan pada `Search Result` atau mengunduh data dalam format Excel. Bagian `Search Result` adalah yang menampilkan hasil pencarian data berdasarkan kriteria pada `Search Option`. Data pada ini akan muncul setelah mengonfirmasi pencarian data dengan menekan `Search`. Hasil pencarian data ditampilkan berbeda-beda sesuai dengan dipilih pada `Search Option`. # Settlement Report *** ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/dSZoIi7emrdXUATw9MvB9_back-office-mms-41.png "Settlement - Settlement Report") Bagian `Search Option` pada Total berisi formulir pencarian *general * digunakan untuk mencari semua data . Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | --------------- | ------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | | | Daftar yang terdaftar pada | *Default*: Total -> semua | | Date Type | Tipe waktu | *Default*: Type | | Settlement Time | Waktu berjalan | *Default*: 00:00 | | Date | Waktu dalam format tanggal dan jam | *Default*: tanggal hari ini dan jarak waktu 24 jam | | Date (Within) | Jarak waktu

Pengaturan waktu bisa langsung ditentukan antara hari ini, 1 minggu, atau 1 bulan | *Default*: *Today* | | Payment Method | Daftar terdapat pada | *Default*: Total -> semua

Isi *dropdown*:
* Total * * * * Click Pay * * * * * | | Trx Type | Tipe | *Default*: Total -> semua tipe

Hanya terdapat pada dan

Isi *dropdown*:
* Total * Full * Installment | | Status | Status | *Default*: Total -> semua

Hanya terdapat pada dan

Isi *dropdown*:
* Total * Approved * Refund * Partial refund | | Search | Tombol untuk mem kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Excel | Tombol untuk memproses kata kunci dimasukkan untuk *file* berisi rangkuman data akan di | Format *file* akan di dalam format Excel | | Excel(Details) | Tombol untuk mem kata kunci dimasukkan untuk *file* berisi rincian data akan di.

*File* berisi rincian data per . | Format *file* akan di dalam format Excel | Bagian `Search Result` pada `Date type: Settlement date` menampilkan data berdasarkan tanggal . Tabel tersebut berisi ringkasan dari setiap tipe terdapat pada . ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/6gRl4EBdtD-5gW2_wW0d3_main.png "Search Result - Date type: Settlement Date") Bagian `Search Result` pada `Date type: Approval/Purchase` terbagi menjadi 2 tabel, digunakan untuk menampillkan data berdasarkan *transaction date*. Tabel pertama menampilkan ringkasan dari setiap tipe terdapat pada . Tabel kedua menampilkan rincian data per . ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/oRkx8nKeMhCOpeM3FVXnu_main-approval.png "Search Result - Date Type: Approval/Purchase") Apabila pilihan diubah menjadi lebih spesifik, data tidak dapat tampil pada `Search Result`. Data hanya bisa dilihat melalui unduh saja. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/M4jiGDcr_sJs_sRaRbXCS_alert.png "Pop-up ketika akan menampilkan data untuk spesifik metode pembayaran") # Tutorial *** ## Mencari Data Settlement Report Berikut panduan untuk mencari data laporan *settlement*. 1. Buka *sidebar*. 2. `Settlement`. 3. `Settlement Report`. 4. Masukkan ketentuan pencarian pada `Search Option`. 5. `Search` untuk melakukan pencarian data. 6. Data dicari akan muncul pada `Search Result`. ## Mengunduh Data Settlement Report Berikut panduan untuk mengunduh data laporan *settlement*. 1. Buka *sidebar*. 2. `Settlement`. 3. `Settlement Report`. 4. Masukkan ketentuan pencarian pada `Search Option`. 5. `Excel` untuk mengunduh rangkuman data dalam bentuk format Excel. 6. `Excel(Detail)` untuk mengunduh rincian data dalam bentuk format Excel. 7. Data dicari akan terunduh secara otomatis. # See also ::::VerticalSplit :::VerticalSplitItem [Pending Settlement](docId\:yba25yJeOhoGQUIBWWyYi) untuk mengetahui cara melihat riwayat data *pending*. ::: :::VerticalSplitItem [Seller Settlement](docId\:g4YT2vmfgxssUWbcUojuX) untuk mengetahui riwayat penjual*.* ::: :::: [title] Blacklist Card [path] Merchant Back Office/Risk Management/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/pWcm59NhoRooir2DCaWcZ_back-office-mms-2022-11-02t100236686.png "Blacklist Card") # Blacklist Card *** Sub-menu `Blacklist Card` pada Risk Management digunakan untuk membantu dalam melakukan *blacklist *terhadap kartu atau milik tidak sesuai dengan ketentuan dari tersebut. Tipe Blacklist terbagi menjadi 3 kategori, yaitu by Card Number, Email, dan Card Bin Number. Informasi kartu dan e-mail milik sudah didaftarkan tidak dapat digunakan lagi pada . ::embed[]{url="https://youtu.be/2JuGZlNOHgA"} Halaman `Blacklist Card` terbagi menjadi 3 , yaitu `Search Option`, `Search Result`, dan `Regist`. Bagian `Search Option` adalah bagian formulir digunakan untuk memasukkan kriteria pencarian data. Bagian `Search Result` untuk menampilkan hasil pencarian berdasarkan kriteria ingin dicari. Bagian `Regist` adalah untuk melakukan pendaftaran *blacklist* *data*. ## Pencarian Blacklist Berdasarkan Nomor Kartu ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/Av34SXQV26MRSI18kQu_d_back-office-mms-2022-11-02t103112332.png "Blacklist Card - Search Option - By Card Number") Bagian `Search Option` pada *Blacklist by: Card Number* berisi formulir pencarian khusus digunakan untuk mencari riwayat data Blacklist berdasarkan nomor kartu. Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ------------ | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | | | Nama | | | Status | Status Blacklist | *Default*: Total -> semua

Isi *dropdown*:
* Total * Active * Inactive | | Blacklist By | Metode Blacklist dipilih | *Default*: Card Number

Isi *dropdown*:
* Card Number * Email * Card Bin Number | | Card Number | Nomor kartu | | | Card Name | Nama Pemilik kartu | | | Search | Tombol untuk mem kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Register | Tombol untuk menampilkan formulir pendaftaran untuk data akan di-*blacklist* | Formulir akan muncul di atas `Search Option` | Bagian `Search Result` pada *Blacklist by: Card Number* menampilkan riwayat data Blacklist berdasarkan nomor kartu. dapat mengubah data dengan menekan `Edit` dan melepaskan data kartu dengan menekan `Release` terdapat pada kolom `Option`. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/fboCEHbzSGt5Roh6gFlos_risk-management-blacklist-card-search-result-card-number-1.png "Blacklist Card - Search Result - By Card Number") ## Registrasi Blacklist Card Berdasarkan Nomor Kartu ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/ifbPXGx3Y02JaepcIDF_5_back-office-mms-2022-11-02t132631782.png "Blacklist Card - Regist - By Card Number") Selain itu, juga dapat mendaftarkan kartu akan di-*blacklist*. Data berhasil didaftarkan akan ditampilkan pada `Search Result` dengan menekan `Register` pada `Search Option`. Formulir `Regist` terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | | | Nama berdasarkan Total/ ID | | | Blacklist By | Metode Blacklist dipilih | *Default*: Card Number

Isi *dropdown*:
* Card Number * Email * Card Bin Number | | Card Number | Nomor kartu | | | Card Name | Nama Pemilik kartu | | | Block Reason | Alasan kartu didaftarkan ke Blacklist | | | Memo | Catatan tambahan dimasukkan oleh | | | Blacklist Period | Periode waktu Blacklist kartu berlaku
**
Pengaturan waktu juga bisa langsung ditentukan antara hari ini, 1 minggu, 1 bulan, atau permanen | *Default selection*
Pengaturan *default*: tanggal hari ini dan jarak waktu 24 jam | | Save | Tombol untuk menyimpan data *blacklist card by card number* | | ## Pencarian Blacklist Berdasarkan *Customer Email* ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/V5OYRwvqyCO-hR-8Vr_qw_back-office-mms-2022-11-02t103101927.png "Blacklist Card - Search Option - By Customer Email") Bagian `Search Option` pada *Blacklist by: Customer Email* berisi formulir pencarian khusus digunakan untuk mencari riwayat data Blacklist berdasarkan e-mail . Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ------------ | ---------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | | | Nama | | | Status | Status Blacklist | *Default*: Total -> semua

Isi *dropdown*:
* Total * Active * Inactive | | Blacklist By | Metode sortir Blacklist dipilih | *Default*: Card Number

Isi *dropdown*:
* Card Number * Email * Card Bin Number | | Email | Data e-mail | | | Search | Tombol untuk memproses kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Register | Tombol untuk menampilkan formulir pendaftaran untuk data akan di-*blacklist* | Formulir akan muncul di atas `Search Option` | Bagian `Search Result` pada *Blacklist by: Customer Email* menampilkan riwayat data Blacklist berdasarkan e-mail . dapat mengubah data dengan menekan `Edit` dan melepaskan data dengan menekan `Release` terdapat pada kolom Option. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/XaOvvAxYFw9Q2N3Mon7QZ_risk-management-blacklist-card-search-result-customer-email.png "Blacklist Card - Search Result - By Customer Email") ## Registrasi Blacklist Card Berdasarkan Email ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/eDWw15qY_FAl72GWF1g1W_back-office-mms-2022-11-02t132526133.png "Blacklist Card - Regist - By Customer Email") Selain itu, juga dapat mendaftarkan kartu yang akan di-*blacklist*. Data berhasil didaftarkan akan ditampilkan pada `Search Result` dengan menekan `Register` pada `Search Option`. Formulir `Regist` terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | | | Nama | | | Blacklist By | Metode Blacklist dipilih | *Default*: Card Number

Isi *dropdown*:
* Card Number * Email * Card Bin Number | | Email | E-mail Pemilik kartu | | | Block Reason | Alasan kartu didaftarkan ke Blacklist | | | Memo | Catatan tambahan dimasukkan oleh | | | Blacklist Period | Periode waktu Blacklist berlaku
**
Pengaturan waktu juga bisa langsung ditentukan antara hari ini, 1 minggu, 1 bulan, atau permanen | *Default selection*
Pengaturan *default*: tanggal hari ini dan jarak waktu 24 jam | | Save | Tombol untuk menyimpan data *blacklist card by customer email* | | ## Pencarian Blacklist Berdasarkan Nomor BIN Kartu ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/DrLYAJ3UuUfImc0LQRpUA_back-office-mms-2022-11-02t103059339.png "Blacklist Card - Search Option - By Card Bin Number") Bagian `Search Option` pada *Blacklist by: Card Bin Number* berisi formulir pencarian khusus digunakan untuk mencari riwayat data Blacklist berdasarkan nomor *card bin*. Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | --------------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | | | Nama | | | Status | Status Blacklist | *Default*: Total -> semua

Isi *dropdown*:
* Total * Active * Inactive | | Card Type | Tipe kartu | *Default*:

Isi *dropdown*:
* * Debit Card | | Blacklist By | Metode sortir Blacklist dipilih | *Default*: Card Number

Isi *dropdown*:
* Card Number * Email * Card Bin Number | | Card Bin Number | Nomor *card bin* | | | Name | Nama | *Default*: Total -> semua

Isi *dropdown*:
* Total * BPD Bali * SCB * AGRIS * BRI AGRO * AIA * dll | | Search | Tombol untuk mem kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Register | Tombol untuk menampilkan formulir pendaftaran untuk data akan di-*blacklist* | Formulir akan muncul di atas `Search Option` | Bagian `Search Result` pada *Blacklist by: Card Bin Number* menampilkan riwayat data Blacklist berdasarkan nomor bin kartu. dapat mengubah data dengan menekan `Edit` dan melepaskan data kartu dengan menekan `Release` terdapat pada kolom `Option`. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/HyvMuYqtlCRQF6uUE8xKf_risk-management-blacklist-card-search-result-card-bin-number.png "Blacklist Card - Search Result - By Card Bin Number") ## Registrasi Blacklist Card Berdasarkan Nomor BIN Kartu ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/aeDGb-ncaShB73OTApaio_back-office-mms-2022-11-02t132341140.png "Blacklist Card - Regist - By Card Bin Number") Selain itu, juga dapat mendaftarkan kartu akan di-*blacklist *untuk ditambahkan ke dalam riwayat. Data berhasil didaftarkan akan ditampilkan pada `Search Result` dengan menekan `Register` pada `Search Option`. Formulir `Regist` terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | | | Nama | | | Card Type | Tipe kartu | *Default*:

Isi *dropdown*:
* * Debit Card | | Blacklist By | Dasar di-*blacklist* | *Default*: Card Number

Isi *dropdown*:
* Card Number * Email * Card Bin Number | | Card Bin Number | Nomor Card Bin | | | Name | Nama | *Default*: Total -> semua

Isi *dropdown*:
* Total * BPD Bali * SCB * AGRIS * BRI AGRO * AIA * etc | | Block Reason | Alasan kartu didaftarkan ke Blacklist | | | Memo | Catatan tambahan dimasukkan oleh | | | Blacklist period | Periode waktu Blacklist berlaku
**
Pengaturan waktu juga bisa langsung ditentukan antara hari ini, 1 minggu, 1 bulan, atau permanen | *Default selection*
Pengaturan *default*: tanggal hari ini dan jarak waktu 24 jam | | Save | Tombol untuk menyimpan data *Blacklist Card by Card Bin nNumber* | | # Tutorial *** ## Mencari Data Blacklist ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/ZSQtS1XwM0eMxgYsFkcga_back-office-mms-100.png "Blacklist Card - Search Result") Berikut panduan untuk mencari data Blacklist. 1. Buka *sidebar*. 2. `Risk Management`. 3. `Blacklist Card`. 4. Masukkan ketentuan pencarian pada `Search Option`. 5. `Search` untuk melakukan pencarian data. 6. Data dicari akan muncul pada `Search Result`. ## Mendaftarkan Data Blacklist ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/MXPKx2fOpMlkvQ9U432vd_back-office-mms-2022-10-20t160148956.png "Blacklist Card - Regist") Berikut panduan untuk mendaftarkan data kartu akan di-*blacklist*. 1. Buka *sidebar*. 2. `Risk Management`. 3. `Blacklist Card`. 4. metode sortir Blacklist pada `Search Option`. 5. `Register`. 6. Isi formulir pada `Regist` muncul di atas `Search Option`. 7. `Save` untuk melanjutkan pembuatan data Blacklist*. * 8. Data akan secara otomatis tersimpan dan akan muncul pada `Search Result`. # See also ::::VerticalSplit :::VerticalSplitItem [Risk Management](docId\:VNOQ2Bc8WEEktAw0vdM76) untuk mempelajari khusus Blacklist dan Whitelist*.* ::: :::VerticalSplitItem [Whitelist Card](docId\:YjMgv80ZV587bRoP4JLh5) untuk mengetahui cara melakukan whitelist. ::: :::: [title] Notice & Help [path] Merchant Back Office/ Menu `Notice & Help` digunakan oleh untuk memeriksa *error*, membuat FAQ, dan menghubungi . ::::LinkArray :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-aRhmnvJnK-1Adlk3--tEJ-20240731-095719.jpg"} [Notice](docId\:aXtwALglhPwRuNzaNRuMP) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-4txlVGvvQdYH-tRX3j5Y_-20240731-095730.jpg"} [FAQ](docId\:miTf4W3FwvNrMQ_uUHv7e) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-6ks-Tw8xFf4qltCM-857U-20240731-095745.jpg"} [Contact CS](docId\:QYQF9kWzsJKLceF9l8POE) ::: :::: # See also ::::VerticalSplit :::VerticalSplitItem [Merchant Back Office](docId\:VMD8YtiiJqku6H8dRhcS6) untuk mempelajari platform disediakan . ::: :::VerticalSplitItem [Login](docId\:E06mj1OMQy3XDodSVlY31) untuk cara akses ke dalam platform. ::: :::: ::::VerticalSplit :::VerticalSplitItem [Dashboard](docId\:ca0Tnj_-gHDF6qjwmjzi1) untuk mempelajari khusus memantau secara *real-time*. ::: :::VerticalSplitItem [Profile](docId\:BabGGtWurVs0v13RqGnyS) untuk mempelajari pengaturan data dan Pengguna. ::: :::: [title] Key-in Payment [path] Merchant Back Office/Service/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/tGJGW7Axxkjej547-Xu1m_back-office-mms-8.png "Key-in Payment") Sub-menu `Key-in Payment` digunakan oleh untuk bertransaksi secara manual dan dapat mengirimkan *invoice* kepada melalui e-mail. Untuk menggunakan ini, harus mengetahui terlebih dahulu, seperti nomor dan waktu masa berlaku . # Key-in Payment *** ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/4VbIeiuYcEl26aKSuYOpA_back-office-mms-47.png "Service - Key-in Payment") Sub-menu `Key-in Payment` membantu untuk melakukan secara manual dari MMS. perlu memasukkan seperti nominal dibayarkan dan kartu untuk ber ke dalam formulir sudah disediakan. Kemudian, dilakukan dengan mesin EDC. Formulir pada `Key-in Payment` terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | -------------------- | -------------------------- | -------------- | | User | Identitas | Mandatory | | I-MID | Internal ID | | | Product Name | Nama | | | Order Name | Nama pesanan | | | Buyer Name | Nama Pembeli | | | Buyer Contact Number | Nomor kontak | | | Buyer E-Mail | E-mail | | | Amount | Jumlah tagihan | | | No | Nomor | | | Expiry (Year) | Tahun batas masa berlaku | | | Expiry (Month) | Bulan batas masa berlaku | | | Installment | Kategori rencana cicilan | | | | Tombol untuk melakukan | | | Cancel | Tombol untuk membatalkan | | # Tutorial *** ## Pembayaran Menggunakan Key-in Payment ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/QEJjdoefmVySeQyilP04U_back-office-mms-2022-11-02t142428767.png "Key-in Payment - Payment Form") Berikut panduan untuk melakukan dengan *Key-in Payment*. 1. Buka *sidebar*. 2. `Service`. 3. `Key-in Payment`. 4. kriteria ketentuan ke dalam formulir tersedia. 5. `Payment` untuk melanjutkan atau `Cancel` untuk membatalkan . 6. Proses akan diproses. ikuti alur berikutnya. # See also ::::VerticalSplit :::VerticalSplitItem Temukan penjelasan terkait pada [Payment Link](docId\:ChpAc7d9l0s9A8mai3itC). ::: :::VerticalSplitItem [Email Payment](docId\:XAVz9EU950MGIr08PvjzL) untuk mengetahui cara menggunakan e-mail. ::: :::: [title] Transaction Data [path] Merchant Back Office/Transaction/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/-h2YOcb9otY-11TYzASTk_transaction-transaction-data.png "Transaction Data") # Transaction Data *** Sub-menu ini membantu untuk memeriksa data pada seluruh . Halaman ini terbagi menjadi 2 bagian, yaitu `Search Option` dan `Search Result`. ::embed[]{url="https://youtu.be/MetuiOsFzrM"} Bagian `Search Option` adalah bagian formulir digunakan untuk memasukkan kriteria pencarian data . Semua *field* terdapat pada formulir ini bersifat opsional, namun hasil pencarian dicari bergantung pada dipilih. Terdapat 10 pilihan ; yakni Total, , , , Click Pay, , , , , dan . dapat melakukan pencarian data untuk ditampilkan pada `Search Result` atau mengunduh data dalam format Excel. Bagian `Search Result` adalah menampilkan hasil pencarian data berdasarkan kriteria dimasukkan pada `Search Option`. Data pada ini akan muncul setelah mengonfirmasi pencarian data dengan menekan tombol `Search`. Hasil pencarian data ditampilkan berbeda-beda sesuai dengan dipilih pada `Search Option`. ## All Payment Method ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/Ssu5B6pU875ohfQRDMk5H_1.png "Transaction - Transaction Data") Bagian `Search Option` pada *metode pembayaran: Total* berisi formulir pencarian *general * digunakan untuk mencari semua data . Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ------------------- | --------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | | | Daftar terdaftar pada | *Default*: Total -> semua | | Payment Method | Daftar terdapat pada | *Default*: Total -> semua

Isi *dropdown*:
* Total * * * * Click Pay * * * * * | | Trx Time | Waktu dalam format tanggal dan jam | *Default*: tanggal hari ini dan jarak waktu 24 jam | | Trx Time (*Within*) | Jarak waktu

Pengaturan waktu bisa langsung ditentukan antara hari ini, 1 minggu, atau 1 bulan | *Default*: *Today* | | Customer Name | Nama Pelanggan | Opsional | | Order Number | Nomor pesanan | Opsional | | Trx Amount | Batas minimum (*From*) dan maksimum (*To*) saldo | Opsional | | Trx Status | Status | *Default*: Total -> semua trx

Isi *dropdown*:
* Total * *Authorization/Complete* * *Cancellation* * *Refund* | | TXID | ID | Opsional | | Search | Tombol untuk memproses kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada bagian `Search Result` | | Excel | Tombol untuk memproses kata kunci dimasukkan untuk *file* akan diunduh | Format *file* akan diunduh dalam format Excel | Bagian `Search Result` pada *metode pembayaran: Total* terbagi menjadi dua tabel. Tabel pertama menampilkan ringkasan dari setiap tipe terdapat pada . Tabel kedua menampilkan rincian data per . dapat melihat rincian terkait dari *hyperlink *dan rincian dari *pop-up * ditampilkan. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/WOAiC49VikCwsxvY-QMjo_1-1.png "Transaction Data - Search Result - All Payment Method") ## Credit Card ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/WdCTCSMIHGtqZoYiwXjUZ_2.png "Transaction Data - Search Option - Credit Card") Bagian `Search Option` pada *metode pembayaran: Credit Card* berisi formulir pencarian spesifik khusus untuk mencari data . Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------- | | | Daftar terdaftar pada . | *Default*: Total -> semua | | Payment Method | Daftar terdapat pada .
*Default*: Total -> semua . | *Default*: Total -> semua | | Date of Approval | Waktu disetujui dalam format tanggal dan jam.

Pengaturan waktu juga bisa langsung ditentukan antara hari ini, 1 minggu, 1 bulan, 3 bulan, atau 6 bulan | *Default selection*
Pengaturan *default*: tanggal hari ini dan jarak waktu 24 jam | | Date of Cancel | Waktu dibatalkan dalam format tanggal dan jam

Pengaturan waktu juga bisa langsung ditentukan antara hari ini, 1 minggu, 1 bulan, 3 bulan, dan 6 bulan | Opsional
Pengaturan *default*: tanggal hari ini dan jarak waktu 24 jam | | Customer Name | Nama Pelanggan | Opsional | | Order Number | Nomor pesanan | Opsional | | Trx Amount(From) | Saldo minimal | Opsional | | Trx Amount(To) | Saldo maksimal | Opsional | | Trx type | Daftar tipe | Default: Total -> semua tipe | | Trx Status | Daftar | Default: Total -> semua | | Merchant Type | Daftar tipe | Default: Total -> semua tipe | | Acquire Bank | Daftar nama *Acquire * | Default: Total -> semua *Acquire * | | Issuer Bank | Daftar nama *Issuer * | Default: Total -> semua *Issuer * | | Card number type | Daftar tipe nomor kartu | *Default*: *Full card number* -> seluruh nomor kartu | | Card Number | Nomor kartu Pelanggan | Opsional | | Approval Code | Kode persetujuan Pelanggan | Opsional | | Customer Email | Email Pelanggan | Opsional | | Customer Contract Number | Nomor kontrak Pelanggan | Opsional | | Product Name | Nama produk dibeli Pelanggan | Opsional | | TXID | ID | Opsional | | Search | Tombol untuk memproses kata kunci dimasukkan Pengguna untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Excel | Tombol untuk memproses kata kunci dimasukkan Pengguna untuk *file* akan diunduh | Format *file* akan diunduh dalam format Excel | ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/vtFCcFMg_oLYYfABtZea__2-1.png "Transaction Data - Search Result - Credit Card") Bagian `Search Result` pada *metode pembayaran: Credit Card* terbagi menjadi dua tabel. Tabel pertama menampilkan data statistik dari seluruh . Tabel kedua menampilkan rincian data per . dapat melihat rincian terkait dari *hyperlink *dan rincian dari *pop-up * ditampilkan. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/1u0frCEzSzntuYb6TXwd0_2-2.png "Credit Card - Merchant Information") ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/DlTGmd5qiVYqgDpGK60oC_2-3.png "Credit Card - Transaction Information") ## Virtual Account ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/c35r9EtvC6EsLwbsl6_uZ_3.png "Transaction Data - Search Option - Virtual Account") Bagian `Search Option` pada *metode pembayaran: Virtual Account* berisi formulir pencarian spesifik khusus untuk mencari data . Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | | | Daftar terdaftar pada
*Default*: Total -> semua | *Default*: Total -> semua | | Payment Method | Daftar terdapat pada | *Default*: Total -> semua | | Date of Deposit | Waktu berhasil masuk dalam format tanggal dan jam

Pengaturan waktu juga bisa langsung ditentukan antara hari ini, 1 minggu, 1 bulan, 3 bulan, atau 6 bulan | *Default selection*
Pengaturan *default*: tanggal hari ini dan jarak waktu 24 jam | | Date of Number | Pengaturan waktu juga bisa langsung ditentukan antara hari ini, 1 minggu, 1 bulan, 3 bulan, atau 6 bulan | Opsional
Pengaturan *default*: tanggal hari ini dan jarak waktu 24 jam | | Name | Nama Pelanggan | Opsional | | Order Number | Nomor pesanan | Opsional | | Vaact Simulation | | Opsional | | Trx Amount(From) | Saldo minimal | Opsional | | Trx Amount(To) | Saldo maksimal | Opsional | | Trx Status | Daftar | *Default*: Total -> semua | | | Daftar nama | *Default*: Total -> semua nama | | Account Number | Nomor akun rekening Pelanggan | Opsional | | TXID | ID | Opsional | | Search | Tombol untuk memproses kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Excel | Tombol untuk memproses kata kunci dimasukkan untuk *file* akan diunduh | Format *file* akan diunduh dalam format Excel | ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/IHGhketDHtaiwIY29d7m6_3-1.png "Transaction Data - Search Result - Virtual Account") Bagian `Search Result` pada *metode pembayaran: Virtual Account* terbagi menjadi dua tabel. Tabel pertama menampilkan data statistik dari seluruh . Tabel kedua menampilkan rincian data per . dapat melihat rincian terkait dari *hyperlink *dan rincian dari *pop-up * ditampilkan. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/UFilPSAXO3aCesXsv6VGV_3-2.png "Virtual Account - Merchant Information") ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/eEeVIB5H1MgVvdFq-eTpD_3-3.png "Virtual Account - Transaction Information") ## Convenience Store ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/CPQ30zdfU3Ni-6eO3kTC3_4.png "Transaction Data - Search Option - Convenience Store") Bagian `Search Option` pada *metode pembayaran: Convenience Store* berisi formulir pencarian spesifik khusus untuk mencari data . Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------- | | | Daftar terdaftar pada
*Default*: Total -> semua | *Default*: Total -> semua | | Payment Method | Daftar terdapat pada | *Default*: Total -> semua | | Date of Deposit | Waktu berhasil masuk dalam format tanggal dan jam.

Pengaturan waktu juga bisa langsung ditentukan antara hari ini, 1 minggu, 1 bulan, 3 bulan, atau 6 bulan | *Default selection*
Pengaturan *default*: tanggal hari ini dan jarak waktu 24 jam | | Date of Number | Pengaturan waktu juga bisa langsung ditentukan antara hari ini, 1 minggu, 1 bulan, 3 bulan, atau 6 bulan | Opsional
Pengaturan *default*: tanggal hari ini dan jarak waktu 24 jam | | Customer Name | Nama Pelanggan | Opsional | | Order Number | Nomor pesanan | Opsional | | Trx Amount(From) | Saldo minimal | Opsional | | Trx Amount(To) | Saldo maksimal | Opsional | | Trx Status | Daftar | *Default*: Total -> semua | | Mitra | Daftar bekerja sama dengan | *Default*: Total -> semua dalam daftar | | Pay Number | Nomor | Opsional | | TXID | ID | Opsional | | Search | Tombol untuk memproses kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Excel | Tombol untuk memproses kata kunci dimasukkan untuk *file* akan diunduh | Format *file* akan diunduh dalam format Excel | ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/7r6QINMk68UOcNxb_j1By_4-1.png "Transaction Data - Search Result - Convenience Store") Bagian `Search Result` pada *metode pembayaran: Convenience Store* terbagi menjadi dua tabel. Tabel pertama menampilkan data statistik dari seluruh . Tabel kedua menampilkan rincian data per . Admin dapat melihat rincian terkait dari *hyperlink *dan rincian dari *pop-up * ditampilkan. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/LAJT1h4n5V78axCDbl0RD_4-2.png "Convenience Store - Merchant Information") ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/sAogjiTR7vJxL6FGMsuLX_4-3.png "Convenience Store - Transaction Information") ## Click Pay ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/GCQUy8BlyFi486mZFhPDv_5.png "Transaction Data - Search Option - Click Pay") Bagian `Search Option` pada *metode pembayaran: Click Pay* berisi formulir pencarian spesifik khusus untuk mencari data Click Pay. Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------- | | | Daftar terdaftar pada
Default: Total -> semua | *Default*: Total -> semua | | Payment Method | Daftar terdapat pada | *Default*: Total -> semua | | Trx Time | Waktu diproses dalam format tanggal dan jam.

Pengaturan waktu juga bisa langsung ditentukan antara hari ini, 1 minggu, 1 bulan, 3 bulan, atau 6 bulan | *Default*: tanggal hari ini dan jarak waktu 24 jam | | Name | Nama Pelanggan | Opsional | | Order Number | Nomor pesanan | Opsional | | Trx Amount(From) | Saldo minimal | Opsional | | Trx Amount(To) | Saldo maksimal | Opsional | | Trx Status | Daftar | *Default*: Total -> semua | | Merchant Type | Daftar tipe | *Default*: Total -> semua tipe | | Mitra | Daftar bekerja sama dengan | *Default*: Total -> semua dalam daftar | | Approval Code | Kode penyetujuan | Opsional | | TXID | ID | Opsional | | Search | Tombol untuk memproses kata kunci dimasukkan pengguna untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Excel | Tombol untuk memproses kata kunci dimasukkan pengguna untuk *file* akan diunduh | Format *file* akan diunduh dalam format Excel | Bagian `Search Result` pada *metode pembayaran: Click Pay* terbagi menjadi dua tabel. Tabel pertama menampilkan data statistik dari seluruh Click Pay. Tabel kedua menampilkan rincian data per . Admin dapat melihat rincian terkait dari *hyperlink *dan rincian dari *pop-up * ditampilkan. ## E-Wallet ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/66ZEXNpEadbIeQhC2-82T_6.png "Transaction Data - Search Option - E-Wallet") Bagian `Search Option` pada *metode pembayaran: E-Wallet* berisi formulir pencarian spesifik khusus untuk mencari data . Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------- | | | Daftar terdaftar pada
*Default*: Total -> semua | *Default*: Total -> semua | | Payment Method | Daftar terdapat pada | *Default*: Total -> semua | | Trx Time | Waktu diproses dalam format tanggal dan jam.

Pengaturan waktu juga bisa langsung ditentukan antara hari ini, 1 minggu, 1 bulan, 3 bulan, atau 6 bulan | *Default*: tanggal hari ini dan jarak waktu 24 jam | | Name | Nama Pelanggan | Opsional | | Order Number | Nomor pesanan | Opsional | | Trx Amount(From) | Saldo minimal | Opsional | | Trx Amount(To) | Saldo maksimal | Opsional | | Trx Status | Daftar | *Default*: Total -> semua | | Type | Daftar tipe | *Default*: Total -> semua tipe | | | Daftar bekerja sama dengan | *Default*: Total -> semua dalam daftar | | Ecash Trace Number | Nomor Ecash bisa dilacak | Opsional | | ECASH NUMBER HP | Nomor hp digunakan pada Ecash | Opsional | | ID/Billing Phone | ID atau nomor telepon penagihan | Opsional | | TXID | ID | Opsional | | Search | Tombol untuk memproses kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Excel | Tombol untuk memproses kata kunci dimasukkan untuk *file* akan diunduh | Format *file* akan diunduh dalam format Excel | ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/-fr0v1f7eJ5EqvGUZPDDQ_6-1.png "Transaction Data - Search Result - e-Wallet") Bagian `Search Result` pada *metode pembayaran: e-Wallet* terbagi menjadi dua tabel. Tabel pertama menampilkan data statistik dari seluruh . Tabel kedua menampilkan rincian data per . Admin dapat melihat rincian terkait dari *hyperlink *dan rincian dari *pop-up * ditampilkan. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/gKTNPYeVq2Bk9-abbYtOR_6-2.png "E-Wallet - Merchant Information") ![E-Wallet - Transaction Information](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/ElVHAHTTvsFPfz0x9k5KD_6-3.png "E-Wallet - Transaction Information") ## Paylater ![Transaction Data - Search Option - Paylater](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/qYFZyxITxvDLfEzie8rYg_image-merchant-back-office-transaction-data-paylater.png "Transaction Data - Search Option - Paylater") Bagian `Search Option` pada *metode pembayaran: Paylater* berisi formulir pencarian spesifik khusus untuk mencari data . Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------- | | | Daftar terdaftar pada
*Default*: Total -> semua | *Default*: Total -> semua | | Payment Method | Daftar terdapat pada | *Default*: Total -> semua | | Trx Time | Waktu diproses dalam format tanggal dan jam.

Pengaturan waktu juga bisa langsung ditentukan antara hari ini, 1 minggu, 1 bulan, 3 bulan, atau 6 bulan | *Default*: tanggal hari ini dan jarak waktu 24 jam | | Name | Nama Pelanggan | Opsional | | Order Number | Nomor pesanan | Opsional | | Trx Amount(From) | Saldo minimal | Opsional | | Trx Amount(To) | Saldo maksimal | Opsional | | Trx Status | Daftar | *Default*: Total -> semua | | | Daftar bekerja sama dengan | *Default*: Total -> semua dalam daftar | | TXID | ID | Opsional | | TXID | ID | Opsional | | Search | Tombol untuk memproses kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Excel | Tombol untuk memproses kata kunci dimasukkan untuk *file* akan diunduh | Format *file* akan diunduh dalam format Excel | Bagian `Search Result` pada *metode pembayaran: Paylater* terbagi menjadi dua tabel. Tabel pertama menampilkan data statistik dari seluruh . Tabel kedua menampilkan rincian data per . Admin dapat melihat rincian terkait dari *hyperlink *dan rincian dari *pop-up * ditampilkan. ## Payout ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/i0YRsMmVGBOZhxdhv67JS_8.png "Transaction Data - Search Option - Payout") Bagian `Search Option` pada *metode pembayaran: Payout* berisi formulir pencarian spesifik khusus untuk mencari data . Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | | | Daftar terdaftar pada
*Default*: Total -> semua | *Default*: Total -> semua | | Payment Method | Daftar terdapat pada | *Default*: Total -> semua | | Date of Approval | Waktu disetujui dalam format tanggal dan jam.

Pengaturan waktu juga bisa langsung ditentukan antara hari ini, 1 minggu, atau 1 bulan | *Default selection*
Pengaturan *default*: tanggal hari ini dan jarak waktu 24 jam | | Date of Request | Waktu diajukan dalam format tanggal dan jam.

Pengaturan waktu juga bisa langsung ditentukan antara hari ini, 1 minggu, dan 1 bulan | Optional
Pengaturan *default*: tanggal hari ini dan jarak waktu 24 jam | | Beneficiary Name | Nama pemilik akun | Opsional | | Account No | Nomor akun rekening | Opsional | | Beneficiary Status | Daftar status akun | *Default*: Total -> semua akun | | Beneficiary Type | Daftar tipe akun | *Default*: Total -> semua tipe akun | | Name | Daftar nama | *Default*: Total -> semua nama | | Number | Daftar nomor | *Default*: Total -> semua nomor | | Order Number | Nomor pesanan | Opsional | | Trx Amount(From) | Saldo minimal | Opsional | | Trx Amount(To) | Saldo maksimal | Opsional | | Trx Status | Daftar | *Default*: Total -> semua | | TXID | ID | Opsional | | Search | Tombol untuk memproses kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Excel | Tombol untuk memproses kata kunci dimasukkan untuk *file* akan diunduh | Format file akan diunduh dalam format Excel | | Register/Search | Tombol untuk menampilkan bagian khusus pendaftaran dan pencarian data secara spesifik | | | Bulk Register | Tombol untuk menampilkan khusus pendaftaran data dalam jumlah banyak dengan mengunggah *file* | | ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/ZORMkeLksJM0bbC9gmjqS_8-1.png "Transaction Data - Search Result - Payout") Bagian `Search Result` pada *metode pembayaran: Payout* terbagi menjadi dua tabel. Tabel pertama menampilkan data statistik dari seluruh . Tabel kedua menampilkan rincian data per . Admin dapat melihat rincian terkait dari *hyperlink *dan rincian dari *pop-up * ditampilkan. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/mNUP543hLJT8TKRpwpUja_8-2.png "Payout - Merchant Information") ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/KDT9dFf-6n7Tbm14OifZG_8-3.png "Payout - Transaction Information") ## QRIS ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/0I_0aynWlHmPLUeW34l9-_11.png "Transaction Data - Search Option - QRIS") Bagian `Search Option` pada *metode pembayaran: QRIS* berisi formulir pencarian spesifik khusus untuk mencari data . Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------- | | | Daftar terdaftar pada
*Default*: Total -> semua | *Default*: Total -> semua | | Payment Method | Daftar terdapat pada | *Default*: Total -> semua | | Trx Time | Waktu diproses dalam format tanggal dan jam.

Pengaturan waktu juga bisa langsung ditentukan antara hari ini, 1 minggu, 1 bulan, 3 bulan, atau 6 bulan | *Default*: tanggal hari ini dan jarak waktu 24 jam | | Name | Nama Pelanggan | Opsional | | Order Number | Nomor pesanan | Opsional | | Trx Amount(From) | Saldo minimal | Opsional | | Trx Amount(To) | Saldo maksimal | Opsional | | Trx Status | Daftar | *Default*: Total -> semua | | Type | Daftar tipe | *Default*: Total -> semua tipe | | | Daftar bekerja sama dengan | *Default*: Total -> semua dalam daftar | | M\_MID | ID utama | Opsional | | Store Code | Kode toko | Opsional | | Request ID | ID pengajuan | Opsional | | TXID | ID | Opsional | | Search | Tombol untuk memproses kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Excel | Tombol untuk memproses kata kunci dimasukkan untuk *file* akan diunduh | Format *file* akan diunduh dalam format Excel | ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/EeIYblzpSDMWh4_zc3lCo_11-1.png "Transaction Data - Search Result - QRIS") Bagian `Search Result` pada *metode pembayaran QRIS* terbagi menjadi dua tabel. Tabel pertama menampilkan data statistik dari seluruh . Tabel kedua menampilkan rincian data per . Admin dapat melihat rincian terkait dari *hyperlink *dan rincian dari *pop-up * ditampilkan. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/MDAtrOvOyYLOJ8RKCoaTk_11-2.png "QRIS - Merchant Information") ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/kgex4465HWDn5FR3Q3WOb_11-3.png "QRIS - Transaction Information") ## GPN ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/uKjVCvDzjSk444HjVhQWi_12.png "Transaction Data - Search Option - GPN") Bagian `Search Option` pada *metode pembayaran GPN* berisi formulir pencarian spesifik khusus untuk mencari data . Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------- | | | Daftar terdaftar pada
*Default*: Total -> semua | *Default*: Total -> semua Merchant | | Payment Method | Daftar terdapat pada | *Default*: Total -> semua | | Trx Time | Waktu diproses dalam format tanggal dan jam.

Pengaturan waktu juga bisa langsung ditentukan antara hari ini, 1 minggu, atau 1 bulan | *Default*: tanggal hari ini dan jarak waktu 24 jam | | Name | Nama Pelanggan | Opsional | | Order Number | Nomor pesanan | Opsional | | Trx Amount(From) | Saldo minimal | Opsional | | Trx Amount(To) | Saldo maksimal | Opsional | | Trx Status | Daftar | *Default*: Total -> semua | | TXID | ID transaksi | Opsional | | Search | Tombol untuk memproses kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Excel | Tombol untuk memproses kata kunci dimasukkan untuk *file* akan diunduh | Format *file* akan diunduh dalam format Excel | Bagian `Search Result` pada *metode pembayaran GPN* terbagi menjadi dua tabel. Tabel pertama menampilkan data statistik dari seluruh . Tabel kedua menampilkan rincian data per . Admin dapat melihat rincian terkait dari *hyperlink *dan rincian dari *pop-up * ditampilkan. # Tutorial *** ## Mencari Data Transaksi Berikut panduan untuk mencari data . 1. Buka *sidebar.* 2. `Transaction`. 3. `Transaction Data`. 4. ketentuan pencarian pada `Search Option`. 5. `Search` untuk melakukan pencarian data. 6. Data dicari akan muncul pada `Search Result`. ## Mengunduh Data Transaksi Berikut panduan untuk mengunduh data . 1. Buka *sidebar*. 2. `Transaction`. 3. `Transaction Data`. 4. ketentuan pencarian pada `Search Option`. 5. `Excel` untuk mengunduh data dalam format Excel. 6. Data dicari akan terunduh secara otomatis. ## Membatalkan Transaksi ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/r7sLkUclTgIfP1qyuJnQr_back-office-mms-5.png "Transaction Data - Cancelled") Berikut panduan untuk membatalkan khusus dan . 1. data akan dibatalkan pada `Search Result`. 2. *hyperlink* TXID pada baris data akan dibatalkan. 3. Rincian akan muncul pada *pop-up.* 4. nominal akan dibatalkan pada `Cancelled Amount` (kolom nomor 1 dari gambar di atas). 5. alasan pembatalan pada `Cancelled Reason` (kolom nomor 2 dari gambar di atas). 6. `Cancel` (nomor 3 dari gambar di atas). 7. Pada *pop-up confirmation*, tekan `Okay` untuk melakukan pembatalan . Sebaliknya, tekan `Cancel` untuk kembali ke sebelumnya. :::hint{type="info"} Ikuti tutorial Mencari Data Transaksi terlebih dahulu sebelum melakukan Pembatalan Transaksi. ::: ## Mendaftarkan Transaksi ### Single Transaction ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/u4UrLb8bVNefk7-WIgXn8_9.png "Payout - Register Single Transaction") Berikut panduan untuk mendaftarkan satu khusus . 1. `Register/Search Payout`. 2. Isi formulir `Regist & Search Account` muncul di atas `Search Option`. 3. `Save` untuk menyimpan . Jika ingin melakukan pencarian lebih dahulu, tekan `Search`. 4. `Close` untuk menutup formulir pendaftaran. ### Bulk Transaction ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/PYHZvQzXuL0Sc6gkTrtfL_10.png "Payout - Register Bulk Transaction") Berikut panduan untuk mendaftarkan dalam jumlah banyak khusus . 1. `Bulk Register Payout`. 2. Pada `Bulk Register Payout` muncul di atas `Search Option`: - nomor akun baru pada *text field*, kemudian tekan `Search File` untuk mencari data akun tersebut. - `File Upload` untuk mengunggah *file* pendaftaran. - `Download Sample` untuk mengunduh contoh *file* akan digunakan untuk *bulk upload.* 3. `Close` untuk menutup pendaftaran. # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Noti History](docId\:wn_8Dv5FNJLiqhW4cfx3g) untuk mengetahui cara memeriksa riwayat . ::: :::VerticalSplitItem [Fail Transaction](docId\:Kw36Cm_cK3RzRNUHfzavQ) untuk mengetahui cara memeriksa gagal. ::: :::: [title] Daftar Istilah Pada File Laporan [path] Merchant Back Office/ # Tentang File Laporan *** File laporan terdapat pada portal (MMS). File tersebut digunakan untuk memeriksa laporan secara rinci baik secara rangkuman keseluruhan maupun per dalam jangka waktu tertentu. # Daftar File Laporan *** ::::LinkArray{contentSource="CUSTOM"} :::LinkArrayItem{headerType="COLOR" headerColor="#12b76a"} [MMS - File Settlement Report](docId\:noT4USRc-jUpy6uKGNqRm) ::: :::LinkArrayItem{headerType="COLOR" headerColor="#12b76a"} [MMS - File Fail Transaction Report](docId\:fEFX_xA5eEjZj_XDjF1_P) ::: :::: [title] Disbursement Report [path] Merchant Back Office/Settlement/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/yacrNLI-Swh7rJvu-JRFF_settlemtnt-disbursement-report.png "Disbursement Report") Sub-menu ini membantu untuk melihat rangkuman . Halaman ini terbagi menjadi 2 , yaitu; `Search Option` dan `Search Result`. ::embed[]{url="https://youtu.be/rs1S4qLpXic"} Bagian `Search Option` adalah formulir digunakan untuk memasukkan kriteria pencarian data . Setiap *field* terdapat pada formulir ini bersifat opsional, namun hasil pencarian dicari bergantung pada dipilih. Terdapat 6 pilihan ; yakni Total, *Overbooking*, *Online*, LLG, RTGS, dan Cashout. Admin dapat melakukan pencarian data untuk ditampilkan pada `Search Result` atau meng data dalam format Excel. Bagian `Search Result` adalah menampilkan hasil pencarian data berdasarkan kriteria dimasukkan pada `Search Option`. Data pada ini akan muncul setelah mengonfirmasi pencarian data dengan menekan `Search`. Hasil pencarian data ditampilkan berbeda-beda sesuai dengan dipilih pada `Search Option`. # Disbursement Report *** ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/zAa1DLfiCq4_RhOKQ0D_l_back-office-mms-45.png "Settlement - Disbursement Report") Bagian `Search Option` berisi formulir pencarian digunakan untuk mencari semua data dilakukan. Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | --------------- | ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ | | | Daftar terdaftar pada | *Default*: Total -> semua | | Date | Waktu dilakukan dalam format tanggal dan jam | *Default*: tanggal hari ini dan jarak waktu 24 jam | | Date (Within) | Jarak waktu dilakukan

Pengaturan waktu bisa langsung ditentukan antara hari ini, 1 minggu, atau 1 bulan | *Default*: *Today* | | Method | Metode digunakan saat melakukan | *Default*: Total

Isi *dropdown*:
* Total * Overbooking * Online * LLG * RTGS * Cashout | | Search | Tombol untuk memproses kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Excel | Tombol untuk mem kata kunci dimasukkan untuk *file* akan di | Format *file* akan di dalam format Excel | | Excel (Details) | Tombol untuk mem kata kunci dimasukkan untuk *file* akan di

*File* berisi rincian data per | Format *file* akan di dalam format Excel | Bagian `Search Result` menampilkan rincian berjalan sesuai dengan ketentuan dari `Search Option`. Jika memilih *metode pembayaran Total,* maka akan menampilkan rangkuman dari seluruh dilakukan. Jika memilih *metode pembayaran yang lebih spesifik (misalkan *`LLG`*)*, maka akan menampilkan rangkuman untuk tersebut saja. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/Q6ESsI77wmGsG9iXk-9SZ_llg.png "Disbursement Report - Payment Method: LLG") # Tutorial *** ## Mencari Data Disbursement Report Berikut panduan untuk mencari data laporan . 1. Buka *sidebar*. 2. `Settlement`. 3. `Disbursement Report`. 4. ketentuan pencarian pada `Search Option`. 5. `Search` untuk melakukan pencarian data. 6. Data dicari akan muncul pada `Search Result`. ## Mengunduh Data Disbursement Report Berikut panduan untuk mengunduh data laporan Disbursement. 1. Buka *sidebar*. 2. `Settlement`. 3. `Disbursement Report`. 4. ketentuan pencarian pada `Search Option`. 5. `Excel` untuk meng rangkuman data dalam bentuk format Excel. 6. `Excel(Detail)` untuk mengunduh rincian data dalam bentuk format Excel. 7. Data dicari akan ter secara otomatis. # See also ::::VerticalSplit :::VerticalSplitItem [Calendar](docId\:SKnGsVbD-3xg6Acn3Ojkr) untuk mengetahui cara memeriksa kalendar untuk . ::: :::VerticalSplitItem [Reconcile](docId\:AHK2dHdorKc5gVz8BDRkt) untuk mengetahui cara melihat riwayat data Reconcile. ::: :::: [title] Settlement [path] Merchant Back Office/ Menu `Settlement` digunakan oleh untuk memantau dan mendapatkan laporan dari dan Reconcile terjadi pada . ::::LinkArray :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-eEcukRCzwruztp3dI7uTV-20240731-092122.jpg"} [Calendar](docId\:SKnGsVbD-3xg6Acn3Ojkr) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-_rrpS4h248axyBZik6EVX-20240731-092137.jpg"} [Settlement Report](docId:9ESDQYwVyCq3ce254IC3B) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-0SC9rcozUF4kpKQzg0Omf-20240731-092149.jpg"} [Reconcile](docId\:AHK2dHdorKc5gVz8BDRkt) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-vpWp7j22GM_NQiJowu5D3-20240731-092201.jpg"} [Pending Settlement](docId\:yba25yJeOhoGQUIBWWyYi) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-c6uukspmXWSffmQgSnyYz-20240731-092212.jpg"} [Disbursement Report](docId:9O4NDwWma2rgYfwkNWOOi) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://archbee-image-uploads.s3.amazonaws.com/ueSgidS-H3kdWkcRhVS2v-nA5aR06la9VU4VF-Dfbj2-20240731-092308.jpg"} [Seller Settlement](docId\:g4YT2vmfgxssUWbcUojuX) ::: :::: # See also ::::VerticalSplit :::VerticalSplitItem [Merchant Back Office](docId\:VMD8YtiiJqku6H8dRhcS6) untuk mempelajari platform disediakan . ::: :::VerticalSplitItem [Transaction](docId:7oUXdgyOx1PqOQBm9caDt) untuk mempelajari khusus mengatur dan memantau . ::: :::: ::::VerticalSplit :::VerticalSplitItem [Discount Event](docId:2qa-RAoG00FVzWNpoW_ec) untuk mempelajari khusus mengatur *event*. ::: :::VerticalSplitItem [Statistic](docId\:uBklBxrtiCfVe6SdoEl7B) untuk mempelajari khusus melihat rangkuman . ::: :::: [title] Payout Balance [path] Merchant Back Office/Transaction/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/oxBrL-pqekrisJkod3r8B_transaction-payout-balance.png "Payout Balance") Sub-menu ini membantu untuk memeriksa sisa dimiliki oleh dan menampilkan riwayat . Halaman ini terbagi menjadi 2 , yaitu `Search Option` dan `Search Result`. ::embed[]{url="https://youtu.be/0hMZE2qNS60"} Bagian `Search Option` adalah formulir digunakan untuk memasukkan kriteria pencarian data . Setiap *field* terdapat pada formulir ini bersifat opsional. dapat melakukan pencarian data untuk ditampilkan pada `Search Result` atau mengunduh data dalam format Excel. Bagian `Search Result` adalah menampilkan hasil pencarian data berdasarkan kriteria dimasukkan pada `Search Option`. Data pada ini akan muncul setelah mengonfirmasi pencarian data dengan menekan `Search`. # Payout Balance *** ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/_vxS82R-KiiVORu-CTnr6_1.png "Transaction - Payout Balance") Bagian `Search Option` berisi formulir pencarian digunakan untuk mencari semua data . Formulir tersebut terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ------------------- | --------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | | | Daftar terdaftar pada | *Default*: Total -> semua | | Trx Time | Waktu dalam format tanggal dan jam | *Default*: tanggal hari ini dan jarak waktu 24 jam | | Trx Time (*Within*) | Jarak waktu

Pengaturan waktu bisa langsung ditentukan antara hari ini, 1 minggu, atau 1 bulan | *Default*: *Today* | | Destination | tujuan | *Default*: Total -> semua tujuan | | Trx Status | Status | *Default*: Total -> semua trx

Isi *dropdown*:
* Total * Authorization/Complete * Cancelation * Refund | | TXID | ID | Opsional | | Search | Tombol untuk memproses kata kunci dimasukkan untuk mencari data | Hasil pencarian data akan ditampilkan pada `Search Result` | | Excel | Tombol untuk memproses kata kunci dimasukkan untuk *file* akan diunduh | Format *file* akan diunduh dalam format Excel | Bagian `Search Result` menampilkan rincian data per . dapat melihat rincian terkait dari *hyperlink * tersedia. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/ZpDr62UMeydaRPAmY7wsy_1-1.png "Payout Balance - Search Result - Merchant Detail") # Tutorial *** ## Mencari Data Transaksi Berikut panduan untuk mencari data . 1. Buka *sidebar*. 2. `Transaction`. 3. `Payout Balance`. 4. ketentuan pencarian pada `Search Option`. 5. `Search` untuk melakukan pencarian data. 6. Data dicari akan muncul pada `Search Result`. ## Mengunduh Data Transaksi Berikut panduan untuk mengunduh data . 1. Buka *sidebar*. 2. `Transaction`. 3. `Payout Balance`. 4. ketentuan pencarian pada `Search Option`. 5. `Excel` untuk mengunduh data dalam bentuk format Excel. 6. Data dicari akan terunduh secara otomatis. # See also ::::VerticalSplit :::VerticalSplitItem [Preauth Data](docId\:PZyq9ecr_CqxGUh_oGJLZ) untuk mengetahui cara memeriksa data kartu Pre-Auth. ::: :::VerticalSplitItem [Beneficiary Account](docId\:UX7TnX6wKsQFy_kXIvDbD) untuk mengetahui cara memeriksa data akun Penerima. ::: :::: [title] Working Capital Loan [path] Merchant Back Office/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/LH7Lf-qBm1WWup_8Qj3TA_1.png "Working Capital Loan") Menu `Working Capital Loan` digunakan oleh untuk mengajukan dana pinjaman kepada , yaitu KreditPintar. gambar *header *untuk mendapatkan pengajuan lebih lanjut. ::embed[]{url="https://youtu.be/qQ1aAv5vZH4"} # See also ::::VerticalSplit :::VerticalSplitItem [Service](docId\:wJN9n07xZh_Esj9CeANSK) untuk mengetahui *progress* pengiriman pesan. ::: :::VerticalSplitItem [Risk Management](docId\:VNOQ2Bc8WEEktAw0vdM76) untuk mempelajari khusus Blacklist dan Whitelist*.* ::: :::: [title] Merchant Data [path] Merchant Back Office/Profile/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/e6QlhrY30V5Rv7CJbetWQ_back-office-mms-65.png "Merchant Data") # Merchant Data *** Menu `Merchant Data` berisikan secara keseluruhan terdiri dari 7 tab, yakni `Merchant Info`, `Settlement Info`, `Service Info`, `Email Management`, `Card Event`, `SMS`, dan `Others`. ::embed[]{url="https://youtu.be/J8stpxgxOOE"} Halaman `Merchant Data` terbagi menjadi 2 , yaitu `Search Option` dan `Search Result`. Bagian `Search Option` adalah formulir digunakan untuk memasukkan kriteria pencarian data. Bagian `Search Result` untuk menampilkan hasil pencarian berdasarkan kriteria ingin dicari. ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/Q6Y1NIqqmnOqcFSO4xC-n_1.png "Merchant Data - Merchant Info") ## Merchant Info ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/Q6Y1NIqqmnOqcFSO4xC-n_1.png "Merchant Data - Merchant Info") *Tab* `Merchant Info` menampilkan profil secara lengkap. *Field * terdapat pada formulir dalam *tab* ini terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ----------------------------------- | ----------------------------------------- | ---------------- | | I-MID | ID | | | I-MID Info | Informasi | Nama, lini , dll | | Top I-MID | Top ID | | | NPWP | Nomor NPWP | | | Company Name | Nama perusahaan | | | Name | Nama | | | Corporate Type | Tipe korporasi/perusahaan | | | No. TDP | Nomor TDP | | | Director Name | Nama Direktur | | | Address | Alamat | | | CS Email | E-mail CS | | | CS Phone Number | Nomor kontak CS | | | Contact Number | Nomor kontak | | | Contact Fax | Nomor fax | | | Website URL | Alamat URL Website | | | PIC Name | Nama PIC | | | Contact Number () | Nomor kontak | | | Email () | Email PIC | | | Financial PIC Name | Nama PIC Finance | | | Contact Number (Financial PIC Name) | Nomor kontak PIC Finance | | | Email (Financial PIC Name) | Alamat e-mail PIC Finance | | | IT PIC Name | Nama PIC IT | | | Contact Number (IT PIC Name) | Nomor kontak IT PIC Name | | | Email (IT PIC Name) | Alamat e-mail IT PIC Name | | | Contract Date | Tanggal kontrak kerja sama ditandatangani | | | Register Date | Tanggal berhasil terdaftar dalam | | ## Settlement Info ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/8CGdF22JKtVJYTMZyuxDA_image.png "Merchant Data - Settlement Info") *Tab* `Settlement Info` menampilkan . *Field * terdapat pada formulir dalam tab ini terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ------------------------------------ | ------------------------------------- | ---------------- | | | Nama Pelayan | | | Account Number | Nomor akun | Nama, lini , dll | | Beneficiary | Nomor Penerima | | | Type | Tipe | | | Based on the Issuance of Tax Receipt | Status berdasarkan isu terhadap resi | | | How to Issue of Tax Receipt | Bagaimana cara penanganan pada resi | | | Seller | dari Penjual | | ## Service Info ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/gpCcNMO0kP_k0DHUlI4qs_image.png "Merchant Data - Service Info") Tab `Service Info` menampilkan servis digunakan oleh . Terdapat 8 buah tab servis masing-masing berisi rincian data dari , VA, CVS, Click-Pay, , Pay Loan, , dan . ### Credit Card ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/7P1lsNP9QnlAPx8-WeqPp_image.png "Merchant Data - Service Info - Credit Card") *Field * terdapat pada formulir dalam *tab* ini terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | --------------- | ------------------------ | -------------------------------------------------------------- | | Status | Status fitur | | | Type | Tipe | Nama, lini , dll | | Approval Type | Tipe Approval | | | Period | Periode | | | Fee | Biaya tagihan | Tombol `View Document` untuk melihat rincian *Credit Card Fee* | | Applied Date | Tanggal mulai berlaku | | | Offus Send Type | Tipe pengiriman ke beda | | ### VA ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/L3vw32ZaLpkqdja80fqAF_image.png "Merchant Data - Service Info - VA") *Field * terdapat pada formulir dalam *tab* ini terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | -------------------- | ------------------------------ | --------------------------------------------------- | | Status | Status fitur VA | | | Type | Tipe | Nama, lini , dll | | Created VA Type | Tipe VA dibuat | | | Amount Type | Tipe jumlah tagihan | | | Amount Limit | Batas jumlah tagihan | | | Min/Max Amount (IDR) | Batas jumlah tagihan (min/max) | Pengaturan mengikuti tipe VA | | Amount Function | Fungsi jumlah tagihan | | | Expiry Date | Tanggal kedaluwarsa | | | Beneficiary | Nomor Penerima | | | Period | Periode | | | Fee | Biaya tagihan | Tombol `View Document` untuk melihat rincian VA Fee | | Applied Date | Tanggal mulai berlaku | | ### CVS ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/R49rJW0LBaxRSuz4aVH8b_image.png "Merchant Data - Service Info - CVS") *Field * terdapat pada formulir dalam *tab* ini terdiri dari: | **Name** | **Description** | **Remark** | | ---------------- | --------------------- | ------------------------------------------------------ | | Status | Status fitur CVS | | | Type | type | Nama, lini , dll | | Created CVS Type | Tipe CVS dibuat | | | Amount Function | Fungsi jumlah tagihan | | | Expiry Date | Tanggal kedaluwarsa | | | Beneficiary | Nomor Penerima | | | Period | Periode | | | Fee | Biaya tagihan | Tombol `View Document` untuk melihat rincian CVS *Fee* | | Applied Date | Tanggal mulai berlaku | | ### Click-Pay ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/rNrNBMVZA3NRo7dXxONkI_image.png "Merchant Data - Service Info - Click-Pay") *Field * terdapat pada formulir dalam *tab* ini terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ------------ | ---------------------- | ---------------------------------------------------------------------- | | Status | Status fitur Click-Pay | | | Type | Tipe | | | Period | Periode | | | Fee | Biaya tagihan | Tombol `View Document` untuk melihat rincian Click-Pay* Fee* | | Applied Date | Tanggal mulai berlaku | | ### E-Wallet ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/orL8_TjEnWxVsQ7_UqZVJ_image.png "Merchant Data - Service Info - E-Wallet") *Field * terdapat pada formulir dalam *tab* ini terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ------------ | --------------------- | --------------------------------------------------------------- | | Status | Status fitur | | | Type | Tipe | | | Period | Periode | | | Fee | Biaya tagihan | Tombol `View Document` untuk melihat rincian &#xNAN;* Fee* | | Applied Date | Tanggal mulai berlaku | | ### Pay Loan ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/N_zigW0RVQYVmzKoUGt5K_image.png "Merchant Data - Service Info - Pay Loan") *Field * terdapat pada formulir dalam tab ini terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ------------ | --------------------- | --------------------------------------------------- | | Status | Status fitur Pay Loan | | | Type | Tipe | | | Period | Periode | | | Fee | Biaya tagihan | Tombol `View Document` untuk melihat rincian *Fee* | | Applied Date | Tanggal mulai berlaku | | ### Payout ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/axHIiELp_UAudLWTSobvF_image.png "Merchant Data - Service Info - Payout") *Field * terdapat pada formulir dalam *tab* ini terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ------------ | --------------------- | --------------------------------------------------- | | Status | Status fitur | | | Type | Tipe | | | Period | Periode | | | Fee | Biaya tagihan | Tombol `View Document` untuk melihat rincian *Fee* | | Applied Date | Tanggal mulai berlaku | | | VA | | | ### QRIS ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/gPNXd9NN6jkja97hlRAr9_image.png "Merchant Data - Service Info - QRIS") *Field * terdapat pada formulir dalam *tab* ini terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ------------ | --------------------- | --------------------------------------------------- | | Status | Status fitur | | | Type | Tipe | | | Period | Periode | | | Fee | Biaya tagihan | Tombol `View Document` untuk melihat rincian *Fee* | | Applied Date | Tanggal mulai berlaku | | ## Email Management ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/7qrY63KMv7DQfdw58HAVI_2.png "Merchant Data - Email Management ") Tab `Email Management` berfungsi untuk mengatur email akan digunakan oleh dan disimpan pada MMS . *Field * terdapat pada formulir dalam *tab* ini terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ------------------- | ------------------------------------------------------------------ | ------------------------------------------------ | | Email Type | Jenis e-mail akan di kirimkan | Isi daftar:
* Reconcile * Notification Fail | | TO Email | Penerima utama akan menerima e-mail dari | | | CC Email | Penerima lainnya digunakan untuk menerima e-mail dari | | | CC Email Add/Modify | Untuk mengubah atau menambahkan penerima e-mail | Uneditable | | Status | Digunakan untuk aktif atau tidaknya e-mail akan dikirimkan oleh | Opsional | | Work | Tombol untuk menyimpan data didaftarkan/diubah | | ## Card Event ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/6iUBzgbsHwmfxdliANpEZ_image.png "Merchant Data - Card Event") Tab `Card Event` memuat *card bin event*. *Field * terdapat pada formulir dalam *tab* ini terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ----------------- | ---------------------------- | -------------- | | | dipilih | | | Event Type | Jenis *event* akan berjalan | | | Installment Type | Tipe cicilan | | | Installment Month | Periode cicilan ditentukan | | | Card Bin List | | | ## SMS ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/TSYNulb4S1MqTXB-AFavc_image.png "Merchant Data - SMS") Tab `SMS` menampilkan rincian terkait penggunaan fitur , seperti token, tipe , dan *masking*. *Field * terdapat pada formulir dalam *tab* ini terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ------------------- | ------------------ | -------------- | | Available Token | Token tersedia | | | Token Fee (1 Token) | Biaya 1 kali token | | | Type | Tipe | | | Masking | Suatu Broadcast | | ## Others ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/70a0hevUWiENM9J7_vRPl_3.png "Merchant Data - Others") Tab `Others` menampilkan tambahan dimiliki oleh . Bagian ini terbagi menjadi 2 , yaitu `Transfer Notice` dan `M_KEY`. *Field * terdapat pada formulir `Transfer Notice` dalam *tab* ini terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | ------------------------------ | ------------------------------------------------------------------ | ------------------------------------ | | Notification Use | Aktivasi penggunaan Notifikasi | Isi *dropdown*:
* Use * Not Use | | Method | Metode digunakan | | | Start Date | Tanggal *update* terakhir dari *link* URL | | | URL/IP | *Link* URL ataupun IP menerima | | | Resend Interval (by frequency) | Jumlah pengulangan pengiriman jika mengalami gagal notif ke URL | | | | Metode CC | | | VA | Metode VA | | | Link to Logo | URL gambar logo akan ditampilkan pada | Akan muncul pada *Payment Page* | | Page | Laman | | | Reject Push Notification URL | URL Notifikasi tampilan permintaan ditolak | | | Save | Tombol untuk menyimpan pengaturan | | *Field *pada formulir `M_KEY` dalam *tab* ini terdiri dari: | **Nama** | **Deskripsi** | **Keterangan** | | -------- | ------------- | -------------- | | KEY | key | | # Tutorial *** ## Melihat Informasi Profil Merchant Data Berikut panduan untuk melihat profil Data: 1. Buka *sidebar*. 2. `Profile`. 3. `Merchant Data`. 4. lihat pada bar `Search Result` dan klik pada tiap tersedia di `Search Result`. Contoh: Info, Info, Service Info, dll. Gambar contoh panduan untuk melihat profil `Merchant Data` pada *tab* `Others`: ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/swKSl7XVDPQP2h5JJaNC0_image.png "Merchant Data - Others - Transfer Notice") ## Mengubah Logo Merchant Berikut panduan untuk mengubah logo : 1. Buka *sidebar*. 2. `Profile`. 3. `Merchant Data`. 4. Pada bagian `Search Result`, pilih *tab* `Others`. 5. tautan logo pada `Link to Merchant Logo`. Ketentuan logo terdapat pada sebelah kiri `Save`. 6. `Save` untuk menyimpan perubahan. ## Menyimpan Perubahan Data :::hint{type="info"} Berlaku hanya untuk *tab *`Email Management` dan `Others`. ::: Berikut panduan untuk menyimpan perubahan data: 1. Buka *sidebar*. 2. `Profile`. 3. `Merchant Data`. 4. Ubah data pada *tab *`Email Management` atau `Others`. 5. `Save` untuk menyimpan perubahan. # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [User ID](docId\:Tjd1p8wHGH1E-QVsS8XJ0) untuk mengetahui cara mengatur akses Pengguna. ::: :::VerticalSplitItem [Transaction Limit](docId\:TFslgr1ys133jJKPqEoer) untuk mengetahui cara memeriksa data limit kartu terdaftar. ::: :::: [title] SMS [path] Messaging/ ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/VnQMwaEMaieNmsmk-1xHc_header-21.png "Mitra SMS ") **NICEPAY SMS Solutions** merupakan menyediakan berbagai pengiriman pesan melalui jaringan *provider* dengan aman tanpa membutuhkan perangkat keamanan terpisah. Layanan ini sudah terintegrasi dengan berbagai macam *Service Provider* terhubung dengan koneksi *host-to-host* untuk pelaksanaan lebih cepat dan lebih baik. Hanya dengan integrasi dengan kami dan nikmati layanan *single* *transmit* didukung oleh 4 *Service Provider* di . # Daftar Service Provider yang Tersedia *** Berikut daftar Service Provider sudah bekerja sama dengan kami: | **No** | ***Service Provider Name*** | | ------ | --------------------------- | | 1 | Telkomsel | | 2 | Indosat Ooredoo Hutchison | | 3 | XL | | 4 | Smartfren | # Fitur Layanan Pengiriman SMS *** Fitur di untuk *Broadcast* terbagi menjadi: - Regular: digunakan untuk Promo, *Reminder*, dan *Non-Confidential* - Premium: digunakan untuk *Payment Link*, OTP, dan *Confidential* # Biaya Layanan Pengiriman SMS *** akan dikenakan biaya standar untuk menggunakan pengiriman . Setiap *provider* memiliki biaya yang berbeda-beda. :::hint{type="info"} Silakan kunjungi [Produk NICEPAY](docId\:geGcTDX-FpQOROu1YHRR6) untuk informasi lebih lanjut. ::: # See also ::::VerticalSplit :::VerticalSplitItem [SMS API](docId\:VieUg405uv4bhHtFPmtk3) untuk mengetahui rincian keperluan dengan kami. ::: :::VerticalSplitItem [Service](docId\:wJN9n07xZh_Esj9CeANSK) untuk mengetahui progres pengiriman pesan. ::: :::: [title] Messaging [path] / ![](https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/xxLcLcdD7gyEogOLXGwVO_messaging.jpg "Messaging") Berikan terkini dengan pilihan aman dan nyaman bersama . Sebagai perusahaan fokus dalam mengembangkan teknologi di , menyediakan layanan digital komunikasi yang stabil, cepat dan aman menjadi faktor penunjang diperhatikan oleh . Oleh karena itu, memberikan kemudahan untuk mengirimkan pesan kepada para dengan menggunakan sudah bekerja sama dengan 4 perusahaan *Service Provider *ternama di . :::hint{type="info"} Untuk lebih lanjut, silakan kunjungi [SMS](docId\:jNixDDXA2UQM43_-bEXmO). ::: # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem [Operasi Bisnis](docId:8r87f_pn_ZI8LtKK3kq-K) untuk mendapatkan seputar menjalankan . ::: :::VerticalSplitItem [Payout](docId:_tBoQGqS-T6sk-ziXQl55) untuk mempelajari terbaru . ::: :::: [title] FAQ Merchant Back Office [path] Merchant Back Office/ ### Bagaimana cara mengunduh file pada menu Settlement > Settlement Report? mengikuti panduan melalui tautan berikut [Panduan Mengunduh Data Settlement Report Pada Menu Settlement Report](docId:9ESDQYwVyCq3ce254IC3B). *** ### Bagaimana cara mengunduh file pada MMS? Pada beberapa , terdapat `Excel` untuk mengunduh laporan ke dalam *file* dengan format Excel. Berikut adalah daftar panduan untuk mengunduh *file* pada . | **Menu MMS** | **Tautan** | | ------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | | Transaction > Transaction Data | [Mengunduh Data Transaksi Pada Menu Transaction Data](docId\:iZwosih8r9HIc0UurgYMa) | | Transaction > Preauth Data | [Mengunduh Data Transaksi Pada Menu Preauth Data](docId\:PZyq9ecr_CqxGUh_oGJLZ) | | Transaction > Noti History | [Mengunduh Data Transaksi Pada Menu Noti History](docId\:wn_8Dv5FNJLiqhW4cfx3g) | | Transaction > Card Event History | [Mengunduh Data Transaksi Pada Menu Card Event History](docId\:EZbQsGUb8c02JifEDobHt) | | Transaction > Fail Transaction | [Mengunduh Data Transaksi Pada Menu Fail Transaction](docId\:Kw36Cm_cK3RzRNUHfzavQ) | | Transaction > Beneficiary Account | [Mengunduh Data Transaksi Pada Menu Beneficiary Account](docId\:UX7TnX6wKsQFy_kXIvDbD) | | Transaction > Balance | [Mengunduh Data Transaksi Pada Menu Payout Balance](docId\:g9JdFsDXboWzf2TEHzkrC) | | Discount Event > Discount Event Enroll | [Mengunduh Data Discount Pada Menu Discount Event Enroll](docId\:HS9L9Cw20M4tp83N3v1bR) | | Discount Event > Discount Event Transaction | [Mengunduh Data Discount Event Transaction Pada Menu Discount Event Transaction](docId\:S0LDFXlG5jHeF0tRTp9-y) | | > Report | [Mengunduh Data Transaksi Pada Menu Settlement Report](docId:9ESDQYwVyCq3ce254IC3B) | | > Reconcile | [Mengunduh Data Riwayat Reconcile Pada Menu Reconcile](docId\:AHK2dHdorKc5gVz8BDRkt) | | > Pending | [Mengunduh Data Transaksi Pada Menu Pending Settlement](docId\:yba25yJeOhoGQUIBWWyYi) | | > Disbursement Report | [Mengunduh Data Transaksi Pada Menu Disbursement Report](docId:9O4NDwWma2rgYfwkNWOOi) | | > Seller | [Mengunduh Data Transaksi Pada Menu Seller Settlement](docId\:g4YT2vmfgxssUWbcUojuX) | | Service > Email | [Mengunduh Data Transaksi Pada Menu Email Payment](docId\:XAVz9EU950MGIr08PvjzL) | | Service > History Log | [Mengunduh Data Transaksi Pada Menu SMS History Log](docId\:iEREuK7SKBxL6YfUaFgQT) | | Service > Top Up | [Mengunduh Data Riwayat SMS Pada Menu SMS Top Up](docId\:ubOKZmYWQRYzfqeK6lFeK) | | Service > Transaction Limit | [Mengunduh Data Transaksi Pada Menu Transaction Limit](docId\:TFslgr1ys133jJKPqEoer) | | Statistic | [Mengunduh Data Transaksi Pada Menu Statistic](docId\:uBklBxrtiCfVe6SdoEl7B) | *** ### Apa perbedaan tombol `Excel` dengan `Excel(Details)`? Jika pada suatu terdapat 2 tersebut, `Excel` berisi rangkuman keseluruhan data . Sementara, `Excel(Details)` berisi rangkuman keseluruhan data beserta rincian data per . *** ### Bagaimana cara membaca file pada menu Settlement > Settlement Report? mengunjungi [MMS - File Settlement Report](docId\:noT4USRc-jUpy6uKGNqRm) untuk lebih lanjut. *** ### Apakah informasi pada menu Settlement > Calendar dapat diunduh dalam bentuk file? Ya. *File* dapat diunduh melalui `Print` dengan format PDF. ## File Laporan *** ### Apa rumus perhitungan biaya layanan NICEPAY? Rumus perhitungan biaya adalah jumlah dari Fee + Installment Fee + FDS Fee + Pajak (). *** ### Apa perbedaan transaksi pada bagian From NICEPAY dan bagian From Bank/Mitra? Transaksi pada From dan bagian From / berbeda dari tipe . - Jika tipe , maka rincian menggunakan skema MA sehingga berada pada bagian From . - Jika tipe , maka rincian menggunakan skema PG sehingga berada pada bagian From /. *** ### Pada File Excel(Detail) bagian rincian per transaksi khusus metode pembayaran Payloan, apa perbedaan nominal minus dan plus pada kolom Settlement Amount? - Jika nominal pada Amount minus pada **refund**, maka nominal tersebut adalah nominal akan di-*refund*. - Jika nominal pada Amount minus pada **deposit**, maka nominal tersebut adalah nominal akan ditagih kepada atau dipotong dari lain. *** ### Kapan nominal pada kolom Set Off akan terisi? Kolom Set Off akan terisi jika melakukan dengan dana deposit pada metode . *** ### Bagaimana cara meminta bantuan untuk melakukan pemeriksaan suatu transaksi pada tanggal tertentu? :::Iframe{iframeHeight="0" code="Anda dapat menghubungi Customer Service kami melalui e-mail kepada tim Customer Service kami: NICEPAY Customer Service. Customer Service kami beroperasi setiap hari, Senin-Minggu pukul 00:00-24:00 WIB termasuk hari libur nasional. "} :::