MiFinity

Connect Provider account in Corefy Dashboard

Step 1 - Open connection form

Open MiFinity in the provider directory and press Connect at MiFinity Provider Overview page in the New connection section. Choose Provider account.

Step 2 - Fill in fields and select settings

• Account Holder ID
• API Key
• Test Mode -> (enable if you are using sandbox credentials)

Choose Currency / Features. USD, EUR, GBP, CHF, CAD, AUD, NZD, NOK, SEK, and DKK are confirmed; check with your Corefy account manager which are enabled for your account.

First request to Corefy API (MIN)

What it does: creates a payment-invoice; Corefy then embeds a MiFinity-hosted iframe (using the initialization token MiFinity returns) where the customer logs in to their MiFinity wallet and completes the payment.

Payment - MIN

POST /api/payment-invoices

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "8e3dbbb0-17af-4c9a-bedb-93bdac6900a2",
      "service": "mifinity_gbp_invoice",
      "currency": "GBP",
      "amount": 10
    }
  }
}

Payment - MAX

POST /api/payment-invoices

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "6795502c-e27d-4d07-85e0-93245aab9a3f",
      "service": "mifinity_gbp_invoice",
      "currency": "GBP",
      "amount": 10,
      "customer": {
        "reference_id": "cus_123",
        "name": "John Smith",
        "email": "johnsmith@gmail.com",
        "phone": "+15551234567",
        "date_of_birth": "1990-01-01",
        "address": {
          "country": "GB",
          "city": "London",
          "full_address": "1 Main street"
        }
      }
    }
  }
}

customer is entirely optional - anything you don't send falls back to the Constants below (or is simply left blank on MiFinity's side) instead of failing the request. This connector also supports USD, EUR, CHF, CAD, AUD, NZD, NOK, SEK, and DKK (use mifinity_<ccy>_invoice as the service code).

Extended request (MAX)

Why add extra fields (typical reasons): - Provide additional customer details for compliance/reconciliation - Positively influence conversion rate - Include optional fields required by your specific flow

Constants (fallback fields)

Constants are static values that Corefy can send to the provider instead of dynamic data from your API request, when those fields are missing in the request.

Priority (predictable rule): 1. If a value is present in the request -> Corefy uses the request value 2. Else if the constant is set -> Corefy uses the constant 3. Else -> provider may reject the request or apply its defaults (depends on provider)

Currently available constants (constant -> Corefy API field)

• CUSTOMER_REFERENCE_ID -> customer.reference_id
• DATE_OF_BIRTH -> customer.date_of_birth
• COUNTRY -> customer.address.country
• CITY -> customer.address.city
• FULL_ADDRESS -> customer.address.full_address
• NATIONALITY -> nationality -> falls back to customer.address.country if not set as a request field or constant.

Connect Provider account in Corefy Dashboard

Uses the same Provider account connection as Payments above - one connection covers both directions, there's nothing extra to fill in for payouts specifically.

First request to Corefy API (MIN)

What it does: creates a payout-invoice and sends funds to a bank account or to another MiFinity wallet.

Payout - MIN (bank transfer)

POST /api/payout-invoices

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "reference_id": "0dde9e79-2c64-4703-adaf-93d710633401",
      "service": "bank_transfer_aggregated_gbp",
      "currency": "GBP",
      "amount": 10,
      "customer": {
        "reference_id": "cus_123",
        "address": {
          "country": "GB"
        }
      },
      "fields": {
        "beneficiary_full_name": "John Smith",
        "account_number": "31511100",
        "bank_code": "100000"
      }
    }
  }
}

Payout - MIN (MiFinity wallet)

POST /api/payout-invoices

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "reference_id": "3c6d2f8e-8a2a-4e7a-9b1a-2f6a7b9c0d1e",
      "service": "mifinity_wallet_eur",
      "currency": "EUR",
      "amount": 10,
      "customer": {
        "reference_id": "cus_123"
      },
      "fields": {
        "account_number": "recipient@example.com"
      }
    }
  }
}

For mifinity_wallet_<ccy> (EUR/CAD), the destination is just the recipient's MiFinity account - send it as fields.account_number (or fields.email, if that's what you have).

Extended request (MAX)

Why add extra fields (typical reasons): - Provide additional customer details for compliance/reconciliation - Positively influence conversion rate - Include optional fields required by your specific flow

No Options or Constants are configured for this flow.