Overview
The Numi Payment Methods node allows you to retrieve available payment methods for a user based on their phone number. This is useful in workflows where you need to dynamically fetch or filter payment options for users, such as during onboarding, payment processing, or customer support scenarios.
Example use cases:
- Displaying available payout methods to a user before initiating a transaction.
- Filtering payment methods by name for targeted operations.
- Integrating with other systems that require knowledge of a user's available payment options.
Properties
| Name | Meaning |
|---|---|
| Operation | Selects the action to perform. Options: "Get Payment Methods" (fetches Numi payment methods) |
| User Phone Number | The user's telephone number used to obtain their available payment methods. (Required) |
| Payment Method Name | (Optional) Filter results by a specific payment method name. |
Output
The node outputs a JSON object with the following structure:
{
"paymentMethods": [
{
// Payment method details (structure depends on API response)
"name": "Method Name",
// ...other fields
}
// ...more methods
],
"response_paymentMethods": {
"message": " List of payment method names separated by dashes and line breaks"
}
}
- paymentMethods: An array containing one or more payment method objects as returned by the underlying service.
- response_paymentMethods.message: A string summarizing the names of the payment methods found.
Dependencies
- External Service: Requires access to the Numi partner service via the
PartnerServiceFactory. - Credentials: Needs a configured credential named
numiKeyApiin n8n for authentication.
Troubleshooting
Common issues:
- Missing or invalid credentials: If the
numiKeyApicredential is not set up or is incorrect, the node will fail to connect to the Numi service. - Invalid or missing phone number: The "User Phone Number" property is required. If omitted or invalid, the node may return an error or empty result.
- Payment method not found: If a specific "Payment Method Name" is provided but does not exist for the user, the output may contain an empty array or undefined values.
Error messages and resolutions:
- Authentication failed: Check your
numiKeyApicredentials in n8n. - No payment methods found: Verify the phone number is correct and that the user has available payment methods.
- Cannot read property 'name' of undefined: This may occur if a non-existent payment method name is specified. Double-check the spelling and availability.
Links and References
- n8n Documentation: Credentials
- n8n Documentation: Custom Nodes
- (If available) Numi API documentation (contact your Numi partner representative for access)