Payfunnels icon

Payfunnels

Payfunnels

Actions4

Overview

This node integrates with the Payfunnels API to manage payments and subscriptions. Specifically, for the Payment Refund operation, it allows users to refund a specified amount of a payment by providing the payment ID, refund amount, and reason. This is useful in scenarios such as handling customer refund requests, correcting duplicate charges, or addressing fraudulent transactions.

Practical examples include:

  • Refunding a customer who requested a return.
  • Reversing a duplicate payment made by mistake.
  • Marking a payment as refunded due to suspected fraud.

Properties

Name Meaning
Payment ID The unique identifier of the payment to be refunded.
Amount The monetary amount to refund from the original payment.
Reason The reason for the refund. Options: Duplicate, Fraudulent, Requested By Customer.

Output

The node outputs JSON data representing the response from the Payfunnels API after attempting the refund. This typically includes details about the refund transaction such as status, refunded amount, and any relevant metadata returned by the API.

No binary data output is produced by this operation.

Example output structure (simplified):

{
  "id": "refund_transaction_id",
  "paymentId": "original_payment_id",
  "amount": 100,
  "reason": "requested_by_customer",
  "status": "success",
  "createdAt": "2024-01-01T12:00:00Z"
}

Dependencies

  • Requires an active API key credential for authenticating with the Payfunnels API.
  • The node makes HTTP requests to https://api.payfunnels.com/n8n-integration.
  • Proper network access to the Payfunnels API endpoint is necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing Payment ID will cause the refund request to fail.
    • Attempting to refund an amount greater than the original payment may result in an error.
    • Network connectivity problems can prevent successful API calls.
    • Insufficient permissions or invalid API credentials will cause authorization errors.

  • Error messages:

    • Errors returned from the API are captured and surfaced by the node.
    • If the node is set to continue on failure, errors are included in the output JSON under an error field.
    • To resolve errors, verify that the Payment ID exists, the refund amount is valid, and the API key is correct and has sufficient permissions.

Links and References

Discussion