POST v1/companies/{companyId}/locations/{locationId}/ecomm-refund
Refund a full or partial payment
Request Information
URI Parameters
| Name | Description | Type | Additional information |
|---|---|---|---|
| companyId |
Cova company identifier |
integer |
Required |
| locationId |
Cova location identifier |
integer |
Required |
Body Parameters
Payment refund request
CovaPayRefundRequest| Name | Description | Type | Additional information |
|---|---|---|---|
| RefundReference |
Recommended to supply the original order reference to assist in retailer reconciliation |
string |
None. |
| RequestedAmount |
A positive, decimal number (with 2 decimal digits) representing the amount to refund. Must be lower than or equal to the original charge amount. Over-refund fails asynchronously and is not raised to the caller. |
decimal number |
None. |
| SessionId |
The original Cova Pay session id, captured from the payment session |
string |
None. |
Request Formats
application/json, text/json
Sample:
{
"RefundReference": "sample string 1",
"RequestedAmount": 2.0,
"SessionId": "sample string 3"
}
Response Information
Resource Description
CovaPayRefundResponse| Name | Description | Type | Additional information |
|---|---|---|---|
| Id |
Refund identifier - generated |
globally unique identifier |
None. |
Response Formats
application/json, text/json
Sample:
{
"Id": "ad94594c-b64a-4f08-93b8-7f8a88b1c553"
}