Skip to content

Logo

TechToPay

Building the future of payments

Supports in this guide: Payments

Provider website: techtopay.com

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

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

Prerequisites: get from TechToPay

Send a connection request at techtopay.com/contact or contact your TechToPay account manager directly to get your account verified and receive the following credentials.

  • API key -> Corefy field api_key.
  • 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 TechToPay in the provider directory and press Connect at TechToPay Provider Overview page in the New connection section.

Step 2 - Fill in fields and select settings

  • API key
  • Secret key
  • Test Mode -> (enable if you are using sandbox credentials)

Success

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

Payment - MIN

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "18e99db1-4737-4b93-9546-cd12361179ff",
      "service": "payment_card_eur_hpp",
      "currency": "EUR",
      "amount": 10
    }
  }
}

Payment - MAX

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "29fa9cb2-5848-4ca4-a657-de23472280aa",
      "service": "payment_card_eur_hpp",
      "currency": "EUR",
      "amount": 10,
      "customer": {
        "reference_id": "cus_123",
        "name": "John Doe",
        "email": "test@example.com",
        "phone": "+380680786663",
        "date_of_birth": "1990-01-01",
        "address": {
          "full_address": "Main street 1",
          "country": "GB",
          "city": "London",
          "post_code": "W1J 5AX"
        }
      }
    }
  }
}

Important

customer.name is split into first/last name and transliterated to Latin before being sent to TechToPay. 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

Refunds

TechToPay supports refunds for the full amount only (no partial or multiple refunds).

Additional info

  1. Active reconciliation is available - both the asynchronous callback and an active status request can finalize the payment.
  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 the API key and secret key for the selected environment (test_mode)
  • Currency or service is not supported -> confirm allowed currencies/features in your TechToPay account and in Corefy - only EUR is available
  • Refund fails with multiple attempts -> only a single, full-amount refund per payment is allowed

Question

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