
BitAndPay
International Transactions at the palm of your hand
Supports in this guide: Payments
Provider website: bitandpay.com
What you need to do for start processing transactions (brief summary)
- Get your credentials (from BitAndPay)
- Connect in Dashboard
- Send an API request
Prerequisites: get from BitAndPay
Contact your BitAndPay account manager to get your account verified and receive the following credentials.
- Merchant ID -> Corefy field
merchant_id. - Merchant Site ID -> Corefy field
merchant_site_id. - Merchant Token -> Corefy field
merchant_token. - Live URL -> Corefy field
live_url-> your account-specific endpoint, given by BitAndPay.
Payments processing (connect Provider account, create payment-invoice)
Connect Provider account in Corefy Dashboard
Step 1 - Open connection form
Open BitAndPay in the provider directory and press Connect at BitAndPay Provider Overview page in the New connection section.
Step 2 - Fill in fields and select settings
- Merchant ID
- Merchant Site ID
- Merchant Token
- Live URL
- Test Mode -> (enable if you are using sandbox credentials)
Choose Currency / Features; check with your Corefy account manager which are enabled for your account.
Success
You have connected BitAndPay Provider account!
First request to Corefy API (MIN)
What it does: creates a payment-invoice and redirects the customer to a BitAndPay-hosted page to complete the payment via Pay by Bank or BLIK, depending on what's enabled for your account.
Payment - MIN
POST /api/payment-invoices
{
"data": {
"type": "payment-invoice",
"attributes": {
"reference_id": "3a4b5c6d-7e8f-4a0b-8c12-3d4e5f6a7b8c",
"service": "paybybank_eur_hpp",
"currency": "EUR",
"amount": 10
}
}
}
Payment - MAX
POST /api/payment-invoices
{
"data": {
"type": "payment-invoice",
"attributes": {
"reference_id": "4b5c6d7e-8f9a-4b1c-8d23-4e5f6a7b8c9d",
"service": "paybybank_eur_hpp",
"currency": "EUR",
"amount": 10,
"customer": {
"reference_id": "cus_123",
"name": "John Smith",
"email": "johnsmith@gmail.com",
"phone": "+15551234567",
"address": {
"country": "DE",
"region": "Bavaria",
"city": "Munich",
"full_address": "1 Main street",
"post_code": "80331"
}
}
}
}
}
customer is entirely optional - everything is only used to prefill the hosted form, it never blocks the sale.
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
No Options are configured for this connector.
Constants (fallback fields)
Constants are static values that Corefy can send to the provider instead of dynamic data from your API request, when those fields are missing in the request. For BitAndPay, they only apply to the Pay by Bank method (paybybank_eur_hpp) - BLIK has no Constants.
Priority (predictable rule): 1. If a value is present in the request -> Corefy uses the request value 2. Else if the constant is set -> Corefy uses the constant 3. Else -> provider may reject the request or apply its defaults (depends on provider)
Currently available constants (constant -> Corefy API field)
email->customer.emailphone->customer.phonefirst_name->customer.name(first part)last_name->customer.name(second part)country_code->customer.address.countrystate->customer.address.regioncity->customer.address.cityaddress->customer.address.full_addresspost_code->customer.address.post_codeuser_ip->customer.metadata.ip
Refunds
This connector does not support refunds.
Additional info
- Callback routing is automatic - Corefy generates the callback/return URLs per transaction, nothing to configure in BitAndPay's own back-office.
- Active reconciliation is available - Payments support an active status request, in addition to the asynchronous callback.
- No payouts - this connector does not support payouts through Corefy.
FAQ / Troubleshooting
- Invalid credentials / auth error -> verify Merchant ID/Merchant Site ID/Merchant Token/Live URL for the selected environment
- Refund request fails -> refunds aren't supported by this connector
- Currency or service is not supported -> confirm allowed currencies/methods in your BitAndPay account and in Corefy
Question
Still looking for help connecting your BitAndPay account? Please contact our support team!