Accepting EFT Payments

Learn how sellers can process payments from Canada-based bank accounts.

EFT PAD Requirements

Canadian-based sellers must present a clear authorization to buyers. Before debiting a buyer's bank account, sellers must first collect authorization from the buyer defining a specific payment schedule or terms. To learn more, read our EFT Pad Requirements guide.

EFT Payments

To accept an EFT Payment, you must collect the following bank account information.

Field Description
Account Type
account_type		 Bank account type
Account Owner
name		 Bank account owner name
Account Number
account_number		 Bank account number
Routing Number
bank_code		 Bank account routing number/bank code
Institution Number
institution_number		 Bank account institution number
Transit Number
transit_number		 Bank account transit number

Step 1: Create an Identity for your Buyer

To process an EFT payment, first create an Identity to represent the buyer. An Identity resource helps manage payments, payment methods, bank accounts, transaction history, and more.

shelljson
Copy
Copied
curl "https://finix.sandbox-payments-api.com/identities" \
  -H "Content-Type: application/json" \
  -H "Finix-Version: 2022-02-01" \
  -u  USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e \
  -d '{
    "entity": {
      "phone": "7145677613",
      "first_name": "Collen",
      "last_name": "Wade",
      "email": "therock@gmail.com"
    }
  }'
Copy
Copied
{
    "id": "IDo6hT8RukoNfFDBx8KmzsyP",
    "created_at": "2024-04-17T00:21:13.52Z",
    "updated_at": "2024-04-17T00:21:13.52Z",
    "application": "APgPDQrLD52TYvqazjHJJchM",
    "entity": {
        "ach_max_transaction_amount": 0,
        "amex_mid": null,
        "annual_card_volume": 0,
        "business_address": null,
        "business_name": null,
        "business_phone": null,
        "business_tax_id_provided": false,
        "business_type": null,
        "default_statement_descriptor": null,
        "discover_mid": null,
        "dob": null,
        "doing_business_as": null,
        "email": "therock@gmail.com",
        "first_name": "Collen",
        "has_accepted_credit_cards_previously": false,
        "incorporation_date": null,
        "last_name": "Wade",
        "max_transaction_amount": 0,
        "mcc": null,
        "ownership_type": null,
        "personal_address": {
            "line1": null,
            "line2": null,
            "city": null,
            "region": null,
            "postal_code": null,
            "country": null
        },
        "phone": "7145677613",
        "principal_percentage_ownership": null,
        "short_business_name": null,
        "tax_authority": null,
        "tax_id_provided": false,
        "title": null,
        "url": null
    },
    "identity_roles": [],
    "tags": {},
    "_links": {
        "self": {
            "href": "https://finix.sandbox-payments-api.com/identities/IDo6hT8RukoNfFDBx8KmzsyP"
        },
        "verifications": {
            "href": "https://finix.sandbox-payments-api.com/identities/IDo6hT8RukoNfFDBx8KmzsyP/verifications"
        },
        "merchants": {
            "href": "https://finix.sandbox-payments-api.com/identities/IDo6hT8RukoNfFDBx8KmzsyP/merchants"
        },
        "settlements": {
            "href": "https://finix.sandbox-payments-api.com/identities/IDo6hT8RukoNfFDBx8KmzsyP/settlements"
        },
        "authorizations": {
            "href": "https://finix.sandbox-payments-api.com/identities/IDo6hT8RukoNfFDBx8KmzsyP/authorizations"
        },
        "transfers": {
            "href": "https://finix.sandbox-payments-api.com/identities/IDo6hT8RukoNfFDBx8KmzsyP/transfers"
        },
        "payment_instruments": {
            "href": "https://finix.sandbox-payments-api.com/identities/IDo6hT8RukoNfFDBx8KmzsyP/payment_instruments"
        },
        "associated_identities": {
            "href": "https://finix.sandbox-payments-api.com/identities/IDo6hT8RukoNfFDBx8KmzsyP/associated_identities"
        },
        "disputes": {
            "href": "https://finix.sandbox-payments-api.com/identities/IDo6hT8RukoNfFDBx8KmzsyP/disputes"
        },
        "application": {
            "href": "https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM"
        }
    }
}

Step 2. Create a Bank Account

Create a CAD Bank Account using Plaid

We recommend you use Plaid to create bank accounts for your buyers. Learn how to create Bank Accounts with Plaid by reading our guide.

Create a CAD Bank Account via API

attention

Please note that creating Payment Instruments and passing payment details (account number, card number, etc.) directly via the API should only be done for testing purposes. You must use the Tokenization Forms or Mobile Tokenization to accept payment details, and remain out of PCI scope.

A Payment Instrument resource represents the payment details of a credit card or bank account. A Payment Instrument is associated with a single Identity.

Copy
Copied
curl "https://finix.sandbox-payments-api.com/payment_instruments" \
  -H "Content-Type: application/json" \
  -H "Finix-Version: 2022-02-01" \
  -u  USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e \
  -d '{
    "account_number": "123123123",
    "account_type": "PERSONAL_CHECKING",
    "country": "CAN",
    "currency": "CAD",
    "identity": "IDo6hT8RukoNfFDBx8KmzsyP",
    "institution_number": "123",
    "name": "John Smith",
    "transit_number": "12345",
    "type": "BANK_ACCOUNT"
	}'

Response:

Copy
Copied
{
    "id": "PIk5jFRUwkvE1WHBRCgrBzRs",
    "created_at": "2024-04-17T00:26:19.56Z",
    "updated_at": "2024-04-17T00:26:19.56Z",
    "application": "APgPDQrLD52TYvqazjHJJchM",
    "created_via": "API",
    "currency": "CAD",
    "disabled_code": null,
    "disabled_message": null,
    "enabled": true,
    "fingerprint": "FPR8RAHfXm1BMYYVJyHWHhw4J",
    "identity": "IDo6hT8RukoNfFDBx8KmzsyP",
    "instrument_type": "BANK_ACCOUNT",
    "account_type": "PERSONAL_CHECKING",
    "bank_account_validation_check": "NOT_ATTEMPTED",
    "bank_code": null,
    "country": "CAN",
    "institution_number": "123",
    "masked_account_number": "XXXXX3123",
    "name": "John Smith",
    "transit_number": "12345",
    "tags": {},
    "third_party": null,
    "third_party_token": null,
    "type": "BANK_ACCOUNT",
    "_links": {
        "self": {
            "href": "https://finix.sandbox-payments-api.com/payment_instruments/PIk5jFRUwkvE1WHBRCgrBzRs"
        },
        "authorizations": {
            "href": "https://finix.sandbox-payments-api.com/payment_instruments/PIk5jFRUwkvE1WHBRCgrBzRs/authorizations"
        },
        "transfers": {
            "href": "https://finix.sandbox-payments-api.com/payment_instruments/PIk5jFRUwkvE1WHBRCgrBzRs/transfers"
        },
        "verifications": {
            "href": "https://finix.sandbox-payments-api.com/payment_instruments/PIk5jFRUwkvE1WHBRCgrBzRs/verifications"
        },
        "application": {
            "href": "https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM"
        },
        "identity": {
            "href": "https://finix.sandbox-payments-api.com/identities/IDo6hT8RukoNfFDBx8KmzsyP"
        }
    }
}

Step 3. Create a CAD Bank Transfer

Once you have a CAD bank account, you can create an EFT Payment.

Copy
Copied
curl "https://finix.sandbox-payments-api.com/transfers" \
  -H "Content-Type: application/json" \
  -H "Finix-Version: 2022-02-01" \
  -u  USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e \
  -d '{
    "amount": 350,
    "currency": "CAD",
    "merchant": "MU2ekLKCiV8M5waZ3Ayg7ic6",
    "source": "PIk5jFRUwkvE1WHBRCgrBzRs"
  }'

Response:

Copy
Copied
{
    "id": "TRg8Xu7rvD7JT9NmGTHF4eFe",
    "created_at": "2024-04-17T00:28:57.41Z",
    "updated_at": "2024-04-17T00:28:58.22Z",
    "additional_buyer_charges": null,
    "additional_healthcare_data": null,
    "additional_purchase_data": null,
    "address_verification": null,
    "amount": 350,
    "amount_requested": 350,
    "application": "APgPDQrLD52TYvqazjHJJchM",
    "currency": "CAD",
    "destination": null,
    "externally_funded": "UNKNOWN",
    "failure_code": null,
    "failure_message": null,
    "fee": 0,
    "idempotency_id": null,
    "merchant": "MU2ekLKCiV8M5waZ3Ayg7ic6",
    "merchant_identity": "IDbuyRPdoEBfEsKcuKEPgkqP",
    "messages": [],
    "parent_transfer": null,
    "parent_transfer_trace_id": null,
    "raw": null,
    "ready_to_settle_at": null,
    "receipt_last_printed_at": null,
    "security_code_verification": null,
    "source": "PIk5jFRUwkvE1WHBRCgrBzRs",
    "split_transfers": [],
    "state": "PENDING",
    "statement_descriptor": "FNX*FINIX FLOWERS",
    "subtype": "API",
    "tags": {},
    "trace_id": "f098d089-1bf7-45c9-96ca-bdd72e2c3fd5",
    "type": "DEBIT",
    "_links": {
        "application": {
            "href": "https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM"
        },
        "self": {
            "href": "https://finix.sandbox-payments-api.com/transfers/TRg8Xu7rvD7JT9NmGTHF4eFe"
        },
        "merchant_identity": {
            "href": "https://finix.sandbox-payments-api.com/identities/IDbuyRPdoEBfEsKcuKEPgkqP"
        },
        "payment_instruments": {
            "href": "https://finix.sandbox-payments-api.com/transfers/TRg8Xu7rvD7JT9NmGTHF4eFe/payment_instruments"
        },
        "reversals": {
            "href": "https://finix.sandbox-payments-api.com/transfers/TRg8Xu7rvD7JT9NmGTHF4eFe/reversals"
        },
        "fees": {
            "href": "https://finix.sandbox-payments-api.com/transfers/TRg8Xu7rvD7JT9NmGTHF4eFe/fees"
        },
        "disputes": {
            "href": "https://finix.sandbox-payments-api.com/transfers/TRg8Xu7rvD7JT9NmGTHF4eFe/disputes"
        },
        "source": {
            "href": "https://finix.sandbox-payments-api.com/payment_instruments/PIk5jFRUwkvE1WHBRCgrBzRs"
        },
        "fee_profile": {
            "href": "https://finix.sandbox-payments-api.com/fee_profiles/FPvCQUcnsueN3Bc3zR1qCBG8"
        }
    }
}