---
title: "Commit payout transaction"
method: PUT
path: "/payout/{user_token}/{payout_token}"
tags: ["Payout"]
---

# Commit payout transaction

`PUT /payout/{user_token}/{payout_token}`

This **PUT** endpoint is used to commit a previously created payout transaction. <br> Once a payout transaction is created, you can use this endpoint to commit the transaction and initiate the actual payout. <br> To use this endpoint, you need to provide the `user_token` and `payout_token` of the payout transaction you want to commit in the URL Path. <br> The response will include a JSON object containing details about the committed payout transaction, including the `payout_token`, `payout_status`, `pickup_code` and possible errors.

## Path parameters

- `user_token` string, required
- `payout_token` string, required

## Headers

- `Idempotency-Key` string

## Response `200`

successful operation

- PayoutTxnCommitResp
  - `payout_token` string, uuid, required — Token that represents the transaction that was just created.
  - `status` 'success' | 'failure' | 'addtl_attr_req' | 'ex_rate_expired' | 'nsf', required — Status that indicates whether the transaction was successfully processed. If `success`, everything was processed correctly. `failure` indicates a generic error. `addtl_attr_req` indicates that in order to process this transaction, additional attributes are required to be updated for this customer. `ex_rate_expired` indicates that the transaction exchange rate has expired and a new transaction has to be created.
  - `pickup_code` string — Code/pin that is required when collecting the money. Should be provided to the recipient to present to payout location.
  - `errors` string — Description of errors preventing transfer from being injected.

## Other responses

- `400` — Bad request.
- `401` — Unauthorized.
- `403` — Forbidden.
- `404` — Not found.
- `405` — Method Not Allowed.
- `500` — Internal server error.
- `504` — Gateway Time-out.

---

[API](https://skmtc.net/masspay/apis/masspay-api.md) · [All operations](https://skmtc.net/masspay/apis/masspay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/masspay/masspay-api/revisions/c03b61a6a551/schema)