Pay.cc

Connect H2H Merchant account in Corefy Dashboard

Step 1 - Open connection form

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

Step 2 - Fill in fields and select settings

• Login
• Control Key
• Endpoint ID
• Test Mode -> (enable if you are using sandbox credentials)
• Multi Currency Integration

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. Pay.cc 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
    }
  }
}

This connector also supports USD.

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",
        "email": "johnsmith@gmail.com",
        "phone": "+15551234567",
        "date_of_birth": "1990-01-01",
        "address": {
          "country": "FR",
          "city": "Paris",
          "full_address": "1 Main street",
          "post_code": "75000"
        }
      }
    }
  }
}

customer is entirely optional - anything you don't send falls back to the Constants below, or to a hardcoded placeholder (Berlin, Germany) if neither is set.

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.
• use_default_browser_info -> optional, boolean - if real browser/device fingerprint data isn't available for a sale, falls back to the browser-related Constants below instead of sending nothing.
• custom_finalization_logic -> optional, boolean - changes how Corefy finalizes the payment status internally; ask your account manager whether your account needs this enabled.
• allow_callback_for_all_transaction_types -> optional, boolean - exposed on the connection form, but has no observable effect in the current integration.

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 -> a hardcoded placeholder (Berlin, Germany) is used for address/country/city/post code, and a placeholder phone/email for those fields

Currently available constants (constant -> Corefy API field)

• ADDRESS -> customer.address.full_address
• COUNTRY -> customer.address.country
• CITY -> customer.address.city
• POST_CODE -> customer.address.post_code
• PHONE -> customer.phone
• EMAIL -> customer.email
• DATE_OF_BIRTH -> customer.date_of_birth
• BROWSER_IP, BROWSER_USER_AGENT, BROWSER_ACCEPT_HEADER, BROWSER_LANGUAGE, BROWSER_TZ_OFFSET, BROWSER_SCREEN_WIDTH, BROWSER_SCREEN_HEIGHT, BROWSER_COLOR_DEPTH, BROWSER_JAVA_ENABLED, BROWSER_INFO -> used as fallback browser/device data when use_default_browser_info is enabled and real browser data isn't available

Refunds

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

Connect Provider account in Corefy Dashboard

Step 1 - Open connection form

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

Step 2 - Fill in fields and select settings

• Login
• Control Key
• Endpoint ID
• API URL (optional)
• Test Mode -> (enable if you are using sandbox credentials)
• Multi Currency Integration

First request to Corefy API (MIN)

What it does: creates a payment-invoice and redirects the customer to a Pay.cc-hosted page to complete the payment with Apple Pay or Google Pay. This flow covers Apple Pay/Google Pay only - it does not accept plain card payments (use the H2H Merchant account for that).

Payment - MIN

POST /api/payment-invoices

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

This connector also supports googlepay_eur_hpp, and both methods in GBP and USD (applepay_gbp_hpp, googlepay_gbp_hpp, applepay_usd_hpp, googlepay_usd_hpp).

Payment - MAX

POST /api/payment-invoices

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "6795502c-e27d-4d07-85e0-93245aab9a3f",
      "service": "applepay_eur_hpp",
      "currency": "EUR",
      "amount": 10,
      "customer": {
        "reference_id": "cus_123",
        "email": "johnsmith@gmail.com",
        "phone": "+15551234567",
        "address": {
          "country": "FR",
          "city": "Paris",
          "full_address": "1 Main street",
          "post_code": "75000"
        }
      }
    }
  }
}

customer is entirely optional - everything is only used to prefill/enrich the sale, it never blocks the sale.

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 (applepay_<ccy>_hpp / googlepay_<ccy>_hpp), same constant set as the H2H Merchant account above (ADDRESS/COUNTRY/CITY/POST_CODE/PHONE/EMAIL/DATE_OF_BIRTH/browser-related constants).

Refunds

This flow does not support refunds - use the H2H Merchant account if you need refunds.