Refund
https://{Environment}.payture.com/apim/RefundThis command is used to refund funds charged in a one-step or two-step payment.
Processing the request refunds the charged funds to the Customer's card in full or in part.
Important! For the refund to succeed, the payment must have the Charged status at the time the request is processed.
Request
curl https://sandbox3.payture.com/apim/Refund \
-X POST \
-H "Content-Type: application/x-www-form-urlencoded" \
-d Key=Merchant \
-d Password=123 \
-d OrderId=5f63838d-fb03-00c6-c890-c67cfc1c54ea \
-d Amount=12480 \Parameter names in requests are case-sensitive
| Parameter | Description | Format |
|---|---|---|
| Key | Payment terminal name Provided with the test/production access credentials | String Mandatory |
| Password | Payment terminal password Provided with the test/production access credentials | String Mandatory |
| OrderId | Unique payment ID in the Merchant's system Recommended format: GUID/UUID or alphanumeric. Other formats may cause failures in banking services | String [1..50] Mandatory |
| Amount | Amount to refund, in kopecks. If the parameter is omitted, a full refund is made Digits only, without decimal or other separators | Integer Optional |
| Cheque | Fiscal receipt data in JSON format, Base64-encoded | String Optional |
Response
XML string with the Refund element
Response examples
<Refund Success="True" OrderId="5f63838d-fb03-00c6-c890-c67cfc1c54ea" NewAmount="2000"/>| Parameter | Description | Format |
|---|---|---|
| Success | Operation success flag. Possible values:True — the operation succeededFalse — the operation failed | String Mandatory |
| OrderId | Payment ID in the Merchant's system Matches the value passed in the request | String [1..50] Mandatory |
| NewAmount | Remaining charged amount after the refund, in kopecks Returned if “Success=True” | Integer Optional |
| ErrCode | Error code. See error codes Returned if “Success=False” | String Optional |
