This page is no longer supported. Please refer to the current guide for up-to-date information.

Asynchronous mode of operation involves flow:

  • The merchant initiates a Refund, VOID or Settle request
  • Solid takes the request for processing and responds with an intermediate processing/created status
  • After processing the request, a notification arrives at the webhook url with the final status of the order refunded / void_ok / settle_ok


Refund Request Sample:

{
"order_id": "777",
"amount": 2575
}

Refund Response Sample:

{
"order": {
"order_id": "777",
"amount": 2575,
"currency": "USD",
"status": "processing"
},
"transaction": {
"id": "149310695572758ff0116380f7",
"operation": "refund",
"status": "processing",
"descriptor": "DESCRIPTOR",
"amount": 2575,
"currency": "USD",
"refund_reason": "System Error - PSP",
"refund_reason_code": "0012",
"created_at": "2022-05-17 09:06:21",
"updated_at": "2022-05-17 09:06:32",
},
"transactions": {
"149310695572758ff0116380f7": {
"id": "149310695572758ff0116380f7",
"operation": "refund",
"status": "processing",
"descriptor": "DESCRIPTOR",
"amount": 2575,
"currency": "USD",
"refund_reason": "System Error - PSP",
"refund_reason_code": "0012",
"created_at": "2019-05-17 09:06:21",
"updated_at": "2019-05-17 09:06:32",
},
"149310695572758ff010f5d352": {
"id": "149310695572758ff010f5d352",
"operation": "pay",
"status": "success",
"descriptor": "DESCRIPTOR",
"amount": 2575,
"currency": "USD",
"created_at": "2022-05-17 09:06:21",
"updated_at": "2022-05-17 09:06:32",
"card": {
"bin": "444455",
"brand": "VISA",
"country": "USA",
"number": "444455XXXXXX6666",
"card_holder": "cardholder name",
"card_exp_month": "03",
"card_exp_year": 2025,
"card_type": "DEBIT"
"card_token": {
"token": "140dc2f1bd02c...f806d4db669ef"
}
}
}
}
}

Card Order Status Webhook Sample:

{
"transaction": {
"amount": 2575,
"created_at": "2019-10-29 10:01:20",
"currency": "USD",
"descriptor": "DESCRIPTOR",
"id": "149310695572758ff0116380f7",
"operation": "refund",
"status": "success",
"updated_at": "2019-10-29 10:01:20"
},
"transactions": {
"149310695572758ff0116380f7": {
"amount": 2575,
"card": {
"bin": "444455",
"brand": "VISA",
"country": "USA",
"number": "444455XXXXXX6666",
"card_holder": "cardholder name",
"card_exp_month": "03",
"card_exp_year": 2025,
"card_type": "DEBIT"
},
"card_token": {
"token": "140dc2f1bd02c...f806d4db669ef"
},
"created_at": "2019-10-29 10:01:19",
"currency": "USD",
"descriptor": "FAKE_PSP",
"id": "149310695572758ff0116380f7",
"operation": "pay",
"status": "success",
"updated_at": "2019-10-29 10:01:20"
},
"149310695572758ff0116380f7": {
"amount": 2575,
"created_at": "2019-10-29 10:01:20",
"currency": "USD",
"descriptor": "FAKE_PSP",
"id": "149310695572758ff0116380f7",
"operation": "refund",
"status": "success",
"updated_at": "2019-10-29 10:01:20"
},
"billing_details": {
"address": "11437 Woodmeadow Pkwy",
"zip": "85001",
"country": "USA",
"city": "New Delhi",
"state": "TX"
},
},
"order": {
"amount": 2575,
"currency": "USD",
"descriptor": "FAKE_PSP",
"fraudulent": true,
"marketing_amount": 2575,
"marketing_currency": "USD",
"order_id": "777",
"order_description": "Acquiring user account from previously saved card",
"traffic_source": "experiment_id=10",
"processing_amount": 2575,
"processing_currency": "USD",
"refunded_amount": 2575,
"status": "refunded"
},
"chargebacks":{
"494531":{
"id":494531,
"dispute_date":"2021-07-13",
"settlement_date":"2021-07-13",
"amount":1200,
"status":"accepted",
"reason_code":"4853",
"currency":"USD",
"type":"1st_chb",
"chargeback_flow":{
"759854":{
"id":759854,
"amount":1200,
"currency":"USD",
"type":"1st_chb",
"status":"accepted",
"date":"2021-07-13",
"updated_date":"2021-07-13",
"deadline_date":"2021-07-23",
"arn_code":"21edw"
}
}
}
},
"verify_url": "https://acs.solidgate.com/api/v1/verify-3ds/554293692/96454d39ed80f256e9f77bb36271b2aff0c2af3ec769911dfd",
"payment_adviser": {
"advise": "recurring"
}
}

In case of any questions, please, contact us with a ticket on http://support.solidgate.com/