Skip to content

Logo

OMNO

Revolutionizing online payment processing by unifying payment service providers for seamless transactions.

Supports in this guide: Payments

Provider website: omno.com


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

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

Prerequisites: get from OMNO

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

  • Client ID -> Corefy field client_id.
  • Client secret -> Corefy field client_secret.

USD.


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

Connect H2H Merchant account in Corefy Dashboard

Step 1 - Open connection form

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

Step 2 - Fill in fields and select settings

  • Client ID
  • Client secret
  • Currency / Features -> choose values available for your account (USD)

Success

You have connected OMNO 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. CVV is always required (no CVV-exempt mode), and 3D Secure control version is not configurable for this connector.

Payment - MIN

POST /api/payment-invoices

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "b0818fe6-4526-4402-b08a-f71093a492f4",
      "service": "payment_card_usd_hpp",
      "currency": "USD",
      "amount": 10,
      "customer": {
        "reference_id": "33333"
      }
    }
  }
}

Payment - MAX

POST /api/payment-invoices

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "a16162b7-7877-402c-877d-240f60bcbcf2",
      "service": "payment_card_usd_hpp",
      "currency": "USD",
      "amount": 10,
      "customer": {
        "reference_id": "d95e408e-fcc3-4bce-8cfe-9c1b4369ae35",
        "name": "John Wick",
        "email": "johnwick@example.com",
        "phone": "+380123456789",
        "address": {
          "full_address": "Main street 1",
          "country": "FR",
          "city": "Paris",
          "region": "Paris",
          "post_code": "75001"
        }
      }
    }
  }
}

Important

  • For US/CA addresses, customer.address.region is sent as the billing state; for all other countries, customer.address.city is sent instead.
  • No Constants have a hardcoded placeholder fallback - if a customer field is missing and its matching Constant isn't set either, the field is simply left out of the request to OMNO.

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 -> provider may reject the request or apply its defaults (depends on provider)

Currently available constants (constant -> Corefy API field)

  • FIRST_NAME -> customer.name (first name part)
  • LAST_NAME -> customer.name (last name part)
  • EMAIL -> customer.email
  • PHONE -> customer.phone
  • COUNTRY -> customer.address.country
  • STATE -> customer.address.region (US/CA only)
  • CITY -> customer.address.city
  • ADDRESS -> customer.address.full_address
  • POST_CODE -> customer.address.post_code

Refunds

OMNO does not support 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 Client ID and Client secret
  • Currency or service is not supported -> confirm allowed currencies/features in your OMNO account and in Corefy - only USD is available
  • Refund fails -> OMNO does not support refunds through Corefy

Question

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