Buckaroo
Buckaroo is a well-known Dutch Payment Service Provider. The Buckaroo for FinDock extension supports several payment methods.
Please note your contract with Buckaroo needs to include the payment methods you wish to activate and use.
Multi-merchant | Multi-currency |
---|---|
Payment Method | One-time | Recurring | Refunds |
---|---|---|---|
Bancontact | |||
Card | |||
iDEAL | |||
iDEAL QR | |||
PayPal | |||
SEPA Direct Debit | |||
Sofort |
Prerequisites
- FinDock is installed and configured.
- WebHub is connected.
Install Buckaroo extension
Follow the standard procedure for installing payment processors to add the Buckaroo payment extension and activate payment methods.
Check and assign the required permissions. If you are using custom permission set groups, ensure the Buckaroo permission sets are assigned.
Configure Buckaroo notifications
To ensure FinDock can receive messages from Buckaroo, you need to make a few adjustments to certain settings in Buckaroo Plaza.
- Log into Buckaroo Plaza.
- Under My Buckaroo / Websites, click the Push settings tab.
- Configure these settings:
- Delayed and Push responses: enable for responses, refunds and invoices
- HTTP Method: POST
- Hash method: SHA1
Configure Buckaroo extension
To configure Buckaroo for FinDock:
- Launch the FinDock app and click the FinDock Setup tab.
- Go to Payment Processors & Methods.
- Under Installed Processors, click the Buckaroo processor entry.
- Click Add account.
- Fill in the settings for your Buckaroo account.
- Name: Enter a name for your account. If you have multiple accounts, ensure the name reflects the purpose or usage of the account.
- Available Card Brands: Select the card brands you want to display on payment forms. The list includes all supported brands, but only select brands included in your Buckaroo contract.
- Is Default: Toggle on if the account should be used as the default account for a transaction when no account is provided.
- Endpoint: This is the Buckaroo server address for initiating transactions. There are two options:
- Test:
https://testcheckout.buckaroo.nl/nvp/
- Production:
https://checkout.buckaroo.nl/nvp/
- Test:
- Secret Key: Used to sign the Buckaroo transactions requests. You can create a Secret Key in Buckaroo Plaza under Configuration / Secret / Secret Key.
- Log Requests: When enabled, all requests to Buckaroo are logged before being submitted. Use with care as this might be data-storage intensive.
- Website Key: The identifier for the website in Buckaroo Plaza under My Buckaroo / Websites / {yourwebsite}. The website key is in the table in the first row. If you have multiple websites, use the filter option in the top right to switch between websites.
- Mandate Prefix: If you use Buckaroo for direct debits, you need to enter the Mandate Prefix provided to you by Buckaroo. You can find it in your Buckaroo Plaza account under My Buckaroo / General information / Mandate prefix.
- Click Save.
If you have more than one account, see multi-merchant accounts. Once enabled, you can add more accounts to you Buckaroo extension setup.
You merchant account may also include Credit Management. If you have this enabled, the settings for credit management need to be filled out according to your Buckaroo contract.
Schedule Buckaroo Apex job (optional)
FinDock regularly listens for webhook notifications from Buckaroo. This is normally sufficient for keeping payment data in FinDock up to date with Buckaroo.
However, it is possible that under certain conditions notifications are missed. To ensure you have all the latest data from Buckaroo, you can schedule a special Apex job, called BuckarooPendingInstallmentsSchedule
, to handle updates on transactions.
The Apex batch can be scheduled as needed, but we suggest running it daily if you are going to use it. The job queries all Buckaroo installments in the Salesforce org with status โPendingโ and makes a callout to Buckaroo to get the latest status in Buckaroo and updates the installments accordingly as needed.
SEPA Direct Debit options with Buckaroo
If you use Buckaroo for SEPA Direct Debit payments, ensure the FinDock Core mandate service is set to automatically create mandates.
For direct debit payments created through the Payment API, including PayLinks and Giving Pages, FinDock creates mandates based on the mandate service settings. Upon creation, the mandates get the status Success and are activated. The mandate reference is then sent to Buckaroo as part of the first installment collection through a payment schedule.
If a SEPA Direct Debit payment is created by a Salesforce user, you only need to create the recurring payment and payment profile.
To manually create Salesforce records for new SEPA Direct Debit payments:
- Create a payment profile for the payer with record type IBAN.
- Fill in the required fields for the payer's bank account.
- Create a new recurring payment and link it to the payment profile.
- Run a payment schedule to collect the first installment.
If you are creating Salesforce records for a migration that includes existing mandates, be sure to set the migrated mandates to active (and status Success). You can migrate Buckaroo mandate reference different ways.
Mandates that should no longer be used for collection can be deactivated by emptying the Active checkbox on the record. This can be done manually for each Mandate record or automated through Salesforce tooling.
iDEAL QR with Payment Request Generator
You can generate open or closed iDEAL QRs with the Payment Request Generator using the Ideal reference type.
ย ย ย You may need to contact Buckaroo to enable iDEAL QR for your merchant account.
There are several input mapping fields to define for the generator run, such as amounts, description, expiration date, and QR image size. The QR image size depends on how the QR will be distributed. If no size is defined, FinDock uses the default size of 100x100 pixels.
ย ย ย Currently the maximum QR image size is 2000x2000 pixels. Larger values result in an error in the generator run, and FinDock does not send callouts to Buckaroo.
For the generated values, you need to create custom fields - preferably Buckaroo specific - on the target object to store (output mapping) the following values:
- Payment Reference: Text(255)
- Payment URL: Url(255)
- QR URL: Url(255)
- QR Base 64: Long text Area(32768)
In addition, create a custom Description field (Text(35)) as the input field on Campaign, Campaign Member or other, where you can provide the text that is shown to the payer on the iDEAL payment page.
Payment API message examples
To test your Buckaroo configuration, you can use the following examples with the Payment API.
One-time iDEAL with Buckaroo
The following message initiates a one-time iDEAL payment with Buckaroo, passing a issuer
to by-pass the Buckaroo bank selection screen.
{
"SuccessURL": "https://www.example.com/success",
"FailureURL": "https://www.example.com/error",
"Payer": {
"Contact": {
"SalesforceFields": {
"FirstName": "Eric",
"LastName": "Johnson",
"Email": "eric@johnson.com"
}
}
},
"OneTime": {
"Amount": "36"
},
"PaymentMethod": {
"Name": "Ideal",
"Processor": "Buckaroo",
"Parameters": {
"issuer" : "abnamro"
}
},
"Settings": {
"SourceConnector": "PaymentHub"
}
}
Recurring SEPA Direct Debit with Buckaroo
The following message initiates a recurring SEPA Direct Debit payment with Buckaroo, passing a holderName
and IBAN
parameter to set up the Mandate.
{
"SuccessURL": "https://www.example.com/success",
"FailureURL": "https://www.example.com/error",
"Payer": {
"Contact": {
"SalesforceFields": {
"FirstName": "Eric",
"LastName": "Johnson",
"Email": "eric@johnson.com"
}
}
},
"Recurring": {
"Amount": "25",
"Frequency": "Monthly",
"StartDate": "2020-11-01"
},
"PaymentMethod": {
"Name": "Direct Debit",
"Processor": "Buckaroo",
"Parameters" : {
"IBAN" : "NL13TEST0123456789",
"holderName" : "E. Johnson"
}
},
"Settings": {
"SourceConnector": "PaymentHub"
}
}
Recurring card with Buckaroo
The following message initiates a recurring card payment with Buckaroo. Important to note is that recurring card payments with Buckaroo require an initial payment on setup. This is indicated by the InitialPaymentonRecurring
parameter response from the Payment API.
{
"SuccessURL": "https://www.example.com/success",
"FailureURL": "https://www.example.com/error",
"Payer": {
"Contact": {
"SalesforceFields": {
"FirstName": "Eric",
"LastName": "Johnson",
"Email": "eric@johnson.com"
}
}
},
"OneTime": {
"Amount": 25
},
"Recurring": {
"Amount": "25",
"Frequency": "Monthly",
"StartDate": "2024-01-01"
},
"PaymentMethod": {
"Name": "CreditCard",
"Processor": "Buckaroo"
}
},
"Settings": {
"SourceConnector": "PaymentHub"
}
}
Buckaroo transaction types
Buckaroo uses transaction type codes to precisely distinguish payment actions such as collection, refunds and reversals across payment methods, card brands, and other factors.
The following is a list of the currently supported transaction type codes. These codes are recognized by FinDock and used as inbound report subtypes (for report type Buckaroo).
If you need to use a specific transaction type code that is not included in the tables below, please contact FinDock Support.
Transaction codes for collection
Code | Description |
---|---|
C004 | SEPA Direct Debit |
C005 | SEPA Direct Debit recurring |
C008 | Simple SEPA Direct Debit |
C021 | iDEAL |
C032 | Credit card - Carte Bancaire via Worldline |
C043 | Credit card - Mastercard via EMS |
C044 | Credit card - Visa via EMS |
C045 | Credit card - Carte Bleue via EMS |
C046 | Credit card - Maestro via EMS |
C047 | Credit card - Visa Electron via EMS |
C089 | Credit card - MasterCard via Worldline |
C090 | Bancontact |
C192 | Credit card - Visa via Worldline |
C251 | Maestro via Worldline |
C758 | Credit card - Carte Bancaire via EMS |
C801 | VISA Pay via Buckaroo |
C806 | Mastercard Pay via Buckaroo |
C811 | Maestro Pay via Buckaroo |
C812 | Maestro Pay Recurrent via Buckaroo |
C821 | Credit card - Carte Bancaire |
C822 | Credit card - Carte Bancaire |
C826 | Credit card - Carte Bleue Pay via Buckaroo |
C827 | Credit card - Carte Bleue Pay Recurrent via Buckaroo |
C860 | Credit card - Carte Bancaire Pay Collecting via Buckaroo |
C864 | Credit card - Carte Bleue Pay Collecting via Buckaroo |
C872 | Credit card - Maestro Pay Collecting via Buckaroo |
C876 | Credit card - MasterCard Pay Collecting via Buckaroo |
C880 | Credit card - Visa Pay Collecting via Buckaroo |
C884 | Credit card - Visa Electron Pay Collecting via Buckaroo |
C990 | Amex Pay |
N074 | Sofort banking |
V001 | Credit card - Mastercard via OmniPay |
V010 | PayPal |
V034 | Credit card - Maestro via OmniPay |
V043 | Credit card - Mastercard via EMS |
V044 | Credit card - Visa via EMS |
V045 | Credit card - Carte Bleue via EMS |
V046 | Credit card - Maestro via EMS |
V047 | Credit card - Visa Electron via EMS |
V089 | Credit card - MasterCard via Worldline |
V090 | Bancontact |
V094 | Credit card - Maestro Pay Recurrent via OmniPay |
V245 | Credit card - Maestro via Worldline |
V754 | Credit card - Carte Bancaire via Worldline |
V758 | Credit card - Carte Bancaire via EMS |
Transaction codes for refunds
Code | Description |
---|---|
C030 | Credit card - Carte Bancaire Refund via Worldline |
C079 | Credit card - Mastercard Refund via EMS |
C080 | Credit card - Visa Refund via EMS |
C081 | Credit card - Carte Bleue Refund via EMS |
C082 | Credit card - Maestro Refund via EMS |
C083 | Credit card - Visa Electron Refund via EMS |
C092 | Bancontact Refund |
C121 | Refund - iDEAL |
C194 | Credit card - Visa refund via Worldline |
C197 | Credit card - MasterCard refund via Worldline |
C252 | Credit card - Maestro Refund via Worldline |
C500 | SEPA Direct Debit Refund |
C543 | Refund - Sofort banking |
C757 | Credit Card - Carte Bancaire Refund via EMS |
C803 | VISA Refund via Buckaroo |
C808 | Mastercard Refund via Buckaroo |
C813 | Maestro Refund via Buckaroo |
C828 | Credit card - Carte Bleue Refund via Buckaroo |
C861 | Credit Card - Carte Bancaire Refund Collecting via Buckaroo |
C865 | Credit card - Carte Bleue Refund Collecting via Buckaroo |
C873 | Credit card - Maestro Refund Collecting via Buckaroo |
C877 | Credit card - MasterCard Refund Collecting via Buckaroo |
C881 | Credit card - Visa Refund Collecting via Buckaroo |
C885 | Credit card - Visa Electron Refund Collecting via Buckaroo |
C992 | Amex Refund |
V070 | Credit card - Maestro Refund via OmniPay |
V072 | Credit card - Amex Refund via Aexp |
V079 | Credit card - Mastercard Refund via EMS |
V080 | Credit card - Visa Refund via EMS |
V081 | Credit card - Carte Bleue Refund via EMS |
V082 | Credit card - Maestro Refund via EMS |
V083 | Credit card - Visa Electron Refund via EMS |
V110 | Refund - PayPal |
V197 | Credit card - MasterCard refund via Worldline |
V246 | Credit card - Maestro Refund via Worldline |
V753 | Credit Card - Carte Bancaire Refund via Worldline |
V757 | Credit Card - Carte Bancaire Refund via EMS |
Transaction codes for reversals
Code | Description |
---|---|
C501 | SEPA Direct Debit Storno |
C502 | SEPA Direct Debit Reject |