> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.pay4power.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.pay4power.com/_mcp/server.

# Initiate - Renewal

POST https://p4p-core-bill-payments-service.dev.payinvert.com/api/v2.1/b2b/tv/initiate
Content-Type: application/json

Creates a TV subscription transaction and prepares it for final payment and vending.

Reference: https://docs.pay4power.com/tv/initiate-renewal

## Authentication

- `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer <token>`, where token is your auth token.

## Servers

- `https://p4p-core-bill-payments-service.dev.payinvert.com/api/v2.1` (Sandbox, default)
- `https://bills.v2.pay4power.com/api/v2.1` (Live)

## Request

### Body (application/json)

This endpoint expects a map from string to any.

- `map from string to any`

## Response

### 200

- `map from string to any`

## Examples

**Request**

```json
{
  "provider": "DSTV",
  "receiver": "8888888888888",
  "renewal": true
}
```

**Response**

```json
{
  "correlationId": "dd545f1f-ad4e-4c9c-ad0d-f934233529bd",
  "data": {
    "amount": 1000,
    "commission": {
      "commissionAmount": 0,
      "commissionCap": 1500,
      "commissionPercentage": "0.00",
      "isCustomRate": false
    },
    "customerAddress": "FCT Abuja",
    "customerName": "Avoseh Emmanuel",
    "provider": "DSTV",
    "providerLogo": "https://pay4power-uploads.s3.eu-west-1.amazonaws.com/TV/DStv.png",
    "receiver": "8888888888888",
    "verificationReference": "151A08E795AD11F193940D090709175A"
  },
  "errors": null,
  "message": "IUC Number verified successful",
  "statusCode": 200,
  "success": true
}
```