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/application

Create Merchant API Parameters for EU or UK 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: APPROVED RECOMMEND_APPROVE RECOMMEND_DECLINE DECLINE
defaultIPN	No	If included, this URL will be used to receive the following IPNs: AUTH_ONLY CANCEL_ON_RENEWAL CANCELLATION CANCELLATION_REFUND CHARGE CHARGEBACK CHARGEBACK_STATUS_CHANGED CONTRACT_CHANGE DECLINE FAILED_PAYOUT_TRANSFER RECURRING REFUND SUBSCRIPTION_REMINDER
businessInfo (Click this row to show/hide the full list.)	Yes	Container for the businessInfo parameters
businessName	Yes	Customer-facing name of the business Type: string Limit: Maximum 60 characters
legalName	Yes	Legal name of the business Type: string Limit: Maximum 60 characters
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 15 characters with no spaces, dashes, or any other characters
website	Yes	Main website for the merchant's business Type: string Limit: Maximum 200 characters
businessType	Yes	Type of business Valid values: Limited Liability Non-profit Partnership Private Corporation Public Corporation Sole Proprietorship
businessCategory	Yes	Category of the business Valid values: Business Services Education Non-profit Personal Services Pharmacy Physical Goods Software Travel Other
taxId	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, CA, Germany, or US	Merchant's business address state/province/county/region Type: string Limit: 2-letter code. (For CA, Germany, and US, refer to State and Province Codes.)
zip	Yes	Merchant's business address zip/postal code Type: string Limit: Maximum 15 characters
country	Yes	Merchant's business address country Type: string Limit: 2-letter code For Great Britain, Wales, or Scotland, use use GB. For all other countries, refer to Country Codes.
email	Yes	Email address of the entity to receive all communications. Type: string Limits: Minimum 7 characters Maximum 150 characters "+" character not permitted Note: Once the application is approved, an access URL for your BlueSnap Production account will be sent to this email address.
accountUsername	Required only for testing.	Merchant's account username. This is for the BlueSnap Merchant Portal credentials for the merchant. Type: alphanumeric Limits: Maximum 18 characters Must be unique Only accepts the following special characters: - . _ ( ) :
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 8 characters
bankingInfo (Click this row to show/hide the full list.)	Yes	Container for the bankingInfo parameters
payoutCurrency	Yes	Currency in which the merchant will be paid. Type: string Limit: EUR if the bussiness country is set to any EU country, and GBP if the business country is set to UK
minimalPayoutAmount	Yes	The minimum amount at which the customer will be paid. Until this value is reached, funds continue to accumulate. Type: string Limit: This must be specified in the currency selected in payoutCurrency. Minimum value is the equivalent of $35 USD.
refundReserve	Yes	The amount of funds kept in the account to cover refunds. Type: string Limits: This must be specified in the currency selected in payoutCurrency. Minimum value is the equivalent of $100 USD
bankCountry	Only if the payoutCurrency is EUR.	Country where the bank is located. Type: string Limit: 2-letter code For Great Britain, Wales, or Scotland, use GB. For all other countries, refer to Country Codes.
bic GBP: sortOrder (also known as a Sort Code, National Sort Code [NSC], SWIFT code)	Only if the payoutCurrency is EUR.	Bank Identification Code also known as a SWIFT code Type: string Limit: Maximum 60 characters
sortOrder	Only if the payoutCurrency is GBP.	Bank Identification Code (also known as a Sort Code, National Sort Code [NSC], SWIFT code) Type: string Limit: Maximum 60 characters
iban	Only if the payoutCurrency is EUR.	International Bank Account Number Type: string Limit: Maximum 60 characters
accountNumber	Only if the payoutCurrency is GBP.	Bank account number. Type: string Limit: US: Maximum 17 characters Other: Maximum 34 alphanumeric characters
routingNumber	No	Routing number for the merchant's business bank account Type: string Limit: Maximum 9 characters
bankState	No	US state where the bank is located Type: string Limit: 2-letter code. (Refer to State Codes.)
accountType	Only if the payoutCurrency is USD	Account number for the merchant's business bank account Type: string Valid values: Checking Savings
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 An owner must have at least 25% ownership of the company. You can have up to 4 owners. If no one person owns at least 25%, do not include this section; use companyRep instead. 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 Limit: US: Maximum 40 Other: Maximum 60
ownerLastName	Yes	Business owner's last name Type: string Limit: US: Maximum 40 Other: Maximum 60
ownerDateOfBirth	Yes	The business owner's date of birth. Type: numeric Limit: Must be in the format of MM/DD/YYYY
ownerGovID	Yes	Business owner's government ID number Type: alphanumeric Limit: no special characters US: Last 4 of the SSN Other: Maximum 50
ownerPhone	Yes	Business owner's personal phone number Type: string Limit: No spaces, dashes, or any other characters US: Maximum 10 Other: Maximum 15
address	Yes	Business owner's home street address Type: string Limit: US: Maximum 40 Other: Maximum 60
city	Yes	Business owner's home address city Type: string Limit: US: Maximum 25 Other: Maximum 60
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 Limit: US: Maximum 10 Other: Maximum 15
country	Yes	Business owner'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.
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: US: Maximum 40 Other: Maximum 60
companyRepLastName	Yes	Company representative's last name Type: string Limit: US: Maximum 40 Other: Maximum 60
companyRepDateOfBirth	Yes	Company representative's date of birth. Type: numeric Limit: Must be in the format of MM/DD/YYYY
companyRepGovID	Yes	Company representative's government ID number Type: alphanumeric Limit: no special characters US: Last 4 of the SSN Other: Maximum 50
companyRepPhone	Yes	Company representative's personal phone number Type: string Limit: No spaces, dashes, or any other characters US: Maximum 10 Other: Maximum 15
companyRepAddress	Yes	Company representative's home street address Type: string Limit: US: Maximum 40 Other: Maximum 60
companyRepCity	Yes	Company representative's home address city Type: string Limit: US: Maximum 25 Other: Maximum 60
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 Limit: US: Maximum 10 Other: Maximum 15
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 Must be in the format MM/DD/YYYY
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 Must be in the format MM/DD/YYYY
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

Here are some 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": "My Business",
        "legalName": "Business LLC",
        "productAndServiceDesc": "Provide a detailed description of your product or service.",
        "phone": "5555555555",
        "website": "https://www.website.com",
        "businessType": "Public Corporation ",
        "businessCategory": "Software",
        "taxId": "77-0770770",
        "address": "1234 Main Street",
        "city": "City",
        "zip": "12345",
        "country": "France",
        "email": "[email protected]",
        "accountUsername": "MerchantUsername77017",
        "salesVolume": "100000",
        "businessRegistrationNumber": "BR123456"
    },
    "bankingInfo": {
        "minimalPayoutAmount": "100",
        "refundReserve": "100",
        "payoutCurrency": "EUR",
        "bankCountry": "EE",
        "bic": "CMCIFR2A",
        "iban": "FR7615489048180007263550158"
    },
    "ownershipInfoArr": [
        {
            "ownerFirstName": "Chris",
            "ownerLastName": "Jones",
            "ownerDateOfBirth": "01/01/2000",
            "ownerGovID": "1111",
            "ownerPhone": "1555123456",
            "address": "1234 Main Street",
            "city": "Waltham",
            "state": "FL",
            "zip": "02453",
            "country": "US"
        },
        {
            "ownerFirstName": "Jamie",
            "ownerLastName": "Doe",
            "ownerDateOfBirth": "02/01/2000",
            "ownerGovID": "2222",
            "ownerPhone": "1555123456",
            "address": "200 Broadway",
            "city": "Happy",
            "state": "FL",
            "zip": "12345",
            "country": "US"
        }
    ],
    "companyRep": {
        "companyRepFirstName": "Jesse",
        "companyRepLastName": "Smith",
        "companyRepDateOfBirth": "12/13/1967",
        "companyRepGovID": "1234",
        "companyRepAddress": "123 South Street",
        "companyRepCity": "Happy",
        "companyRepState": "FL",
        "companyRepZip": "12345",
        "companyRepCountry": "US",
        "companyRepPhone": "1555123456"
    },
    "merchantAgreementsSign": {
        "serviceAgreementDate": "01/01/2019",
        "pricingAgreementDate": "01/01/2019",
        "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",
    "businessInfo": {
        "businessName": "My Business",
        "legalName": "Business LLC",
        "productAndServiceDesc": "Provide a detailed description of your product or service.",
        "phone": "5555555555",
        "website": "https://www.website.com",
        "businessType": "Public Corporation ",
        "businessCategory": "Software",
        "taxId": "77-0770770",
        "address": "1234 Main Street",
        "city": "City",
        "zip": "12345",
        "country": "GB",
        "email": "[email protected]",
        "accountUsername": "MerchantUsername77015",
        "salesVolume": "100000",
        "businessRegistrationNumber": "BR123456"
    },
    "bankingInfo": {
        "minimalPayoutAmount": "100",
        "refundReserve": "100",
        "payoutCurrency": "GBP",
        "sortOrder": "400507",
        "accountNumber": "12345678"
    },
    "ownershipInfoArr": [
        {
            "ownerFirstName": "Jamie",
            "ownerLastName": "Doe",
            "ownerDateOfBirth": "01/01/2019",
            "ownerGovID": "1111",
            "ownerPhone": "9729999999",
            "address": "1234 Main Street",
            "city": "City",
            "state": "FL",
            "zip": "12345",
            "country": "us"
        },
        {
            "ownerFirstName": "Jamie",
            "ownerLastName": "Doe",
            "ownerDateOfBirth": "02/01/2000",
            "ownerGovID": "2222",
            "ownerPhone": "1555123456",
            "address": "200 Broadway",
            "city": "Happy",
            "state": "FL",
            "zip": "12345",
            "country": "US"
        }
    ],
    "companyRep": {
        "companyRepFirstName": "Jesse",
        "companyRepLastName": "Smith",
        "companyRepDateOfBirth": "12/13/1967",
        "companyRepGovID": "1234",
        "companyRepAddress": "123 South Street",
        "companyRepCity": "Happy",
        "companyRepState": "FL",
        "companyRepZip": "12345",
        "companyRepCountry": "US",
        "companyRepPhone": "1555123456"
    },
    "merchantAgreementsSign": {
        "serviceAgreementDate": "01/01/2019",
        "pricingAgreementDate": "01/01/2019",
        "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" 
}