Skip to content

Logo

PaymixVia

Supports in this guide: Payments

Provider website: paymixvia.com

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

  1. Choose account type
  2. Get your credentials (from PaymixVia)
  3. Connect in Dashboard
  4. Send an API request

Choose account type

PaymixVia can be connected in different ways (depending on your needs):

  • If you do card payments -> choose H2H Merchant account

If you are not sure which one to use, confirm with your Corefy account manager.

Prerequisites: get from PaymixVia

Get the following values for your PaymixVia project/account:

  • MID -> Corefy field mid -> example: mid_9f2c1a3b -> where to find: PaymixVia backoffice / issued by PaymixVia manager
  • Hash Key -> Corefy field hash_key -> example: hk_7d3f8b2a9c1e4560 -> where to find: PaymixVia backoffice / issued by PaymixVia manager
Payments processing (connect H2H Merchant account, create payment-invoice)

Connect H2H Merchant account in Corefy Dashboard

Step 1 - Open connection form

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

Step 2 - Fill in fields and select settings

  • MID
  • Hash Key

Choose Currency and Features. You can set these parameters according to available currencies and features for your PaymixVia account, but it is necessary to check details of the connection with your Corefy account manager.

Success

You have connected PaymixVia H2H Merchant account!

First request to Corefy API (MIN)

What it does: creates a payment-invoice.

Payment - MIN

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "service": "payment_card_eur_hpp",
      "currency": "EUR",
      "amount": 100,
      "customer": {
        "reference_id": "55041b5b-adfd-4073-a92b-fd8b495a4cc1",
        "email": "johnsmith@gmail.com"
      },
      "reference_id": "86e68af6-6b95-4cc0-be16-e4df8044604c"
    }
  }
}
customer.email is required by PaymixVia's own API (mandatory on their side, even though Corefy's own code doesn't separately validate its presence).

Payment - MAX

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "service": "payment_card_eur_hpp",
      "currency": "EUR",
      "amount": 100,
      "customer": {
        "reference_id": "bc75bc54-5023-4f98-8c0d-ec5ed7e8f380",
        "name": "John Smith",
        "email": "johnsmith@gmail.com",
        "phone": "+15551234567",
        "date_of_birth": "1990-05-14",
        "address": {
          "country": "DE",
          "region": "Berlin",
          "city": "Berlin",
          "post_code": "10115",
          "full_address": "1st Street 1"
        }
      },
      "reference_id": "08f5e97c-1170-4bda-9625-3bde3c6dcd20"
    }
  }
}
Unlike other providers on this platform, PaymixVia has no send_customer_data option: any billing details present in customer (name, email, phone, date of birth, address) are always forwarded as-is. PaymixVia also supports USD, GBP, NOK, DKK, SEK, CZK, and RON (use payment_card_<currency>_hpp as the service code, in lowercase).

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

Options are configured on the Corefy side and affect how Corefy builds provider requests or processes responses.

Currently available options (1)

  • ignore_callback - suppresses processing of callbacks received from PaymixVia
ignore_callback

What it does: when enabled, Corefy ignores callbacks received from PaymixVia instead of processing them.

When to use: if you rely only on reconciliation/status checks and don't want callback-driven updates for this connection.

Default: "false"

Allowed values: true, false

Additional info

  1. Callback routing is handled automatically (Corefy generates the callback URL per transaction).
  2. customer.address.region (billing state) is only forwarded to PaymixVia for US and Canadian addresses — it's dropped for every other country.

FAQ / Troubleshooting

  • Invalid credentials / auth error -> verify credentials for the selected environment and account type
  • Currency or service is not supported -> confirm allowed currencies/features in your PaymixVia account and in Corefy
  • Not sure which account type to use? -> ask your Corefy account manager

Question

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