---
title: "Create Bill"
method: POST
path: "/paymentgateway/api/v1/paybill"
---

# Create Bill

`POST /paymentgateway/api/v1/paybill`

## Headers

- `Content-Type` string, required
- `Authorization` string

## Request body

- object
  - `merchantCode` string, required — Your merchant code
  - `payableCode` string, required — Your payable code/pay item id
  - `amount` string, required
  - `redirectUrl` string, required — The URL you want the customer to be redirected to after a successful payment
  - `transactionReference` string — Transaction Reference on your system you want the payment to be linked to if successful
  - `customerId` string — The customer id on your system
  - `currencyCode` string, required
  - `customerEmail` string, required — The email address of the customer

## Response `200`

200

- object
  - `id` integer
  - `merchantCode` string
  - `payableCode` string
  - `amount` integer
  - `surcharge` unknown
  - `code` string
  - `transactionReference` string
  - `redirectUrl` string
  - `customerId` string
  - `reference` string
  - `customerEmail` string
  - `currencyCode` string
  - `createdOn` unknown
  - `enabled` boolean
  - `paymentUrl` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/interswitchgroup/apis/oauth2.md) · [All operations](https://skmtc.net/interswitchgroup/apis/oauth2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/interswitchgroup/oauth2/revisions/13065c872c78/schema)