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
REQUIRED
Payment result callback URL to merchant, only supports https
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
object
payerInfo
object
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
Merchant ID of the order owner (sub-merchant). Required when calling with a partner credential on behalf of a sub-merchant; can be omitted with a merchant-owned credential (defaults to the credential owner). Max 60 characters
merchantAppId
string
App ID under the owner merchant, used for disambiguation when the owner merchant has multiple authorized apps. Required if the credential covers multiple apps of the owner merchant; can be omitted when only one app is authorized (resolved automatically). 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!