🌊 AgentSnap API Flow
A step-by-step guide to a typical premium collection workflow.
Environments
We provide two environments:
- Production
- Staging
To use one of them, you need to register in the corresponding one using the following links:
Once you've registered via the appropriate environment's dashboard, feel free to use one of our Postman collections to start sending requests quickly.
Postman Collections 💻
To import a collection:
- Open Postman and click 'Import'
- Paste either the production or staging url below into the form field
Production Postman collection: https://app.agentsnap.io/api/swagger/public-json
Staging Postman collection: https://agent-staging.snaprefund.io/api/swagger/public-json
API Workflows
Good to knowBefore we walk through these flows, let's make sure we're on the same page about the words you're going to see below. They're defined as:
- Policyholder - The individual or business you are collecting payments from.
- Carrier - The insurance company you work with.
- Invoice - A request for payment for a policy.
- Refund - A payment sent back to a policyholder.
Carrier Management Flow
This flow describes how to create and manage carriers. You can associate carriers with invoices.
- If you need to add a new insurance carrier, create a carrier. You will receive a
carrierId
in the response. - You can see all your existing carriers by listing your carriers.
Full Invoice and Payment Flow
This flow describes creating a new policyholder and a new invoice, then collecting payment.
- Create a policyholder. You will receive a
policyholderId
in the response. - Create an invoice for the policyholder using the
policyholderId
from step 1. You can also associate acarrierId
. - The response from creating an invoice will contain a payment link. Provide this link to your policyholder to collect payment via ACH, credit card, or other supported methods.
Refund Flow
This flow describes how to issue a refund to an existing policyholder.
- You need the
policyholderId
of the policyholder you want to refund. If you don't have it, list your policyholders to find the correct one. - Create a refund for the policyholder using their
policyholderId
.
Payment Flows
The AgentSnap API supports several ways to send payments. You can either send a flexible payment link and let the recipient choose how to cash out, or send a direct payment where you specify the payment method.
Pending Payment Flow (Recipient Chooses)
This is the most flexible option. You send a payment to an email address, and the recipient is sent a link to choose how they'd like to receive the funds.
- Send a pending payment with the
recipientEmail
andamount
.
Direct Payment Flows (You Choose)
These flows are used when you want to specify exactly how the payment is sent. This requires that you have already collected the necessary details from the policyholder.
To a Bank Account (ACH, RTP, Same-Day ACH)
- Get the policyholder's
bankId
by listing their banks. - Call the appropriate endpoint for the desired speed:
By Paper Check
- Get the policyholder's address
alias
by listing their addresses. - Send a Paper Check with the address
alias
andmailType
.
Mass Payments via CSV
- Prepare a CSV file with columns for
Email
,Amount
, andMemo
. - Send mass pending payments by uploading the file.
Updated 1 day ago