Order Reconciliation
Kashier reconciliation is the process of verifying that the electronic payment and refund transactions processed in your system match the transactions reported by the Kashier.
Retrieve Order Details
Kashier enables you to retrieve details of your Orders.
Endpoint | Value |
---|---|
URL | https://test-api.kashier.io/payments/orders/:merchantOrderId |
Method | get |
Parameters
Parameter | Type | Description | Required |
---|---|---|---|
merchantOrderId | Path Parameter | Unique Order Identifier | True |
Headers
Key | Description |
---|---|
Authorization | The Authorization is secretkey that is used to identify the merchant , you can obtain from kashier's dashboard, learn more about Authorization. |
Click here to shrink1curl -X 'GET' 'https://test-api.kashier.io/payments/orders/:merchantOrderId'2-H 'Authorization: your_secretKey'3-H "accept: application/json"
Response structure
Click here to expandClick here to shrink1{2 "response": {3 "_id": "6113a5242bd6930018c881ae",4 "merchantId": "MID-3552-454",5 "orderId": "10a9fa55-4286-488b-8419-18a87e835ecd",6 "merchantOrderId": "6c3e0871-0a7b-45ec-af33-2fc8221ee188",7 "totalRefundedAmount": 0,8 "totalCapturedAmount": 99,9 "totalAuthorizedAmount": "99.00",10 "method": "card",11 "sourceOfFunds": {12 "cardInfo": {13 "maskedCard": "511111******1118",14 "cardBrand": "Mastercard",15 "cardHash": "b506253054c1bd027e272d6f9bf78cdb5087d4c7e56f5c2be7a45361ea274b1c",16 "expiryYear": "06",17 "expiryMonth": "22",18 "cardHolderName": "John Doe",19 "ccvToken": "d583518a-f324-4dba-8301-cc976951c0da",20 "cardDataToken": "b14160c8-8152-4cb0-b68a-7d100f87a58e"21 },22 "3DSecure": {23 "processACSRedirectURL": "https://test-iframe.kashier.io/v2/3ds"24 }25 },26 "paymentType": "ext-default-hostedpaymentpage-test",27 "apiKeyId": "5feccc49043fa4001f59965c",28 "apiKeyName": "default-hostedpaymentpage-test",29 "paymentOrigin": "kashier-iframe-test",30 "paymentChannel": "online | e-commerce",31 "paymentAgreement": "",32 "metaData": {33 "Customer Name ": "m k",34 "Customer E-mail": "mk@kashier.io",35 "Customer Phone": "01000000000",36 "wixTransactionId": "bb64932d-1933-4d1e-ae39-7574ea3fd61f",37 "wixMerchantId": "c81c8e41-7a25-455f-a199-0a2ebe945c73",38 "cancelUrl": "https://cashier-services.wix.com/_api/payment-services-web/plugin/redirections/bb64932d-1933-4d1e-ae39-7574ea3fd61f/canceled",39 "errorUrl": "https://cashier-services.wix.com/_api/payment-services-web/plugin/redirections/bb64932d-1933-4d1e-ae39-7574ea3fd61f/error?pmName=9a829e14-3576-42ad-93ad-c67fc5c068d2&pmUrl=&failureCode=6000",40 "successUrl": "https://cashier-services.wix.com/_api/payment-services-web/plugin/redirections/bb64932d-1933-4d1e-ae39-7574ea3fd61f/approved",41 "time": "2021-08-11T10:23:31.547Z"42 },43 "transactions": [44 {45 "requestCredentials": {},46 "feeTrxAmount": 0,47 "request": {48 "payload": {49 "apiOperation": "CHECK_3DS_ENROLLMENT",50 "order": {51 "amount": "99.00",52 "currency": "EGP"53 },54 "sourceOfFunds": {55 "provided": {56 "card": {57 "cardDataToken": "b14160c8-8152-4cb0-b68a-7d100f87a58e"58 }59 }60 },61 "3DSecure": {62 "authenticationRedirect": {63 "responseUrl": "https://test-iframe.kashier.io/v2/3ds/10a9fa55-4286-488b-8419-18a87e835ecd/8357f0b8-04af-4d59-9b96-252ca06a3a0c/MID-3552-454/mpgs/EGP?amount=99.00&pusherId=d4dc551c-7b78-4aa4-96b3-05eead829118_undefined_6c3e0871-0a7b-45ec-af33-2fc8221ee188_https://morning-fortress-77263.herokuapp.com/redirect/MID-3552-454/bb64932d-1933-4d1e-ae39-7574ea3fd61f",64 "pageGenerationMode": "CUSTOMIZED"65 }66 },67 "provider": {68 "type": "mpgs"69 }70 },71 "method": "PUT",72 "url": "",73 "auth": {}74 },75 "currency": "EGP",76 "amount": 99,77 "status": "SUCCESS",78 "transactionId": "TX-35524541714",79 "operation": "3dsecure_verify",80 "_id": "6113a5242bd6930018c881af",81 "isPF": true,82 "feeDetails": {83 "processing": 0,84 "transaction": 085 },86 "requestDate": "2021-08-11T10:23:32.233Z",87 "responseDate": "2021-08-11T10:23:32.669Z",88 "response": {89 "payload": {90 "sourceOfFunds": {91 "provided": {92 "card": {93 "brand": "Mastercard",94 "cardHolderName": "John Doe",95 "expiry": {96 "year": "22",97 "month": "06"98 },99 "number": "511111******1118"100 }101 }102 },103 "response": {104 "3DSecure": {105 "gatewayCode": "NOT_ENROLLED_NO_ERROR_DETAILS"106 }107 },108 "merchant": "TESTELEMENTS",109 "3DSecureId": "3DSecureId-8357f0b8-04af-4d59-9b96-252ca06a3a0c",110 "3DSecure": {111 "xid": "rYcMadtijLKOy++b5e//KM7Bc5M=",112 "summaryStatus": "CARD_NOT_ENROLLED"113 }114 },115 "merchantIdentifier": "TESTELEMENTS",116 "operation": "3dsecure_verify",117 "3DSecureSummary": "CARD_NOT_ENROLLED",118 "3DSecureTransactionId": "rYcMadtijLKOy++b5e//KM7Bc5M=",119 "3DSecureId": "3DSecureId-8357f0b8-04af-4d59-9b96-252ca06a3a0c",120 "transactionResponseMessage": {121 "ar": "عملية مرفوضة",122 "en": "Declined"123 },124 "transactionResponseCode": "98",125 "status": "SUCCESS",126 "is3DSecureVerificationRequired": false127 },128 "transactionResponseMessage": {129 "ar": "عملية مرفوضة",130 "en": "Declined"131 },132 "transactionResponseCode": "98"133 },134 {135 "requestCredentials": {},136 "feeTrxAmount": 0,137 "request": {138 "payload": {139 "apiOperation": "PAY",140 "order": {141 "amount": "99.00",142 "currency": "EGP"143 },144 "sourceOfFunds": {145 "type": "CARD",146 "provided": {147 "card": {148 "expiry": {149 "month": "",150 "year": ""151 },152 "nameOnCard": "John Doe",153 "number": "",154 "securityCode": "",155 "cardDataToken": "b14160c8-8152-4cb0-b68a-7d100f87a58e",156 "ccvToken": "d583518a-f324-4dba-8301-cc976951c0da"157 }158 }159 },160 "correlationId": "8357f0b8-04af-4d59-9b96-252ca06a3a0c",161 "provider": {162 "type": "mpgs"163 },164 "3DSecureId": "3DSecureId-8357f0b8-04af-4d59-9b96-252ca06a3a0c",165 "cardToken": null,166 "ccvToken": null,167 "isToken": null,168 "shopper_reference": null,169 "paymentOperationType": null,170 "saveCard": null171 },172 "method": "PUT",173 "url": "",174 "auth": {175 "username": "Merchant.TestElements",176 "password": "e724fbc131a47c004f246df10848f2dc"177 }178 },179 "currency": "EGP",180 "amount": 99,181 "status": "SUCCESS",182 "transactionId": "TX-35524541715",183 "operation": "pay",184 "_id": "6113a5242bd6930018c881b0",185 "isPF": true,186 "requestDate": "2021-08-11T10:23:32.751Z",187 "responseDate": "2021-08-11T10:23:33.198Z",188 "response": {189 "payload": {190 "version": "44",191 "transaction": {192 "type": "PAYMENT",193 "terminal": "QNBAA003",194 "source": "INTERNET",195 "receipt": "122310033582",196 "id": "TX-35524541715",197 "frequency": "SINGLE",198 "currency": "EGP",199 "authorizationCode": "033582",200 "amount": 99,201 "acquirer": {202 "transactionId": "123456789",203 "timeZone": "+0200",204 "settlementDate": "2021-08-11",205 "merchantId": "1478963",206 "id": "QNBAA_S2I",207 "date": "0811",208 "batch": 20210811209 }210 },211 "timeOfRecord": "2021-08-11T10:23:33.036Z",212 "sourceOfFunds": {213 "provided": {214 "card": {215 "brand": "Mastercard",216 "cardHolderName": "John Doe",217 "securityCode": "100",218 "number": "511111******1118",219 "nameOnCard": "John Doe",220 "expiry": {221 "year": "22",222 "month": "06"223 }224 }225 },226 "type": "CARD"227 },228 "result": "SUCCESS",229 "response": {230 "gatewayCode": "APPROVED",231 "cardSecurityCode": {232 "gatewayCode": "MATCH",233 "acquirerCode": "M"234 },235 "acquirerMessage": "Approved",236 "acquirerCode": "00"237 },238 "order": {239 "totalRefundedAmount": 0,240 "totalCapturedAmount": 99,241 "totalAuthorizedAmount": 99,242 "status": "CAPTURED",243 "id": "10a9fa55-4286-488b-8419-18a87e835ecd",244 "currency": "EGP",245 "creationTime": "2021-08-11T10:23:33.015Z",246 "amount": 99247 },248 "merchant": "TESTELEMENTS",249 "gatewayEntryPoint": "WEB_SERVICES_API",250 "correlationId": "8357f0b8-04af-4d59-9b96-252ca06a3a0c",251 "authorizationResponse": {252 "transactionIdentifier": "123456789",253 "stan": "33582",254 "responseCode": "00",255 "processingCode": "003000",256 "posEntryMode": "812",257 "posData": "1025100006600",258 "financialNetworkCode": "777",259 "commercialCardIndicator": "3",260 "commercialCard": "888",261 "cardSecurityCodeError": "M"262 },263 "3DSecureId": "3DSecureId-8357f0b8-04af-4d59-9b96-252ca06a3a0c",264 "3DSecure": {265 "xid": "rYcMadtijLKOy++b5e//KM7Bc5M=",266 "enrollmentStatus": "NOT_ENROLLED"267 }268 },269 "merchantIdentifier": "TESTELEMENTS",270 "operation": "pay",271 "currency": "EGP",272 "amount": 99,273 "issuerAuthorizationCode": "033582",274 "settlementDate": "2021-08-11",275 "transactionDate": "2021-08-11T10:23:33.036Z",276 "transactionId": "TX-35524541715",277 "gatewayMessage": "Payment accepted",278 "transactionResponseMessage": {279 "ar": "تمت الموافقة",280 "en": "Approved"281 },282 "transactionResponseCode": "00",283 "gatewayCode": "APPROVED",284 "status": "SUCCESS"285 },286 "transactionResponseMessage": {287 "ar": "تمت الموافقة",288 "en": "Approved"289 },290 "transactionResponseCode": "00"291 }292 ],293 "provider": "mpgs",294 "status": "CAPTURED",295 "lastModifiedDate": "2021-08-11T10:23:32.749Z",296 "date": "2021-08-11T10:23:32.226Z",297 "order": {298 "amount": "99.00",299 "currency": "EGP",300 "callbackURL": "https://morning-fortress-77263.herokuapp.com/redirect/MID-3552-454/bb64932d-1933-4d1e-ae39-7574ea3fd61f"301 },302 "merchantDetails": {303 "storeName": "TEST ft- MK Company",304 "merchantId": "MID-3552-454",305 "businessIndustry": "food_ordering",306 "MCC": "3333"307 },308 "__v": 0309 },310 "messages": {311 "en": "The payment transaction has been retreived successfully",312 "ar": "تم استرداد عملية الدفع بنجاح"313 },314 "status": "SUCCESS"315}
You can varify the reason of failure transaction by checking transactionResponseCode key in transaction object that has operation key equals to pay. Learn more about Payment Reason Code