VAS

The value-added-services rail

VAS (Value-Added Services) is Posteering's capability: buy a good — airtime, data, a bill payment — or issue and redeem a denominated instrument (a gift card, reward points). It speaks one vocabulary: "vend a good," the sibling of Bankrail ("collect and transfer") and Wallet ("hold and move a balance").

The core discipline: the customer pays first, and Posteering never fronts the money. A purchase debits the customer's own funding source, then vends; if the vend fails, the debit is refunded. No commingling — every debit is bound to its own purchase reference.

What it gives you

• Purchase — debit the customer's asserted wallet, vend the good, refund on failure. Airtime, data, and bills today.
• Denomination — vend in naira, or against a denominated instrument (gift card, reward points), each drawn at its own rate against the same funding source.
• Redemption — issue a redeemable instrument and redeem it later; redemption is recipient-scoped (only the intended redeemer can retrieve and redeem a code).
• Delivered artifacts — a vend that produces a code (a gift-card PIN) carries it on the terminal event, delivered to the buyer.

The vendor is data

A vend routes to a vendor (an aggregator such as Squad; a simulate vendor in the sandbox). The vendor name is data, never a code path — you send vendor and product; the vending layer routes to that vendor's adapter. Adding a vendor changes nothing in the contract.

Amounts are always kobo (integer minor units).

Base URL

https://api.posteering.com/api/v1/consumer

Through the One API

Reach VAS the same way you reach any product — through the One API's passthrough and provisioning. The wallet a customer funds is the wallet a vend draws from; the funding wallet is asserted by the perimeter, never named in the request body (a consumer cannot name an arbitrary wallet to debit).