Overview
This node integrates with the PhonePe Payment API to perform various payment-related operations, including creating payment links, checking payment status, initiating refunds, and verifying the authenticity of PhonePe webhook callbacks. It is useful for automating payment workflows, monitoring transaction statuses, handling refunds, and ensuring webhook security in payment processing systems.
Use Case Examples
- Creating a payment link for a customer to complete a transaction.
- Checking the status of a payment to confirm if it was successful or failed.
- Initiating a refund for a previously completed payment.
- Verifying the authenticity of webhook callbacks received from PhonePe to ensure they are legitimate.
Properties
| Name | Meaning |
|---|---|
| Test Mode (Sandbox) | Whether to use the PhonePe Sandbox environment for testing the API calls. |
| Webhook Payload (Base64) | The base64-encoded request body received from the PhonePe webhook callback, used for verification. |
| X-VERIFY Header | The X-VERIFY header value received from the PhonePe webhook, used to verify the webhook's authenticity. |
Output
JSON
isValid- Boolean indicating if the webhook signature is valid.status- Verification status string, either 'VERIFIED' or 'INVALID'.message- Human-readable message about the webhook verification result.webhookData- Parsed JSON object of the decoded webhook payload or an error message if decoding fails.
Dependencies
- Requires an API key credential for PhonePe API authentication, including saltKey, saltIndex, and merchantId.
Troubleshooting
- Ensure the webhook payload is correctly base64-encoded before inputting it into the node.
- Verify that the X-VERIFY header value matches the signature generated using the provided saltKey and saltIndex; mismatches indicate invalid webhook signatures.
- Check that the API credentials (saltKey, saltIndex, merchantId) are correctly configured to avoid authentication errors.
- For the 'verifyWebhook' operation, if the webhook payload cannot be decoded or parsed, the node outputs an error message in the webhookData field.