Skip to main content
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:
TypeTypical use
CUSTOMERPaying you
SUPPLIERYou pay them
EMPLOYEEPayroll
BENEFICIARYPayout recipient
FRIENDPersonal contact
FAMILYFamily member
DONORDonation source
DONEEDonation recipient
CONTACTGeneral contact
SERVICE_PROVIDERVendor or contractor
PARTNERBusiness partner
SELFYour 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

InvoiceOrder
NumberAuto-generated invoice numberOrder number
Due dateSupportedOptional
Best forB2B billing, formal invoicesE-commerce, retail
Both can be published and collected through checkout sessions or hosted checkout.
Last modified on June 23, 2026