Bill Payment · Credit Card

Credit Card Bill Fetch

Fetch credit card bill details

POST request

URL: https://api.payorbit.in/api/v1/bill-payment/credit-card/bill-fetch

Body

{
    "card": "3008",
    "mobile": "9876543210",
    "opcode": "ICIC",
    "orderid": "UNIQUE_ID_123"
}

Include a valid Bearer token with every request

Code sample

curl -X POST "https://api.vizodigital.com/api/v1/bill-payment/credit-card/bill-fetch" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "mobile": "9876543210",
    "card": "3008",
    "opcode": "ICIC",
    "orderid": "UNIQUE_ID_123"
  }'

Success Response

{
    "fee": 0.1,
    "data": {
        "orderid": "UNIQUE_ID_123",
        "fetch_id": "TSB974ca11c49f641e08b17690a43631819",
        "bill_date": "08/12/2024",
        "bill_amount": 7475.12,
        "minimum_due": 2344,
        "bill_due_date": "28/12/2024",
        "customer_name": "XXXX KUMAR AGARWAL"
    },
    "status": "success",
    "message": "Transaction Successful",
    "wallet_balance": 999.9
}

Failure response

{
    "status": "error",
    "message": "Request failed. Check credentials, wallet balance, or validation errors."
}

Overview

Fetch due details for a specific credit card before processing a payment.

Returns a fetch_id that is required for the Bill Pay API.

Access & billing

This endpoint must be enabled for your account under Plan API access (credit_card_fetch).
Fee is deducted from your developer wallet before the provider call.
Failed provider calls refund the fee automatically.
Response includes fee and wallet_balance.

Your request is authenticated with a Bearer token. Provider credentials are applied server-side — never send Inspay username/token from the client.

Body

application/json required

Bill fetch request body

Schema

{
    "type": "object",
    "required": [
        "mobile",
        "card",
        "opcode",
        "orderid"
    ],
    "properties": {
        "card": {
            "type": "string",
            "description": "Last 4 digits (or card identifier as required by operator)"
        },
        "mobile": {
            "type": "string",
            "description": "10-digit registered mobile number"
        },
        "opcode": {
            "type": "string",
            "description": "Operator code, e.g. ICIC"
        },
        "orderid": {
            "type": "string",
            "description": "Unique client order / request ID"
        }
    }
}

Example

{
    "card": "3008",
    "mobile": "9876543210",
    "opcode": "ICIC",
    "orderid": "UNIQUE_ID_123"
}

Responses

200 · application/json default

Bill details fetched successfully

Example

{
    "fee": 0.1,
    "data": {
        "orderid": "UNIQUE_ID_123",
        "fetch_id": "TSB974ca11c49f641e08b17690a43631819",
        "bill_date": "08/12/2024",
        "bill_amount": 7475.12,
        "minimum_due": 2344,
        "bill_due_date": "28/12/2024",
        "customer_name": "XXXX KUMAR AGARWAL"
    },
    "status": "success",
    "message": "Transaction Successful",
    "wallet_balance": 999.9
}

Rate Limits

60/min