Skip to content

Logo

Trezuz

One integration. 80+ payment providers. Limitless growth.

Supports in this guide: Payments

Provider website: trezuz.com

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

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

Prerequisites: get from Trezuz

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

  • Terminal ID -> Corefy field terminal_id.
  • Client ID -> Corefy field client_id.
  • Client Secret -> Corefy field client_secret.
  • Username -> Corefy field username.
  • Password -> Corefy field password.
  • API Password -> Corefy field api_password -> used to verify callback notifications from Trezuz.
  • API URL (optional) -> Corefy field api_url -> leave as default unless your account manager tells you otherwise.

USD/EUR only.

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

Connect H2H Merchant account in Corefy Dashboard

Step 1 - Open connection form

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

Step 2 - Fill in fields and select settings

  • Terminal ID
  • Client ID
  • Client Secret
  • Username
  • Password
  • API Password
  • API URL (optional)
  • Test Mode -> (enable if you are using sandbox credentials)

Success

You have connected Trezuz 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": "5e6f7a81-2b3c-4d5e-8f93-4a5b6c7d8e9f",
      "service": "payment_card_usd_hpp",
      "currency": "USD",
      "amount": 10
    }
  }
}

Payment - MAX

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "6f7a8b92-3c4d-4e5f-8a04-5b6c7d8e9f0a",
      "service": "payment_card_usd_hpp",
      "currency": "USD",
      "amount": 10,
      "customer": {
        "reference_id": "cus_123",
        "name": "John Smith",
        "email": "johnsmith@gmail.com",
        "phone": "+15551234567",
        "address": {
          "country": "US",
          "city": "New York",
          "full_address": "1 Main street",
          "post_code": "10001"
        }
      }
    }
  }
}

Important

customer is entirely optional, with no Constants configured at all - if a field is missing, it's simply left blank (first/last name falls back to the name embossed on the card). customer.address.country also automatically determines the phone dialing code Trezuz expects, separately from customer.phone itself.

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

No Options or Constants are configured for this connector.

Refunds

This connector does not support refunds.

Additional info

  1. Callback routing is automatic - Corefy generates the callback/return URLs per transaction, nothing to configure in Trezuz's own back-office.
  2. Active reconciliation is available - Payments support an active status request, in addition to the asynchronous callback.
  3. No recurring and no payouts - this connector does not support saving/charging a token or payouts through Corefy.

FAQ / Troubleshooting

  • Invalid credentials / auth error -> verify Terminal ID/Client ID/Client Secret/Username/Password for the selected environment
  • Refund request fails -> refunds aren't supported by this connector
  • Currency or service is not supported -> confirm allowed currencies in your Trezuz account and in Corefy - only USD and EUR are available

Question

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