Canada

Supported payment methods and integration details for Canada

Country Details

Country Code: 1 • Currency: CAD (Canadian Dollar)

Supported Payment Methods & Payload Requirements

Channel	Flow	`payment_method_type`	Required Payload Array / Fields	Destination / Operator	API Reference
SWIFT Wire Transfer	Payout	`"bank"`	`bank: [{"bank_name": "...", "bank_code": "...", "branch_name": "...", "account_name": "...", "account_number": "..."}]`	Canadian Commercial Banks	Payments API
SWIFT Wire Transfer	Deposit	`"bank"`	Contact Support for CAD Wire Details	Canadian Commercial Banks	Collections API

Payment Flow: How It Works

Payouts (Disbursements)

Initiation: Send a POST request to the Unified Payments endpoint with currency: "CAD" and payment_method_type: "bank".
Recipient Bank Details: Provide the recipient’s bank account information, SWIFT/BIC code, and account name.
Settlement & Callback: Funds are routed via international wire transfer, and Niobi sends an asynchronous webhook callback (payment_step: 2, status: "success") to your client_callback_url upon clearance.

Sample Requests & Responses

CAD Bank Payout Request

{
    "client_id": "YOUR_CLIENT_ID",
    "params": {
        "amount": 1000,
        "client_callback_url": "https://example.com/callback",
        "currency": "CAD",
        "first_name": "John",
        "last_name": "Doe",
        "payment_method_type": "bank",
        "payment_reference": "YOUR-PAYOUT-REF",
        "third_party_reference_1": "TX-CAD-DISB-1001",
        "bank": [
            {
                "bank_name": "Royal Bank of Canada",
                "bank_code": "ROYCCAT2",
                "branch_name": "Toronto",
                "account_name": "John Doe",
                "account_number": "123456789"
            }
        ]
    },
    "salt": "random_salt_12345",
    "sender": "YOUR_INTEGRATION_NAME",
    "timestamp": 1724835600,
    "signature": "a1b2c3d4e5f60718293a4b5c6d7e8f90123456789abcdef0123456789abcdef0"
}

Try it

Try it: POST /api/v4/niobi-unified-collections

Collections API reference for CAD deposits.

Try it: POST /api/v4/niobi-unified-payments

Payments API reference for CAD payouts.

Transaction Limits

For the full list of minimum and maximum transaction limits for Canada (CAD) collections and payouts, please see the Transaction Limits for Canada section on the Transaction Limits page.

Get Started with Niobi

API Authentication

Collecting Payments

Making Payments

Transaction Status

Supporting Documentation

Canada | Supported Payment Methods & Corridors

Canada

Supported Payment Methods & Payload Requirements

Payment Flow: How It Works

Payouts (Disbursements)

Sample Requests & Responses

CAD Bank Payout Request

Try it

Try it: POST /api/v4/niobi-unified-collections

Try it: POST /api/v4/niobi-unified-payments

Transaction Limits

​Canada

​Supported Payment Methods & Payload Requirements

​Payment Flow: How It Works

​Payouts (Disbursements)

​Sample Requests & Responses

​CAD Bank Payout Request

​Try it

Try it: POST /api/v4/niobi-unified-collections

Try it: POST /api/v4/niobi-unified-payments

​Transaction Limits

Canada

Supported Payment Methods & Payload Requirements

Payment Flow: How It Works

Payouts (Disbursements)

Sample Requests & Responses

CAD Bank Payout Request

Try it

Transaction Limits