> ## Documentation Index > Fetch the complete documentation index at: https://docs.y.uno/llms.txt > Use this file to discover all available pages before exploring further. # Capture Authorization (two cards) > Captures the authorization of one card of a two-card payment, using that card's transaction id. This request captures one card of a payment created with `capture: false` in [Create Payment (two cards)](https://docs.y.uno/reference/payments/create-payment-v2.md). Capture is per card: call it once for each card, with the `id` of that card's `AUTHORIZE` transaction from `payment_method.payment_methods[].transactions`. After the first capture, the payment is `SUCCEEDED / PARTIALLY_CAPTURED`. After both, it is `SUCCEEDED / CAPTURED`. The response is `201` with the payment in the v2 shape. > [!WARNING] > > While the payment is in `REFUND_RETRY_IN_PROCESS` or `CANCEL_RETRY_IN_PROCESS`, a capture is rejected. See [Pay with two cards](https://docs.y.uno/docs/payment-features/pay-with-two-cards.md#operations). This request requires an `X-Idempotency-Key`. See [Authentication](https://docs.y.uno/reference/getting-started/authentication.md#idempotency) for details. ## OpenAPI ````yaml openapi/payments/capture-authorization-v2.json POST /payments/{payment_id}/transactions/{transaction_id}/capture openapi: 3.1.0 info: title: payments-v2 version: 2.0.0 servers: - url: https://api-sandbox.y.uno/v2 description: Sandbox - url: https://api.y.uno/v2 description: Production (US) - url: https://api.eu.y.uno/v2 description: Production (EMEA) security: - sec0: [] sec1: [] paths: /payments/{payment_id}/transactions/{transaction_id}/capture: post: summary: Capture Authorization (two cards) description: >- Captures the authorization of one card. Call it once per card, with that card's `AUTHORIZE` transaction id. operationId: capture-authorization-v2 parameters: - name: X-Idempotency-Key in: header required: true description: >- Unique key for this request. Required on every v2 payment request. Retry an unclear outcome with the same key. Without it the request is rejected with `400 INVALID_PARAMETERS`: "The header 'x-idempotency-key' is required." schema: type: string format: uuid - name: payment_id in: path required: true description: The `id` of the payment returned by `POST /v2/payments`. schema: type: string format: uuid - name: transaction_id in: path required: true description: >- The `id` of the card transaction to operate on, from `payment_method.payment_methods[].transactions[]`. schema: type: string format: uuid requestBody: content: application/json: schema: type: object required: - merchant_reference - reason properties: merchant_reference: type: string description: >- Identification of the payment transaction defined by the merchant (MAX 255; MIN 3) amount: type: object description: >- Optional. Amount to capture on this card. If you omit it, the full authorized amount of the card is captured. required: - currency - value properties: currency: type: string description: ISO 4217 currency code (3 characters). example: BRL value: type: number description: Amount in major units (multiple of 0.0001). example: 300 reason: type: string description: >- Reason for the operation. Possible values are `DUPLICATE`, `FRAUDULENT` and `REQUESTED_BY_CUSTOMER`. enum: - DUPLICATE - FRAUDULENT - REQUESTED_BY_CUSTOMER additional_data: type: object description: Additional data to complement the payment capture properties: order: type: object description: Specifies the order object. properties: shipping_amount: type: number description: >- The shipping amount of the order (multiple of 0.0001) format: float fee_amount: type: number description: The fee amount of the order (multiple of 0.0001) format: float items: type: array description: Specifies the items array of object. items: properties: id: type: string description: >- The unique identifier of the item (MAX 255; MIN 3). name: type: string description: The name of the item (MAX 255; MIN 3). quantity: type: integer description: The quantity of the item. format: int32 unit_amount: type: number description: >- The unit amount of the item (multiple of 0.0001). format: float category: type: string description: >- The category of the item. Check the [Item category reference](/reference/items-category-list). enum: - art - baby - coupons - beauty_&_personal_care - donations - computing - books - grocery_&_gourmet_food - cameras - video_games - television - car_electronics - electronics - automotive - toys_&_games - musical_instruments - handmade - garden_&_outdoor - entertainment - industrial_&_scientific - fashion - games - pet_supplies - home - musical - phones - services - learnings - tickets - travels - virtual_goods - others brand: type: string description: The brand of the item (MAX 255; MIN 3). sku_code: type: string description: >- The stock keeping unit (SKU) of the item (MAX 255; MIN 3). manufacture_part_number: type: string description: The manufacture part number of the item required: - id - name - quantity - unit_amount type: object airline: type: object description: Specifies the airline object. properties: pnr: type: string description: Passenger name record (MAX 10; MIN 1). legs: type: array description: Specifies the legs array of objects. items: properties: departure_airport: type: string description: >- IATA code. See http://www.iata.org (MAX 3; MIN 3). departure_datetime: type: string description: >- The departure date and time in UTC time ([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601), MAX 27; MIN 27). format: date-time departure_airport_timezone: type: string description: Airport timezone (MAX 6; MIN 6). arrival_airport: type: string description: >- IATA airport code. See http://www.iata.org (MAX 3; MIN 3). carrier_code: type: string description: >- IATA carrier code. See http://www.iata.org (MAX 2; MIN 2). carrier_name: type: string description: >- The name of the airline carrier (MAX 100; MIN 1). flight_number: type: string description: >- The flight number assigned by the airline carrier (MAX 5; MIN 1). fare_basis_code: type: string description: >- Code base rate provides specific information on the fare in addition to the class service, both required for booking (MAX 15; MIN 1). fare_class_code: type: string description: >- The fare class code of the airline (MAX 1; MIN 1). The values can be a letter (A-Z) but may vary depending on the airline's definition. Check the [Airline information reference](/reference/airline-information#fare-class-code). enum: - F - FR - B - CR - 'Y' - YD base_fare: type: number description: >- The transaction amount, excluding taxes and fees, the smallest unit of currency (multipleOf 0.0001). format: float base_fare_currency: type: string description: >- The currency used to transaction amount (MAX 3; MIN 3; [ISO 4217](country-reference)). stopover_code: type: string description: >- 1-letter code that indicates whether the passenger is allowed to make a stopover. Only two types of characters are allowed: O: Stopover allowed (the letter “O”, not zero) / X: Stopover not allowed. (MAX 1; MIN 1) required: - departure_airport - departure_datetime - departure_airport_timezone - arrival_airport - carrier_code - flight_number - fare_basis_code - fare_class_code type: object passengers: type: array description: >- Specifies the passengers array of objects associated to the tickets. items: properties: first_name: type: string description: The passenger first name (MAX 255; MIN 3). last_name: type: string description: The passenger last name (MAX 255; MIN 3) middle_name: type: string description: The passenger middle name (MAX 255; MIN 3). type: type: string description: >- The passenger type (MAX 1; MIN 1). Check the [Airline information reference](/reference/airline-information#passenger-type). enum: - A - C - I date_of_birth: type: string description: >- The passenger date of birth in the YYYY-MM-DD (MAX 10; MIN 10). format: date nationality: type: string description: >- The passenger nationality (MAX 2; MIN 2; [ISO 3166-1](country-reference)). enum: - AR - BO - BR - CL - CO - CR - EC - SV - GT - HN - MX - NI - PA - PY - PE - US - UY document: type: object description: Specifies the passengers' document object. properties: document_number: type: string description: >- Document number for passenger (MAX 40; MIN 3). document_type: type: string description: >- The passenger's document type (MAX 6, MIN 2; ([Country reference](country-reference))). enum: - DNI - CI - LC - LE - CUIT - CUIL - PAS - CPF - RG - CNH - CNPJ - RUT - RUN - CC - CE - NIT - DUI - PIC - DPI - IFR - INE - CP - RFC - CURP - CIP - CIC - CUI - RUC - '' country: type: string description: >- Country where the document was issued (MAX 2; MIN 2; [ISO 3166-1](country-reference)). enum: - AR - BO - BR - CL - CO - CR - EC - SV - GT - HN - MX - NI - PA - PY - PE - US - UY loyalty_number: type: string description: Number of passenger loyalty program. loyalty_tier: type: string description: >- Tier of passenger loyalty program. Check the [Airline information reference](/reference/airline-information#loyalty-tier). enum: - '1' - '2' - '3' phone: type: object description: Specifies the phone object for the passenger. type: object tickets: type: array description: >- Specifies the array of ticket objects associated to the passengers. items: properties: ticket_number: type: string description: Ticket number (MAX 14; MIN 1). e_ticket: type: boolean description: Is this an e-ticket? (true) (false). restricted: type: boolean description: >- Indicates if the ticket is refunfable or not (true/false) total_fare_amount: type: number description: >- Total fare amount in the smallest unit of currency (multiple of 0.0001). format: float total_tax_amount: type: number description: >- Total taxes amount in the smallest unit of currency (multiple of 0.0001). format: float total_fee_amount: type: number description: >- Total fee amount in the smallest unit of currency (multiple of 0.0001). format: float issue: type: object description: Specifies the issue object. properties: carrier_prefix_code: type: string description: >- Issuing or Validating carrier. This is the AWB Prefix (Air waybill) 3-numeric code (MAX 3; MIN 3). travel_agent_code: type: string description: >- Code of the travel agent issuing the ticket (MAX 9; MIN 8). travel_agent_name: type: string description: >- The name under which the point of sale appears on the agency list or franchise name (MAX 32; MIN 1). date: type: string description: Ticket issuing date (MAX 27; MIN 27). format: date-time address: type: string description: >- Address of the agent whose sold the ticket (MAX 255; MIN 3). city: type: string description: >- City name of the agent whose sold the ticket (MAX 255; MIN 3). country: type: string description: >- Country code alpha 2 where the ticket was issued (MAX 2; MIN 2; [ISO 3166-1](country-reference)). enum: - AR - BO - BR - CL - CO - CR - EC - SV - GT - HN - MX - NI - PA - PY - PE - US - UY type: object seller_details: type: object description: Specifies the seller's details object. properties: name: type: string description: The seller's legal name (MAX 255; MIN 3). email: type: string description: The seller's e-mail (MAX 255; MIN 3). reference: type: number description: The seller's identification code (MAX 255; MIN 3). format: float website: type: string description: The seller's website URL (MAX 255; MIN 3). industry: type: string description: >- The seller's industry (MAX 235; MIN 1) For more information access the [Industry category reference page](/reference/industry-category-list). merchant_category_code: type: string description: MCC - The merchant category code (MAX 235; MIN 1). country: type: string description: >- The seller's country (MAX 255; MIN 3; [ISO 3166-1](/reference/country-reference)). enum: - AR - BO - BR - CL - CO - CR - EC - SV - GT - HN - MX - NI - PA - PY - PE - US - UY - '' document: type: object description: Specifies the document object of the seller. properties: document_number: type: string description: The seller's document number (MAX 40; MIN 3). document_type: type: string description: >- The seller's document type (MAX 6, MIN 2; [Document Type List](/reference/country-reference)). enum: - DNI - CI - LC - LE - CUIT - CUIL - PAS - CPF - RG - CNH - CNPJ - RUT - RUN - CC - CE - NIT - DUI - PIC - DPI - IFR - INE - CP - RFC - CURP - CIP - CIC - CUI - RUC - '' phone: type: object description: Specifies the seller's phone number object. properties: country_code: type: string description: >- The country calling code of the seller's phone (MAX 3; MIN 1). Check the [Country reference](country-reference) to see the phone codes. number: type: string description: >- The seller's phone number, without the country code (MAX 32; MIN 1). address: type: object description: Specifies the seller's address object. properties: address_line_1: type: string description: >- The primary address line of the seller (MAX 255; MIN 3). address_line_2: type: string description: >- The secondary billing address line of the seller (MAX 255; MIN 3). city: type: string description: >- The city considered for the seller's address (MAX 255; MIN 3). country: type: string description: >- The country considered for the seller's address (MAX 2; MIN 2; [ISO 3166-1](/reference/country-reference)). enum: - AR - BO - BR - CL - CO - CR - EC - SV - GT - HN - MX - NI - PA - PY - PE - US - UY - '' state: type: string description: >- The state considered for the seller's address (MAX 255; MIN 3). zip_code: type: string description: >- The zipcode considered for the seller's address (MAX 11; MIN 4). responses: '201': description: The payment after the operation, in the v2 shape content: application/json: schema: $ref: '#/components/schemas/PaymentV2' examples: One card captured: value: id: 7c1b6e2a-5f3d-4a8e-9b21-3e4f5a6b7c8d account_id: 493e9374-510a-4201-9e09-de669d75f256 description: Order paid with two cards country: BR status: SUCCEEDED sub_status: PARTIALLY_CAPTURED merchant_order_id: order-10045 created_at: '2026-10-27T14:02:11.120Z' updated_at: '2026-10-27T14:02:12.300Z' split_payment_methods: true payment_methods_count: 2 sdk_action_required: false amount: currency: BRL value: 300 checkout: session: null payment_method: capture: false account_updater: false payment_methods: - sequence: 1 type: CARD amount: currency: BRL value: 200 transactions: - id: d2a4f6b8-1c3e-4a5b-8d7f-9e0a1b2c3d4e type: AUTHORIZE status: SUCCEEDED category: CARD amount: 200 provider_id: YUNO_TEST_PAYMENT_GATEWAY response_code: SUCCEEDED response_message: Transaction successful reason: null description: null merchant_reference: null three_d_secure_action_required: false created_at: '2026-10-27T14:02:11.402Z' updated_at: '2026-10-27T14:02:12.118Z' - id: a5d7c9e1-4f6b-4d8e-9a0c-2b3c4d5e6f7a type: CAPTURE status: SUCCEEDED category: CARD amount: 200 provider_id: YUNO_TEST_PAYMENT_GATEWAY response_code: SUCCEEDED response_message: Transaction successful reason: null description: null merchant_reference: null three_d_secure_action_required: false created_at: '2026-10-27T14:02:11.402Z' updated_at: '2026-10-27T14:02:12.118Z' - sequence: 2 type: CARD amount: currency: BRL value: 100 transactions: - id: e3b5a7c9-2d4f-4b6c-9e8a-0f1b2c3d4e5f type: AUTHORIZE status: SUCCEEDED category: CARD amount: 100 provider_id: YUNO_TEST_PAYMENT_GATEWAY response_code: SUCCEEDED response_message: Transaction successful reason: null description: null merchant_reference: null three_d_secure_action_required: false created_at: '2026-10-27T14:02:11.402Z' updated_at: '2026-10-27T14:02:12.118Z' customer_payer: id: cfae0941-7234-427a-a739-ef4fce966c79 first_name: Ana last_name: Souza email: ana.souza@example.com workflow: DIRECT callback_url: https://merchant.example.com/checkout/return metadata: [] '400': description: >- Invalid request. `INVALID_PARAMETERS` for a missing idempotency key or an amount above what can be operated on; `INVALID_STATUS` when the card cannot take the operation, for example a refund while the card has an open chargeback, or a capture or cancel while the payment is in `REFUND_RETRY_IN_PROCESS` or `CANCEL_RETRY_IN_PROCESS`. content: application/json: schema: type: object properties: code: type: string messages: type: array items: type: string examples: Missing idempotency key: value: code: INVALID_PARAMETERS messages: - The header 'x-idempotency-key' is required. '401': description: Invalid credentials content: application/json: schema: type: object properties: code: type: string messages: type: array items: type: string example: code: INVALID_CREDENTIALS messages: - Invalid credentials components: schemas: PaymentV2: type: object description: A payment funded by two cards. properties: id: type: string format: uuid account_id: type: string format: uuid description: type: string country: type: string status: type: string description: >- Aggregated status of the payment. See [Pay with two cards](/docs/payment-features/pay-with-two-cards#statuses). sub_status: type: string description: >- Aggregated sub status, for example `APPROVED`, `AUTHORIZED`, `PARTIALLY_CAPTURED`, `PARTIALLY_REFUNDED`, `REFUND_RETRY_IN_PROCESS` or `CANCEL_RETRY_IN_PROCESS`. merchant_order_id: type: string merchant_reference: type: string created_at: type: string format: date-time updated_at: type: string format: date-time split_payment_methods: type: boolean description: '`true` for a payment funded by two cards.' payment_methods_count: type: integer description: 'Number of cards that fund the payment: `2`.' sdk_action_required: type: boolean description: >- `true` when the SDK must continue the payment, for example to run a 3DS challenge. amount: type: object description: Total of the payment. required: - currency - value properties: currency: type: string description: ISO 4217 currency code (3 characters). example: BRL value: type: number description: Amount in major units (multiple of 0.0001). example: 300 checkout: type: object properties: session: type: - string - 'null' payment_method: type: object properties: capture: type: boolean description: Capture setting shared by both cards. account_updater: type: - boolean - 'null' payment_methods: type: array description: >- One entry per card. There is no status per card: read each card's outcome from its `transactions`. minItems: 2 maxItems: 2 items: type: object properties: sequence: type: integer description: 'Position of the card: `1` or `2`.' type: type: string enum: - CARD amount: type: object description: Part of the total that this card pays. required: - currency - value properties: currency: type: string description: ISO 4217 currency code (3 characters). example: BRL value: type: number description: Amount in major units (multiple of 0.0001). example: 300 payment_method_detail: type: object description: Card details, as in the v1 payment object. payment_method_owner: type: object description: Cardholder, when sent in the request. transactions: type: array description: >- Transactions of this card. A card that went through 3DS shows `THREE_D_SECURE` followed by `PURCHASE` or `AUTHORIZE`. items: type: object description: >- One transaction of the card. Read the outcome of the card from its transactions. properties: id: type: string format: uuid description: >- Transaction id. Use it in the per-transaction operations. type: type: string description: >- Transaction type, for example `THREE_D_SECURE`, `PURCHASE`, `AUTHORIZE`, `CAPTURE`, `CANCEL` or `REFUND`. status: type: string description: >- Status of this transaction, for example `SUCCEEDED`, `DECLINED`, `PENDING` or `ERROR`. category: type: string example: CARD amount: type: number description: Amount of this transaction. provider_id: type: string description: Provider that processed the transaction. response_code: type: string description: Yuno response code of the transaction. response_message: type: string reason: type: - string - 'null' description: type: - string - 'null' merchant_reference: type: - string - 'null' three_d_secure_action_required: type: - boolean - 'null' created_at: type: string format: date-time updated_at: type: - string - 'null' format: date-time customer_payer: type: object description: The payer, as sent in the request. additional_data: type: - object - 'null' callback_url: type: string workflow: type: string enum: - DIRECT - REDIRECT - SDK_CHECKOUT metadata: type: array items: type: object securitySchemes: sec0: type: apiKey in: header name: public-api-key x-default: sec1: type: apiKey in: header name: private-secret-key x-default: ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.