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

Name	Type	Description
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)

200: OK

Refund to Balance Response;

Parameter name		Description
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