Glossary - Payment API

Payment Attributes

ParametersMeaningType
idThe token identifier returned by tokenization (e.g. token-1). Referenced as mode.tokenId when payingstring
created_atTimestamp is in UTC yyyy-MM-ddTHH:mm:ssZ all time values in our API are in UTC time as per ISO8601string
deletedboolean
user_idstring
merchant_idstring
business_idstring
store_idstring
amountPayment amount in minor units of currency (1000 = 10.00 USD)
amount.currencyISO 4217 currency code, e.g. USDstring
amount.value0integer
amount.displaystring
amount_without_charges
amount_without_charges.currencystring
amount_without_charges.value0integer
amount_without_charges.displaystring
charges
charges.idstring
charges.product
charges.percentageinteger
charges.amountstring
charges.amount.currency
charges.amount.valueinteger
charges.amount.displaystring
countrystring
billing_address
billing_address.countrystring
billing_address.citystring
billing_address.postal_codestring
billing_address.street_namestring
billing_address.house_numberstring
billing_address.state_or_provincestring
card_holder_namestring
provider
method
statusCard verification result: verified (usable for payments) or failed (not usable)
errorsstringstring
amount_split
amount_split.basketValueinteger
amount_split.taxinteger
amount_split.deliveryFeeinteger
amount_split.driverTipinteger
amount_split.restaurantTipinteger
amount_after_refund
amount_after_refund.currencystring
amount_after_refund.valueinteger
amount_after_refund.displayinteger
provider_idstring
external_idstring
reporting_idstring
cancellation_referencestring
refund_referencestring
external_referencestring
gatewayProfileIdIdentifier of the gateway profile — the configuration that determines which PSP/gateway setup handles the token or payment (e.g. gateway-1)string
channelLinkIdIdentifier of the channel link — the connection between a channel and a Deliverect location (e.g. channelLink-1)string
customerIdThe channel's identifier for the end customer. Ties the vaulted token to a customer for reuse (e.g. customer-1)string
payment_methodObject containing raw card details (number, expiration_month, expiration_year, cvc). Sent only to the BasisTheory proxy, never to Deliverect Pay directlyobject
modeObject describing how the payment is funded. For this flow, type is token and tokenId references a verified tokenobject
captureModeimmediate — capture funds instantly (default); manual — pre-authorize now, capture laterstring
payerObject identifying the paying customer: name (display name) and reference (channel-side customer reference)object
paymentIdIdentifier of the created payment (e.g. payment-1)string
paymentStatusStatus of the payment, e.g. authorizedstring