Actions10
Overview
The node integrates with the Cryptomus API to manage cryptocurrency payments. It supports various operations including creating payments, retrieving payment details, refunding payments, and managing webhooks. The "Refund Payment" operation specifically allows users to refund a payment by specifying the payment identifier and refund details.
This node is useful in scenarios where businesses or services accept cryptocurrency payments and need to automate payment management tasks such as issuing refunds, checking payment statuses, or handling payment notifications. For example, an e-commerce platform can use this node to refund customers directly to their wallet addresses when orders are canceled or returned.
Properties
| Name | Meaning |
|---|---|
| Identifier Type | Type of identifier used to find the payment. Options: "Payment UUID", "Order ID". |
| Payment ID | The unique identifier of the payment, either UUID or Order ID depending on the above. |
| Refund Address | Wallet address where the refunded funds will be sent. |
| Refund Amount | Amount to refund. If left empty, the entire payment amount will be refunded. |
| Test Payment | Boolean flag indicating whether the payment is for testing purposes (true/false). |
Output
The output is a JSON object containing the response from the Cryptomus API related to the refund operation. This typically includes confirmation of the refund request, status information, and any relevant metadata returned by the API.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential configured with access to the Cryptomus Payment API.
- The node uses HTTP requests to communicate with the Cryptomus API endpoints.
- Proper API credentials must be set up in n8n with permission to perform payment-related actions.
Troubleshooting
- Invalid Credentials Error: If the provided API credentials do not have the correct API type (must be for payment), the node throws an error indicating the wrong API type. Ensure that the credentials used are specifically for the payment API.
- Missing Required Parameters: Errors may occur if required fields like Payment ID, Refund Address, or Identifier Type are missing or invalid. Double-check input values.
- API Request Failures: Network issues or incorrect API endpoint usage can cause failures. Review the error message returned by the API for guidance.
- Refund Amount Issues: If the refund amount exceeds the original payment or is formatted incorrectly, the API may reject the request. Use valid numeric strings and ensure the amount does not exceed the paid amount.
Links and References
- Cryptomus API Documentation (for detailed API endpoint descriptions and parameters)
- n8n Documentation on Creating Custom Nodes