Purchase Pin

post
Purchase an Epin
https://test.platform.baxi.com.ng​/services​/epin​/request
This endpoint allows you to purchase epin from any of the ePin service providers
Request
Response
Request
Headers
Baxi-date
required
string
Date in RFC Format
Authorization
required
string
See authentication page
Body Parameters
amount
required
number
This is the numberOfPins x pinValue.
pinValue
required
number
This is the cost/price of the pin bundle you are willing to purchase.
numberOfPins
required
number
Total number of pins to purchase. This should not be more than the total quantity available from the "Retrieve Pin Bundles" request.
agentReference
required
string
Unique Id generated by integrator to identify current transaction.
agentId
required
string
Your unique agent identification number
Response
200: OK
pins: This is an array of object containing pin request.
  - instructions: This is a description for using the pin
  - serialNumber: This is the serial number of the Pin
  - pin: This is the real pin to be used to get value for the service.
  - expiresOn: This defines the validity period of the pin 
{
  "status": "success",
  "message": "Successful",
  "code": 200,
  "data": {
    "statusCode": "0",
    "transactionStatus": "success",
    "transactionReference": 4,
    "transactionMessage": "Successful pin purchase",
    "pins": [
      {
        "instructions": "Dial *203*3*YOURPIN# to recharge.",
        "serialNumber": "1491224645326",
        "pin": "1290372508463929",
        "expiresOn": "2017-04-06"
      }
    ]
  }
}
​

e-pin Services - Previous

Retrieve Pin Bundles

Next - Electricity Services

Electricity Service Providers

Last updated 2 months ago

Purchase Pin

postPurchase an Epin

post
Purchase an Epin