Skip to content

Logo

Payon

Supports in this guide: Payments

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

  1. Get your credentials (from Payon)
  2. Connect in Dashboard
  3. Send an API request
  4. Check the result (callback and/or active status request)

Prerequisites: get from Payon

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

  • Channel ID -> Corefy field entity_id.
  • Access Token -> Corefy field access_token.
  • API URL -> Corefy field api_url - optional; if left blank, Corefy uses a default endpoint for your account automatically, based on the Test mode setting below.
  • Test mode -> Corefy field test_mode.

Supported currencies: USD, EUR, CAD, AUD.

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

Connect H2H Merchant account in Corefy Dashboard

Step 1 - Open connection form

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

Step 2 - Fill in fields and select settings

  • Channel ID
  • Access Token
  • API URL (optional)
  • Test Mode -> (enable if you are using sandbox credentials)

Success

You have connected Payon 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. Only Visa and Mastercard card networks are supported.

Payment - MIN

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "4e0d58fe-dc16-4657-b81f-9c4aa33c4230",
      "service": "payment_card_usd_hpp",
      "currency": "USD",
      "amount": 100
    }
  }
}

Payment - MAX

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "d9b2e8ab-56df-4516-9b52-6a5cfa7bd6e2",
      "service": "payment_card_eur_hpp",
      "currency": "EUR",
      "amount": 100,
      "customer": {
        "reference_id": "cus_123",
        "name": "John Doe",
        "email": "test@test.com",
        "address": {
          "full_address": "1 Main street",
          "country": "DE",
          "city": "Berlin",
          "post_code": "10115"
        }
      }
    }
  }
}

Extended request (MAX)

Why add extra fields (typical reasons): - Provide additional customer details for compliance/reconciliation - Positively influence 3-D Secure/issuer risk scoring - Include optional fields required by your specific flow

Important

  • customer.* fields are only forwarded to Payon when the Include Customer data Option (see below) is enabled on your connection - otherwise they are accepted by Corefy but not sent to the provider.
  • If the issuer requires 3-D Secure, Corefy handles the authentication redirect transparently through the checkout/SDK layer - you don't need to branch your integration for it.

Options

  • include_sender_data -> optional, boolean - sends your own merchant profile (company name, address, country, IBAN) to Payon as the payment's sender/originator details.
  • include_customer_data -> optional, boolean - sends the customer's billing address and name/email from your request's customer object to Payon.

Refunds

Payon supports partial refunds, but only one refund per payment (no multiple partial refunds against the same payment). A refund requires the original payment's ID, which Corefy sends automatically.

Important

A submitted refund's own status cannot be checked with a separate active status request - rely on the refund's own response and/or the asynchronous callback for its final status. Active status requests (reconciliation) are only available for the original payment.

Recurring

This connector supports saving the card as a token during a sale (via Corefy's standard tokenize-on-sale request) and later charging that same token without sending full card data again - no separate connection setting is needed to enable it.

Additional info

  1. Supported currencies: USD, EUR, CAD, AUD.
  2. Only Visa and Mastercard card networks are supported.
  3. Active reconciliation is available for Payments - both the asynchronous callback and an active status request can finalize a payment.
  4. 3-D Secure browser/device data is collected and submitted automatically by Corefy's checkout/SDK layer as part of card payments - no extra setup needed on your side.

FAQ / Troubleshooting

  • Invalid credentials / connection test fails -> verify Channel ID and Access Token match the selected environment (Test mode on/off)
  • Card payment isn't completing -> the issuer may require 3-D Secure authentication; Corefy handles this via an automatic redirect, no special handling is required on your side
  • Refund rejected / can't refund a payment twice -> only one refund (which can be partial) is allowed per payment
  • Can't see a refund's own status via an active status request -> this isn't supported for refunds specifically; check the refund's own response or wait for the callback
  • Does this connector support saving cards for later charges? -> yes, via Corefy's standard tokenize-on-sale request

Question

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