POST
/paymentorder.doEndpoint metadata is pulled from Strapi and paired with the imported GitBook reference content below.
Invoice Payment
Thepaymentorder.domethod is used for a payment request.
Request Payload
userName | Yes | String [1..100] | Login of the API user on whose behalf requests are processed for a particular merchant. |
password | Yes | Password | |
MDORDER | Yes | String [1..32] | Unique order number generated by EPG after the registration of the order |
$PAN | Mandatory | Integer [0..12] | Order amount in the minor denomination |
$CVC | Optional | Integer [3] | Payment currency code in the ISO 4217 format. |
YYYY | No | String [1..512] | URL to which the customer is redirected after a successful payment. |
MM | No | String [1..598] | Free form description of the order. |
POST /paymentorder.do
Initiate a payment
{
"openapi": "3.0.0",
"info": {
"title": "BomaPay API",
"version": "1.0.0"
},
"servers": [
{
"url": "https://dev.bpcbt.com/payment/rest",
"description": "Dev Sandbox"
}
],
"paths": {
"/paymentorder.do": {
"post": {
"description": "Initiate a payment",
"operationId": "initiate payment",
"requestBody": {
"description": "Initiate payment",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Payment"
}
}
}
},
"responses": {
"200": {
"description": "success",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/OrderSuccessResponse"
}
}
}
},
"400": {
"description": "invalid input, object invalid",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/OrderFailureResponse"
}
}
}
}
}
}
}
},
"components": {
"schemas": {
"Payment": {
"required": [
"userName",
"password",
"MDORDER",
"$PAN",
"$CVC",
"YYYY",
"MM"
],
"type": "object",
"properties": {
"userName": {
"type": "string"
},
"password": {
"type": "string"
},
"MDORDER": {
"type": "string",
"minLength": 1,
"maxLength": 32
},
"$PAN": {
"type": "integer",
"minLength": 12,
"maxLength": 19
},
"$CVC": {
"type": "integer",
"maxLength": 3,
"minLength": 3
},
"YYYY": {
"type": "integer",
"format": "year",
"maxLength": 4,
"minLength": 4
},
"MM": {
"type": "integer",
"format": "month",
"minimum": 1,
"maximum": 12
},
"language": {
"type": "string"
}
}
},
"OrderSuccessResponse": {
"required": [
"orderId",
"formUrl"
],
"type": "object",
"properties": {
"orderId": {
"type": "string"
},
"formUrl": {
"type": "string"
}
}
},
"OrderFailureResponse": {
"required": [
"errorCode",
"errorMessage"
],
"type": "object",
"properties": {
"errorCode": {
"type": "integer"
},
"errorMessage": {
"type": "string"
}
}
}
}
}
}The Payment object
{
"openapi": "3.0.0",
"info": {
"title": "BomaPay API",
"version": "1.0.0"
},
"components": {
"schemas": {
"Payment": {
"required": [
"userName",
"password",
"MDORDER",
"$PAN",
"$CVC",
"YYYY",
"MM"
],
"type": "object",
"properties": {
"userName": {
"type": "string"
},
"password": {
"type": "string"
},
"MDORDER": {
"type": "string",
"minLength": 1,
"maxLength": 32
},
"$PAN": {
"type": "integer",
"minLength": 12,
"maxLength": 19
},
"$CVC": {
"type": "integer",
"maxLength": 3,
"minLength": 3
},
"YYYY": {
"type": "integer",
"format": "year",
"maxLength": 4,
"minLength": 4
},
"MM": {
"type": "integer",
"format": "month",
"minimum": 1,
"maximum": 12
},
"language": {
"type": "string"
}
}
}
}
}
}