Send mass pending payments
API Refs
- Production: Send mass pending payments
- Staging: Send mass pending payments
Request body
| Name | Type | Format |
|---|---|---|
| file | form-data | csv |
File structure
| Column name | Type | Description | Required |
|---|---|---|---|
| string | Insured’s email address | yes | |
| Amount | number | The amount you’re sending this Insured | yes |
| Memo (optional) | string | Describe your payment with an optional message. Your recipient will see this memo | no |
| Recipient's Mailing Address (optional) | string | Insured’s Mailing Address | no |
All four columns must be in the first row of the file, with these exact names. You can leave the Memo and address values empty.
Example
-
Get list of self payments Request;
-
Get list of self payments Response:
[ { "id": 1, "transactionId": "a444aa44-aaa4-4a4a-aaaa-a44a44444a44", "amount": 10.23, "createdAt": "2023-08-09T15:42:26.683Z", "customerId": 2, "customerName": "John Smith", "merchantName": "Jake Merchant", "fee": "0.00", "feeDeductFrom": null, "status": "Awaiting-cash-out", "type": "--", "memo": "" } ] -
Send mass pending payments Request file structure:
Email Amount Memo (optional) Recipient's Mailing Address (optional) [email protected] 20.23 Payment for Claim #1337 456 Example St. -
Get list of self payments Request;
-
Get list of self payments Response:
[ { "id": 1, "transactionId": "a444aa44-aaa4-4a4a-aaaa-a44a44444a44", "amount": 10.23, "createdAt": "2023-08-09T15:42:26.683Z", "customerId": 2, "customerName": "John Smith", "merchantName": "Jake Merchant", "fee": "0.00", "feeDeductFrom": null, "status": "Awaiting-cash-out", "type": "--", "memo": "" }, { "id": 2, "transactionId": "a555aa55-aaa5-5a5a-aaaa-a55a55555a55", "amount": 10.23, "createdAt": "2023-08-10T12:03:26.683Z", "customerId": 2, "customerName": "John Smith", "merchantName": "Jake Merchant", "fee": "0.00", "feeDeductFrom": null, "status": "Awaiting-cash-out", "type": "--", "memo": "Payment for Claim #1337" } ]
Description
The file must be of the required structure. Rows with invalid values are ignored.
You can submit multiple pending payments in a single request.
To do this, you need to upload a file with the required information.
Who gets the email. For each row in the file, if no account exists yet for that email address, an invitation email is always sent. If an account exists, the email is sent only when payment emails are turned on for that insured. An insured you created through the API who has not yet signed up counts as having no account, so they get the invitation email too. You get a copy for each row when your own payment emails are on, and a copy of an invitation is always sent. The emails are sent shortly after the file has been processed, not during the upload. Today most of them are sent twice. See Which payments send emails for all the cases. See the Insured’s preferences page for how to turn payment emails on or off.
Updated 3 days ago