Concryt

Connect H2H Merchant account in Corefy Dashboard

Step 1 - Open connection form

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

Step 2 - Fill in fields and select settings

• Merchant ID
• Payment Key
• Test Mode -> (enable if you are using sandbox credentials)

Choose Currency / Features; 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; card data itself is collected and submitted separately by Corefy's checkout/SDK layer, not as part of this request. Concryt may return a 3D Secure challenge redirect depending on the card.

Payment - MIN

POST /api/payment-invoices

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

Payment - MAX

POST /api/payment-invoices

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "6795502c-e27d-4d07-85e0-93245aab9a3f",
      "service": "payment_card_eur_hpp",
      "currency": "EUR",
      "amount": 10,
      "customer": {
        "reference_id": "cus_123",
        "name": "John Smith",
        "email": "johnsmith@gmail.com",
        "phone": "+15551234567",
        "date_of_birth": "1990-01-01",
        "individual_tax_id": "12345678901",
        "address": {
          "country": "FR",
          "region": "IDF",
          "city": "Paris",
          "street": "1 Main street",
          "post_code": "75000"
        }
      }
    }
  }
}

customer is entirely optional - email/name/phone/date_of_birth/individual_tax_id/address fields each fall back to the matching Constant below, or are simply left blank on Concryt's side.

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

• ignore_callback -> optional, boolean - for cascading to work correctly, excludes finalizing the payment from the asynchronous callback; Corefy then relies only on an active status request (reconciliation) to finalize it.

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_EMAIL -> customer.email
• CUSTOMER_FIRST_NAME -> customer.name (first part)
• CUSTOMER_LAST_NAME -> customer.name (second part)
• CUSTOMER_PHONE -> customer.phone
• CUSTOMER_DATE_OF_BIRTH -> customer.date_of_birth
• CUSTOMER_INDIVIDUAL_TAX_NUMBER -> customer.individual_tax_id
• CUSTOMER_COUNTRY -> customer.address.country
• CUSTOMER_REGION -> customer.address.region
• CUSTOMER_CITY -> customer.address.city
• CUSTOMER_STREET -> customer.address.street
• CUSTOMER_POST_CODE -> customer.address.post_code

Refunds

This connector supports partial and multiple refunds against the same payment.

Connect Merchant account in Corefy Dashboard

Step 1 - Open connection form

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

Step 2 - Fill in fields and select settings

• Merchant ID
• Control Key
• API URL (optional)
• Test Mode -> (enable if you are using sandbox credentials)

First request to Corefy API (MIN)

What it does: creates a payment-invoice and redirects the customer to a hosted page to complete the payment with BLIK or Open Banking.

Payment - MIN

POST /api/payment-invoices

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

This connector also supports blik_eur_hpp, openbanking_pln_hpp, and openbanking_eur_hpp.

Payment - MAX

POST /api/payment-invoices

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "6795502c-e27d-4d07-85e0-93245aab9a3f",
      "service": "blik_pln_hpp",
      "currency": "PLN",
      "amount": 10,
      "customer": {
        "reference_id": "cus_123",
        "name": "John Smith",
        "email": "johnsmith@gmail.com",
        "phone": "+15551234567",
        "address": {
          "country": "PL",
          "region": "Mazowieckie",
          "city": "Warsaw",
          "full_address": "1 Main street",
          "post_code": "00-001"
        },
        "metadata": {
          "ip": "203.0.113.5",
          "user_agent": "Mozilla/5.0",
          "language": "en",
          "screen_width": 1920,
          "screen_height": 1080,
          "color_depth": 24,
          "timezone": "60",
          "java_enabled": false,
          "javascript_enabled": true,
          "accept_header": "text/html"
        }
      }
    }
  }
}

customer is entirely optional - the customer.metadata.* browser/device fields fall back to the matching Constant below if not sent.

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 are configured for this flow.

Constants (fallback fields)

Configured per service (blik_<ccy>_hpp, openbanking_<ccy>_hpp).

Currently available constants (constant -> Corefy API field)

• IP -> customer.metadata.ip
• LANG -> customer.metadata.language
• USER_AGENT -> customer.metadata.user_agent
• ACCEPT_HEADER -> customer.metadata.accept_header
• JAVASCRIPT_ENABLED -> customer.metadata.javascript_enabled
• JAVA_ENABLED -> customer.metadata.java_enabled
• COLOR_DEPTH -> customer.metadata.color_depth
• TIMEZONE -> customer.metadata.timezone
• SCREEN_HEIGHT -> customer.metadata.screen_height
• SCREEN_WIDTH -> customer.metadata.screen_width

Refunds

This flow only supports full refunds - a partial refund is rejected outright.