Skip to main content
Payments and refunds are in beta. Contact Vori Support to enable them for your account. Until they are enabled, these endpoints answer 403 Forbidden.

A card payment taken through the Vori API on behalf of a store. One payment is one charge attempt, and a payment is never edited once the processor has answered.

id
string
required

Unique identifier for the record.

amount
string<positive-monetary>
required

Amount charged to the card, in dollars.

Pattern: ^[0-9]+(\.[0-9]+)?$
Example:

"199.99"

amount_details
object | null
required

Tax and line items supplied when the payment was taken.

amount_refunded
string<monetary>
required

Total of the refunds of the payment that went through, in dollars. Refunds that failed or are still with the processor are not counted. 0.00 when nothing was refunded.

Pattern: ^-?[0-9]+(\.[0-9]+)?$
Example:

"199.99"

created_at
string<date-time>
required

When the record was created.

idempotency_key
string
required

Your own key for the charge, unique within the banner for each mode. Sending the same key again returns the payment already taken rather than charging the card twice. Up to 255 characters.

metadata
object | null
required

Your own key/value pairs, exactly as supplied when the payment was taken.

Example:
mode
enum<string>
required

Whether money moved for real or not, which follows the API key that took the payment: test runs in the payment processor's test environment and never moves money, and live takes an actual payment.

Available options:
live,
test
payment_details
object | null
required

Purchase reference supplied when the payment was taken.

payment_method
object
required

The card the payment was taken from.

processor
enum<string>
required

The payment processor that handled the charge, which is the one configured for the store.

Available options:
datacap
status
enum<string>
required

Where the payment stands: captured once the amount was taken from the card, authorized while the processor only holds it, and failed when the card was refused. A payment the processor has not answered for yet is not served at all: sending the same request again with the same idempotency_key and the same token settles it.

Available options:
authorized,
captured,
failed
store_id
string
required

ID of the store the payment was taken for.

Pattern: ^[0-9]+$
updated_at
string<date-time>
required

When the record was last changed.