4.3 Create Order API (Online Payment)

POST

/pay/v1/createOrder

Creates an order in the system and returns the order reference number and the calculated MDR with the payment gateway URL. The client application will be responsible for the redirection.

Request

Body Params application/json

Example

{
    "mchId": "28",
    "data": {
        "msgId": "2018214458600173569882",
        "mchId": "8600001",
        "apiCode": "UN1001",
        "trxAmount": "100",
        "type": "Purchase",
        "redirectSuccessUrl": "https://api.uat.unionmeta.io/pay/redirectSuccess",
        "redirectFailureUrl": "https://api.uat.unionmeta.io/pay/redirectFailure",
        "notifyUrl": "https://api.uat.unionmeta.io/pay/notify/merchantCallback",
        "timeExpire": 3600,
        "currency": "PHP",
        "orderItems": [
            "Product Info 1",
            "Product Info 2"
        ]
    },
    "sign": ""
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/pay/v1/createOrder' \
--header 'Content-Type: application/json' \
--data-raw '{
    "mchId": "28",
    "data": {
        "msgId": "2018214458600173569882",
        "mchId": "8600001",
        "apiCode": "UN1001",
        "trxAmount": "100",
        "type": "Purchase",
        "redirectSuccessUrl": "https://api.uat.unionmeta.io/pay/redirectSuccess",
        "redirectFailureUrl": "https://api.uat.unionmeta.io/pay/redirectFailure",
        "notifyUrl": "https://api.uat.unionmeta.io/pay/notify/merchantCallback",
        "timeExpire": 3600,
        "currency": "PHP",
        "orderItems": [
            "Product Info 1",
            "Product Info 2"
        ]
    },
    "sign": ""
}'

Responses

🟢200

application/json

Body

Example

{
  "message": "",
  "data": {
    "msgId": "2018214458600173569882",
    "orderNo": "2021049602470023169364",
    "paymentGatewayUrl": "https://uat-payments.starpay.com.ph/9cdbcde04c0c0a4e04a025c1fb3fbddf/v1/login?uuid=e3af20d918a143c3ac4f3c495d828e29&orderReferenceNumber=OR%2347F3K&amount=151.50&signature=JDJhJDEwJFVYZElsd0J2T3dFY0RUWmRlbHQ4Yi5GTXVaSHN3ZEZ2OFQvME9CRHBUQVFETURvQ2ZnT0xh",
    "trxState": "unpaid",
    "trxAmount": "100",
    "mdrAmount": "0.5",
    "message": "success"
  },
  "code": ""
}

Modified at 2026-03-11 08:30:13

4.2 Payment Result Callback (Static QR)

4.4 Create Order API (Generate QR)