Legacy API Version
You are currently viewing documentation for Create Merchant API version 1.0. Version 1.0 is the legacy version and will be deprecated in June 2025.
To view the Create Merchant API 2.0, go to EU Customer.
EU Merchant Countries
To use the Create Merchant API request below, merchants must be based out of one of the following countries:
- Austria
- Belgium
- Bulgaria
- Croatia
- Cyprus
- Czech Republic
- Denmark
- Estonia
- Faroe Islands
- Finland
- France
- Germany
- Gibraltor
- Greece
- Guernsey
- Hungary
- Iceland
- Ireland
- Italy
- Latvia
- Liechtenstein
- Lithuania
- Luxembourg
- Malta
- Netherlands
- Norway
- Poland
- Portugal
- Romania
- San Marino
- Slovakia
- Slovenia
- Spain
- Sweden
- Switzerland
Create the merchant account
When you have collected all your merchant information, use the Create Merchant API request to send to BlueSnap for review.
Create Merchant API Request
https://platform.bluesnap.com/services/2/merchants/bank-update/{merchantId}
Create Merchant API Parameters for EU Customers
Parameter | Required | Details |
---|---|---|
pfToken | No. Include if using Secure Customer Data Fields | Secure Customer Data Fields token. |
approvalTesting | No | If you include this parameter, you are testing the customer-onboarding workflow; the customer
account is NOT created but you will receive an IPN and an email as you would in an actual
onboarding. Refer to the testing section for details on how to use this parameter. Type: string Valid values:
|
defaultIPN | No | Only use if you want to set up a different notification endpoint for each of your merchants. The endpoint URL you define with this parameter will receive transactional IPNs (Webhooks). The IPNs (Webhooks) you receive for your merchants will be determined during your account setup. Learn more. |
businessInfo (Click this row to show/hide the full list.) |
Yes | Container for the businessInfo parameters ASCII characters only |
businessName | Yes | Customer-facing name of the business Type: string Limits:
|
legalName | Yes | Legal name of the business Type: string Limits:
|
productAndServiceDesc | Yes | Provides a detailed description of the business including information about
customers and the merchant's products, services, or both
Type: string Limit: Maximum 1500 characters |
phone | Yes | Company phone number Type: string Limit: Maximum 15 digits with no spaces, dashes, or any other characters |
website | Yes | Main website for the merchant's business Type: string Limits:
|
businessType | Yes | Type of business Valid values:
|
businessCategory | Yes |
Category of the business. Valid values:
|
taxId (VAT) | Yes | Merchant's tax ID number Do NOT include the 2-character country code in this field. Type: alphanumeric 15 characters |
address | Yes | Merchant's business address. Must be a registered business address. Type: string Limit: Maximum 60 characters |
city | Yes | Merchant's business address city Type: string Limit: Maximum 60 characters |
state | Only if country is Germany | Merchant's business address state/province/county/region Type: string Limit: 2-letter code. (Refer to State and Province Codes.) |
zip | Yes | Merchant's business address zip/postal code Type: string Limits: Maximum 15 characters, spaces allowed |
country | Yes | Merchant's business address country Type: string Limit: 2-letter code Refer to Country Codes. |
Yes | The business email address provided by your merchant.
Type: string Limits:
Note: Once the application is approved, an access URL for your merchant's Chargeback Disputes Portal will be sent to this email address. |
|
salesVolume | Yes | Merchant's current annual sales volume (Must be in USD) Type: numeric Limit: Value must be greater than zero |
businessRegistrationNumber | Yes | The business's registration number Type: string Limit: Maximum 20 characters |
bankingInfo (Click this row to show/hide the full list.) |
Yes | Container for the bankingInfo parameters. Payouts to the merchant's bank will be in EUR. |
minimalPayoutAmount | Yes | The minimum amount at which the customer will be paid. Until this value is reached,
funds continue to accumulate. Type: string Limit:
|
refundReserve | Yes | The amount of funds kept in the account to cover refunds. Type: string Limits:
|
bankCountry | Yes | Country where the bank is located. Type: string Limit: 2-letter code Refer to Country Codes. |
bic | Yes | Bank Identification Code, also known as a SWIFT code Type: string Limit: Maximum 11 characters |
iban | Yes | International Bank Account Number Type: string Limit: Maximum 34 characters |
paymentReference | No |
Reference text that appears on the customer's bank statement when they are paid out. Type: string Limit: Maximum 100 alphanumeric characters |
ownershipInfoArr (Click this row to show/hide the full list.) |
Yes, if anyone owns at least 25%. | Container for the ownershipInfoArr
parameters
Note: The information provided in this section should be the personal information of the owner, not for the business. For example, provide the owner's address, not the business address. |
ownerFirstName | Yes | Business owner's first name Type: string Limits:
|
ownerLastName | Yes | Business owner's last name Type: string Limits:
|
ownerDateOfBirth | Yes | The business owner's date of birth. Type: numeric with "/" Limits:
|
ownerGovID | Yes | Business owner's government ID number Type: numeric Limits:
|
ownerPhone | Yes | Business owner's personal phone number Type: string Limits:
|
address | Yes | Business owner's home street address Type: string Limits:
|
city | Yes | Business owner's home address city Type: string Limits:
|
state | Only if companyRepCountry is US or CA | Business owner's home address state/province/county/region Type: string Limit: 2-letter code. (For US or CA, refer to State and Province Codes.) |
zip | Yes | Business owner's home address zip/postal code Type: string Limits:
|
country | Yes | Business owner's home address country Type: string Limit: 2-letter code Refer to Country Codes. |
companyRep (Click this row to show/hide the full list.) |
Yes | Container for the companyRep parameters
Information of the person who oversees the business and has significant control over the
entity. For example, the CEO, COO, or CFO. Note: Information provided in this section should be the personal information of the representative, not for the business. For example, provide the representative's address and phone number, not the business address and phone number. |
companyRepFirstName | Yes | Company representative's first name Type: string Limit:
|
companyRepLastName | Yes | Company representative's last name Type: string Limit:
|
companyRepDateOfBirth | Yes | Company representative's date of birth. Type: numeric with "/" Limits:
|
companyRepGovID | Yes | Company representative's government ID number Type: numeric Limits:
|
companyRepPhone | Yes | Company representative's personal phone number Type: number Limit:
|
companyRepAddress | Yes | Company representative's home street address Type: string Limit:
|
companyRepCity | Yes | Company representative's home address city Type: string Limit:
|
companyRepState | Only if companyRepCountry is US or CA | Company representative's home address state/province/county/region Type: string Limit: 2-letter code. (For US and CA, refer to State and Province Codes.) |
companyRepZip | Yes | Company representative's home address zip or postal code Type: string Limits:
|
companyRepCountry | Yes | Company representative's home address country Type: string Limit: 2-letter code For Great Britain, Wales, or Scotland, use GB. For all other countries, refer to Country Codes. |
merchantAgreementsSign (Click this row to show/hide the full list.) |
Yes |
Container for the merchantAgreementsSign parameters. Important: In addition to the agreements below, you must present your merchant with a link to the latest BlueSnap Merchant Terms & Conditions (available here) and the merchant must expressly consent to it before they begin using BlueSnap. |
serviceAgreementDate | Yes |
Date the merchant signed the merchant service agreement. You must present the merchant with a link to the BlueSnap Merchant Agreement (available here) and the merchant must sign it before they begin using BlueSnap. Type: string |
pricingAgreementDate | Yes | Date the merchant signed the pricing agreement. You must present the merchant with a link to the BlueSnap Pricing Agreement and the merchant must sign it before they begin using BlueSnap. Type: string |
merchantIp | Yes | Merchant's IP address Type: string Limit: Maximum 45 characters Format: IPv4 xxx.xxx.xxx.xxx IPv6 xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx |
Create Merchant API Request examples
Note
Before using Test mode, review the Customer Onboarding steps.
curl -v -X POST https://platform.bluesnap.com/services/2/merchants/application \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
"approvalTesting": "APPROVED",
"businessInfo": {
"businessName": "Doing Business As Name Germany",
"legalName": "Legal Business Name Germany",
"productAndServiceDesc": "Products",
"phone": "12757781072",
"website": https://www.website.com,
"businessType": "Public Corporation",
"businessCategory": "Software",
"taxId": "876876876",
"address": "Lychener Str. 60",
"city": "Berlin",
"state": "BE",
"zip": "10437",
"country": "DE",
"email": first.last@merchant.com,
"salesVolume": "100000",
"businessRegistrationNumber": "HRB 12217"
},
"bankingInfo": {
"minimalPayoutAmount": "100",
"refundReserve": "100",
"bankCountry": "DE",
"bic": "LMCIFR2A",
"iban": "DE7615489048180007263550158"
},
"ownershipInfoArr": [
{
"ownerFirstName": "Bertrand",
"ownerLastName": "Russell",
"ownerDateOfBirth": "01/01/1962",
"ownerGovID": "654654-6545",
"ownerPhone": "12757781072",
"address": "1234 Main Street",
"city": "Berlin",
"zip": "10458",
"country": "DE"
},
{
"ownerFirstName": "Ludwig",
"ownerLastName": "Wittgenstein",
"ownerDateOfBirth": "03/11/1971",
"ownerGovID": "654654-6545",
"ownerPhone": "12757781072",
"address": "1234 Lein Str.",
"city": "Berlin",
"zip": "10277",
"country": "DE"
}
],
"companyRep": {
"companyRepFirstName": "Mary",
"companyRepLastName": "Wollstonecraft",
"companyRepDateOfBirth": "12/13/1967",
"companyRepGovID": "98798798798",
"companyRepAddress": "123 Lein Str.",
"companyRepCity": "Berlin",
"companyRepZip": "10277",
"companyRepCountry": "DE",
"companyRepPhone": "12757981072"
},
"merchantAgreementsSign": {
"serviceAgreementDate": "01/01/2023",
"pricingAgreementDate": "01/01/2023",
"merchantIp": "192.168.20.15"
}
}
curl -v -X POST https://platform.bluesnap.com/services/2/merchants/application \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
"approvalTesting": "APPROVED",
"pfToken": "5ad59e4389abba704ee2d61580d1d5cc1ba0ccf114470d404f771a198d99891b_"
}'
Response
If your request is successful, you receive a 200 OK
response from BlueSnap. When our automated review is complete, you receive an IPN explaining the status of your merchant approval process.
{
"sandboxId": 1682291,
"message": "success"
}