Create Payment
/payin/v1/createPayment
Create payment
Request
Header Parameters
content-type
string
REQUIRED
Fixed value: application/json
x-api-key
string
REQUIRED
Provided by Paydify, same as appId
x-api-timestamp
string
REQUIRED
Timestamp in milliseconds
x-api-signature
string
REQUIRED
Signature, see the signature algorithm
Body
mchTxnId
string
REQUIRED
Merchant order ID, maximum 60 characters
txnAmount
string
REQUIRED
Order amount, e.g. 100.23
currency
string
REQUIRED
The currency of the order amount (txnAmount). What you may pass depends on the product type of your app (chosen once at onboarding; a mismatched currency is rejected, nothing is auto-converted): a stablecoin acquiring app passes USDT/USDC and the customer pays this exact amount; a fiat acquiring app passes USD/SGD, auto-converted to a stablecoin at the real-time rate (see paymentCurrency). Full list: Supported currencies and blockchains
paymentCurrency
string
Fiat acquiring only: which stablecoin (USDT/USDC) the fiat amount is converted into — the customer pays in it; defaults to the stablecoin configured for the app. Not needed for stablecoin acquiring apps. See Supported currencies and blockchains
checkoutMode
string
REQUIRED
Checkout mode, fixed value: MERCHANT
payMethod1
string
Wallet used for payment, see Supported wallets (API enums)
payMethod2
string
Blockchain used for payment, see Supported blockchains (API enums)
notificationUrl
string
Server-side callback URL for payment results, https only. Optional — when omitted, the webhook URL configured under merchant Portal - Developer - Webhook is used. Max 300 characters
successReturnUrl
string
Redirect URL after successful payment
failReturnUrl
string
Redirect URL after failed payment
pendingReturnUrl
string
Redirect URL during pending payment
source
string
Order source tag
txnTitle
string
Payment title
txnDesc
string
Payment description
accountInfo
array
toAddress
string
REQUIRED
Merchant receiving address; required and non-empty when the list element is present
network
string
Target blockchain network (e.g. ETH / BSC / SOL / TRX / BASE / KAIA), paired with toAddress; if omitted, falls back to outer payMethod2. Used for network resolution only when toAddress is non-empty. See Supported blockchains (API enums)
payerInfo
object
uid
string
Merchant-side user ID
mchExtInfo
string
Merchant extension information, JSON string, this field is passed through and returned in callbacks
lifetime
integer
Order timeout period in milliseconds, default 30 minutes
merchantId
string
Required when the service provider has more than one sub-merchant: pass the target MerchantID. You can find it under merchant Portal - Merchant Management. Max 60 characters
merchantAppId
string
Required when the service provider has more than one sub-merchant and more than one app ID: pass the target MerchantAppID. Max 64 characters
Response
Body
code
string
Response code, SYS_SUCCESS indicates success
message
string
Response message
messageDetail
string
Detailed response message
success
boolean
Whether the request was successful
data
object
txnId
string
Paydify order ID
mchTxnId
string
Merchant order ID
state
string
Payment status
errorMsg
string
Payment failure reason description
qrCode
string
Payment link QR code base64 data
deeplink
string
Native payment link
httplink
string
HTTP payment link
1
RESPONSE
Click the Send API Request button above and see the response here!