Skip to content

Logo

Facilero

The smart place for payments

Supports in this guide: Payments

Provider website: facilero.com

What you need to do for start processing transactions (brief summary)

  1. Get your credentials (from Facilero)
  2. Connect in Dashboard
  3. Send an API request

Prerequisites: get from Facilero

Contact your Facilero account manager to get your account verified and receive the following credentials.

  • Partner ID -> Corefy field partner_id.
  • Username -> Corefy field user_name.
  • Secret key -> Corefy field secret_key.
  • Member ID -> Corefy field member_id.
  • Terminal ID -> Corefy field terminal_id.

USD, EUR, GBP, AUD, CAD.

Payments processing (connect H2H Merchant account, create payment-invoice)

Connect H2H Merchant account in Corefy Dashboard

Step 1 - Open connection form

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

Step 2 - Fill in fields and select settings

  • Partner ID
  • Username
  • Secret key
  • Member ID
  • Terminal ID
  • Currency / Features -> choose values available for your account (USD, EUR, GBP, AUD, CAD)
  • Test Mode -> (enable if you are using sandbox credentials)

Success

You have connected Facilero H2H Merchant account!

First request to Corefy API (MIN)

What it does: creates a payment-invoice; card data itself is collected and submitted separately by Corefy's checkout/SDK layer, not as part of this request. Facilero may return a 3D Secure challenge redirect depending on the card.

Payment - MIN

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "87c341d0-d05f-47a3-94ac-b99941f4ae31",
      "service": "payment_card_eur_hpp",
      "currency": "EUR",
      "amount": 10
    }
  }
}

Payment - MAX

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "9c1e2f3a-4b5c-4d6e-8f70-1a2b3c4d5e6f",
      "service": "payment_card_eur_hpp",
      "currency": "EUR",
      "amount": 10,
      "customer": {
        "reference_id": "cus_123",
        "email": "test@example.com",
        "phone": "+380680786663",
        "address": {
          "full_address": "Main street 1",
          "country": "FR",
          "city": "Paris",
          "post_code": "75001"
        }
      }
    }
  }
}

Important

  • The cardholder's first/last name sent to Facilero comes from the card's own embossed name, not from customer.
  • If customer.address.* fields are missing, Corefy falls back to customer.metadata.city/.country/.zip/.street (these exact metadata key names, not configurable); if neither is set, the field is simply not sent.
  • If a card requires 3D Secure authentication in a way Facilero can't confirm support for, the payment is declined immediately rather than attempting a challenge.

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

Refunds

Facilero supports partial refunds, but only one refund per payment (no multiple partial refunds against the same payment).

Additional info

  1. Active reconciliation is available - an active status request can finalize the payment in addition to the asynchronous callback.
  2. No recurring - this connector does not support saving/charging a token through Corefy.
  3. No Options or Constants are configured for this connector.

FAQ / Troubleshooting

  • Invalid credentials / auth error -> verify Partner ID, Username, Secret key, Member ID and Terminal ID for the selected environment (test_mode)
  • Payment declined with a 3D Secure enrolment error -> this happens when Facilero can't confirm 3DS support for the card; try a different card or contact your account manager
  • Currency or service is not supported -> confirm allowed currencies/features in your Facilero account and in Corefy - USD, EUR, GBP, AUD, CAD are available
  • Refund fails with multiple attempts -> only one refund per payment is allowed

Question

Still looking for help connecting your Facilero account? Please contact our support team!