PMH - Request Transaction

Developing

VPay-DEV

POST

/api/transaction/requestTransaction

Last modified:2025-11-22 09:07:10

Request

Header Params

Body Params application/jsonRequired

Example

{
      "TITLESCREEN": "Pay Online Merchant",
      "LOGO": "https://minio-local.jitsinnovationlabs.com/baseline-dev-wallet-backend/Upload/merchant/5f19f2d2-c525-4672-8339-1786e490e04d.png",
      "RECEIVERNAME": "ONLINE MERCHANT",
      "SHOPNAME": "ONLINE MERCHANT",
      "SHOPID": "692132ee6ec7b6da5a82f0e2",
      "SENDERPHONE": "0962233764",
      "SENDERCLIENT": "customer",
      "RECEIVERPHONE": "0978264817",
      "RECEIVERCLIENT": "merchant",
      "SUBUSERPHONE": "0978264817",
      "SUBUSERCLIENT": "merchant",
      "TRANSACTIONID": "test1",
      "REFERENCENUMBER": "249144623847",
      "AMOUNT": 1000,
      "FEE": "",
      "SERVICEID": "60925be5230be21ac5e1087c",
      "EXPIREDDATE": "2025-11-22T07:55:23.870Z",
      "STATUS": "processing",
      "CURRENCY": "USD",
      "DEVICEID": "devicetest3",
      "MessageType": "FO",
      "SERVICECODE": "SUBSPAYONLINEMERCHANT",
      "RECEIVERUSERID": "692132eecb1c6cb446a4fb43",
      "VOUCHER": ""
    }

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/transaction/requestTransaction' \
--header 'Authorization: Bearer 8d5fcef4-f174-4fd6-8f68-899f0e1d651a' \
--header 'Content-Type: application/json' \
--data-raw '{
      "TITLESCREEN": "Pay Online Merchant",
      "LOGO": "https://minio-local.jitsinnovationlabs.com/baseline-dev-wallet-backend/Upload/merchant/5f19f2d2-c525-4672-8339-1786e490e04d.png",
      "RECEIVERNAME": "ONLINE MERCHANT",
      "SHOPNAME": "ONLINE MERCHANT",
      "SHOPID": "692132ee6ec7b6da5a82f0e2",
      "SENDERPHONE": "0962233764",
      "SENDERCLIENT": "customer",
      "RECEIVERPHONE": "0978264817",
      "RECEIVERCLIENT": "merchant",
      "SUBUSERPHONE": "0978264817",
      "SUBUSERCLIENT": "merchant",
      "TRANSACTIONID": "test1",
      "REFERENCENUMBER": "249144623847",
      "AMOUNT": 1000,
      "FEE": "",
      "SERVICEID": "60925be5230be21ac5e1087c",
      "EXPIREDDATE": "2025-11-22T07:55:23.870Z",
      "STATUS": "processing",
      "CURRENCY": "USD",
      "DEVICEID": "devicetest3",
      "MessageType": "FO",
      "SERVICECODE": "SUBSPAYONLINEMERCHANT",
      "RECEIVERUSERID": "692132eecb1c6cb446a4fb43",
      "VOUCHER": ""
    }'

Responses

🟢200OK

application/json

Body

Example

{
    "err": 0,
    "message": "string",
    "data": {
        "errorCode": 0,
        "errorMsg": "string",
        "amount": 0,
        "totalAmount": 0,
        "transRefId": "string",
        "totalFee": 0,
        "fees": [
            null
        ],
        "totalDiscount": 0,
        "discounts": [
            null
        ],
        "debitFee": 0,
        "creditFee": 0,
        "creditDiscount": 0,
        "debitDiscount": 0,
        "discountCalculating": [
            null
        ]
    },
    "display": [
        null
    ]
}

Modified at 2025-11-22 09:07:10

Decode QR

PMH - Confirm Transaction