Refund to Balance

Refund to Balance provides you with the ability to make instant refunds to your customers' iyzico accounts. As the refund process is independent of banking procedures, once approval is obtained from the merchant, funds are transferred directly to the account without relying on the banking processes.

How to launch Refund to Balance process?

  • When your customer initiates a refund process on your website, they choose the option "Refund to my iyzico account." The link or button to facilitate this process is obtained through a request to the iyzico service.

  • When the customer clicks on the provided link, they are redirected to the iyzico page where they either register or log in to their iyzico account using their phone number/email and the SMS code they receive during the login process.

  • Once the customer confirms the refund to be credited to their iyzico account, they are redirected to the callback URL you specified during the request.

  • Upon approval of the refund by the merchant, the transfer of funds to the customer's iyzico account takes place.

Refund to Balance Request;

Refund to Balance Request

POST https://api.iyzipay.com/payment/iyzipos/item/approve

Request Body

NameTypeDescription

locale

String

Language settings (default: tr)

conversationId

String

Conversation ID to match request and response

paymentId*

String

ID of the related payment.

callbackUrl*

String

Redirection URL(https)

Refund to Balance Response;

Parameter nameDescription

token

string

Unique value created for refund. This token is sent to callBackUrl

url

string

Url to start the refund to iyzico account process

status

string

Service response result (success / failure)

errorCode

string

Error code if service response status is failure

errorMessage

string

Error message if service response status is failure

errorGroup

string

Error group if service response status is failure

locale

string

Language (default: tr)

systemTime

integer

Response system timestamp value

conversationId

string

If set, conversation ID to match request and response

Last updated