Mass Payout Auth

Auth Mass Payout

post

https://api.iyzipay.comhttps://sandbox-api.iyzipay.com

/v1/mass/payout/auth

Second step of the two-phase process. Transitions valid mass payout items from INIT to PROCESSING. Messages to be processed are queued (for fund reservation/transfer). Invalid orders remain unchanged. An audit trail is recorded.

Query parameters

localestring · enumRequired

Response language.

Possible values:

Header parameters

AuthorizationstringRequired

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

Example: IYZWSv2 aXBzaWduYXR1cmU...

Content-TypestringRequired

Content-Type value.

Example: application/json

Body

application/json

Mass payout authorization request.

requestIdstringRequired

Correlation / tracking identifier returned from the initialization step.

Example: 79cdefc1-3ce6-4f51-bdd9-c050274db664

Responses

200

Successful

application/json

post

/v1/mass/payout/auth

HTTPcURL

POST /v1/mass/payout/auth?locale=en HTTP/1.1
Host: api.iyzipay.com
Authorization: IYZWSv2 aXBzaWduYXR1cmU...
Content-Type: application/json

{
  "requestId": "79cdefc1-3ce6-4f51-bdd9-c050274db664"
}

200

Successful

{
  "status": "success",
  "systemTime": 1759231995145
}