Skip to content

Logo

B2pay

International payment system

Supports in this guide: Payments

Provider website: paylink.work

Note

This provider's own brand name is "Paylink" - unrelated to the separately documented PayLink connector (a different company, different website). The b2pay naming is kept here to avoid confusion between the two.

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

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

Prerequisites: get from B2pay

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

  • User ID -> Corefy field user_id.
  • Email -> Corefy field email.
  • API key -> Corefy field api_key.

EUR, USD.

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

Connect H2H Merchant account in Corefy Dashboard

Step 1 - Open connection form

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

Step 2 - Fill in fields and select settings

  • User ID
  • Email
  • API key
  • Test Mode -> (enable if you are using sandbox credentials)

Success

You have connected B2pay 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.

Payment - MIN

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "cda5799b-feb6-4b5d-926d-018a078f6b9e",
      "service": "payment_card_eur_hpp",
      "currency": "EUR",
      "amount": 10
    }
  }
}

Payment - MAX

POST /api/payment-invoices 

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "77713f66-be92-4829-8dd8-aff17358ec97",
      "service": "payment_card_eur_hpp",
      "currency": "EUR",
      "amount": 10,
      "description": "Order #12345",
      "customer": {
        "reference_id": "076e343a-1623-4fcc-86cf-c55525d02b69",
        "email": "test@example.com",
        "phone": "+380912312321",
        "address": {
          "country": "DE",
          "city": "Berlin",
          "street": "Main street 1",
          "post_code": "10115"
        }
      }
    }
  }
}

Important

No Constants are configured for this connector - if a customer field is missing, it's simply not sent.

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

  • skip_too_many_requests_resolutions -> optional, boolean - when a status check is rate-limited by B2pay, suppresses the error detail and returns a plain pending result instead of a reconcile-required resolution with the error message attached.

Refunds

B2pay does not support refunds.

Additional info

  1. Active reconciliation is available - both the asynchronous callback and an active status request can finalize the payment.
  2. No recurring - this connector does not support saving/charging a token through Corefy.

FAQ / Troubleshooting

  • Invalid credentials / auth error -> verify User ID, Email and API key for the selected environment (test_mode)
  • Currency or service is not supported -> confirm allowed currencies/features in your B2pay account and in Corefy - only EUR and USD are available
  • Status checks keep returning an error during high load -> enable skip_too_many_requests_resolutions to treat rate-limited checks as a plain pending instead

Question

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