Skip to main content

​
Endpoint

POST /v1/partner/createCollectRequest

​
Example: Axios POST Request

await axios.post(
  "https://api.upitranzact.com/v1/partner/createCollectRequest",
  {
	pid: "Your Partner ID", // eg. PABC
    mid: "Your Merchant ID", // Example: ABC
    amount: "Numeric value between 1-100000", // Example: 200
    merchantReferenceId: "Unique order ID", // Example: ORD12345 (optional)
    vpa: "Customer UPI Id", // Example: upiId@oksbi
    customer_name: "John",
    customer_email: "[email protected]",
    customer_mobile: "Your Customer Mobile", // Must be a valid phone number
  },
  {
    headers: {
      Authorization: "Basic base64(public_key:secret_key)"
    }
  }
);

​
Key Parameters

  • pid: Your partner identifier.
  • mid: Your merchant identifier.
  • amount: Must be a numeric value between 1 and 100000.
  • merchantReferenceId: A unique string for transaction tracking (optional).
  • vpa: UPI ID of the customer.
  • customer_name: Full name of the customer.
  • customer_email: A valid email address.
  • customer_mobile: A valid mobile number.
  • Authorization: Must be in the format Basic base64(public_key:secret_key).
Make sure to replace placeholder values with actual data before executing.

​
Headers

NameValue
Content-Typeapplication/x-www-form-urlencoded
AuthorizationBasic base64(public_key:secret_key)

​
Request Body Parameters

NameTypeDescriptionExampleRequired
pidstringYour Partner IDPABCYes
midstringMerchant IDABCYes
amountintegerThe total amount100Yes
merchantReferenceIdstringUnique identifier for the orderORD12345Yes
vpastringCustomer UPI IDupiId@oksbiYes
customer_namestringCustomer’s full nameJohnYes
customer_emailstringCustomer’s email address[email protected]Yes
customer_mobilestringCustomer’s mobile number0123456789Yes

​
Authorization

Requests must include the Authorization header with a Base64-encoded string of public_key:secret_key. Example Format: 
Authorization: Basic base64(public_key:secret_key)
Example Encoded Header: 
Authorization: Basic eW91cl9wdWJsaWNfa2V5OnlvdXJfc2VjcmV0X2tleQ==

​
Response Body

{
    "status": true,
    "statusCode": 200,
    "msg": "Collect request created successfully",
    "data": {
        "expiry": "2026-01-25T16:23:56+05:30",
        "amount": "100",
        "order_id": "ORD12345"
    }
}