Skip to content

Logo

ToPay

Supports in this guide: Payments

Provider website: topay.pro

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

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

Prerequisites: get from ToPay

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

  • Terminal ID -> Corefy field terminal_id.
  • Secret Key -> Corefy field secret_key.

EUR only.

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

Connect H2H Merchant account in Corefy Dashboard

Step 1 - Open connection form

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

Step 2 - Fill in fields and select settings

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

Success

You have connected ToPay 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.

Payment - MIN

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "1f2aa3ca-abd8-4741-980d-4017ed30cb8c",
      "service": "payment_card_eur_hpp",
      "currency": "EUR",
      "amount": 5
    }
  }
}

Payment - MAX

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "1dc26f5a-a361-499b-9533-39625b59ab73",
      "service": "payment_card_eur_hpp",
      "currency": "EUR",
      "amount": 5,
      "customer": {
        "reference_id": "9a2f6d0d-bda7-4e1f-8a02-5b6c7d8e9f0a",
        "name": "John Doe",
        "email": "john@example.com",
        "phone": "+380680786663",
        "address": {
          "full_address": "Main street 1",
          "country": "GB",
          "city": "London",
          "post_code": "W1J 5AX"
        }
      }
    }
  }
}

Important

No Constants are configured for this connector - if a customer field is missing, it's simply 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

Options

  • ignore_callback -> optional, boolean - for cascading to work correctly, ignores ToPay's asynchronous callback and relies only on an active status request to finalize the payment.

Refunds

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

Additional info

  1. Active reconciliation is available - both the asynchronous callback and an active status request can finalize the payment, unless ignore_callback is enabled.
  2. No recurring - this connector does not support saving/charging a token through Corefy.

FAQ / Troubleshooting

  • Invalid credentials / auth error -> verify the Terminal ID and Secret Key for the selected environment (test_mode)
  • Currency or service is not supported -> confirm allowed currencies/features in your ToPay account and in Corefy - only EUR is available
  • Refund fails with multiple attempts -> only one refund per payment is allowed

Question

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