NATS4 Payoneer
NATS4 now offers the ability to send affiliate payouts with the new pay via type, Payoneer. This allows you to pay your affiliates for referrals they have made by depositing their payment directly into a Payoneer Prepaid Mastercard card.
Note: If you do not see Payoneer as an available Pay Via Type in NATS, please put in a support ticket, as you may need to upgrade to the latest version of NATS4.
Setting Up Payoneer in NATS
To begin setting up your new Payoneer pay via type in NATS, go to the Payments Admin, and click the "Pay Via Types" tab at the top of the page. This will bring you to your list of Currently Configured Affiliate Payment (Pay Via) Types.
If you do not see Payoneer in this list, you will need to upgrade your installation of NATS4 to the latest version. Please put in a support ticket requesting integration of the Payoneer Pay Via Type if you do not see this.
Payoneer will be disabled by default in the Payments Admin. To enable this pay via type for your affiliate payouts, click the "Enable Payoneer by Default" action icon, which is marked by a green arrow.
Once you enable your new Payoneer Pay Via Type, you can begin customizing your pay via type settings. Click the "Edit Payoneer Details" action icon to customize your new pay via type.
Here, you can change a variety of values and settings for your Payoneer. This includes:
- Description - Provides an internal description of this pay via type for administrators. This is not seen by affiliates.
- Minimum Payout - A comma-separated list of the minimum payout amounts that affiliates can choose to receive payouts for. Affiliates will not receive payouts unless they reach one of these minimum amounts here.
- Cost(+)/Bonus(-) - The dollar amount added or subtracted from the affiliate payout for using this Pay Via Type each time the affiliate is sent a payment.
- Dump Format - Defines the format you want NATS to use to build a dump of your stored Payoneer payments.
- Enabled - Choose if you want this pay via type to be available to all affiliates by default.
Click Save once you have finished configuring the available options. You can also keep the default settings if you wish -- these are set up to be fully functional as well.
Setting Up Rules
You can also choose to only enable this pay via type for certain affiliates with the Rules feature if you wish. Just click the "Edit Payoneer Rules" action icon to do so.
If you want to enable Payoneer for some affiliates and disable it for everyone else, create a "DISABLE" rule for ALL affiliates. After you save that rule, simply create "ENABLE" rules for the affiliates or countries that you want to provide with Payoneer functionality. You can create a rule for multiple affiliates at once with the Advanced Form here.
If you want to disable Payoneer for some affiliates and enable it for everyone else, create an "ENABLE" rule for ALL affiliates. After you save that rule, simple create "DISABLE" rules for the affiliates or countries that you do NOT want to provide with Payoneer functionality. You can create a rule for multiple affiliates at once with the Advanced Form here.
Converting Your Dump Format
Although Payoneer can process transactions for members from any country, the Payoneer system only accepts USD as a default currency type. If you use USD (US Dollars) as your default currency type for your Payment Dumps, just go to the Payments Admin and scroll down to the "Stored Payments" section of this page. Click the "View Payoneer Payment Dump" action icon, and you will see the data for your Payoneer payments on the page that pops up.
If you do not use USD (US Dollars) as your default currency type for your Payment Dumps, you will need to convert all of the dollar amounts in your Payment Dumps to your desired currency type. To do this, go to the Payments Admin and click the "Dump Formats" tab at the top of the page. NATS does not allow you to edit your default Payment Dump Formats, so you will need to duplicate an existing one first. Find the Dump Format you want to use with Payoneer (such as the Payoneer dump format), and click the "Create Duplicate Format" action icon.
You will then need to configure your new duplicate dump format with the Smarty code necessary to perform currency conversions. For example, if you wish to convert all of your USD (US Dollar) values to EUR (Euros), enter the following code into the "Entry Header" field:
{$affiliate.payvia.Email_with_Payoneer},{math equation="(x*y)/z" x=$total.total_amount y=$config.RATE_EUR_TO_USD z=100 assign=convert_total}{$convert_total|string_format:'%.2f'},USDConvert,Payment{$entry.paymentid},{$entry.memo},{$smarty.now|date_format:'%D'}
If you want to convert your USD (US Dollar) values to any other currency, simply replace the "EUR" in $config.RATE_EUR_TO_USD in the above example with the short name of the currency type you wish to use. For example, you can convert USD to CAD (Canadian Dollars), GBP (British Pounds), JPY (Japanese Yen), etc.
The equation listed above uses the currency conversion settings defined in NATS. To update your currency exchange rates, go to the Configuration Admin and go to the "Currency - All" section. You'll see individual sections for each currency type that is available in NATS. Find the currency type you want to convert to, and enter the current conversion rate into the RATE_XXX_TO_USD field. Once you've entered the most recent currency conversion rates for the currency types you want to do, save your changes.
