Pay a bill from the merchant wallet
Reserves the selected environment wallet before dispatch. Success consumes the reservation, a definite failure releases it, and an unknown provider outcome remains PROCESSING for requery. Payments are never automatically retried through the secondary provider.
Reserves the selected environment wallet before dispatch. Success consumes the reservation, a definite failure releases it, and an unknown provider outcome remains PROCESSING for requery. Payments are never automatically retried through the secondary provider.
x-api-key<token>Your API key: ck_test_... for test mode, ck_live_... for live. Send it with x-api-secret (or Authorization: Bearer ).
x-api-secret?stringRecommended: API secret sent over HTTPS. You may send it as Authorization: Bearer instead. If supplied, x-timestamp and x-signature are not required.
x-timestamp?stringLegacy signed mode: Unix time in milliseconds; maximum clock skew five minutes.
x-signature?stringLegacy signed mode: HMAC-SHA256(secret, timestamp.METHOD.url.idempotencyKey.bodyHash).
x-idempotency-key*string1–128 letters/digits or ._:-. Same key and payload replay for 24 hours; conflicting, in-flight, or expired keys return 409. Never change a key to retry an uncertain payment.
application/json- body
provider?string"VTPASS""VTPASS""FLUTTERWAVE"serviceCode*stringVTpass serviceID or Flutterwave biller_code.
productCode?stringVTpass variation/type or Flutterwave item_code.
customerId*stringMeter, smartcard, account, or phone number expected by the selected product.
category*string"AIRTIME""DATA""ELECTRICITY""TV""INTERNET""OTHER"amountMinor*stringPositive integer minor units. 500000 means NGN 5,000.00.
currency?string"NGN"phoneNumber*stringreference?string1 <= length <= 80application/json- response
id*stringtransactionId*stringreference*stringstatus*string"PENDING""PROCESSING""SUCCESS""FAILED"amountMinor*stringcurrency*stringenvironment*string"SANDBOX""LIVE"provider*string"VTPASS""FLUTTERWAVE"category*stringserviceCode*stringproductCode?customerIdMasked*stringproviderReference?token?Electricity/recharge token when supplied by the provider. Returned on the first successful response and authenticated detail reads.
requiresReconciliation*booleancreatedAt*stringdate-timeupdatedAt*stringdate-timecurl -X POST 'https://api.creddot.com/api/v1/bills' \ -H 'x-idempotency-key: string' \ -H 'Content-Type: application/json' \ -d '{ "serviceCode": "ikeja-electric", "customerId": "1111111111111", "category": "ELECTRICITY", "amountMinor": "500000", "phoneNumber": "+2348012345678"}'{ "id": "string", "transactionId": "string", "reference": "string", "status": "PENDING", "amountMinor": "string", "currency": "string", "environment": "SANDBOX", "provider": "VTPASS", "category": "string", "serviceCode": "string", "productCode": {}, "customerIdMasked": "string", "providerReference": {}, "token": {}, "requiresReconciliation": true, "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z"}