Skip to main content
PlatformManaged Solutions
Sandbox

Adding Managed Bill Pay to an Existing Build

This guide walks you through adding a Managed Solution to a build you already have on the Unit Platform — specifically, adding Managed Bill Pay to a Banking build you've already configured.

To get started, make sure you've signed up for Unit's Sandbox environment - if you haven't yet, please do so before proceeding.

4 hours

Applications API​

When creating an application via the Applications API, add BillPay to the requestedProducts array in your request. The requestedProducts field is available for sole proprietorship and business applications.

See the Create Sole Proprietor Application and Create Business Application endpoints for details.

Application Form​

When creating an application form via the Application form, add BillPay to the requestedProducts array in your request. The requestedProducts field is available for SoleProprietorship, SingleMemberBusiness, or MultipleMemberBusiness application types.

See the Create Application Form endpoint for details.

Embedding the Managed Solution component​

After the application is approved, you can embed the Managed Solution component using a customer token for bill pay.

For details on customer authentication see the Authentication guide.

Customer token​

Bill Pay required scopes:

ResourceRead ScopeWrite Scope
Vendorsbillpay-vendors
Billsbillpay-bills
Linked Accountsbillpay-linked-accounts

Use following request to create a customer token

curl --location 'https://api.s.unit.sh/customers/10116/token' \
--header 'Content-Type: application/vnd.api+json' \
--header 'Authorization: ${TOKEN}' \
--data '{
	"data":{
		"type":"customerToken",
        "attributes": {
               "scope": "applications customers accounts cards transactions statements payments repayments counterparties authorizations billpay-bills billpay-linked-accounts rewards settlements billpay-vendors linked-accounts authorization-requests check-deposits received-payments check-payments customer-token-write",
            "upgradableScope": "customers-write accounts-write cards-write cards-sensitive cards-sensitive-write transactions-write payments-write repayments-write payments-write-counterparty payments-write-linked-account payments-write-ach-debit counterparties-write linked-accounts-write authorization-requests-write check-deposits-write received-payments-write check-payments-write billpay-bills-write billpay-vendors-write"
        }
	}
}'

Embedding the Managed Solution component​

<html>
    <head>
        <script type="module"
            src="https://ui.s.unit.sh/release/latest/components-extended.es.js"
        ></script>
        <!--        For production environment use `https://ui.unit.co/release/latest/components-extended.es.js` as the script source.-->
    </head>
    <body>
        <unit-elements-white-label-app
            customer-token="{{customerToken}}"
            theme="{{themeUrl}}"
        >
        </unit-elements-white-label-app>
    </body>
</html>