API Reference Third Party Payer Payments V1

Create third party payer payment

Deprecated

POST

Request

This endpoint expects an object.

third_party_payer_idUUIDRequired

amount_centsintegerRequired

allocationslist of objectsRequired

Allocations are portions of payments that are applied to specific resources, known as targets. Each allocation has and amount, defined in cents, and a target.

payment_timestampdatetimeOptional

payment_notestringOptional

check_numberstringOptional

invoice_idUUIDOptional

Response

This endpoint returns an object.

third_party_payer_payment_idUUID

third_party_payerobject

amount_centsinteger

allocationslist of objects

check_numberstringOptional

payment_timestampdatetimeOptional

payment_notestringOptional

invoice_idUUIDOptional

Errors

POST

1 curl -X POST https://api.joincandidhealth.com/api/third-party-payer-payments/v1 \
2      -H "Authorization: Bearer <token>" \
3      -H "Content-Type: application/json" \
4      -d '{
5   "third_party_payer_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
6   "amount_cents": 0,
7   "allocations": [
8     {
9       "amount_cents": 0,
10       "target": {
11         "type": "service_line_by_id",
12         "value": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32"
13       }
14     }
15   ]
16 }'

1 {
2   "third_party_payer_payment_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
3   "third_party_payer": {
4     "third_party_payer_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
5     "name": "string",
6     "description": "string",
7     "category": "string",
8     "enabled": true
9   },
10   "amount_cents": 0,
11   "check_number": "string",
12   "payment_timestamp": "2023-01-01T00:00:00Z",
13   "payment_note": "string",
14   "allocations": [
15     {
16       "amount_cents": 0,
17       "target": {
18         "type": "service_line",
19         "service_line_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
20         "claim_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
21         "encounter_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32"
22       }
23     }
24   ],
25   "invoice_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32"
26 }

Built with

1	curl -X POST https://api.joincandidhealth.com/api/third-party-payer-payments/v1 \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"third_party_payer_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
6	"amount_cents": 0,
7	"allocations": [
8	{
9	"amount_cents": 0,
10	"target": {
11	"type": "service_line_by_id",
12	"value": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32"
13	}
14	}
15	]
16	}'

1	{
2	"third_party_payer_payment_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
3	"third_party_payer": {
4	"third_party_payer_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
5	"name": "string",
6	"description": "string",
7	"category": "string",
8	"enabled": true
9	},
10	"amount_cents": 0,
11	"check_number": "string",
12	"payment_timestamp": "2023-01-01T00:00:00Z",
13	"payment_note": "string",
14	"allocations": [
15	{
16	"amount_cents": 0,
17	"target": {
18	"type": "service_line",
19	"service_line_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
20	"claim_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
21	"encounter_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32"
22	}
23	}
24	],
25	"invoice_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32"
26	}