Approval

In the marketplace solution, once the payment has been processed by iyzico, the funds are securely held in a protected pool until the submerchant grants approval for the payment breakdown or specific product. During this period, the submerchant has the flexibility to cancel the payment, issue a refund for a particular item, or provide approval for the fund transfer if the product has been successfully delivered to the buyer and the transaction has been completed without any issues. Additionally, the submerchant can withdraw their approval for the transaction if necessary.

For such usages iyzico offers 2 ways of finalize the payment;

Please note that iyzico does not have the capability to grant product approvals. Since there is no corresponding function available in the control panel, these approvals must be sent programmatically at the code level.

Approve Item

post

To approve an item, provide the split id (paymentTransactionId). The id is returned by the payment service.

Header parameters

AuthorizationstringRequired

Authorization header; a signed hash value that starts with IYZWSv2 and is generated in Base64 format.

Example: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=

Content-TypestringRequired

Request body content type.

Example: application/json

Body

localestring · enumOptionalExample: enPossible values:

conversationIdstringOptionalExample: conversationId

paymentTransactionIdstringRequired

Split id to be approved.

Example: 27206433

Responses

200

Successful response

application/json

statusstring · enumOptionalExample: successPossible values:

localestring · enumOptionalExample: enPossible values:

systemTimeintegerOptionalExample: 1756115925593

conversationIdstringOptionalExample: conversationId

paymentTransactionIdstringOptionalExample: 27206433

400

Error response

application/json

post

/payment/iyzipos/item/approve

POST https://api.iyzipay.com/payment/iyzipos/item/approve
Authorization: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
Content-Type: application/json

{
  "locale": "en",
  "conversationId": "conversationId",
  "paymentTransactionId": "27206433"
}

{
  "status": "success",
  "locale": "en",
  "systemTime": 1756115925593,
  "conversationId": "conversationId",
  "paymentTransactionId": "27206433"
}

Sample Codes

Dissapprove

post

To disapprove a product, the related paymentTransactionId must be provided in the request. The id (paymentTransactionId) of the disapproved payment transaction will be returned in the response.

Header parameters

AuthorizationstringRequired

Authorization header; a signed hash value that starts with IYZWSv2 and is generated in Base64 format.

Example: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=

Content-TypestringRequired

Request body content type.

Example: application/json

Body

localestring · enumOptionalExample: enPossible values:

conversationIdstringOptionalExample: conversationId

paymentTransactionIdstringRequired

Split id whose approval will be revoked.

Example: 27206433

Responses

200

Successful response

application/json

statusstring · enumOptionalExample: successPossible values:

localestring · enumOptionalExample: enPossible values:

systemTimeintegerOptionalExample: 1756115925593

conversationIdstringOptionalExample: conversationId

paymentTransactionIdstringOptionalExample: 27206433

400

Error response

application/json

post

/payment/iyzipos/item/disapprove

POST https://api.iyzipay.com/payment/iyzipos/item/disapprove
Authorization: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
Content-Type: application/json

{
  "locale": "en",
  "conversationId": "conversationId",
  "paymentTransactionId": "27206433"
}

{
  "status": "success",
  "locale": "en",
  "systemTime": 1756115925593,
  "conversationId": "conversationId",
  "paymentTransactionId": "27206433"
}