AFEX Global Payments for Businesses

v 9.0 v 10.0 v 11.0 v 12.0 Third Party 169
Download for v 12.0 Deploy on
Required Apps Invoicing (account)
Lines of code 1857
Technical Name afex_integration
Also available in version v 11.0 v 10.0 v 9.0
You bought this module and need support? Click here!
Required Apps Invoicing (account)
Lines of code 1857
Technical Name afex_integration
Also available in version v 11.0 v 10.0 v 9.0

AFEX Global payments for businesses

AFEX is pleased to provide the Odoo community with a global payments app!

Fast, efficient payments to your global vendors in their local currencies!

At AFEX, we pioneered personalized foreign exchange. As one of the world's largest non-bank providers of global B2B payments and risk management solutions, we're a trusted partner to more than 35,000 businesses and individuals worldwide.

We facilitate payments in more than 100 currencies to 180 countries across the globe. Our solutions are cost-effective, secure and strategic. Our global payments infrastructure is supported by 40 years of cross-border payments and FX markets expertise.

Using the AFEX app, you can access a live exchange rate in virtually any currency, validate your vendor's banking details, and schedule your payment. Your vendors receive the correct amount in their currency, and you'll be able to see the cost in yours.


To make payments using the AFEX app you will need to set up a free, no obligation account with AFEX.

CLICK HERE and we'll contact you to complete your account set up and answer any questions you have about managing your global payments through AFEX.


With the AFEX app, you can automatically validate vendors' banking details

  • Enter the supplier's details and banking information.
  • After approval by AFEX, you can book your payments to the supplier.


  • Choose Vendor Bill(s) that require payment.
  • Select AFEX Payment as the payment method and obtain a quote for the foreign currency amount.
  • Validate the payment to book the foreign currency payment.
  • Transfer the quoted settlement amount from your bank or funding balance to AFEX to fund the payment.
  • AFEX sends the payment to the vendor via SWIFT—your vendor receives it within two business days.


Odoo v12 Instructions for Setup and Usage.


Use of AFEX services is subject to terms and conditions that vary by jurisdiction.
Please click on the link below to read the terms and conditions for your location.

AFEX Terms and Conditions

If you don't see your jurisdiction listed, click here to request a call back.

AFEX Global Payments for Businesses

Introduction (

This module allows vendor banks to be synchronised with AFEX to create AFEX Beneficiaries. It also allows payments within Odoo to book payments to vendors through AFEX.

You must have an AFEX account, and request/receive an API Key from AFEX before this module can be used. AFEX's terms and conditions apply.

AFEX homepage:

Setup for Odoo v12

  • Settings > Users & Companies > Companies > General Information Tab

    These settings must be set for each Odoo defined company which will trade with AFEX.

    • AFEX API Key Supplied by AFEX and entered here.
    • Allow Earliest Value Date Leave this disabled if your trade requests should always choose the Two business days rate. If you wish users to be able to choose Today or Next business day rates, then enable this option.
    • Default Value Date If users can choose rates other than Two business days, then this will be required to be the default rate.
  • Accounting > Configuration > Journals

    A new Cash/Bank Journal can be created which will be used for AFEX payments. A single journal will suffice if settlement will always be in the local currency. If settlement will be made in other currencies, then a journal will be required per currency. The settlement currency is the currency used to pay AFEX, not the currency used to pay the vendor.

    • Journal Entries
      • Default Debit / Credit Account G/L account for AFEX clearing. Should be set up as a non reconcilable liability account which is reviewed periodically. It could also be a revenue or expense account. The balance which accumulates in here will be the difference between the Odoo anticipated settlement from stored currency rates, and the actual settlement value to AFEX. It may be treated as a straight expense, or it may be allocated to other areas of the accounts.
      • Currency Leave blank for settlement in the company currency, or enter a currency if settling in another in-between currency. The payment will use the currency from here when posting to the clearing account defined above.
      • AFEX Journal Enabled.
      • AFEX Scheduled Payment If journal type is Bank, then this can be enabled to create transactions using pre-purchased funding balances.
      • AFEX Invoicing Partner This is the partner to which the liability will be posted when making an AFEX trade.
      • AFEX Fees Account Select an account for expensing AFEX fees.
      • Direct Debit Journal If this journal settles in Australian Dollars, then settlement can be by direct debit. Choose the Odoo Journal used for direct debit payments if you wish this to use this option. The account number for direct debit payments will be picked up from this journal.
      • Direct Debit by Default Enable this if you want direct debit to be the default settlement option.
    • Advanced Settings
      • For Incoming Payments None should be selected.
      • For Outgoing Payments Enable manual.
  • Partner > Accounting Tab > Bank Accounts

    Vendors have an option available against their bank accounts to allow them to be marked as bank accounts to be associated with AFEX. There should only be one for any currency for a given vendor.

    • AFEX Beneficiary
    • Currency

    Other values will depend on the beneficiary. Generally, attempting to sync beneficiaries with incomplete information will tell you of missing required data, but it varies due to many factors.

    Remittance Line 2 options are based on Currency, AFEX Bank Country and Partner Country.

    • AFEX Corporate If the beneficiary is not an individual.
    • AFEX Bank Country
    • AFEX Intermediary Bank Country
    • Payment Notification Email Address
    • Remittance Line 2 Options supplied by AFEX.
    • AFEX Sync Information Various values.

    Other required values are picked up from the partner address area.

    Bank Accounts have a Retrieve Beneficiary Information from AFEX option available in their Action Drop Down to allow the Bank Account and its Partner details to be retrieved from AFEX to Odoo.

  • Partner

    Partners have an AFEX Sync option available in their Action Drop Down to allow the Partner and their Bank Accounts to be synced to AFEX, which will create AFEX Beneficiaries.

    • Action
      • AFEX Sync

    The AFEX Beneficiary should be confirmed by AFEX before any payments are made.

    A general indication of the status is shown on the Accounting Tab.

    • AFEX Status Either Sync Needed or Synchronised.
  • Settings > Technical > System Parameters

    The URL defaults to the live URL ( If need be, it can be changed in the System Parameters.

    • Key afex.url
    • Value the URL (e.g.

Usage for Odoo v12

  • Accounting > Vendors > Bills > [Open Bill] > Register Payment or Accounting > Vendors > Bills > [Select Multiple] > [Action Drop Down and Register Payment] or Accounting > Vendors > Payments > [Create]

    To make a foreign currency payment using an AFEX Journal for a vendor who has an associated confirmed AFEX Beneficiary. Choose the correct payment journal, which will determine the settlement currency. The payment amount and currency can be chosen. If part or overpaying a single bill, an option will be given to choose if the balance is to be kept open or if it is to be written off.

    The Purpose of Payment can be selected if a different one is needed for this payment.

    If the payment journal can use direct debit payment, then this can be enabled or disabled for the trade in question.

    If the system configuration allows users to select Today or Next business day rates, as well as Two business days, then this can be selected for the trade in question.

    If the payment journal has a funding balance, a button will be displayed to retrieve the current balance for that currency.

    If the payment journal is a trade journal, a button will be displayed to retrieve a quote. The system will retrieve the exchange rate from AFEX and display the payment amount conversion using the exchange rate. Quote information is displayed on the payment screen.

    If applicable, the AFEX fee amount(s) and currency will be displayed as well.

    Each Payment Quote is valid for 30 seconds.

    The Re-Quote button on the payment screen can be used to refresh the quote.

    When the payment is Validated, the system will send information to AFEX to book and schedule a payment to the vendor.

    The vendor will be marked as paid to the level selected, and a bill will be raised to the AFEX partner. Any fee(s) in the same currency as the settlement currency will be included in the same bill. Otherwise, separate bill(s) will be raised for the fee(s).

    If direct debit settlement was selected, then the AFEX bill will be marked as paid.

    Information about the booked payment will be displayed on the AFEX bill, and on the Odoo payment record.

    If not settled by direct debit, and if not using a funding balance, then you must remit settlement funding for the payment to AFEX within 24 hours of booking the payment to ensure the foreign currency payment can be sent to the vendor on the scheduled date.

    Upon AFEX receiving payment, the booked payment to the vendor will be confirmed for the scheduled time.

Please log in to comment on this module

  • The author can leave a single reply to each comment.
  • This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
  • If you want to start a discussion with the author, please use the developer contact information. They can usually be found in the description.
Please choose a rating from 1 to 5 for this module.