---
title: "Create a Provisioning"
method: POST
path: "/provisionings"
tags: ["Provisioning"]
---

# Create a Provisioning

`POST /provisionings`

Move funds from merchant's collection account to transfer account

## Headers

- `ApiKey` string, required
- `MerchantId` string, required
- `Environment` 'live' | 'sandbox', required

## Request body

- CreateProvisioningDto
  - `amount` number, required — Amount intended to be moved from CollectionAccount to TransferAccount. A positive integer representing how much to charge in the smallest currency unit (e.g., 100 cents to charge €1.00 or 100 to charge FCFA100, a zero-decimal currency).
  - `currency` string, required — Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html).
  - `description` string, required — An arbitrary string attached to the Transfer. Mostly useful for displaying to user.

## Response `200`

- ProvisioningDto
  - `id` string, required — Unique identifier for the Provisioning
  - `status` string, required — Type of this Transaction
  - `date` string, required — Datetime in UTC timezone at which this object was created. Follows the [Datetime ISO](https://en.wikipedia.org/wiki/ISO_8601).
  - `withdrawal` ProvisioningWithdrawalDto
    - `id` string, required — Unique identifier for the Transaction
    - `type` string, required — Type of this Transaction
    - `date` string, required — Datetime in UTC timezone at which this object was created. Follows the [Datetime ISO](https://en.wikipedia.org/wiki/ISO_8601).
    - `amount` number, required — Transaction amount. A positive integer representing how much to charge in the smallest currency unit (e.g., 100 cents to charge €1.00 or 100 to charge FCFA100, a zero-decimal currency).
    - `currency` string, required — Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html).
  - `deposit` ProvisioningDepositDto
    - `id` string, required — Unique identifier for the Transaction
    - `type` string, required — Type of this Transaction
    - `date` string, required — Datetime in UTC timezone at which this object was created. Follows the [Datetime ISO](https://en.wikipedia.org/wiki/ISO_8601).
    - `amount` number, required — Transaction amount. A positive integer representing how much to charge in the smallest currency unit (e.g., 100 cents to charge €1.00 or 100 to charge FCFA100, a zero-decimal currency).
    - `currency` string, required — Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html).
  - `description` string, required — An arbitrary string attached to the Transfer. Mostly useful for displaying to user.
  - `failureCause` ProvisioningFailureCauseDto

## Other responses

- `201`
- `401` — Wrong credentials
- `409` — Invalid request
- `500` — Internal error

---

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