Provisioning

Create a Provisioning

Changed on Nov 3, 2026

Move funds from merchant's collection account to transfer account. With an API key, the request awaits Hub2 validation and its amount is held on the collection account until then; a request above the available collection balance is refused with 409 insufficient-funds, and one whose amount cannot be held for another reason with 422.

post/provisionings

Request

The document declares no server URL.
Auth
none declared. Required headers: ApiKey, MerchantId, Environment

Headers

ApiKeystring required

Your api key. To create a key, please get into our dashboard. If you don't have access to it, please reach the Support team.

MerchantIdstring required

Your merchant ID. This information is available in our dashboard. If you don't have access to it, please reach the Support team.

Environment'live' | 'sandbox' required

Allow you to choose between the sandbox mode to perform some tests or the live mode for real world transactions.

Request body

amountnumber 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).

currencystring required

Three-letter ISO currency code.

descriptionstring required

An arbitrary string attached to the Transfer. Mostly useful for displaying to user.

Example request

{
  "amount": 100,
  "currency": "XOF"
}

Response

idstring required

Unique identifier for the Provisioning

statusstring required

Type of this Transaction

datestring required

Datetime in UTC timezone at which this object was created. Follows the Datetime ISO.