Skip to content

CrossPay

CrossPay

Supports in this guide: Payments, Payouts

Provider website: crosspay.net

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

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

Choose account type

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

  • If you do direct card payments (H2H, no redirect) -> 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 CrossPay

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

  • Public key -> Corefy field public_key.
  • Secret key -> Corefy field secret_key.

UAH, EUR, UZS.

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

Connect H2H Merchant account in Corefy Dashboard

Step 1 - Open connection form

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

Step 2 - Fill in fields and select settings

  • Public key
  • Secret key
  • Test Mode -> (enable if you are using sandbox credentials)
  • Currency / Features -> choose values available for your account (UAH, EUR, UZS)

Success

You have connected CrossPay 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. Cardholder name is taken from the card's own embossed name, not from customer.

Payment - MIN

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "6be05631-8710-4b14-a369-1928a2b70eda",
      "service": "payment_card_uah_hpp",
      "currency": "UAH",
      "amount": 10
    }
  }
}

Payment - MAX

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "199be985-c243-478a-86a8-4b8c902e5bb6",
      "service": "payment_card_uah_hpp",
      "currency": "UAH",
      "amount": 10,
      "customer": {
        "reference_id": "cus_123",
        "email": "test@test.com"
      }
    }
  }
}

Important

CrossPay only uses customer.reference_id and customer.email - no other customer fields (name, phone, address) are sent to CrossPay at all. Both are optional and simply omitted if not provided.

Important

For CVV-exempt UZS transactions only, if no CVV is supplied, Corefy sends a fixed placeholder CVV (123) to CrossPay instead of leaving the field empty. This does not apply to any other currency.

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

Options

  • traffic_type -> optional, enumeration (trusted, untrusted) - tells CrossPay how to classify the traffic for this transaction. If not set, no value is sent and CrossPay applies its own default.

Refunds

CrossPay does not support refunds.

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

Connect Provider account in Corefy Dashboard

Step 1 - Open connection form

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

Step 2 - Fill in fields and select settings

  • Public key
  • Secret key
  • Test Mode -> (enable if you are using sandbox credentials)

Success

You have connected CrossPay Provider account!

First request to Corefy API (MIN)

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

Payout - MIN

POST /api/payout-invoices 

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

Important

fields.card_number is required - it's the only recipient detail CrossPay needs. No customer data is used by this connector's Payouts flow at all.

Refunds

CrossPay does not support refunds.

Additional info

  1. Active reconciliation is available on both Payments and Payouts - Corefy can poll CrossPay's status endpoints in addition to receiving its asynchronous callbacks.
  2. No recurring - this connector does not support saving/charging a token through Corefy.

FAQ / Troubleshooting

  • Invalid credentials / auth error -> verify the Public key and Secret key for the selected environment (test_mode)
  • Currency or service is not supported -> confirm allowed currencies/features in your CrossPay account and in Corefy - only UAH, EUR and UZS are available for Payments, UAH only for Payouts
  • Payout rejected for missing fields -> fields.card_number is required for every payout
  • Refund fails -> CrossPay does not support refunds through Corefy
  • Not sure which account type to use? -> ask your Corefy account manager

Question

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