Skip to content

Logo

BingoPay

Fast, safe and reliable

Supports in this guide: Payments

Provider website: bingopay.io

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

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

Prerequisites: get from BingoPay

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

  • Payer ID -> Corefy field payer_id.
  • Username -> Corefy field username.
  • Password -> Corefy field password.
Payments processing (connect H2H Merchant account, create payment-invoice)

Connect H2H Merchant account in Corefy Dashboard

Step 1 - Open connection form

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

Step 2 - Fill in fields and select settings

  • Payer ID
  • Username
  • Password
  • Test Mode -> (enable if you are using sandbox credentials)

Success

You have connected BingoPay 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. BingoPay processes this as a direct, non-3DS card payment - there is no redirect step and a CVV is always required.

Payment - MIN

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "feec01c3-fc2c-4686-ba20-b1df92fc2c37",
      "service": "payment_card_usd_hpp",
      "currency": "USD",
      "amount": 10
    }
  }
}

Payment - MAX

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "224629c9-01d0-4c37-b3b1-db3d24cac691",
      "service": "payment_card_usd_hpp",
      "currency": "USD",
      "amount": 10,
      "customer": {
        "reference_id": "224629c9-01d0-4c37-b3b1-db3d24cac691",
        "name": "Serge Kot"
      }
    }
  }
}

Important

customer.name is used as the cardholder name sent to BingoPay; if it's missing, the card's own embossed name is used instead. No other customer fields are used by this connector.

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

Refunds

BingoPay does not support refunds.

Additional info

  1. Active reconciliation is available - both an asynchronous callback and an active status request can finalize the payment.

FAQ / Troubleshooting

  • Invalid credentials / auth error -> verify Payer ID, Username and Password for the selected environment (test_mode)
  • Payment declined for missing CVV -> BingoPay always requires a CVV; non-CVV payments are not supported
  • Currency or service is not supported -> confirm allowed currencies/features in your BingoPay account and in Corefy

Question

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