Skip to main content
This object represents the payment created after generating the checkout session for a customer. To refund a payment, see Refunds and the Refund Payment API.
Metadata and routing logic. For routing logic to work correctly, metadata must also be set at the Checkout Session level. Setting it only on the Payment object will not trigger route logic.

​
Object Fields

​
id
string
The unique identifier of the payment (UUID, MAX 64; MIN 36).Example: 8546df3a-b83e-4bb5-a4b3-57aa6385924f
​
account_id
string
The unique identifier of the account (UUID, MAX 64; MIN 36).Example: 9104911d-5df9-429e-8488-ad41abea1a4b
​
description
string
The description of the payment (MAX 255; MIN 3).Example: Purchase on web
​
country
string
The country where the payment takes place. ISO 3166-1 alpha-2 code.Example: BR
​
merchant_order_id
string
The merchant’s unique order identifier used for reconciliation.Example: order-20260301-001
​
checkout_session
string
The checkout session identifier used to create this payment.Example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
​
status
string
Current payment status. See Payment Statuses for the complete lifecycle.Values: CREATED, PENDING, AUTHORIZED, IN_PROCESS, SUCCEEDED, PARTIALLY_APPROVED, CAPTURED, PARTIALLY_CAPTURED, DECLINED, REJECTED, CANCELLED, EXPIRED, REFUNDED, PARTIALLY_REFUNDED, IN_DISPUTE, CHARGEBACKExample: SUCCEEDED
​
sub_status
string
Provider-level status detail that provides more granular information about the payment state.Example: PENDING_PROVIDER_CONFIRMATION
​
amount
object
The payment amount details.
​
customer_id
string
ID of the associated customer record. Links to the Customer Object.Example: c9d0e1f2-3a4b-5c6d-7e8f-9a0b1c2d3e4f
​
payment_method
object
Details about the payment method used.
​
provider
object
Information about the payment provider that processed the payment.
​
transactions
array
Individual processing attempts for this payment. A payment may have multiple transactions if the first provider declines and Yuno routes to an alternative. See Transactions.
​
refunds
array
Refund records associated with this payment.
​
three_ds
object
3DS authentication details, present for card payments. See 3D Secure.
​
installments
object
Installment details if payment was split into installments.
​
failure_reason
object
Decline details when status is DECLINED or REJECTED.
​
metadata
object
Custom key-value pairs set by the merchant. Up to 50 keys, each key max 40 characters, each value max 500 characters.
​
created_at
string
ISO 8601 timestamp of when the payment was created.Example: 2026-03-01T14:31:00.000Z
​
updated_at
string
ISO 8601 timestamp of the last payment update.Example: 2026-03-01T14:31:02.000Z

​
Example

{
  "id": "8546df3a-b83e-4bb5-a4b3-57aa6385924f",
  "account_id": "9104911d-5df9-429e-8488-ad41abea1a4b",
  "description": "Purchase on web",
  "country": "US",
  "merchant_order_id": "order-20260301-001",
  "checkout_session": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "SUCCEEDED",
  "sub_status": null,
  "amount": {
    "value": 100.50,
    "currency": "USD"
  },
  "customer_id": "c9d0e1f2-3a4b-5c6d-7e8f-9a0b1c2d3e4f",
  "payment_method": {
    "type": "CARD",
    "vaulted_token": "vtok_9f8e7d6c-5b4a-3210-fedc-ba9876543210",
    "card": {
      "first_six": "411111",
      "last_four": "1111",
      "brand": "VISA",
      "type": "CREDIT",
      "issuer_name": "Chase",
      "country": "US"
    }
  },
  "provider": {
    "id": "conn_abc123",
    "name": "ADYEN",
    "transaction_id": "8835562831897070"
  },
  "transactions": [
    {
      "id": "txn_f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "type": "PURCHASE",
      "status": "SUCCEEDED",
      "provider": "ADYEN",
      "provider_transaction_id": "8835562831897070",
      "response_code": "00",
      "response_message": "Approved",
      "created_at": "2026-03-01T14:31:01.000Z"
    }
  ],
  "refunds": [],
  "three_ds": {
    "version": "2.2",
    "eci": "05",
    "status": "AUTHENTICATED",
    "flow": "FRICTIONLESS"
  },
  "installments": null,
  "failure_reason": null,
  "metadata": {
    "internal_ref": "abc-123"
  },
  "created_at": "2026-03-01T14:31:00.000Z",
  "updated_at": "2026-03-01T14:31:02.000Z"
}