Cross-Border Payments

🚧

This feature is currently in closed beta.

If you'd like access to cross-border payments, please contact your Routable Customer Success Manager.

Cross-border Payments

Routable supports payments made from companies in the United States to vendors in several other countries. Routable does not currently provide support for cross-border receivables. See below for a list of countries and currencies supported by Routable.

Creating a Foreign Vendor

To create a foreign Vendor, use the Create a Company endpoint and provide a country_code. The country_code value must not match your own company's country, as vendors in the same country as your company should be treated as domestic vendors rather than cross-border ones. See below for a list of countries currently supported by Routable.

Once the vendor is created, it is strongly recommended to use Routable's Invite a Company workflow to allow the recipient to populate various details concerning their address and funding account using our pre-built form. The data required contains a variety of different fields and formats depending on the recipient's country, and developing your own form to handle each possible scenario can become quite complex.

📘

A word about country codes and currency codes

Routable uses ISO 3166-1 alpha-2 country codes and ISO 4217 currency codes in all of its APIs.

Sending Cross-border Payments

Cross-border payments are created using the Create a Payable endpoint. Payables of this type have a type of international and require a currency_code that corresponds with the receiver's country (see below). Note also that cross-border ACH payments MUST use the delivery_method of international_ach.

{
    "type": "international",
    "acting_team_member": "d373f767-1ef2-413d-9a57-f470d637671c",
    "amount": "52.30",
    "delivery_method": "international_ach",
    "withdraw_from_account": "2a8fe155-512e-4634-bd4a-710f3a1385ae",
    "currency_code": "GBP",
    "line_items": [
        {
            "amount": "52.30",
            "description": "Truck signs",
            "quantity": "1",
            "style": "item",
            "unit_price": "52.30"
        }
    ],
    "pay_to_company": "c1cba353-1de6-4386-bcfb-31a45857cdb7",
    "pay_to_payment_method": "e08864e0-a01b-40c7-bfab-117c044ecdde",
    "send_on": null
}

Once this call completes, the Vendor will receive an email with instructions on how to accept the payment using another of Routable's pre-built external flows.

Countries and currencies currently supported by Routable

Routable continues to add support for new countries to our platform. Don't see the country your Vendor is in yet? Reach out to us at [email protected] and let us know.

Country

Country Code

Currency Code

Andorra

AD

EUR

Australia

AU

AUD

Austria

AT

EUR

Belgium

BE

EUR

Bulgaria

BG

EUR

Canada

CA

CAD

Croatia

HR

EUR

Cyprus

CY

EUR

Czechia

CZ

EUR

Denmark

DK

EUR

Estonia

EE

EUR

Finland

FI

EUR

France

FR

EUR

French Guiana

GF

EUR

Germany

DE

EUR

Gibraltar

GI

EUR

Greece

GR

EUR

Guadeloupe

GP

EUR

Guernsey

GG

GBP

Hungary

HU

EUR

Iceland

IS

EUR

Ireland

IE

EUR

Isle of Man

IM

GBP

Italy

IT

EUR

Jersey

JE

GBP

Latvia

LV

EUR

Liechtenstein

LI

EUR

Lithuania

LT

EUR

Luxembourg

LU

EUR

Malaysia

MY

MYR

Malta

MT

EUR

Martinique

MQ

EUR

Mayotte

YT

EUR

Monaco

MC

EUR

Netherlands

NL

EUR

Norway

NO

EUR

Phillipines

PH

PHP

Poland

PL

EUR

Portugal

PT

EUR

Réunion

RE

EUR

Romania

RO

EUR

Saint-Barthélemy

BL

EUR

Saint-Martin

MF

EUR

Saint Pierre and Miquelon

PM

EUR

San Marino

SM

EUR

Singapore

SG

SGD

Slovak Republic

SK

EUR

Slovenia

SI

EUR

Spain

ES

EUR

Sweden

SE

EUR

Switzerland

CH

EUR

United Kingdom of Great Britain and Northern Ireland

GB

GBP

United States of America

US

USD

Vatican City / Holy See

VA

EUR

👍

Need a hand?

Reach out to our Developer Experience team at [email protected] with any questions you may have!


Did this page help you?