Sign in

v1

latestOpenAPI 3.0.32026-07-232073105.4 KB
Payment

Refund

Used to refund a payment. The refund is executed over paymentTransactionId (per basket item). You can perform a full or partial refund for the payment amount.

post/payment/refund

Headers

Authorizationstring required

Authorization header, IYZWSv2 ile başlayan ve base64 formatında üretilmiş imzalı hash değeridir.

Content-Typestring required

Content-Type değeri.

Request body

paymentTransactionIdstring required

Basket item (payment breakdown) identifier (paymentTransactionId) to be refunded.

conversationIdstring

Unique ID for request/response correlation.

ipstring

IP address the request is sent from.

locale'tr' | 'en'

Response language.

{"stackTrail":"components:schemas:RefundPaymentRequest:properties:price","oasType":"schema","type":"unknown","description":"Amount to refund. **Must not exceed** the item price."}
currencystring

Payment currency.

Response

Successful response

status'success' | 'failure'

Indicates the outcome of the request.

locale'tr' | 'en'

Response language.

systemTimeinteger

Current epoch ms at the time of response.

conversationIdstring

Echoes the conversationId sent in the request.

paymentIdstring

Payment number.

paymentTransactionIdstring

Refunded payment item identifier.

{"stackTrail":"components:schemas:RefundPaymentResponse:properties:price","oasType":"schema","type":"unknown","description":"Refunded amount."}
currencystring

Currency.

authCodestring

Authorization (auth) code returned by the bank.

hostReferencestring

Reference value provided by the bank for the payment.

refundHostReferencestring

Reference value provided by the bank for the refund.

retryabletrue | false

Indicates whether the operation can be retried.

signaturestring

Signature value that can be used for verification.