Use Cross Rivers foreign exchange (FX) rates API to get a foreign currency conversion rate from the card network.

Returns up-to-date foreign exchange rate information for card-based payments. As a Cross River merchant partner, you do this before making an international transaction.

Endpoint: /api/FXRates

The GUID that enables the application to link request with response

requestId

The currency code for the source (monetary) amount. This is a numeric value based on the currencies listed in ISO-4217. For example, if converting from (USD) 840 to (CAD) 124, the value would be 840.

sourceCurrency

The amount of money the payer is sending, in the currency indicated in sourceCurrency.
This value is needed for source-to-destination lookup.

Minor currency units after the decimal point must be ≤ (less than or equal to) the defined currency exponent (the digits following the decimal).

This field cannot be 0 or null.

The field contains between 1 – 13 characters, including a decimal, for example, 100.55.

For example:
Two (2) digits indicated after the decimal point for a two-exponent currency (99.85, 99.00, etc.).

Three (3) digits indicated after the decimal point for a three-exponent currency (989.333, 989.340, 989.000, etc.).

No decimal point or minor units indicated for a zero (0) exponent currency (95, 100, etc.).

sourceAmount

The currency code for the destination (monetary) amount. A numeric value based on the currencies listed in ISO-4217. For example, if converting from (USD) 840 to (CAD) 124, the value would be 124.

destinationCurrency

A list of conversion rates per each relevant card network

fxRateNetworkResponses

Pull transaction by ID

Exchange rates

Information that can be used to distinguish or trace an individual’s identity, either alone or when combined with other information that is linked or linkable to a specific individual. Also known as PII.

Personally_Identifiable_Information

These are contracts for monetary assets that can be purchased, traded, created, modified, or settled for. In terms of contracts, there is a contractual obligation between involved parties during a financial instrument transaction.

financial_instrument

Interest Rate Cards are pre-configured interest rate profiles that can be assigned to specific accounts on demand.

rate_card

A financial institution holding a principal license with a Card Network has the right to issue cards itself and sponsor other institutions (fintechs) to issue on its behalf (BIN sponsorship). Affiliate/Associate members cannot offer BIN sponsorship.

Principal_member

A 6 or 8 digit number assigned by the card networks for card issuing and functions as the first 6 or 8 digits on the card itself. The BIN identifies the bank that is responsible for issuing the program and handling daily settlement with the Network.

Card_BIN

A solution that allows partners to offer card solutions without requiring a direct relationship with the card networks. The bank acts as an intermediary while allowing partners to use its bank identification numbers (BIN). 

BIN_sponsorship

Politically Exposed Person is an individual who holds a prominent public position, or has done so in the recent past and is subject to a higher level of scrutiny due to an increased risk of involvement in bribery, corruption, and money laundering.

Office of Foreign Assets Control. Part of the US Department of the Treasury that administers and enforces economic and trade sanctions based on US foreign policy and national security goals.

OFAC

Move funds internally between accounts. The transfer requires both a debit and credit account and can be either a master account or sub-ledger, or any combination of the two.  Can be made via API calls or for non-API Partners on the COS Explorer.

book_transfer

This is where the financial institution verifies the member has the funds needed before they are transferred to the receiver.

Good_Funds_Model

An instant payment service developed and operated by the Federal Reserve for financial institutions in the United States, which allows individuals and businesses to send and receive money.

FedNow

A payment processing network used to send money electronically between banks in the US. Available year round, it transfers funds between 2 banks account instantaneously. Processes on bank holidays and weekend and after business hours.

A merchant category code (MCC) is a four-digit number used for retail financial services to classify a business by the types of goods or services it provides. Codes are specified by the ISO 18245 standard.

Card Acceptor ID. An internal identifier assigned to your business by your Acquirer when creating the merchant account used for financial processing.

CAID

Business Application Identifier, used by merchants in card payments

The automated loan validation and funding software from Cross River

Arix

Mobile Deposit Capture is the process of submitting a check electronically using a smartphone

Input Message Accountability Data. A unique number given to each FedWire payment when using the Federal Reserver Bank Service and can be used to investigate and track wire transfers.

IMAD

Notification of Change.  The purpose of an NOC is to identify and communicate incorrect information within an ACH entry, such as account numbers or transit and routing number. Sent by a RDFI to the ODFI and the Originator via their ACH Operator.

A global financial messaging standard for electronic payments. It enhances interoperability across financial systems, improves payment processing efficiency and supports compliance by providing detailed transaction information.

ISO20022

A SWIFT Code is a standard format of Bank Identifier Code (BIC) used to specify a particular bank or branch. These codes are used when transferring money between banks, particularly for international wire transfers.

SWIFT

Receiving Depository Financial Institution. All ODFIs must also agree to act as an RDFI to receive ACH payments. An RDFI receives entries directly or indirectly from its ACH Operator for debit or credit to the accounts of its customers.

RDFI

Originating Depository Financial Institution. It has the authority to initiate ACH transactions on behalf of its customers. ODFIs ensure compliance with regulatory standards and securely transmit payment instructions to the ACH network

ODFI

 National Automated Clearing House Association. Nacha governs the ACH Network, the payment system that drives Direct Deposits and Direct Payments with the capability to reach all U.S. bank and credit union accounts

Nacha

International ACH Transaction. A Nacha SEC code.

A uniquely configured financial product you offer your customers. For example, a debit card or a savings account, configured according to your needs and specifications, are product types.

product_type

Bank Identification Number. A unique identifier used in payment card transactions.

COS_Explorer

relationshipmanager

Cross River guides provide details about our products

guide

var_miha

new_var_2

new_mih_var

mih_var

This is a plain text that will be inserted in an expandable heading for using this raw as an exampl

testheight

available

testulet

testvar

altscenario

This is a plain text that will be inserted in an expandable heading for using this raw as an example

scenario

exemplu

variabila

Archbee

text

test

specific

refresh_token

YourBank

MyBank

variable_test_video

variable123

silviu

Bogdan_test

ferwhethgte

target1

google

support

product_name

OFAC compliance

APIs 

APIs intro

Event formats

Webhook management

Webhook events

Request and response codes

Accounts, cards and payment events

Card payments

Lending

Webhooks

Add customer

Customer by ID

Add beneficial owner

Add ID details

Update address

Update phone

Update email

APIs

Response and request codes

Error codes

Customer management

Open account

Tax document list

Tax document

Account management APIs

Create subledger

Subledger info

Subledgers

CD activity

CD penalty fee

Early funds withdrawal

Time deposit (CD) APIs

Account details

Exclude bank/account

Identify bank

Bank list

Deposit sweeps APIs

Accounts

Create new card

Activate card by ID

Set initial PIN

Replace card by ID

Card details

Card details by ID

Transaction details

Get profile

Suspend card

Unsuspend card

Admin block

Close card

Simulate card auth

Simulate card clearing

Simulate card reversal

Simulate incremental

Simulate clearing

Simulate reversal

Cards

Monitor limit utilization

Instant payments

Card transactions

Transaction management

Foreign exchange APIs

Dynamic descriptor

iFrames

International payments

IMPORTANT: Wires API update

Wires

Checks

Payments

Application decisioning

Create and update a loan (new format)

Create a Line-of-Credit (LOC)/ Draws

Add loan documents

Get loan details by ID

Pull funding from merchant

Cancel a loan

ACH parameters

ACH returns

Adjustment action parameters

Check parameters

RPPS parameters

RPPS returns

RPPS transaction reversals

Internal transfer (XPay) parameters

Instant payments parameters

Card parameters

Wire parameters

Loan funding - payment rails

Purchasing a loan

Hook notifications

Enums

Servicing reports

Transaction reports

[Deprecated] Purchase reports

COS reference codes

Status page

Changelog