Parties & Counterparties - Dollr Developer Docs

A party is a contact record — a person or entity identified by name, phone, and optional email/country.

API Reference: Create party · List parties · Retrieve party

Use parties for anyone you collect from or pay out to.

Counterparty

A counterparty links a party to your merchant account with a relationship type:

Type	Typical use
`CUSTOMER`	Paying you
`SUPPLIER`	You pay them
`EMPLOYEE`	Payroll
`BENEFICIARY`	Payout recipient
`FRIEND`	Personal contact
`FAMILY`	Family member
`DONOR`	Donation source
`DONEE`	Donation recipient
`CONTACT`	General contact
`SERVICE_PROVIDER`	Vendor or contractor
`PARTNER`	Business partner
`SELF`	Your own entity

Invoices and orders in the document-first flow require a counterparty_id.

Checkout shortcut

POST /v1/checkouts/create can create or match party and counterparty from payer details in one request. See Collect via checkout or Hosted checkout.

Customers do not need a Dollr account to pay via a payment link — they complete payment in the browser with mobile money or card.

Invoice vs order

	Invoice	Order
Number	Auto-generated invoice number	Order number
Due date	Supported	Optional
Best for	B2B billing, formal invoices	E-commerce, retail

Both can be published and collected through checkout sessions or hosted checkout.

Quick Start — create party → counterparty → invoice
Invoices · Orders · Checkouts

Last modified on June 23, 2026

​Counterparty

​Checkout shortcut

​Invoice vs order

​Related

Counterparty

Checkout shortcut

Invoice vs order

Related