Overview
The PayFabric integration provides a ready-made function you can call when building mappings. It checks whether a payment method exists in iPaaS.com, so you do not have to write that check yourself in a formula.
Where you can use these functions
These functions are available anywhere you write a formula for the PayFabric integration:
Dynamic Formula mappings: where a destination field's value is produced by a formula rather than mapped directly from a source field.
Mapping collection filters: where a formula decides whether a record should be processed.
Error filters: a mapping collection's error filter, which sits alongside its collection filter. When the error filter's formula resolves to true, the transfer raises an error that is held in the Error Logs for review and is not retried automatically.
Translation collections: where a translation entry uses a formula as its source value.
How to use them
Call a function by name and pass the values it needs in parentheses, for example:
await IsValidPaymentMethod(SourcePaymentMethod).Each function's signature shows its name, the parameters it accepts (with their types), and the type of value it returns. Use it as the reference for exactly how to call the function.
Function names and formula syntax are case-sensitive, so type each name exactly as shown. Whether the values a function matches are treated as case-sensitive varies by function, and is called out in the relevant parameter's description.
Every function that returns a
Taskis asynchronous and must be called withawait, as shown in each How to call it example.The function runs at sync time, against the data in your connected PayFabric account and your iPaaS.com subscription.
The functions are grouped below by the area of the integration they support.
Payments
IsValidPaymentMethod
What it does: Checks whether a payment method with the given name exists in iPaaS.com.
Signature: Task<bool> IsValidPaymentMethod(string name)
How to call it: await IsValidPaymentMethod(name)
Parameter | Type | Required | Default | Description |
|
| Yes | N/A | The payment method name to check for in iPaaS.com. |
Returns: bool. true if a payment method with that name exists in iPaaS.com; otherwise false, including when the name is null or the lookup cannot be completed.
Example: "Visa" returns true when a payment method named Visa exists in iPaaS.com.
When to use it: Use this on a mapping collection filter for a To iPaaS flow so a record only processes when its payment method already exists in iPaaS.com. If the payment method does not exist, create it in iPaaS.com first.