Create a submerchant
curl --request POST \
--url https://sandbox-platform.jupico.com/v1/provisioning/submerchant \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"smApplicationId": "507f1f77bcf86cd799439012",
"identity": {},
"payoutBankAccounts": [
{
"accountRouting": "021000021",
"accountNumber": "1234567890",
"accountType": "checking",
"nameOnAccount": "Smith Enterprises LLC",
"isPreferred": true
}
]
}
'import requests
url = "https://sandbox-platform.jupico.com/v1/provisioning/submerchant"
payload = {
"smApplicationId": "507f1f77bcf86cd799439012",
"identity": {},
"payoutBankAccounts": [
{
"accountRouting": "021000021",
"accountNumber": "1234567890",
"accountType": "checking",
"nameOnAccount": "Smith Enterprises LLC",
"isPreferred": True
}
]
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({
smApplicationId: '507f1f77bcf86cd799439012',
identity: {},
payoutBankAccounts: [
{
accountRouting: '021000021',
accountNumber: '1234567890',
accountType: 'checking',
nameOnAccount: 'Smith Enterprises LLC',
isPreferred: true
}
]
})
};
fetch('https://sandbox-platform.jupico.com/v1/provisioning/submerchant', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const url = 'https://sandbox-platform.jupico.com/v1/provisioning/submerchant';
const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({
smApplicationId: '507f1f77bcf86cd799439012',
identity: {},
payoutBankAccounts: [
{
accountRouting: '021000021',
accountNumber: '1234567890',
accountType: 'checking',
nameOnAccount: 'Smith Enterprises LLC',
isPreferred: true
}
]
})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));{
"code": "<string>",
"success": true,
"message": "<string>",
"data": {
"subMerchantId": "507f1f77bcf86cd799439013",
"status": "review"
}
}Provisioning
Create a submerchant
Creates a submerchant linked to an application, with the business identity, fee configuration, and payout bank accounts. The submerchant is the entity that processes transactions once approved.
POST
https://sandbox-platform.jupico.com
/
v1
/
provisioning
/
submerchant
Create a submerchant
curl --request POST \
--url https://sandbox-platform.jupico.com/v1/provisioning/submerchant \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"smApplicationId": "507f1f77bcf86cd799439012",
"identity": {},
"payoutBankAccounts": [
{
"accountRouting": "021000021",
"accountNumber": "1234567890",
"accountType": "checking",
"nameOnAccount": "Smith Enterprises LLC",
"isPreferred": true
}
]
}
'import requests
url = "https://sandbox-platform.jupico.com/v1/provisioning/submerchant"
payload = {
"smApplicationId": "507f1f77bcf86cd799439012",
"identity": {},
"payoutBankAccounts": [
{
"accountRouting": "021000021",
"accountNumber": "1234567890",
"accountType": "checking",
"nameOnAccount": "Smith Enterprises LLC",
"isPreferred": True
}
]
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({
smApplicationId: '507f1f77bcf86cd799439012',
identity: {},
payoutBankAccounts: [
{
accountRouting: '021000021',
accountNumber: '1234567890',
accountType: 'checking',
nameOnAccount: 'Smith Enterprises LLC',
isPreferred: true
}
]
})
};
fetch('https://sandbox-platform.jupico.com/v1/provisioning/submerchant', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const url = 'https://sandbox-platform.jupico.com/v1/provisioning/submerchant';
const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({
smApplicationId: '507f1f77bcf86cd799439012',
identity: {},
payoutBankAccounts: [
{
accountRouting: '021000021',
accountNumber: '1234567890',
accountType: 'checking',
nameOnAccount: 'Smith Enterprises LLC',
isPreferred: true
}
]
})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));{
"code": "<string>",
"success": true,
"message": "<string>",
"data": {
"subMerchantId": "507f1f77bcf86cd799439013",
"status": "review"
}
}Authorizations
Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.
Body
application/json
Must be exactly 24 characters
Example:
"507f1f77bcf86cd799439012"
Identity details for the business and its owners.
Show child attributes
Show child attributes
Bank accounts where the merchant receives payouts.
Minimum array length:
1Show child attributes
Show child attributes
Service provider product ID
Maximum string length:
4Example:
"SP01"
UUID of a fees template with predefined pricing. If omitted, the default template is used.
Example:
"550e8400-e29b-41d4-a716-446655440000"
Response
201 - application/json
Submerchant created successfully
Last modified on August 31, 2026
Was this page helpful?

