BomaPay Documentation

BomaPay API documentation covering payment partners, integration flows, authentication, API endpoints, and SDKs.

← Back to projects
GET
/getOrderStatus.do

Endpoint metadata is pulled from Strapi and paired with the imported GitBook reference content below.

Get Order Status

The request used to get the order status isgetOrderStatusExtended.do

Response Codes

CodeDescription
0Success
2The order is declined because of an error in the payment credentials.
5Access is denied. The user must change the password. orderId is empty.
6Unregistered order Id.
7System error.

Order Status

StatusDescription
0Order was registered but not paid;
1Order was authorized only and wasn't captured yet (for two-phase payments);
2Order was authorized and captured;
3Authorization canceled;
4Transaction was refunded;
5Access control server of the issuing bank initiated authorization procedure;
6Authorization declined;
7Pending order payment;
8Intermediate completion for multiple partial completion.

GET /getOrderStatus.do

Gets the status of an order
{
  "openapi": "3.0.0",
  "info": {
    "title": "BomaPay API",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://dev.bpcbt.com/payment/rest",
      "description": "Dev Sandbox"
    }
  ],
  "paths": {
    "/getOrderStatus.do": {
      "get": {
        "description": "Gets the status of an order",
        "operationId": "orderStatus",
        "parameters": [
          {
            "name": "userName",
            "in": "query"
          },
          {
            "name": "password",
            "in": "query"
          },
          {
            "name": "orderId",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OrderStatusResponse"
                }
              }
            }
          },
          "400": {
            "description": "invalid input, object invalid",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OrderFailureResponse"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "OrderStatusResponse": {
        "type": "object",
        "properties": {
          "expiration": {
            "type": "string"
          },
          "cardholderName": {
            "type": "string"
          },
          "depositAmount": {
            "type": "integer"
          },
          "currency": {
            "type": "string"
          },
          "authorizationResponseId": {
            "type": "string"
          },
          "ErrorCode": {
            "type": "string"
          },
          "ErrorMessage": {
            "type": "string"
          },
          "OrderStatus": {
            "type": "string"
          },
          "OrderNumber": {
            "type": "string"
          },
          "Pan": {
            "type": "string"
          },
          "Amount": {
            "type": "integer"
          }
        }
      },
      "OrderFailureResponse": {
        "required": [
          "errorCode",
          "errorMessage"
        ],
        "type": "object",
        "properties": {
          "errorCode": {
            "type": "integer"
          },
          "errorMessage": {
            "type": "string"
          }
        }
      }
    }
  }
}

###

POST /getOrderStatus.do

Registers an order
{
  "openapi": "3.0.0",
  "info": {
    "title": "BomaPay API",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://dev.bpcbt.com/payment/rest",
      "description": "Dev Sandbox"
    }
  ],
  "paths": {
    "/getOrderStatus.do": {
      "post": {
        "description": "Registers an order",
        "operationId": "registerOrder",
        "requestBody": {
          "description": "Order item to register",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OrderStatus"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OrderStatusResponse"
                }
              }
            }
          },
          "400": {
            "description": "invalid input, object invalid",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OrderFailureResponse"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "OrderStatus": {
        "required": [
          "userName",
          "password"
        ],
        "type": "object",
        "properties": {
          "userName": {
            "type": "string"
          },
          "password": {
            "type": "string"
          },
          "orderId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32
          }
        }
      },
      "OrderStatusResponse": {
        "type": "object",
        "properties": {
          "expiration": {
            "type": "string"
          },
          "cardholderName": {
            "type": "string"
          },
          "depositAmount": {
            "type": "integer"
          },
          "currency": {
            "type": "string"
          },
          "authorizationResponseId": {
            "type": "string"
          },
          "ErrorCode": {
            "type": "string"
          },
          "ErrorMessage": {
            "type": "string"
          },
          "OrderStatus": {
            "type": "string"
          },
          "OrderNumber": {
            "type": "string"
          },
          "Pan": {
            "type": "string"
          },
          "Amount": {
            "type": "integer"
          }
        }
      },
      "OrderFailureResponse": {
        "required": [
          "errorCode",
          "errorMessage"
        ],
        "type": "object",
        "properties": {
          "errorCode": {
            "type": "integer"
          },
          "errorMessage": {
            "type": "string"
          }
        }
      }
    }
  }
}

The OrderStatus object

{
  "openapi": "3.0.0",
  "info": {
    "title": "BomaPay API",
    "version": "1.0.0"
  },
  "components": {
    "schemas": {
      "OrderStatus": {
        "required": [
          "userName",
          "password"
        ],
        "type": "object",
        "properties": {
          "userName": {
            "type": "string"
          },
          "password": {
            "type": "string"
          },
          "orderId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32
          }
        }
      }
    }
  }
}