FiatSystems

Connect H2H Merchant account in Corefy Dashboard

Step 1 - Open connection form

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

Step 2 - Fill in fields and select settings

• Company number
• Merchant hash
• Currency / Features -> choose values available for your account (EUR, USD)
• Test Mode -> (enable if you are using sandbox credentials)

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. FiatSystems may return a 3D Secure challenge redirect depending on the card.

Payment - MIN

POST /api/payment-invoices

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "230d9dff-ddf4-4b98-a0cb-f9fd8a4c8f55",
      "service": "payment_card_usd_hpp",
      "currency": "USD",
      "amount": 10
    }
  }
}

Payment - MAX

POST /api/payment-invoices

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "341e0eff-eef5-4ba9-b1dc-00ae9b5d9f66",
      "service": "payment_card_usd_hpp",
      "currency": "USD",
      "amount": 10,
      "customer": {
        "reference_id": "cus_123",
        "email": "test@example.com",
        "phone": "+15551234567",
        "date_of_birth": "1990-01-01",
        "address": {
          "street": "Main street 1",
          "city": "New York",
          "region": "NY",
          "country": "US",
          "post_code": "10001"
        }
      }
    }
  }
}

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

• use_initial_amount -> optional, boolean - on a successful payment, returns the amount you originally requested instead of the amount FiatSystems reports back.
• custom_finalization_logic -> optional, boolean - by default, a "country blocked" or "general error" result from FiatSystems is finalized as a generic error; enabling this option maps those results more specifically instead.

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)

• EMAIL -> customer.email
• PHONE -> customer.phone
• DATE_OF_BIRTH -> customer.date_of_birth
• FULL_ADDRESS -> customer.address.street (falls back to customer.address.full_address)
• CITY -> customer.address.city
• REGION -> customer.address.region
• COUNTRY -> customer.address.country
• POST_CODE -> customer.address.post_code

Refunds

FiatSystems does not support refunds.

Recurring

FiatSystems supports saving and charging a card token through Corefy (standard tokenize/token-charge flow).