Braintree Marketplace

Confirming Sub-merchant Onboardinganchor

availability

If you're a new merchant looking for a marketplace solution, contact our Sales team.

As part of the sub-merchant onboarding process for Braintree Marketplace, you can confirm the creation of a merchant account as either approved or declined via a webhook. The webhook is triggered after the sub-merchant's information has been verified with several third-party services.

Webhooks allow Braintree to push messages to your servers when you configure a webhook endpoint URL. If you are not using webhooks already, you will need to follow the webhooks guide to get started.

note

The {{ formatVariable "bt_signature" serverSdk.name }} and {{ formatVariable "bt_payload" serverSdk.name }} variables in the code snippets below represent parameters received from the webhook POST request. For more information, read the documentation on parsing webhooks.

Sub-merchant approvedanchor

Once you have webhooks configured, you can listen for a SubMerchantAccountApproved webhook that looks like this:

  1. Node
gateway.webhookNotification.parse(btSignature, btPayload, function (err, webhookNotification) {
  webhookNotification.kind === braintree.WebhookNotification.Kind.SubMerchantAccountApproved
  // true
  webhookNotification.merchantAccount.status
  // "active"
  webhookNotification.merchantAccount.id
  // "blueLaddersStore"
  webhookNotification.merchantAccount.masterMerchantAccount.id
  // "14laddersMarketplace"
  notification.merchantAccount.masterMerchantAccount.status
  // "active"
});

Once you've confirmed that the new sub-merchant has been successfully onboarded, you can start to run transactions on their account.

Sub-merchant declinedanchor

You can also listen for a SubMerchantAccountDeclined webhook that looks like this:

  1. Node
gateway.webhookNotification.parse(btSignature, btPayload, function (err, webhookNotification) {
  webhookNotification.kind === braintree.WebhookNotification.Kind.SubMerchantAccountDeclined
  // true
  webhookNotification.message
  // "Credit score is too low"
  webhookNotification.errors
  // { . . . }
});

If it is Declined, the webhook will contain validation errors indicating why the sub-merchant was declined. There are several reasons this can occur:

  • Failed OFAC
  • Failed Mastercard MATCH
  • Failed KYC
  • SSN invalid
  • SSN matches deceased person

See merchant account validations for specific errors.

In this case, we'll need to gather more information about the sub-merchant in order to approve them. Please contact our Customer Success team with the sub-merchant's first and last name and we'll be happy to assist.

See also


Next Page: Creating Transactions →