Description: Initiates a payout from merchant to customer via secure banking channels.
https://stanzape.com/api/uat/payout/init/
Content-Type: application/json
"X-Signature: " . base64_encode(hash_hmac('sha256', $json_body, $shared_secret, true))
| Language | Core Logic |
|---|---|
| Node.js | crypto.createHmac('sha256', key).update(message).digest('base64') |
| Python | base64.b64encode(hmac.new(key, msg, hashlib.sha256).digest()).decode() |
| Java | Base64.getEncoder().encodeToString(mac.doFinal(message.getBytes())) |
| PHP | base64_encode(hash_hmac('sha256', $message, $key, true)) |
{
"orderdata": {
"orderid": "ORD2025010112562223",
"userid": "1111199999",
"mobile": "1111199999",
"email": "test@gmail.com"
},
"paymentdata": {
"amount": 500.00,
"currency": "INR",
"bankaccnum": "XXXXXXXXXX90",
"ifsccode": "HDFC0000000",
"accholdername": "Holder Name",
"mode": "IMPS"
},
"merchantdata": {
"mid": "XXXXXX02",
"authkey": "XXXXXXXXXXXXXXstanzakey"
}
}
{
"status": "STANZA001",
"message": "Payout Initiated successfully",
"payout_id": "TXN1234567890"
}
{
"status": "STANZA002",
"message": "Error Msg"
}
| Field | Type | Required | Description |
|---|---|---|---|
| orderid | String | Yes | Unique order reference |
| userid | String | Yes | Customer or User ID |
| mobile | String | Yes | Customer phone number |
| String | Yes | Email address of customer | |
| amount | Decimal | Yes | Amount to transfer |
| currency | String | Yes | Currency (e.g., INR) |
| bankaccnum | String | Yes | Bank account number |
| ifsccode | String | Yes | Bank IFSC code |
| accholdername | String | Yes | Name of account holder |
| mode | String | Yes | Transfer mode (IMPS, NEFT, RTGS) |
| mid | String | Yes | Merchant ID issued by StanzaPe |
| authkey | String | Yes | Authentication token |
| Status | Code | Meaning |
|---|---|---|
| ✅ | STANZA001 | Request processed successfully |
| ⚠️ | STANZA002 | Bad Request – Invalid or missing params |
| 🔐 | STANZA003 | Unauthorized – Invalid auth key |
| 💥 | STANZA004 | Server error – try again later |
Include an X-Signature header, generated using HMAC SHA256 with your shared secret.
"X-Signature: " . base64_encode(hash_hmac('sha256', $json_body, $shared_secret, true))
Once the transaction is completed, we send a callback to your webhook URL.
{
"status": "STANZA001",
"message": "Callback Sent Successfully",
"data": {
"orderid": "ORD2025010112562223",
"status": "TXN_SUCCESS",/"TXN_FAILURE",/"PENDING",
"amount": "500",
"utr": "15219934"
}
}
Description: Check the transaction status using the orderid.
https://stanzape.com/api/uat/payout/status/
Content-Type: application/json
"X-Signature: " . base64_encode(hash_hmac('sha256', $json_body, $shared_secret, true))
{
"request": {
"orderid": "ORD2025010112562223"
},
"merchantdata": {
"mid": "XXXXXX02",
"authkey": "XXXXXXXXXXXXXXstanzakey"
}
}
{
"status": "STANZA001",
"message": "Order Found",
"order": {
"orderid": "ORD2025010112562223",
"amount": "500.00",
"status": "TXN_SUCCESS",/"TXN_FAILURE",/"PENDING",
"created_at": "2025-07-23T22:15:00+05:30",
"utr": "15219934"
}
}
{
"status": "STANZA002",
"message": "Order not found"
}
If you're facing issues or need integration support, Email: support@stanzape.com or connect with our team.