Bill Payment API

Pay various bills for your customers, such as TV subscriptions (Canal+, Startimes) and utilities (SNEL, REGIDESO), using your fleet account.

API Version

Overview

The Bill Payment API allows you to integrate utility and subscription payment services directly into your application. All payments are debited from your partner fleet account, providing a centralized way to manage disbursements.

Working with Multiple Currencies

If the bill payment currency differs from your fleet account's funding currency, you can use our Exchange Rates API to get the exact conversion rate before initiating the transaction. This helps in calculating the precise amount that will be debited from your account.

Pay a Bill

POST/api/v1/b2b/bills/pay

Processes a bill payment for a specified provider and customer account.

The reference should be a unique ID from your system to ensure idempotency. The provider code must match one of the supported billers.

cURL

curl -X POST 'https://api.cashpay-all.com/api/v1/b2b/bills/pay' \
-H 'Authorization: Bearer <YOUR_API_KEY>' \
-H 'Content-Type: application/json' \
-d '{
  "customerAccountId": "123456789",
  "amount": 25,
  "currency": "USD",
  "provider": "CANAL_PLUS",
  "reference": "YOUR_UNIQUE_BILL_REF_456"
}'

Success Response

JSON

{
  "success": true,
  "message": "Bill payment request processed successfully.",
  "transactionId": "BILLPAY-A1B2",
  "providerReference": "CANAL_CONFIRM_XYZ"
}

Supported Providers

CANAL_PLUS - Canal+ TV Subscription
STARTIMES - Startimes TV Subscription
SNEL - National Electricity Company
REGIDESO - National Water Company