Remit premium
API Refs
- Staging: Remit premium
This endpoint remits the premium on a paid invoice to the party you owe it to. Unlike Remit commission, which moves money between your own trust and operational accounts, this one sends the premium out of your trust account to the invoice's MGA, or to the carrier when the invoice has no MGA. It goes out as a paper check by USPS First Class mail.
The check memo carries the invoice's policy ID and broker code so the recipient can match it to the policy.
URI Parameters
| Name | Type | Description | Required |
|---|---|---|---|
| invoiceId | number | The ID of the invoice to remit premium for | yes |
Request
This endpoint takes no request body. The recipient and the amount are both derived from the invoice identified by invoiceId.
POST /api/public/invoices/{invoiceId}/remit-premiumAmount
For a standard invoice, the check is written for the net premium plus taxes.
For a premium finance invoice, the amount depends on who pays the carrier. When the finance company pays the carrier, the check covers the down payment less commission, plus taxes if you collect them with the down payment. Otherwise it covers the down payment and the financed amount, less commission, plus taxes.
Response
A successful request returns a 201 Created status code with no response body.
RequirementsThe invoice must belong to your account and must be in the
payout_paidstatus. Requests for an invoice that has not been paid out, or that belongs to another account, return a403 Forbiddenerror.The MGA or carrier receiving the premium must be set up for direct payments and must have a mailing address on file.
Updated 24 days ago