Skip to content

Logo

Aurea Via

Payment solution designed for business success

Supports in this guide: Payments

Provider website: aureavia.com

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

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

Prerequisites: get from Aurea Via

Contact your Aurea Via account manager (or use aureavia.com/contact) to get your account verified and receive the following credentials:

  • MID -> Corefy field mid.
  • Hash Key -> Corefy field hash_key.

USD, EUR, AUD, CAD.

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

Connect H2H Merchant account in Corefy Dashboard

Step 1 - Open connection form

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

Step 2 - Fill in fields and select settings

  • MID
  • Hash Key
  • Test Mode -> (enable if you are using sandbox credentials)

Success

You have connected Aurea Via 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": "d6b7ece9-962b-4a88-9faa-4f7fc75372b1",
      "service": "payment_card_usd_hpp",
      "currency": "USD",
      "amount": 12.34
    }
  }
}

Payment - MAX

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "2ebcf517-8170-45c9-b175-b06ba16c7ace",
      "service": "payment_card_usd_hpp",
      "currency": "USD",
      "amount": 55.3,
      "customer": {
        "reference_id": "d8a97e9d-ca03-4db2-a1ef-254b49d00326",
        "name": "Test Test",
        "email": "test@test.com",
        "phone": "+44444444444",
        "date_of_birth": "2000-01-01",
        "address": {
          "full_address": "Test",
          "country": "US",
          "region": "Iowa",
          "city": "Test",
          "post_code": "Test"
        }
      }
    }
  }
}

Important

  • customer.region is forwarded as the cardholder's billing state only for US and CA addresses; for other countries it is not sent.
  • 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 the asynchronous callback entirely and relies only on an active status request (reconciliation) to finalize the payment.

Refunds

Aurea Via supports refunds for the full amount only, and only one refund per payment (no partial or multiple refunds).

Additional info

  1. Active reconciliation is available - in addition to the asynchronous callback, 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 MID and Hash Key for the selected environment (test_mode)
  • Currency or service is not supported -> confirm allowed currencies/features in your Aurea Via account and in Corefy - only USD, EUR, AUD, CAD are available
  • Refund fails with multiple attempts -> only one full-amount refund per payment is allowed

Question

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