Query payin

The payin flowchart

Request URL

https://gateway.pay247.io/gateway/payin/query

Request Method

POST timestamp must be an integer; examples use milliseconds. Use v3.0 for version. Calculate sign as described in Signature. All merchant requests to the gateway must include uuid and include it in the signature. The response uuid comes from the request header or the server and need not match the request body.

Request fields

Field	Required	Type	Description
`mch_id`	Yes	string	Merchant ID
`mch_order_no`	Yes	string	Merchant order number
`timestamp`	Yes	integer	Timestamp
`version`	Yes	string	Use v3.0
`uuid`	Yes	string	Request ID
`sign`	Yes	string	Signature

{
  "mch_id": "MCH12345678",
  "timestamp": 1693233334134,
  "version": "v3.0",
  "uuid": "550e8400-e29b-41d4-a716-446655440000",
  "sign": "<computed signature>",
  "mch_order_no": "PAYIN-1001"
}

Successful response data

Field	Required	Type	Description
`mch_id`	Yes	string	Merchant ID that owns the order
`mch_order_no`	Yes	string	Order number supplied by the merchant
`order_no`	Yes	string	Platform order number generated by Pay247
`currency`	Yes	string	Order currency
`pay_method`	Yes	string	Selected payment method code
`pay_theme`	Yes	string	Payment theme, usually link or custom
`amount`	Yes	string	Order amount in the order currency
`fee`	Yes	string	Order fee in the order currency
`status`	Yes	string	PENDING, DEALING, TIMEOUT, CLOSED, SUCCESS, FAIL, REFUND, UNDERPAID, OVERPAID
`utr`	Yes	string	Transaction reference; empty if unavailable
`error`	Yes	string	Error, possibly empty
`actual_amount`	No	string	Returned on success, underpayment, or overpayment
`pay_url`	Conditional	string	Returned when custom theme is not used and the channel does not force custom details; may be empty before ready
`pay_params`	Conditional	object or empty string	Custom payment details; returned for custom mode or channels allowing it, with channel-specific content; may be empty before ready
`network`	CRYPTO only	string	Crypto network code; returned only for CRYPTO orders
`to_address`	CRYPTO only	string	Destination wallet address; returned only for CRYPTO orders and may be empty before assignment
`confirmations`	CRYPTO only	integer	On-chain confirmation count; returned only for CRYPTO orders
`transaction_hash`	CRYPTO only	string	On-chain transaction hash; returned only for CRYPTO orders and empty before available

{
  "code": 0,
  "message": "success",
  "uuid": "550e8400-e29b-41d4-a716-446655440000",
  "timestamp": 1693233334135,
  "data": {
    "mch_id": "MCH12345678",
    "mch_order_no": "PAYIN-1001",
    "order_no": "PI202609280001",
    "currency": "INR",
    "amount": "99.11",
    "pay_method": "UPI",
    "fee": "1.00",
    "pay_theme": "link",
    "utr": "",
    "error": "",
    "status": "PENDING",
    "pay_url": "https://checkout.example/pay/PI202609280001"
  }
}

For example (Custom) Support INR: query response

This retains the original example’s fee, utr, and pay_params, which belong to the query response.

{
  "code": 0,
  "message": "success",
  "uuid": "219bf2a2-8994-4ab0-b850-a5c1c70316e5",
  "timestamp": 1756736237009,
  "data": {
    "mch_id": "MCH12345678",
    "mch_order_no": "1119132492",
    "order_no": "PI202509012031309225639045",
    "currency": "INR",
    "amount": "23000.00",
    "pay_method": "UPI",
    "fee": "1495.00",
    "pay_theme": "custom",
    "utr": "395141536523",
    "error": "",
    "status": "PENDING",
    "pay_params": {
      "payee_name": "AJ ENTERPRISE",
      "payee_account_no": "ajenter66@sbi",
      "payee_bank_name": "",
      "payee_branch_name": "",
      "qr": "upi://pay?pa=ajenter66@sbi&pn=AJ ENTERPRISE&tn=O04T&am=22999.48&cu=INR&featuretype=money_transfer",
      "payee_phone": ""
    }
  }
}

For example: successful payin

{
  "code": 0,
  "message": "success",
  "uuid": "7eb3c9e-5a1d-4a19-be2a-c80eac39830a",
  "timestamp": 1594099906123,
  "data": {
    "mch_id": "MCH12345678",
    "mch_order_no": "Test20200707042747519753974848",
    "order_no": "P20200707042747519753974832",
    "currency": "USD",
    "amount": "99.11",
    "actual_amount": "99.11",
    "pay_method": "BANK",
    "fee": "1.99",
    "pay_theme": "link",
    "utr": "",
    "error": "",
    "pay_url": "https://pay.xxx.com/link/DyDpCjDfkr",
    "status": "SUCCESS"
  }
}

Quickstart

Balance

Payin

Payout

Reference

The payin flowchart

Request URL

Request Method

Request fields

Successful response data

For example (Custom) Support INR: query response

For example: successful payin

​The payin flowchart

​Request URL

​Request Method

​Request fields

​Successful response data

​For example (Custom) Support INR: query response

​For example: successful payin

The payin flowchart

Request URL

Request Method

Request fields

Successful response data

For example (Custom) Support INR: query response

For example: successful payin