[PayIn] INR Payment Data

For shops with INR currency, when creating a payin (POST /api/v1/payins) the following fields may be sent in the paymentData object.

Supported fields in paymentData

Parameter	Type	Required	Description
holder	string	No	Customer or payer name.
mobile_number	string	No	Customer mobile number.
email	string	No	Customer email.

Example request body

{
  "external_id": "PIN-INR-001",
  "amount": 5000.00,
  "currency": "INR",
  "shop_code": "your_inr_shop",
  "merchant_user_id": "merchant-user-001",
  "merchant_user_ip": "203.0.113.10",
  "paymentData": {
    "holder": "Rahul Sharma",
    "mobile_number": "9876543210",
    "email": "info@test.com"
  }
}

Response fields

Parameter	Type	Description
id	number	TrustedPay operation ID.
status	string	Current payin status.
external_id	string	Unique payin identifier from the request.
amount	number	Payin amount.
currency	string	Payin currency.
shop_code	string	Shop code used for routing.
merchant_user_id	string	Merchant user identifier from the request.
merchant_user_ip	string	User IP from the request.
payment_page_url	string	URL of the hosted payment page.
payment_page_expires_at	string	Hosted payment page expiration timestamp.
transaction_type	string	Always payin.
created_at	string	Creation timestamp.
updated_at	string	Last update timestamp.
finalization_date	string	Returned when the payin reaches a final status.

Example response body

{
  "id": 12345,
  "status": "pending",
  "external_id": "PIN-INR-001",
  "amount": 5000,
  "currency": "INR",
  "shop_code": "your_inr_shop",
  "merchant_user_id": "merchant-user-001",
  "merchant_user_ip": "203.0.113.10",
  "payment_page_url": "https://api.trustedpay.one/public/payin-pages/pay_12345",
  "payment_page_expires_at": "2025-12-05T10:15:00.000000Z",
  "transaction_type": "payin",
  "created_at": "2025-12-05T10:00:00.000000Z",
  "updated_at": "2025-12-05T10:00:00.000000Z"
}

For INR payment-page payins, request paymentData is used during initiation and is not echoed in the create response.

If holder, mobile_number or email is provided in paymentData, it must be a valid string value.

← Back to PayIn