Payler

Supports in this guide: Payments

Provider website: payler.com

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

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

Prerequisites: get from Payler

Get the following values for your Payler project/account:

• Key -> Corefy field key -> where to find: Payler backoffice / issued by Payler account manager
• Password -> Corefy field password -> where to find: Payler backoffice / issued by Payler account manager
• API URL -> Corefy field api_url -> required only if your account is connected with API version v1 or v2 (see "Options" below); issued by your Payler account manager as your dedicated processing endpoint. Not used, and can be left blank, when your account is connected with API version v2.1 - that version always calls Payler's own sandbox/production endpoints directly.

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "86e68af6-6b95-4cc0-be16-e4df8044604c",
      "service": "payment_card_eur_hpp",
      "currency": "EUR",
      "amount": 10,
      "customer": {
        "reference_id": "55041b5b-adfd-4073-a92b-fd8b495a4cc1",
        "email": "johnsmith@gmail.com"
      }
    }
  }
}

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "08f5e97c-1170-4bda-9625-3bde3c6dcd20",
      "service": "payment_card_eur_hpp",
      "currency": "EUR",
      "amount": 10,
      "customer": {
        "reference_id": "bc75bc54-5023-4f98-8c0d-ec5ed7e8f380",
        "name": "John Smith",
        "email": "johnsmith@gmail.com",
        "phone": "+380677123456",
        "address": {
          "full_address": "Shevchenko St 123",
          "country": "DE",
          "region": "Berlin",
          "city": "Berlin",
          "street": "Shevchenko St",
          "post_code": "10115"
        }
      }
    }
  }
}

Additional info

1. Only the H2H Merchant account flow is available for Payler - there is no separate Provider account/Payouts integration.
2. Payler supports 3D Secure card payments (3DS1 and 3DS2), including the 3DS Method step; the redirect/challenge flow is handled automatically by Corefy.
3. Real-time callback-based status updates apply only when your account is connected with API version v2.1 - Corefy registers a callback URL with Payler for that version. With API versions v1/v2, final status is obtained through the 3DS completion step plus Corefy's automatic reconciliation; no callback is registered with Payler.
4. When connected with the default API version (v2), make sure your integration sends full browser/device data (user agent, screen size, color depth, timezone, language) with every Sale request. This is collected automatically if you use Corefy's standard checkout/SDK; a custom server-to-server integration that omits it entirely can cause the request to fail with a server error instead of a normal decline.
5. Supported currencies: USD, EUR, RUB, KZT - confirm with your account manager which ones are enabled for your specific Payler account.

FAQ / Troubleshooting

• Invalid credentials / auth error -> verify Key and Password match the selected environment (sandbox vs production) and API version
• "Customer email is required" error -> required when your account uses the default API version (v2); add customer.email to the request, or confirm with your account manager which API version your account uses
• Refund rejected as invalid amount -> if your account is connected with API version v2.1, only full-amount refunds are supported; ask your account manager about using API version v1/v2 if you need partial refunds
• Currency or service is not supported -> confirm allowed currencies/features in your Payler account and in Corefy
• Not sure which API version your account uses? -> ask your Corefy account manager or your Payler account manager