GitHubFeedback Form

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
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

PHP

Java

.Net

Node.Js

Python

Postman

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
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"
}

Sample Codes

PHP

Java

.Net

Node.Js

Python

Postman

PreviousOnline PaymentNextSubscription

Last updated