Bank rails

International Payments

11min
cross river offers a set of apis to enable cross border money movement for international payments international payments apis are found in the international module of our cos sandbox register with cross river apis this table presents apis that we describe in detail action api call description international payments docid\ tacjkajzy5xggqjlmvd1i get /international/v1/estimates returns the estimated cost of sending an international payment, including the exchange rate international payments docid\ tacjkajzy5xggqjlmvd1i get /international/v1/meta/quote requirements returns country specific fields you need to submit when requesting a quote international payments docid\ tacjkajzy5xggqjlmvd1i post /international/v1/quotes requests an executable payment quote for sending either usd or foreign currency before actually sending funds international payments docid\ tacjkajzy5xggqjlmvd1i post /international/v1/payments executes a payment quote to send funds internationally get exchange rate estimate returns an estimate of an exchange rate the estimate shows the current foreign exchange rate, including spread and the transaction fee unlike a quote, no beneficiary data is required and the estimate cannot be executed the estimate is not saved important you must have a value for either a fromamount or a toamount , but not both money amounts in api calls and responses are written without a decimal point between the dollars and the cents get list of required fields for quote request returns the country specific fields you need to submit when requesting a quote money amounts in api calls and responses are written without a decimal point between the dollars and the cents the attributes in the response are required for the quote with the parameters defined in the request for this call (except where indicated in the table below) the values provided describe the required responses for example, for lastname the value is ^ {1,255} , indicating that the regular expression characters are permitted, up to 255 characters maximum the bankcountry is fr , as provided in the request request a payment quote calls an executable international payment quote that returns the cost of the transfer, including any fees and the exchange rate to a foreign currency many beneficiary details are conditionally optional depending on destination country call get /international/v1/meta/quote requirements for a list of specific required parameters for your quote you need beneficiary details to create a quote you use the value of the id attribute in the response (the quote id) to originate an international transfer quotes are typically valid for only 30 seconds important you must have a value for either a fromamount or a toamount , but not both bankcountry is always a required field other attributes may or may not be required depending on the country and other parameters money amounts in api calls and responses are written without a decimal point between the dollars and the cents originate a payment originates a cross border money transfer you must get a quote id using the international payments docid\ tacjkajzy5xggqjlmvd1i call the quote id is returned in the id field in the response to that call quote ids submitted in request are typically only valid for 30 seconds money amounts in api calls and responses are written without a decimal point between the dollars and the cents associated webhook events event name description international hold cleared hold on payment cleared funds sent international hold escalated payment on hold and status escalated additional actions needed international payment sent funds sent via a wire payment to the receiver bank international payment canceled payment canceled at partner request international payment returned payment rejected by the receiving bank related topics international payments error codes tutorials send an international payment