Skip to main content
POST
/
api
/
v1
/
biller-reseller
/
orders
Create Biller Reseller Order
curl --request POST \
  --url https://api.payvessel.com/api/v1/biller-reseller/orders \
  --header 'Content-Type: application/json' \
  --header 'api-key: <api-key>' \
  --header 'api-secret: <api-key>' \
  --data '
{
  "biller_id": "<string>",
  "item_id": "<string>",
  "recharge_account": "<string>",
  "amount": 123,
  "reference": "<string>",
  "title": "<string>",
  "description": "<string>"
}
'
{
  "status": true,
  "message": "<string>",
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "business_id": "<string>",
    "reference": "<string>",
    "provider_reference": "<string>",
    "category": "<string>",
    "biller_id": "<string>",
    "item_id": "<string>",
    "recharge_account": "<string>",
    "amount": 123,
    "error_message": "<string>",
    "wallet_transaction_id": "<string>",
    "created_datetime": "2023-11-07T05:31:56Z",
    "updated_datetime": "2023-11-07T05:31:56Z",
    "completed_datetime": "2023-11-07T05:31:56Z"
  }
}

Authorizations

api-key
string
header
required
api-secret
string
header
required

Body

application/json
category
enum<string>
required
Available options:
betting,
airtime,
data
biller_id
string
required
item_id
string
required
recharge_account
string
required
Maximum string length: 15
amount
integer
required

Amount in naira

reference
string
required

Unique merchant order reference

Maximum string length: 32
title
string | null
Maximum string length: 50
description
string | null
Maximum string length: 200

Response

Successful Response

status
boolean
required
message
string
required
data
OrderSchema · object
required