Step 3: Provision Merchant Account

POST {{sandboxAPI}}/identities/{{identity}}/merchants

Now that we’ve associated a Payment Instrument with our seller’s Identity we’re ready to provision a Merchant account. This is the last step before you can begin processing on their behalf. Luckily you’ve already done most of the heavy lifting. Just make one final POST request, and you’ll be returned a Merchant resource. Take a second to inspect this newly created resource, particularly the onboarding_state, which can have 3 potential states that indicate its ability to process and settle funds:

PROVISIONING: Request is pending (state will typically change after two minutes)

processingenabled: False settlementenabled: False APPROVED: Merchant has been approved and can begin processing

processingenabled: True settlementenabled: True REJECTED: Merchant was rejected by the processor either because the information collected was invalid or it failed one of a number of regulatory and/or compliance checks (e.g. KYC, OFAC or MATCH)

processingenabled: False settlementenabled: False

Request Body

{"tags"=>{"key_2"=>"value_2"}}

HEADERS