--- title: Notes regarding payment gateway credentials for Worldline users. description: If you use use Worldline (formerly Bambora) to accept payments on raisin, please be aware of the following account configurations required in order to successfully receive donations. Due to changes in --- [Skip to content](https://knowledgebase.akaraisin.com/en/support/payment-gateway-credentials-for-worldline#main-content) [Submit a request ↗](https://knowledgebase.akaraisin.com/en/support/kb-tickets/new?hsLang=en) [![raisin Logo](https://knowledgebase.akaraisin.com/hs-fs/hubfs/logo_raisin.png?height=40&name=logo_raisin.png)](https://raisinsoftware.org/) - [Help Centre](https://knowledgebase.akaraisin.com/en/support) Open main navigation Close main navigation - [Help Centre](https://knowledgebase.akaraisin.com/en/support) - [Submit a request ↗](https://knowledgebase.akaraisin.com/en/support/kb-tickets/new) How can we help out? - There are no suggestions because the search field is empty. 1. [Help Centre](https://knowledgebase.akaraisin.com/en/support?hsLang=en) 2. [Account & General Setup](https://knowledgebase.akaraisin.com/en/support/account-general-setup?hsLang=en) 3. [Payment](https://knowledgebase.akaraisin.com/en/support/account-general-setup?hsLang=en#payment) # Notes regarding payment gateway credentials for Worldline users. If you use use Worldline (formerly Bambora) to accept payments on raisin, please be aware of the following account configurations required in order to successfully receive donations. ### Security policy Due to changes in Worldline’s policies effective July 23, 2018, donations submitted via their payment gateway will require additional authentication. Raisin’s integration with Worldline supports the [**Username and Password authentication feature**](https://help.na.bambora.com/hc/en-us/articles/360045709674-How-do-I-use-Hash-Validation-or-the-Username-Authentication-). If you use Worldline to process donations in raisin and have not already activated this security feature, you must do so in order to accept donations. #### **What do you need to do to establish a Username and Password?** To set a Username and Password, follow these easy steps:  1. Go to the **Administration** section of your Worldline portal, then to **Account settings** and finally **Order Settings.** 2. Scroll down, under **Payment Gateway** you can select **Security/Authentication**, here you will find your username/password validation or hash validation. 3. Enter a "Username" and "Password" with no spaces, and save your changes. 4. Then, **log in to raisin** and visit the **Manage Payment Accounts** section in General Setup. 5. Click “Create Payment Account”. 6. Re-create your Payment Account, selecting “Worldline” as the Payment Gateway type. To identify this account, a distinct Account Name is recommended. 7. Enter your 9-digit Merchant ID, as well as both your Profile and Payment API Key's with no spaces before or after. 8. In the "Transaction Username" and "Transaction Password" fields, enter the Username and Password you just set in Worldline. 9. Click “Add”. This will be your new Payment Account moving forward. 10. Within each of your live events, **switch** the Payment Account from your old instance to the newly created one with Username and Password. 11. To ensure that the new account is functioning correctly, we **strongly advise** submitting a small donation to one of your raisin events. If successful, check in Worldline that the donation was also deposited. 12. As a final check, notify your Account Manager of the successful change. **Note:** Worldline's policy changes affect all of their integrations, so if you use your Worldline account to process online transactions elsewhere, similar changes will also be required. We recommend ensuring that these systems also support the Username and Password authentication method. raisin does not support hash validation at this time. Ensure this is switched off in your Bambora account to accept payments. ### Tokenization of recurring payments and offline payments Recurring donations and offline pledge payments are submitted to your gateway via a secure method of processing called "tokenization". In order to accept tokens, a Profile API Key and Payments API Key must be set up in your Worldline account. Follow the steps below to find the respective keys: #### Your Worldline Profile API Key: The profile key can be generated by following these steps: 1. In Worldline account settings, go to “Payment Profile Configuration” (found under the “Configuration” menu) option. Select “API access passcode” and “Generate New Code”. 2. ***IMPORTANT:** Under Credit Card Settings, please ensure that the 2nd checkbox (“Do not allow profile to be created with card data duplicated from an existing profile) is not turned on. Setting this on could potentially fail the transaction if two different different donors use the same credit card or same donor donates twice with the same credit card as raisin will create two different profiles with same credit card. The “Process all payment profile transactions as recurring payments” should also be unchecked.* #### Your Payments API Key: To find this in Worldline: 1. Go “Account Settings”, and choose to “Order Settings”. Under Security/Authentication, go to “API access passcode” and “Generate New Code” Once generated, be sure to always keep your keys safe. To connect with raisin, log in to your raisin account and go to **Manage Payment Accounts** in **General Setup**. Create a new account, and enter the keys into the corresponding fields, and then save. #### Further Requirements (Worldline) **Note:** If you're unable to pay for Offline Pledges from the Participant Centre, ensure that you uncheck "Require unique order numbers" box under the **Payment Profile Configuration** from within your Worldline Payment Account. --- If you have any questions or concerns regarding how to make these changes in raisin, please do not hesitate to contact your Account Manager directly. Worldline can also be reached at 1-833-226-2672 or [by request](https://help.na.bambora.com/hc/en-us/requests/new?utm_swu=9506). - [Account & General Setup](https://knowledgebase.akaraisin.com/en/support/account-general-setup?hsLang=en#main-content) - [Organization](https://knowledgebase.akaraisin.com/en/support/account-general-setup?hsLang=en#organization) - [Modules](https://knowledgebase.akaraisin.com/en/support/account-general-setup?hsLang=en#modules) - [Payment](https://knowledgebase.akaraisin.com/en/support/account-general-setup?hsLang=en#payment) - [Shared Content](https://knowledgebase.akaraisin.com/en/support/account-general-setup?hsLang=en#shared-content) - [Security Management](https://knowledgebase.akaraisin.com/en/support/account-general-setup?hsLang=en#security-management) - [Invoice](https://knowledgebase.akaraisin.com/en/support/account-general-setup?hsLang=en#invoice) - [Email](https://knowledgebase.akaraisin.com/en/support/account-general-setup?hsLang=en#email) - [Event Setup](https://knowledgebase.akaraisin.com/en/support/event-setup?hsLang=en#main-content) - [Event Details](https://knowledgebase.akaraisin.com/en/support/event-setup?hsLang=en#event-details) - [Go Live](https://knowledgebase.akaraisin.com/en/support/event-setup?hsLang=en#go-live) - [Registration Information](https://knowledgebase.akaraisin.com/en/support/event-setup?hsLang=en#registration-information) - [Sponsorship Items](https://knowledgebase.akaraisin.com/en/support/event-setup?hsLang=en#sponsorship-items) - [Content Management](https://knowledgebase.akaraisin.com/en/support/content-management?hsLang=en#main-content) - [Pages](https://knowledgebase.akaraisin.com/en/support/content-management?hsLang=en#pages) - [Sections and blocks](https://knowledgebase.akaraisin.com/en/support/content-management?hsLang=en#sections-and-blocks) - [Design](https://knowledgebase.akaraisin.com/en/support/content-management?hsLang=en#design) - [User Profile Fields](https://knowledgebase.akaraisin.com/en/support/content-management?hsLang=en#user-profile-fields) - [Edit Content (Legacy)](https://knowledgebase.akaraisin.com/en/support/content-management?hsLang=en#edit-content-legacy) - [Message Templates](https://knowledgebase.akaraisin.com/en/support/message-templates?hsLang=en) - [User Management](https://knowledgebase.akaraisin.com/en/support/user-management?hsLang=en#main-content) - [Surveys](https://knowledgebase.akaraisin.com/en/support/user-management?hsLang=en#surveys) - [Donors](https://knowledgebase.akaraisin.com/en/support/user-management?hsLang=en#donors) - [Participants & Teams](https://knowledgebase.akaraisin.com/en/support/user-management?hsLang=en#participants-teams) - [Tickets & Tables](https://knowledgebase.akaraisin.com/en/support/user-management?hsLang=en#tickets-tables) - [Revenue Management](https://knowledgebase.akaraisin.com/en/support/revenue-management?hsLang=en#main-content) - [Assign Package Codes (Solicitation Codes)](https://knowledgebase.akaraisin.com/en/support/revenue-management?hsLang=en#assign-package-codes-solicitation-codes) - [Offline Pledges](https://knowledgebase.akaraisin.com/en/support/revenue-management?hsLang=en#offline-pledges) - [Payment and fundraising information](https://knowledgebase.akaraisin.com/en/support/revenue-management?hsLang=en#payment-and-fundraising-information) - [Promo Codes](https://knowledgebase.akaraisin.com/en/support/revenue-management?hsLang=en#promo-codes) - [Transactions](https://knowledgebase.akaraisin.com/en/support/revenue-management?hsLang=en#transactions) - [Tax Receipts](https://knowledgebase.akaraisin.com/en/support/tax-receipts?hsLang=en#main-content) - [Manage](https://knowledgebase.akaraisin.com/en/support/tax-receipts?hsLang=en#manage) - [Setup](https://knowledgebase.akaraisin.com/en/support/tax-receipts?hsLang=en#setup) - [Analytics](https://knowledgebase.akaraisin.com/en/support/analytics?hsLang=en) - [Reports](https://knowledgebase.akaraisin.com/en/support/reports?hsLang=en#main-content) - [General Questions](https://knowledgebase.akaraisin.com/en/support/reports?hsLang=en#general-questions) - [General Donation](https://knowledgebase.akaraisin.com/en/support/reports?hsLang=en#general-donation) - [Downloads](https://knowledgebase.akaraisin.com/en/support/reports?hsLang=en#downloads) - [Common Reports](https://knowledgebase.akaraisin.com/en/support/reports?hsLang=en#common-reports) - [Pledge / Multi-Pledge](https://knowledgebase.akaraisin.com/en/support/reports?hsLang=en#pledge-multi-pledge) - [Export Data](https://knowledgebase.akaraisin.com/en/support/export-data?hsLang=en#main-content) - [Flat File](https://knowledgebase.akaraisin.com/en/support/export-data?hsLang=en#flat-file) - [Integrations](https://knowledgebase.akaraisin.com/en/support/integrations?hsLang=en#main-content) - [Google Analytics](https://knowledgebase.akaraisin.com/en/support/integrations?hsLang=en#google-analytics) - [Strava](https://knowledgebase.akaraisin.com/en/support/integrations?hsLang=en#strava) - [360MatchPro by Double the Donation](https://knowledgebase.akaraisin.com/en/support/integrations?hsLang=en#360matchpro-by-double-the-donation) - [Address Complete](https://knowledgebase.akaraisin.com/en/support/integrations?hsLang=en#address-complete) - [MailChimp](https://knowledgebase.akaraisin.com/en/support/integrations?hsLang=en#mailchimp) - [Live streaming](https://knowledgebase.akaraisin.com/en/support/integrations?hsLang=en#live-streaming) - [DonorPerfect](https://knowledgebase.akaraisin.com/en/support/integrations?hsLang=en#donorperfect) - [Customer Support](https://knowledgebase.akaraisin.com/en/support/customer-support?hsLang=en) [![Chill listening crop-3](https://knowledgebase.akaraisin.com/hs-fs/hubfs/logo_raisin.png?width=63&height=24&name=logo_raisin.png "Chill listening crop-3")](http://www.akaraisin.com) The digital fundraising partner to growing non-profits. Copyright © 2026 raisin Software | [Privacy Policy](https://raisinsoftware.org/privacy-policy/)