Bills / API reference

Validate a recipient

Verify electricity, TV, or education recipient details before purchasing.

POST/products/validate-recipient

Authentication

Send your live API key in the Authorization: Bearer header. All requests use https://api.celerlinks.com/api-service.

The data object varies by provider. If an access_token is returned, include it in the purchase request. A failed validation returns an error; do not proceed.

Request parameters

product_codestring · body · required

Use the code from the current product catalogue.

recipient_numberstring · body · required

Phone number, meter number, or smartcard number for the selected product.

scenariostring · body · optional

Sandbox only: success (default) or failure. Rejected on live routes.

Examples are illustrative. Catalogue IDs, product codes, prices, and provider-specific fields must come from your current API responses.

cURL request

curl --request POST 'https://api.celerlinks.com/api-service/products/validate-recipient' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "product_code": "PRODUCT_CODE",
  "recipient_number": "RECIPIENT_NUMBER"
}'

Illustrative response

{
  "success": true,
  "message": "Request completed successfully",
  "data": {}
}