Token.io

Connect Provider account in Corefy Dashboard

Step 1 - Open connection form

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

Step 2 - Fill in fields and select settings

• Merchant ID
• Member ID
• Key Type
• Public Key ID
• Private Key
• Webhook Public Key
• Test Mode -> (enable if you are using sandbox credentials)

For each payment method/service you plan to use, fill in your receiving bank account Constants (see below) - Creditor IBAN and Creditor Name are required.

First request to Corefy API (MIN)

What it does: creates a payment-invoice and redirects the customer to their own bank (or a provider like Revolut/N26/Wise) to authorize an account-to-account transfer. All methods are EUR only. Depending on the method, fields.iban (the payer's own IBAN) may be required to initiate the transfer.

Payment - MIN

POST /api/payment-invoices

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

This connector also supports sepa_transfer_instant_eur_hpp, revolut_bank_eur_hpp, n26_bank_eur_hpp, wise_eur_hpp, sofortuberweisung_eur_hpp.

Payment - MAX

POST /api/payment-invoices

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "6795502c-e27d-4d07-85e0-93245aab9a3f",
      "service": "sepa_transfer_eur_hpp",
      "currency": "EUR",
      "amount": 10,
      "customer": {
        "reference_id": "cus_123",
        "name": "John Smith",
        "address": {
          "country": "DE",
          "city": "Berlin",
          "full_address": "1 Main street",
          "post_code": "10115"
        }
      },
      "fields": {
        "iban": "DE89370400440532013000"
      }
    }
  }
}

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

Options

• charge_bearer -> optional, enum (CRED / DEBT / SHAR / SLEV) - who pays the transfer fee: creditor (you), debtor (the customer), shared between both, or per the service level agreement. Configured per payment method/service.

Constants (your receiving bank account)

Unlike most connectors, these Constants aren't fallback values - they're the only way Token.io learns where to send the money, since the API request never carries your own bank details. Configure them once per payment method/service.

Available constants (constant -> meaning)

• creditor_iban -> required -> your IBAN.
• creditor_name -> required -> your account/business name as registered with your bank.
• creditor_bic -> optional -> your bank's BIC/SWIFT code.
• creditor_ultimate_name -> optional -> ultimate beneficiary name, if different from the account holder.
• creditor_bank_name -> optional -> your bank's name.
• creditor_address_line, creditor_street_name, creditor_building_number, creditor_post_code, creditor_town_name, creditor_state, creditor_district, creditor_country -> optional -> your registered business address, broken into parts.