Skip to content

GetaPay

We'll help you to find the best payment solutions for your website

Supports in this guide: Payments

Provider website: getapay.io

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

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

Prerequisites: get from GetaPay

Send a connection request at getapay.io or contact your GetaPay account manager directly to get your account verified and receive the following credentials.

  • Project ID -> Corefy field project_id.
  • Secret key -> Corefy field secret_key.

UAH, USD, EUR, KZT.

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

Connect H2H Merchant account in Corefy Dashboard

Step 1 - Open connection form

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

Step 2 - Fill in fields and select settings

  • Project ID
  • Secret key
  • Currency / Features -> choose values available for your account (UAH, USD, EUR, KZT)

Success

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

Payment - MIN

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "45842402-0605-4f45-9738-8c7e6a6a689f",
      "service": "payment_card_usd_hpp",
      "currency": "USD",
      "amount": 5
    }
  }
}

Payment - MAX

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "0da5e981-782f-44f5-bc37-35345f2db1be",
      "service": "payment_card_usd_hpp",
      "currency": "USD",
      "amount": 5,
      "customer": {
        "reference_id": "cus_123",
        "email": "test@example.com",
        "phone": "+15551234567",
        "address": {
          "full_address": "Main street 1",
          "country": "GB",
          "region": "London",
          "city": "London",
          "post_code": "SW1A 1AA"
        }
      }
    }
  }
}

Important

If a customer field below is missing, Corefy falls back to the matching Constant; if that's not set either, a fixed placeholder value is sent to GetaPay instead of leaving the field empty.

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

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 -> Corefy sends a fixed placeholder value (see below)

Currently available constants (constant -> Corefy API field -> placeholder sent if both are missing)

  • COUNTRY -> customer.address.country -> GB
  • REGION -> customer.address.region -> Richmond
  • CITY -> customer.address.city -> London
  • ADDRESS -> customer.address.full_address -> 95 Richmond Road
  • POST_CODE -> customer.address.post_code -> SW198TQ
  • EMAIL -> customer.email -> example@gmail.com
  • PHONE -> customer.phone -> 79161111102

Refunds

GetaPay 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.

FAQ / Troubleshooting

  • Invalid credentials / auth error -> verify the Project ID and Secret key
  • Currency or service is not supported -> confirm allowed currencies/features in your GetaPay account and in Corefy - only UAH, USD, EUR, KZT are available
  • Refund fails with multiple attempts -> only one, full-amount refund per payment is allowed
  • Unexpected placeholder customer data at GetaPay -> this is expected when customer fields and the matching Constants are both missing; send real data or set the Constants to avoid it

Question

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