curl -X POST https://payx.company/api/v1/submit-otp \
-H "x-api-key: px_live_v2_YOUR_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{
"transactionId": "sample_tx_12345678",
"otp": "123456"
}'
const { PayX } = require('payx-node');
const payx = new PayX({ apiKey: process.env.PAYX_SECRET_KEY });
const res = await payx.charge.submitOtp({
transactionId: 'sample_tx_12345678',
otp: '123456'
});
console.log('Result:', res.status);
{
"message": "OTP verified successfully",
"transactionId": "sample_tx_12345678",
"status": "SUCCESSFUL"
}
API Reference
Submit OTP / Voucher
Submit a one-time passcode or authorization voucher for transactions requiring verification
POST
/
submit-otp
curl -X POST https://payx.company/api/v1/submit-otp \
-H "x-api-key: px_live_v2_YOUR_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{
"transactionId": "sample_tx_12345678",
"otp": "123456"
}'
const { PayX } = require('payx-node');
const payx = new PayX({ apiKey: process.env.PAYX_SECRET_KEY });
const res = await payx.charge.submitOtp({
transactionId: 'sample_tx_12345678',
otp: '123456'
});
console.log('Result:', res.status);
{
"message": "OTP verified successfully",
"transactionId": "sample_tx_12345678",
"status": "SUCCESSFUL"
}
Authentication
This endpoint requires your v2 secret API key:- Header:
x-api-key: px_live_v2_...orAuthorization: Bearer px_live_v2_...
Body Parameters
string
required
The transaction ID requiring OTP verification.
string
required
The one-time passcode or authorization voucher code provided by the customer.
Response
string
Status message describing the verification attempt.
string
The unique transaction ID.
string
The updated transaction status (e.g.
PENDING, SUCCESSFUL, FAILED).curl -X POST https://payx.company/api/v1/submit-otp \
-H "x-api-key: px_live_v2_YOUR_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{
"transactionId": "sample_tx_12345678",
"otp": "123456"
}'
const { PayX } = require('payx-node');
const payx = new PayX({ apiKey: process.env.PAYX_SECRET_KEY });
const res = await payx.charge.submitOtp({
transactionId: 'sample_tx_12345678',
otp: '123456'
});
console.log('Result:', res.status);
{
"message": "OTP verified successfully",
"transactionId": "sample_tx_12345678",
"status": "SUCCESSFUL"
}