Skip to content

Paybox

Paybox

Supports in this guide: Payments, Payouts

Provider website: paybox.money

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

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

Choose account type

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

  • If you do direct card payments (H2H, no redirect, KZT only) -> choose H2H Merchant account
  • If you do card payouts -> choose Provider account

If you're not sure which one to use, confirm with your Corefy account manager.

Prerequisites: get from Paybox

Get the following values for your Paybox project/account:

  • Merchant ID -> Corefy field merchant_id -> H2H Merchant account only -> where to find: Paybox backoffice / issued by Paybox manager
  • Password -> Corefy field password -> H2H Merchant account only -> where to find: Paybox backoffice / issued by Paybox manager
  • Merchant -> Corefy field merchant -> Provider account only -> where to find: Paybox backoffice / issued by Paybox manager
  • Signature key -> Corefy field signature_key -> Provider account only -> where to find: Paybox backoffice / issued by Paybox manager

KZT only.

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

Connect H2H Merchant account in Corefy Dashboard

Step 1 - Open connection form

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

Step 2 - Fill in fields and select settings

  • Merchant ID
  • Password
  • Save instant token -> (enable only if you plan to charge saved cards later via Recurring)
  • Test Mode -> (enable if you are using sandbox credentials)

Success

You have connected Paybox 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. No customer data is used by this connector at all - only card details.

Payment - MIN

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "6be05631-8710-4b14-a369-1928a2b70eda",
      "service": "payment_card_kzt_hpp",
      "currency": "KZT",
      "amount": 1000
    }
  }
}

Important

No customer fields are sent to Paybox on Payments - only card data, so there is no MAX example with extended customer details for this flow.

Refunds

Paybox supports partial refunds, but only one refund per payment. The original transaction ID is required to process a refund.

Payouts processing (connect Provider account, create payout-invoice)

Connect Provider account in Corefy Dashboard

Step 1 - Open connection form

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

Step 2 - Fill in fields and select settings

  • Merchant
  • Signature key

Success

You have connected Paybox Provider account!

First request to Corefy API (MIN)

What it does: creates a payout-invoice for a card payout.

Payout - MIN

POST /api/payout-invoices 

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "reference_id": "efbf0a2b-5590-42b7-b10b-94d49452147d",
      "service": "payment_card_kzt",
      "currency": "KZT",
      "amount": 1500,
      "fields": {
        "card_number": "4111111111111111"
      }
    }
  }
}

Important

fields.card_number is required.

Payout - MAX

POST /api/payout-invoices 

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "reference_id": "2f8e6c71-4b3a-4e5d-9c21-7a6f1d0b8e4c",
      "service": "payment_card_kzt",
      "currency": "KZT",
      "amount": 1500,
      "customer": {
        "reference_id": "cus_123",
        "name": "John Smith"
      },
      "fields": {
        "card_number": "4111111111111111"
      }
    }
  }
}

customer.reference_id and customer.name are both optional and passed through to Paybox as-is if present.

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

Important

If you don't send a description, Corefy sends a fixed literal "Payout description" to Paybox instead of leaving the field empty.

Refunds

Paybox does not support refunds on Payouts.

Additional info

  1. Active reconciliation only on Payments - this connector does not implement an asynchronous callback for Payments; status is resolved via the 3DS return step and active status requests.
  2. Payouts has both active reconciliation and an asynchronous callback - status updates can arrive either way.
  3. Recurring is supported on Payments - enable Save instant token on the account, and Corefy saves a token from a successful card payment that can be charged again later.
  4. No Options or Constants are configured for this connector.

FAQ / Troubleshooting

  • Invalid credentials / auth error -> verify Merchant ID/Password (H2H) or Merchant/Signature key (Provider account) for the selected environment (Test Mode)
  • Payout rejected for missing fields -> fields.card_number is required for every payout
  • Refund fails -> Paybox only supports one refund per payment, and only on the H2H Payments flow - Payouts does not support refunds at all
  • Not sure which account type to use? -> ask your Corefy account manager

Question

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