Create Merchant API 2.0
This documentation describes Create Merchant API version 2.0. For version 1.0 documentation, see Create an Australian customer.
After you collect all merchant information, send it to BlueSnap for review in a Create Merchant API request.
Endpoint
https://platform.bluesnap.com/services/2/merchants/new-application
Request Content
The following table describes request body properties to create an Australian customer:
Parameter | Required | Details |
---|---|---|
pfToken
|
Required if using Secure Customer Data Fields. Otherwise, no. | Secure Customer Data Fields token. |
approvalTesting
|
No | Include this parameter to test the customer-onboarding workflow. The customer account is not created but you receive an IPN and email as you would during an actual onboarding. Type: string Valid values: - APPROVED - RECOMMEND_APPROVE - RECOMMEND_DECLINE - DECLINE
|
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 you receive for your merchants will be determined during your account setup. For details, see Manage. |
metadata
|
No | Array of up to three custom metadata objects consisting of key/value
pairs. Limits: - Key names up to 40 characters long - Values up to 500 characters long. |
businessInfo
|
Yes | Container for the businessInfo
parameters.ASCII characters only. |
businessTradingName
|
Yes | The name of the business. Type: string Limits: - Maximum 60 characters - ASCII characters only, with special characters: ",()./-"
|
legalName
|
Yes | Legal name of the business. Type: string Limits: - Maximum 60 characters - ASCII characters only, with special characters: ",()./-"
|
productAndServiceDesc
|
Yes | Detailed description of the business, including information about
customers and merchant products, services, or both. Type: string Limits: Maximum 1500 characters |
phone |
Yes | Company phone number. Type: string Limits: 10 digits with no spaces, dashes, or any other characters |
businessType
|
Yes | Type of business. Valid values: - Association - Cooperative - Partnership - Proprietary Company - Public Company
|
businessCategory
|
Yes | Category of the business. Valid values: - Business Services - Educational Services - Charities/Donations - Miscellaneous Personal Services - Pharmacy - Miscellaneous Specialty Retail - Software - Travel Agencies & Tour Operators - Other |
address
|
Yes | Merchant's business address. Must be a registered business
address. Type: string Limits: Maximum 60 characters |
suburb
|
Yes | Merchant's business address suburb. Type: string Limits: Maximum 60 characters |
state |
Only if country is
US or
CA
|
Merchant's business address state/province/county/region. Type: string Limits: 2-letter code. For US and CA, refer to State and Province Codes. |
zip |
Yes | Merchant's business address zip code. Type: string Limits: Maximum 4 characters |
country
|
Yes | Merchant's business address country. Type: string Limits: 2-letter code. For Great Britain, Wales, or Scotland, use GB. For all other countries, refer to Country Codes. |
email |
Yes | The business email address provided by your merchant. Type: string Limits: - Minimum 7 characters - Maximum 100 characters - Plus sign (" + ")
character not permitted- Must have " @ "
character in string- Must include at least one period ( "." )Note:
After the application is approved, an access URL for your merchant's Chargeback Disputes Portal
is sent to this email address. |
accountUsername
|
Required for testing only. | 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 Limits: Value must be greater than zero |
businessRegistrationNumber
|
Yes | The business's registration number. Type: string Limits: Maximum 20 characters |
acnOrAbn
|
Yes | The business's Australian Company Number (ACN) or Australian Business
Number (ABN). Type: string Limits: Maximum 15 characters |
website
|
Yes | Main website for the merchant's business. Type: string Limits: - Maximum 100 characters - At least 1 "." required - No spaces |
additionalWebsites
|
No | Array of up to 10 website addresses for the merchant's business, in
addition to the main website .Type: string Limits: - Maximum 10 websites - Maximum 100 characters per website address - At least 1 "." required per website address - No spaces in website address |
averageTransactionAmount
|
Yes | Average transaction value for the current calendar year (must be in
USD). Type: string Limits: Numbers only |
highestTransactionAmount
|
Yes | Highest transaction value for the current calendar year (must be in
USD). Type: string Limits: Numbers only |
riskMonitoring
|
Yes | Provides an answer to the following question: Has your company been placed in any Fraud Monitoring or Risk Monitoring Program? Type: string Limits: yes or
no only
|
riskPayment
|
Yes | Provides an answer to the following question: Has your company been previously terminated by a payment processor, acquirer, financial institution, or operator of a payment system due to fraud, Credit Card Laundering, or excessively high chargeback rates? Type: string Limits: yes or
no only
|
riskByCommission
|
Yes | Provides an answer to the following question: Has your company been the subject of a complaint filed by a consumer protection agency? Type: string Limits: yes or
no only
|
bankingInfo
|
Yes | Container for the bankingInfo
parameters. |
bsb |
Yes | Routing number for the merchant's business bank account. Type: string Limits: - Maximum 6 characters - Numbers only |
accountNumber
|
Yes | Account number for the merchant's business bank account. Type: string Limits: - Maximum 9 characters - Numbers only |
minimalPayoutAmount
|
Yes | The minimum amount at which the customer will be paid. Until this value
is reached, funds continue to accumulate. Type: string Limits: Minimum $35 USD. |
refundReserve
|
Yes | The amount of funds kept in the account to cover refunds. Type: string Limits: Minimum $100 USD. |
paymentReference
|
No | Reference text that appears on the customer's bank statement when they
are paid out. Type: string Limits: Maximum 100 alphanumeric character |
ownershipInfoArr
|
Required if a person owns at least 25%. Otherwise, optional. | Container for the ownershipInfoArr
properties.Provide personal information for the owner, not the business. For example, provide the owner's personal address. 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 ownershipInfoArr ,
include companyRep
instead. |
ownerFirstName
|
Yes | Business owner's first name. Type: string Limits: - US: Maximum 40 characters - Other: Maximum 60 characters |
ownerLastName
|
Yes | Business owner's last name. Type: string Limits: - US: Maximum 40 characters - Other: Maximum 60 characters |
ownerDateOfBirth
|
Yes | The business owner's date of birth. Type: numeric with "/" Limits: - Must be in the format of MM/DD/YYYY - Maximum 10 characters |
ownerGovID
|
Yes | Business owner's government ID
number. Type: numeric Limits: - No special characters - US: Last 4 digits of SSN, numbers only - Other: Maximum 50 characters |
ownerPhone
|
Yes | Business owner's personal phone number. Type: string Limits: - No spaces, dashes, or any other characters - US/CA: 10 digits required - UK: Maximum 11 digits - Other: Maximum 15 digits |
ownerPercent
|
Yes | Percentage of the business that belongs to the owner. Limits: - Numbers only - Accepts up to two decimal places |
address
|
Yes | Business owner's home street address. Type: string Limits: - US: Maximum 40 characters - Other: Maximum 60 characters |
city |
Yes | Business owner's home address city. Type: string Limits: - US: Maximum 25 characters - Other: Maximum 60 characters |
state |
Only if country is
US or
CA
|
Business owner's home address state/province/county/region. Type: string Limits: 2-letter code. For US and CA, refer to State and Province Codes. |
zip |
Yes | Business owner's home address zip or postal code. Type: string Limits: - US: Must be 5 or 9 digits - CA: Maximum 7 characters, only 1 space allowed - AU: Maximum 4 characters - UK: Maximum 8 characters, spaces allowed - EU/ROW: Maximum 15 characters, spaces allowed |
country
|
Yes | Business owner's home address country. Type: string Limits: 2-letter code. For Great Britain, Wales, or Scotland, use GB . For
all other countries, refer to Country Codes. |
companyRep
|
Yes | Container for the companyRep
properties.Provide personal information for a person who oversees the business and has significant control over the entity. For example, provide the address and phone number of the CEO, COO, or CFO. |
companyRepFirstName
|
Yes | Company representative's first name. Type: string Limits: - US: Maximum 40 - Other: Maximum 60 |
companyRepLastName
|
Yes | Company representative's last name. Type: string Limits: - US: Maximum 40 - Other: Maximum 60 |
companyRepDateOfBirth
|
Yes | The company representative's date of birth. Type: numeric with "/" Limits: - Must be in the format of MM/DD/YYYY - Maximum 10 characters |
companyRepGovID
|
Yes | Company representative's government ID
number. Type: numeric Limits: - No special characters - US: Last 4 digits of SSN, numbers only - Other: Maximum 50 characters |
companyRepPhone
|
Yes | Company representative's personal phone number. Type: string Limits: - No spaces, dashes, or any other characters - US/CA: 10 digits required - UK: Maximum 11 digits - Other: Maximum 15 digits |
companyRepAddress
|
Yes | Company representative's home street address. Type: string Limits: - US: Maximum 40 characters - Other: Maximum 60 characters |
companyRepCity
|
Yes | Company representative's home address city. Type: string Limits: - US: Maximum 25 characters - Other: Maximum 60 characters |
companyRepState
|
Only if companyRepCountry
is US or
CA
|
Company representative's home address
state/province/county/region. Type: string Limits: 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: - US: Must be 5 or 9 digits - CA: Maximum 7 characters, only 1 space allowed - AU: Maximum 4 characters - UK: Maximum 8 characters, spaces allowed - EU/ROW: Maximum 15 characters, spaces allowed |
companyRepCountry
|
Yes | Company representative's home address country. Type: string Limits: 2-letter code. For Great Britain, Wales, or Scotland, use GB. For all other countries, refer to Country Codes. |
additionalCompanyReps
|
No | Array of up to 20 companyRep
objects, in addition to the primary companyRep
object. |
merchantAgreementsSign
|
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. The merchant must expressly consent to these terms and conditions before they begin using BlueSnap. |
merchantIp
|
Yes | Merchant's IP address. Type: string Limit: Maximum 45 characters IPv4 format: XXX.XXX.XXX.XXX IPv6 format: XXXX:XXXX:XXXX:XXXX:XXXX:XXXX:XXXX:XXXX
|
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
|
serviceAgreementDate
|
Yes | Date the merchant signed the merchant service agreement. You must present the merchant with a link to the BlueSnap Merchant Agreement and the merchant must sign it before they begin using BlueSnap. Type: string Must be in the format MM/DD/YYYY
|
Examples
Request Examples
Test Mode
Before using Test mode, review the Customer Onboarding steps.
curl -v -X POST https://platform.bluesnap.com/services/2/merchants/new-application \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
"approvalTesting": "APPROVED",
"businessInfo": {
"businessTradingName": "My Business",
"legalName": "Business LLC",
"productAndServiceDesc": "Provide a detailed description of your product or service.",
"phone": "5555555555",
"website": "https://www.website.com",
"businessType": "Public Company",
"businessCategory": "Software",
"country": "Australia",
"address": "1234 Main Street",
"suburb": "Austral",
"zip": "1111",
"email": "[email protected]",
"accountUsername": "MerchantUsername7709",
"salesVolume": "100000",
"businessRegistrationNumber": "BR123456",
"acnOrAbn": "770770770",
"averageTransactionAmount": "100",
"highestTransactionAmount": "1000",
"riskMonitoring": "No",
"riskPayment": "No",
"riskByCommission": "No"
},
"bankingInfo": {
"bsb": "084100",
"accountNumber": "123456789",
"minimalPayoutAmount": "100",
"refundReserve": "100"
},
"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",
"ownerPercent": "50"
},
{
"ownerFirstName": "Jamie",
"ownerLastName": "Doe",
"ownerDateOfBirth": "02/01/2000",
"ownerGovID": "2222",
"ownerPhone": "1555123456",
"address": "200 Broadway",
"city": "Happy",
"state": "FL",
"zip": "12345",
"country": "US",
"ownerPercent": "50"
}
],
"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/new-application \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
"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",
"zip": "1111",
"country": "Australia",
"address": "1234 Main Street",
"email": "[email protected]",
"accountUsername": "MerchantUsername7709",
"salesVolume": "100000",
"businessRegistrationNumber": "BR123456",
"businessTradingName": "My Business",
"acnOrAbn": "1",
"suburb": "Austral",
"averageTransactionAmount": "100",
"highestTransactionAmount": "1000",
"riskMonitoring": "No",
"riskPayment": "No",
"riskByCommission": "No"
},
"bankingInfo": {
"bsb": "084100",
"accountNumber": "123456789",
"minimalPayoutAmount": "100",
"refundReserve": "100"
},
"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",
"ownerPercent": "50"
},
{
"ownerFirstName": "Jamie",
"ownerLastName": "Doe",
"ownerDateOfBirth": "02/01/2000",
"ownerGovID": "2222",
"ownerPhone": "1555123456",
"address": "200 Broadway",
"city": "Happy",
"state": "FL",
"zip": "12345",
"country": "US",
"ownerPercent": "50"
}
],
"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/new-application \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
"approvalTesting": "APPROVED",
"pfToken": "5ad59e4389abba704ee2d61580d1d5cc1ba0ccf114470d404f771a198d99891b_"
}'
curl -v -X POST https: //platform.bluesnap.com/services/2/merchants/new-application \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
"metadata": [
{
"key": "merchantId",
"value": "12345678"
}
],
"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",
"zip": "1111",
"country": "Australia",
"address": "1234 Main Street",
"email": "[email protected]",
"accountUsername": "MerchantUsername7709",
"salesVolume": "100000",
"businessRegistrationNumber": "BR123456",
"businessTradingName": "My Business",
"acnOrAbn": "1",
"suburb": "Austral",
"averageTransactionAmount": "100",
"highestTransactionAmount": "1000",
"riskMonitoring": "No",
"riskPayment": "No",
"riskByCommission": "No"
},
"bankingInfo": {
"bsb": "084100",
"accountNumber": "123456789",
"minimalPayoutAmount": "100",
"refundReserve": "100"
},
"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",
"ownerPercent": "50"
},
{
"ownerFirstName": "Jamie",
"ownerLastName": "Doe",
"ownerDateOfBirth": "02/01/2000",
"ownerGovID": "2222",
"ownerPhone": "1555123456",
"address": "200 Broadway",
"city": "Happy",
"state": "FL",
"zip": "12345",
"country": "US",
"ownerPercent": "50"
}
],
"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/new-application \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
"businessInfo": {
"businessName": "My Business",
"legalName": "Business LLC",
"productAndServiceDesc": "Provide a detailed description of your product or service.",
"phone": "5555555555",
"website": "https://www.website.com",
"additionalWebsites": [
"https://www.example1.com",
"https://www.example2.com"
],
"businessType": "Public Corporation ",
"businessCategory": "Software",
"taxId": "77-0770770",
"zip": "1111",
"country": "Australia",
"address": "1234 Main Street",
"email": "[email protected]",
"accountUsername": "MerchantUsername7709",
"salesVolume": "100000",
"businessRegistrationNumber": "BR123456",
"businessTradingName": "My Business",
"acnOrAbn": "1",
"suburb": "Austral",
"averageTransactionAmount": "100",
"highestTransactionAmount": "1000",
"riskMonitoring": "No",
"riskPayment": "No",
"riskByCommission": "No"
},
"bankingInfo": {
"bsb": "084100",
"accountNumber": "123456789",
"minimalPayoutAmount": "100",
"refundReserve": "100"
},
"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",
"ownerPercent": "50"
},
{
"ownerFirstName": "Jamie",
"ownerLastName": "Doe",
"ownerDateOfBirth": "02/01/2000",
"ownerGovID": "2222",
"ownerPhone": "1555123456",
"address": "200 Broadway",
"city": "Happy",
"state": "FL",
"zip": "12345",
"country": "US",
"ownerPercent": "50"
}
],
"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/new-application \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
"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",
"zip": "1111",
"country": "Australia",
"address": "1234 Main Street",
"email": "[email protected]",
"accountUsername": "MerchantUsername7709",
"salesVolume": "100000",
"businessRegistrationNumber": "BR123456",
"businessTradingName": "My Business",
"acnOrAbn": "1",
"suburb": "Austral",
"averageTransactionAmount": "100",
"highestTransactionAmount": "1000",
"riskMonitoring": "No",
"riskPayment": "No",
"riskByCommission": "No"
},
"bankingInfo": {
"bsb": "084100",
"accountNumber": "123456789",
"minimalPayoutAmount": "100",
"refundReserve": "100"
},
"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",
"ownerPercent": "50"
},
{
"ownerFirstName": "Jamie",
"ownerLastName": "Doe",
"ownerDateOfBirth": "02/01/2000",
"ownerGovID": "2222",
"ownerPhone": "1555123456",
"address": "200 Broadway",
"city": "Happy",
"state": "FL",
"zip": "12345",
"country": "US",
"ownerPercent": "50"
}
],
"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"
},
"additionalCompanyReps": [
{
"companyRepFirstName": "John",
"companyRepLastName": "Doe",
"companyRepDateOfBirth": "10/10/1970",
"companyRepGovID": "4321",
"companyRepAddress": "321 North Street",
"companyRepCity": "Jupiter",
"companyRepState": "FL",
"companyRepZip": "54321",
"companyRepCountry": "US",
"companyRepPhone": "5551239876"
}
],
"merchantAgreementsSign": {
"serviceAgreementDate": "01/01/2019",
"pricingAgreementDate": "01/01/2019",
"merchantIp": "192.168.20.15"
}
}'
Response Examples
A successful request returns a 200 OK
response from BlueSnap. When we complete our automated review, you receive an IPN explaining the status of your merchant approval process.
{
"sandboxId": 1682291,
"message": "success"
}