VTU
POST https://sms.hollatags.com/api/vtu
The POST parameters should be sent as x-www-form-urlencoded
This endpoint allows you to retrieve a paginated list of all your attachments (in a conversation if a conversation id is provided). By default, a maximum of ten attachments are shown per page.
Request Body
- Name
user- Type
- string
- Description
Account username.
- Name
amount- Type
- string
- Description
The value of virtual airtime to send to the mobile number. By default, min 10 & max 20000, representing N10 and N20,000 respectively. If you need higher value allowed on your account, please contact help@hollatags.com
- Name
pass- Type
- string
- Description
Account Password.
- Name
reference_id- Type
- string
- Description
This serves as the idempotency unique client reference ID for safely retrying failed or timeout requests without accidentally executing the same transaction twice.
(automatically expire after 30days) (Length is 12 to 40 characters )
We suggest the reference ID should be a V4 UUIDs (e.g 58c0d0f9-7dc6-4ce0-91ae-2d84c5880713), or another random string that can guarantee uniqueness to avoid collisions.
Request
curl --location 'https://sms.hollatags.com/api/vtu' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'user={USERNAME}' \
--data-urlencode 'amount=N20,000' \
--data-urlencode 'to=234700000000' \
--data-urlencode 'pass={PASSWORD}' \
--data-urlencode 'reference_id=58c0d0f9-7dc6-4ce0-91ae-2d84c5880713'
Response
"sent"