---
title: "Create cash payment"
method: POST
path: "/ledger/cash-payments"
tags: ["ledger-payments"]
---

# Create cash payment

`POST /ledger/cash-payments`

Create cash payment, using the created quote

## Request body

- CreateCashPaymentRequest — Details required to create a cash payment. The amount and currency must align with an existing quote.
  - `quoteId` string, uuid, required — Identifier of an existing cash payment quote, retrieved from the cash payment quote endpoint.
  - `accountId` string, uuid, required — Account to debit for this payment. Can be the main account ID or a sub-account ID.
  - `reference` string, required — Alpha-numeric transfer reference, unique for this transfer.
  - `amount` number, required
  - `unitCurrency` string — Should be same as one of payout or account currencies in the quote. Defaults to account currency if not provided.
  - `beneficiaryId` string, uuid, required — Identifier of an existing beneficiary to whom the transfer will be made.
  - `paymentReason` string, required — Reason for the payment, to be provided at the time of transfer creation.
  - `narration` string — Notes to be included in the transfer.
  - `twoFaMethod` 'AUTHENTICATOR_APP' | 'EMAIL' | 'SMS'

## Response `200`

Cash payment created

- TransferResponse — The payment initiation response
  - `id` string, required
  - `status` 'PENDING' | 'IN_PROGRESS' | 'FAILED' | 'SUCCESS', required — Status of the transaction, indicating its current state in the processing lifecycle. - PENDING: The transaction has been created but not yet processed. - IN_PROGRESS: The transaction is currently being processed. - FAILED: The transaction processing has failed. - SUCCESS: The transaction has been successfully processed.
  - `awaiting2fA` boolean, required — Indicates if transfer is awaiting 2FA confirmation. This applies mostly to transaction initiated via dashboard
  - `twoFaMethod` User2FAMethod[] — List of 2fa enabled

## Other responses

- `400` — Request could not be validated
- `401` — Client is not authorized to make request

---

[API](https://skmtc.net/nestechops/apis/onboard-external-api-gateway.md) · [All operations](https://skmtc.net/nestechops/apis/onboard-external-api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nestechops/onboard-external-api-gateway/revisions/76329919f8a7/schema)