Skip to navigation

Get payment

Get a payment by its ID

Authentication

AuthorizationBearer
API Key authentication using Bearer token

Path parameters

idstringRequired

Response

200
idstring
Unique payment identifier.
numberinteger

Sequential payment number within your organization (shown as “PAY-0001”).

customerIdstring
The customer this payment belongs to.
invoiceIdstring or null
The invoice this payment was collected for, when created by an automatic charge. Null for manually recorded payments.
orderIdstring or null
The order this payment relates to, when known.
amountinteger

Payment amount in stored minor units: cents for USD; for JPY, hundredths when currencyDecimals is 2 and whole yen when it is 0.

allocatedAmountinteger
Portion allocated to invoice lines, in stored minor units described by currencyDecimals.
balanceinteger
Unallocated remainder, in stored minor units described by currencyDecimals.
currencystring

Three-letter ISO currency code.

currencyDecimalsinteger

Decimals of this payment’s amounts, from the currency and how Paid stores it: 2 for USD (4999 is $49.99); for JPY 2 while Paid stores yen in hundredths, then 0. Divide amounts by 10^currencyDecimals; never assume 100.

paymentDatedatetime
When the payment was made.
paymentTypestring
How the payment was made, e.g. creditCard, bankTransfer, ach, cash, or check.
statusstring

Payment status: draft, posted, processing, requiresAction, failed, or canceled.

metadatamap from strings to any or null

Key-value metadata stored on the payment.

createdAtdatetime
updatedAtdatetime

Errors

400
Bad Request Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error