Acquire product with given SKU (async)

Allows to acquire product (by SKU) for given beneficiary. Result will be delivered asynchronously by calling user callback.

Possible results:

If status is 'INITIATED', you will receive a callback.

If status is 'FAILURE', the operation was rejected.

Request Body required

operationId AcquireOperationId required
Unique operation id of the acquisition
sku ProductSku required
Product SKU
beneficiaryId BeneficiaryId required
Product specific beneficiary ID, described in product group's beneficiaryIdLabel or product's beneficiaryIdLabel in /acquire/products, for example: acquirer msisdn, ticket number or DSTV Smart Card number
customerMsisdn +234'10 digits' or 234'10 digits' or 0'10 digits' or +0'10 digits' or '10 digits' required
Customer msisdn
amount double
Amount to acquire. Must be provided for products with amountSource other than 'FIXED'. If not provided for amountSource 'FIXED' amount from product will be used.

Responses

Successful response

Schema

status string required
Possible values: [INITIATED, FAILURE]
error string
Possible values: [INTERNAL, INVALID_AMOUNT, UNKNOWN_SKU, INVALID_BENEFICIARY_ID, UNSPECIFIED]

{
  "status": "INITIATED",
  "error": "INTERNAL"
}

The operation was successfully initiated. You will receive a callback with operation's final status

{
  "status": "INITIATED"
}

Provided SKU is invalid

{
  "status": "FAILURE",
  "error": "UNKNOWN_SKU"
}

Provided amount is invalid

{
  "status": "FAILURE",
  "error": "INVALID_AMOUNT"
}

Provided amount is invalid

{
  "status": "FAILURE",
  "error": "INVALID_BENEFICIARY_ID"
}