LiqPay

Supports in this guide: Payments, Payouts

Provider website: liqpay.ua

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

1. Choose account type
2. Get your credentials (from LiqPay)
3. Connect in Dashboard
4. Send an API request

Choose account type

LiqPay can be connected in different ways (depending on your needs):

• If you do card payments directly (Sale, Auth/Capture, Card verification, token Recurring, Refunds) -> choose H2H Merchant account
• If you do card/wallet/Privat24/MasterPass/cash-terminal payments through a hosted checkout page, or card payouts -> choose Provider account

Both account types use the same LiqPay public/private key pair, but are separate connections with independent configuration. If you're not sure which one to use, confirm with your Corefy account manager.

Prerequisites: get from LiqPay

Open your LiqPay account's API section and generate a key pair to get the following credentials. H2H Merchant account and Provider account are separate connections with independent credentials.

For H2H Merchant account:

• Public key -> Corefy field public_key.
• Private key -> Corefy field private_key.
• Account type -> Corefy field type -> Internet acquiring (standard card payment, default use case), Account to card, Card to account, or Card verification -> confirm with your LiqPay manager which one applies to your account.
• Save instant token -> Corefy field save_instant_token -> enable if you want to save a card token for recurring charges.

For Provider account:

• Public key -> Corefy field public_key.
• Private key -> Corefy field private_key.
• Currencies -> Corefy field currencies -> select which of UAH/EUR/USD/RUB your account supports.

UAH only on the H2H Merchant account; Payouts are UAH only on the Provider account as well.

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "6f7a8b9c-0d1e-4f2a-8b13-6c7d8e9f0a1b",
      "service": "payment_card_uah",
      "currency": "UAH",
      "amount": 10
    }
  }
}

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "7a8b9c0d-1e2f-4a3b-8c24-7d8e9f0a1b2c",
      "service": "payment_card_uah",
      "currency": "UAH",
      "amount": 10,
      "description": "Order #123",
      "customer": {
        "reference_id": "cus_123",
        "phone": "+380991234567"
      }
    }
  }
}

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "8b9c0d1e-2f3a-4b4c-8d35-8e9f0a1b2c3d",
      "service": "liqpay_uah_hpp",
      "currency": "UAH",
      "amount": 10
    }
  }
}

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "reference_id": "9c0d1e2f-3a4b-4c5d-8e46-9f0a1b2c3d4e",
      "service": "payment_card_uah",
      "currency": "UAH",
      "amount": 10,
      "fields": {
        "card_number": "4111111111111111"
      }
    }
  }
}

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "reference_id": "0d1e2f3a-4b5c-4d6e-8f57-0a1b2c3d4e5f",
      "service": "payment_card_uah",
      "currency": "UAH",
      "amount": 10,
      "fields": {
        "card_number": "4111111111111111",
        "card_holder": "Ivan Ivanov"
      }
    }
  }
}

Additional info

1. Active reconciliation is available for Payouts - the Provider account supports an active status request for payouts, in addition to any asynchronous updates.
2. Payments rely on callbacks and active status requests differently per account type - the H2H Merchant account processes LiqPay's callback and also supports active reconciliation; the Provider account (HPP) relies on the customer's return and LiqPay's callback to finalize the payment.
3. No recurring on the Provider account or Payouts - Recurring (via save_instant_token) is only available on the H2H Merchant account.

FAQ / Troubleshooting

• Invalid credentials / auth error -> verify the public/private key pair and test_mode setting for the selected account type - H2H Merchant account and Provider account use entirely different credential sets even though both use a LiqPay key pair
• Refund fails with multiple attempts -> only one refund per payment is allowed, and only on the H2H Merchant account - Payments through the Provider account and all Payouts don't support refunds at all
• Currency or service is not supported -> confirm allowed currencies/features in your LiqPay account and in Corefy - the H2H Merchant account and Payouts are UAH only, the Provider account also supports EUR/USD/RUB depending on your LiqPay account
• Not sure which account type to use? -> H2H Merchant account is for direct card payments (Sale, Auth/Capture, Card verification, Recurring, Refunds); Provider account is for hosted-checkout payments (card, wallet, Privat24, MasterPass, cash terminal) and card Payouts