3. Debit Debit Pay

Description

• Merchant Debit Debit Pay

Request URL

• /api/jt/direct/debit/pay

Request Method

• POST

Request Headers

Parameter Name	Required	Type	Description
Content-Type	Yes	string	application/json

Request Body Parameters

Parameter Name	Required	Type	Description
appId	Yes	string	Application APPID
appName	Yes	string(1-100)	Merchant application name
timestamp	Yes	long	Current timestamp (milliseconds)
mchOrderId	Yes	string(1-32)	Merchant order, format: letters+numbers, 1-32 characters
amount	Yes	long	Collection amount (unit: cents)
channelCode	Yes	string	Platform collection channel code
payToken	Yes	string	Direct debit Token
customerName	No	string(1-128)	Payer name
email	No	string(1-128)	Payer email
mobile	No	string(11)	Payer phone number(09 followed by 9 digits)
callbackUrl	Yes	string(1-256)	Merchant transaction notification URL
remark	No	string(1-256)	Collection remark
sign	Yes	string	Signature, refer to Signature Algorithm

Request Body Example

{
  "appId": "f90addc4861540ef9312e87d8f360e08",
  "appName": "Merchant App",
  "timestamp": 1704067200000,
  "mchOrderId": "DD20240101120000",
  "amount": 10000,
  "channelCode": "JTWALLET_DIRECT_DEBIT",
  "payToken": "tok_abcdef1234567890",
  "customerName": "John Doe",
  "email": "johndoe@example.com",
  "mobile": "09123456789",
  "callbackUrl": "https://merchant.com/notify/direct-debit",
  "remark": "Monthly subscription payment",
  "sign": "afejafe15af4e8953f1a352ds4156f456ea1253f1d5a456fea13fd45a"
}

Response Parameters

Parameter Name	Type	Description
code	integer	Response code
message	string	Response message
data	Object	Data

data Parameters

Field	Type	Description
mchOrderId	string	Merchant order number
transactionId	string	Transaction serial number
transactionStatus	string	Transaction status (e.g., PENDING)
channelType	string	Payment channel type (e.g., DIRECT_DEBIT)
channelCode	string	Channel code (e.g., JTWALLET_DIRECT_DEBIT)

Response Example

{
  "code": 10000,
  "message": "Success",
  "data": {
    "mchOrderId": "DD20240101120000",
    "transactionId": "TXN20240101120000123456",
    "transactionStatus": "PENDING",
    "channelType": "DIRECT_DEBIT",
    "channelCode": "JTWALLET_DIRECT_DEBIT"
  }
}

Response Failure Example see reference

{
  "code": 1002,
  "message": "merchant white ip forbidden"
}