Two-card payments (v2)
Capture Authorization (two cards)
Captures the authorization of one card of a two-card payment, using that card’s transaction id.
POST
/
payments
/
{payment_id}
/
transactions
/
{transaction_id}
/
capture
Capture Authorization (two cards)
curl --request POST \
--url https://api-sandbox.y.uno/v2/payments/{payment_id}/transactions/{transaction_id}/capture \
--header 'Content-Type: application/json' \
--header 'X-Idempotency-Key: <x-idempotency-key>' \
--header 'private-secret-key: <api-key>' \
--header 'public-api-key: <api-key>' \
--data '
{
"merchant_reference": "<string>",
"additional_data": {
"order": {
"shipping_amount": 123,
"fee_amount": 123,
"items": [
{
"id": "<string>",
"name": "<string>",
"quantity": 123,
"unit_amount": 123,
"brand": "<string>",
"sku_code": "<string>",
"manufacture_part_number": "<string>"
}
]
},
"airline": {
"pnr": "<string>",
"legs": [
{
"departure_airport": "<string>",
"departure_datetime": "2023-11-07T05:31:56Z",
"departure_airport_timezone": "<string>",
"arrival_airport": "<string>",
"carrier_code": "<string>",
"flight_number": "<string>",
"fare_basis_code": "<string>",
"carrier_name": "<string>",
"base_fare": 123,
"base_fare_currency": "<string>",
"stopover_code": "<string>"
}
],
"passengers": [
{
"first_name": "<string>",
"last_name": "<string>",
"middle_name": "<string>",
"date_of_birth": "2023-12-25",
"document": {
"document_number": "<string>"
},
"loyalty_number": "<string>",
"phone": {}
}
],
"tickets": [
{
"ticket_number": "<string>",
"e_ticket": true,
"restricted": true,
"total_fare_amount": 123,
"total_tax_amount": 123,
"total_fee_amount": 123,
"issue": {
"carrier_prefix_code": "<string>",
"travel_agent_code": "<string>",
"travel_agent_name": "<string>",
"date": "2023-11-07T05:31:56Z",
"address": "<string>",
"city": "<string>"
}
}
]
},
"seller_details": {
"name": "<string>",
"email": "<string>",
"reference": 123,
"website": "<string>",
"industry": "<string>",
"merchant_category_code": "<string>",
"document": {
"document_number": "<string>"
},
"phone": {
"country_code": "<string>",
"number": "<string>"
},
"address": {
"address_line_1": "<string>",
"address_line_2": "<string>",
"city": "<string>",
"state": "<string>",
"zip_code": "<string>"
}
}
}
}
'import requests
url = "https://api-sandbox.y.uno/v2/payments/{payment_id}/transactions/{transaction_id}/capture"
payload = {
"merchant_reference": "<string>",
"additional_data": {
"order": {
"shipping_amount": 123,
"fee_amount": 123,
"items": [
{
"id": "<string>",
"name": "<string>",
"quantity": 123,
"unit_amount": 123,
"brand": "<string>",
"sku_code": "<string>",
"manufacture_part_number": "<string>"
}
]
},
"airline": {
"pnr": "<string>",
"legs": [
{
"departure_airport": "<string>",
"departure_datetime": "2023-11-07T05:31:56Z",
"departure_airport_timezone": "<string>",
"arrival_airport": "<string>",
"carrier_code": "<string>",
"flight_number": "<string>",
"fare_basis_code": "<string>",
"carrier_name": "<string>",
"base_fare": 123,
"base_fare_currency": "<string>",
"stopover_code": "<string>"
}
],
"passengers": [
{
"first_name": "<string>",
"last_name": "<string>",
"middle_name": "<string>",
"date_of_birth": "2023-12-25",
"document": { "document_number": "<string>" },
"loyalty_number": "<string>",
"phone": {}
}
],
"tickets": [
{
"ticket_number": "<string>",
"e_ticket": True,
"restricted": True,
"total_fare_amount": 123,
"total_tax_amount": 123,
"total_fee_amount": 123,
"issue": {
"carrier_prefix_code": "<string>",
"travel_agent_code": "<string>",
"travel_agent_name": "<string>",
"date": "2023-11-07T05:31:56Z",
"address": "<string>",
"city": "<string>"
}
}
]
},
"seller_details": {
"name": "<string>",
"email": "<string>",
"reference": 123,
"website": "<string>",
"industry": "<string>",
"merchant_category_code": "<string>",
"document": { "document_number": "<string>" },
"phone": {
"country_code": "<string>",
"number": "<string>"
},
"address": {
"address_line_1": "<string>",
"address_line_2": "<string>",
"city": "<string>",
"state": "<string>",
"zip_code": "<string>"
}
}
}
}
headers = {
"X-Idempotency-Key": "<x-idempotency-key>",
"public-api-key": "<api-key>",
"private-secret-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'X-Idempotency-Key': '<x-idempotency-key>',
'public-api-key': '<api-key>',
'private-secret-key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
merchant_reference: '<string>',
additional_data: {
order: {
shipping_amount: 123,
fee_amount: 123,
items: [
{
id: '<string>',
name: '<string>',
quantity: 123,
unit_amount: 123,
brand: '<string>',
sku_code: '<string>',
manufacture_part_number: '<string>'
}
]
},
airline: {
pnr: '<string>',
legs: [
{
departure_airport: '<string>',
departure_datetime: '2023-11-07T05:31:56Z',
departure_airport_timezone: '<string>',
arrival_airport: '<string>',
carrier_code: '<string>',
flight_number: '<string>',
fare_basis_code: '<string>',
carrier_name: '<string>',
base_fare: 123,
base_fare_currency: '<string>',
stopover_code: '<string>'
}
],
passengers: [
{
first_name: '<string>',
last_name: '<string>',
middle_name: '<string>',
date_of_birth: '2023-12-25',
document: {document_number: '<string>'},
loyalty_number: '<string>',
phone: {}
}
],
tickets: [
{
ticket_number: '<string>',
e_ticket: true,
restricted: true,
total_fare_amount: 123,
total_tax_amount: 123,
total_fee_amount: 123,
issue: {
carrier_prefix_code: '<string>',
travel_agent_code: '<string>',
travel_agent_name: '<string>',
date: '2023-11-07T05:31:56Z',
address: '<string>',
city: '<string>'
}
}
]
},
seller_details: {
name: '<string>',
email: '<string>',
reference: 123,
website: '<string>',
industry: '<string>',
merchant_category_code: '<string>',
document: {document_number: '<string>'},
phone: {country_code: '<string>', number: '<string>'},
address: {
address_line_1: '<string>',
address_line_2: '<string>',
city: '<string>',
state: '<string>',
zip_code: '<string>'
}
}
}
})
};
fetch('https://api-sandbox.y.uno/v2/payments/{payment_id}/transactions/{transaction_id}/capture', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api-sandbox.y.uno/v2/payments/{payment_id}/transactions/{transaction_id}/capture",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'merchant_reference' => '<string>',
'additional_data' => [
'order' => [
'shipping_amount' => 123,
'fee_amount' => 123,
'items' => [
[
'id' => '<string>',
'name' => '<string>',
'quantity' => 123,
'unit_amount' => 123,
'brand' => '<string>',
'sku_code' => '<string>',
'manufacture_part_number' => '<string>'
]
]
],
'airline' => [
'pnr' => '<string>',
'legs' => [
[
'departure_airport' => '<string>',
'departure_datetime' => '2023-11-07T05:31:56Z',
'departure_airport_timezone' => '<string>',
'arrival_airport' => '<string>',
'carrier_code' => '<string>',
'flight_number' => '<string>',
'fare_basis_code' => '<string>',
'carrier_name' => '<string>',
'base_fare' => 123,
'base_fare_currency' => '<string>',
'stopover_code' => '<string>'
]
],
'passengers' => [
[
'first_name' => '<string>',
'last_name' => '<string>',
'middle_name' => '<string>',
'date_of_birth' => '2023-12-25',
'document' => [
'document_number' => '<string>'
],
'loyalty_number' => '<string>',
'phone' => [
]
]
],
'tickets' => [
[
'ticket_number' => '<string>',
'e_ticket' => true,
'restricted' => true,
'total_fare_amount' => 123,
'total_tax_amount' => 123,
'total_fee_amount' => 123,
'issue' => [
'carrier_prefix_code' => '<string>',
'travel_agent_code' => '<string>',
'travel_agent_name' => '<string>',
'date' => '2023-11-07T05:31:56Z',
'address' => '<string>',
'city' => '<string>'
]
]
]
],
'seller_details' => [
'name' => '<string>',
'email' => '<string>',
'reference' => 123,
'website' => '<string>',
'industry' => '<string>',
'merchant_category_code' => '<string>',
'document' => [
'document_number' => '<string>'
],
'phone' => [
'country_code' => '<string>',
'number' => '<string>'
],
'address' => [
'address_line_1' => '<string>',
'address_line_2' => '<string>',
'city' => '<string>',
'state' => '<string>',
'zip_code' => '<string>'
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Idempotency-Key: <x-idempotency-key>",
"private-secret-key: <api-key>",
"public-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api-sandbox.y.uno/v2/payments/{payment_id}/transactions/{transaction_id}/capture"
payload := strings.NewReader("{\n \"merchant_reference\": \"<string>\",\n \"additional_data\": {\n \"order\": {\n \"shipping_amount\": 123,\n \"fee_amount\": 123,\n \"items\": [\n {\n \"id\": \"<string>\",\n \"name\": \"<string>\",\n \"quantity\": 123,\n \"unit_amount\": 123,\n \"brand\": \"<string>\",\n \"sku_code\": \"<string>\",\n \"manufacture_part_number\": \"<string>\"\n }\n ]\n },\n \"airline\": {\n \"pnr\": \"<string>\",\n \"legs\": [\n {\n \"departure_airport\": \"<string>\",\n \"departure_datetime\": \"2023-11-07T05:31:56Z\",\n \"departure_airport_timezone\": \"<string>\",\n \"arrival_airport\": \"<string>\",\n \"carrier_code\": \"<string>\",\n \"flight_number\": \"<string>\",\n \"fare_basis_code\": \"<string>\",\n \"carrier_name\": \"<string>\",\n \"base_fare\": 123,\n \"base_fare_currency\": \"<string>\",\n \"stopover_code\": \"<string>\"\n }\n ],\n \"passengers\": [\n {\n \"first_name\": \"<string>\",\n \"last_name\": \"<string>\",\n \"middle_name\": \"<string>\",\n \"date_of_birth\": \"2023-12-25\",\n \"document\": {\n \"document_number\": \"<string>\"\n },\n \"loyalty_number\": \"<string>\",\n \"phone\": {}\n }\n ],\n \"tickets\": [\n {\n \"ticket_number\": \"<string>\",\n \"e_ticket\": true,\n \"restricted\": true,\n \"total_fare_amount\": 123,\n \"total_tax_amount\": 123,\n \"total_fee_amount\": 123,\n \"issue\": {\n \"carrier_prefix_code\": \"<string>\",\n \"travel_agent_code\": \"<string>\",\n \"travel_agent_name\": \"<string>\",\n \"date\": \"2023-11-07T05:31:56Z\",\n \"address\": \"<string>\",\n \"city\": \"<string>\"\n }\n }\n ]\n },\n \"seller_details\": {\n \"name\": \"<string>\",\n \"email\": \"<string>\",\n \"reference\": 123,\n \"website\": \"<string>\",\n \"industry\": \"<string>\",\n \"merchant_category_code\": \"<string>\",\n \"document\": {\n \"document_number\": \"<string>\"\n },\n \"phone\": {\n \"country_code\": \"<string>\",\n \"number\": \"<string>\"\n },\n \"address\": {\n \"address_line_1\": \"<string>\",\n \"address_line_2\": \"<string>\",\n \"city\": \"<string>\",\n \"state\": \"<string>\",\n \"zip_code\": \"<string>\"\n }\n }\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Idempotency-Key", "<x-idempotency-key>")
req.Header.Add("public-api-key", "<api-key>")
req.Header.Add("private-secret-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api-sandbox.y.uno/v2/payments/{payment_id}/transactions/{transaction_id}/capture")
.header("X-Idempotency-Key", "<x-idempotency-key>")
.header("public-api-key", "<api-key>")
.header("private-secret-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"merchant_reference\": \"<string>\",\n \"additional_data\": {\n \"order\": {\n \"shipping_amount\": 123,\n \"fee_amount\": 123,\n \"items\": [\n {\n \"id\": \"<string>\",\n \"name\": \"<string>\",\n \"quantity\": 123,\n \"unit_amount\": 123,\n \"brand\": \"<string>\",\n \"sku_code\": \"<string>\",\n \"manufacture_part_number\": \"<string>\"\n }\n ]\n },\n \"airline\": {\n \"pnr\": \"<string>\",\n \"legs\": [\n {\n \"departure_airport\": \"<string>\",\n \"departure_datetime\": \"2023-11-07T05:31:56Z\",\n \"departure_airport_timezone\": \"<string>\",\n \"arrival_airport\": \"<string>\",\n \"carrier_code\": \"<string>\",\n \"flight_number\": \"<string>\",\n \"fare_basis_code\": \"<string>\",\n \"carrier_name\": \"<string>\",\n \"base_fare\": 123,\n \"base_fare_currency\": \"<string>\",\n \"stopover_code\": \"<string>\"\n }\n ],\n \"passengers\": [\n {\n \"first_name\": \"<string>\",\n \"last_name\": \"<string>\",\n \"middle_name\": \"<string>\",\n \"date_of_birth\": \"2023-12-25\",\n \"document\": {\n \"document_number\": \"<string>\"\n },\n \"loyalty_number\": \"<string>\",\n \"phone\": {}\n }\n ],\n \"tickets\": [\n {\n \"ticket_number\": \"<string>\",\n \"e_ticket\": true,\n \"restricted\": true,\n \"total_fare_amount\": 123,\n \"total_tax_amount\": 123,\n \"total_fee_amount\": 123,\n \"issue\": {\n \"carrier_prefix_code\": \"<string>\",\n \"travel_agent_code\": \"<string>\",\n \"travel_agent_name\": \"<string>\",\n \"date\": \"2023-11-07T05:31:56Z\",\n \"address\": \"<string>\",\n \"city\": \"<string>\"\n }\n }\n ]\n },\n \"seller_details\": {\n \"name\": \"<string>\",\n \"email\": \"<string>\",\n \"reference\": 123,\n \"website\": \"<string>\",\n \"industry\": \"<string>\",\n \"merchant_category_code\": \"<string>\",\n \"document\": {\n \"document_number\": \"<string>\"\n },\n \"phone\": {\n \"country_code\": \"<string>\",\n \"number\": \"<string>\"\n },\n \"address\": {\n \"address_line_1\": \"<string>\",\n \"address_line_2\": \"<string>\",\n \"city\": \"<string>\",\n \"state\": \"<string>\",\n \"zip_code\": \"<string>\"\n }\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-sandbox.y.uno/v2/payments/{payment_id}/transactions/{transaction_id}/capture")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Idempotency-Key"] = '<x-idempotency-key>'
request["public-api-key"] = '<api-key>'
request["private-secret-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"merchant_reference\": \"<string>\",\n \"additional_data\": {\n \"order\": {\n \"shipping_amount\": 123,\n \"fee_amount\": 123,\n \"items\": [\n {\n \"id\": \"<string>\",\n \"name\": \"<string>\",\n \"quantity\": 123,\n \"unit_amount\": 123,\n \"brand\": \"<string>\",\n \"sku_code\": \"<string>\",\n \"manufacture_part_number\": \"<string>\"\n }\n ]\n },\n \"airline\": {\n \"pnr\": \"<string>\",\n \"legs\": [\n {\n \"departure_airport\": \"<string>\",\n \"departure_datetime\": \"2023-11-07T05:31:56Z\",\n \"departure_airport_timezone\": \"<string>\",\n \"arrival_airport\": \"<string>\",\n \"carrier_code\": \"<string>\",\n \"flight_number\": \"<string>\",\n \"fare_basis_code\": \"<string>\",\n \"carrier_name\": \"<string>\",\n \"base_fare\": 123,\n \"base_fare_currency\": \"<string>\",\n \"stopover_code\": \"<string>\"\n }\n ],\n \"passengers\": [\n {\n \"first_name\": \"<string>\",\n \"last_name\": \"<string>\",\n \"middle_name\": \"<string>\",\n \"date_of_birth\": \"2023-12-25\",\n \"document\": {\n \"document_number\": \"<string>\"\n },\n \"loyalty_number\": \"<string>\",\n \"phone\": {}\n }\n ],\n \"tickets\": [\n {\n \"ticket_number\": \"<string>\",\n \"e_ticket\": true,\n \"restricted\": true,\n \"total_fare_amount\": 123,\n \"total_tax_amount\": 123,\n \"total_fee_amount\": 123,\n \"issue\": {\n \"carrier_prefix_code\": \"<string>\",\n \"travel_agent_code\": \"<string>\",\n \"travel_agent_name\": \"<string>\",\n \"date\": \"2023-11-07T05:31:56Z\",\n \"address\": \"<string>\",\n \"city\": \"<string>\"\n }\n }\n ]\n },\n \"seller_details\": {\n \"name\": \"<string>\",\n \"email\": \"<string>\",\n \"reference\": 123,\n \"website\": \"<string>\",\n \"industry\": \"<string>\",\n \"merchant_category_code\": \"<string>\",\n \"document\": {\n \"document_number\": \"<string>\"\n },\n \"phone\": {\n \"country_code\": \"<string>\",\n \"number\": \"<string>\"\n },\n \"address\": {\n \"address_line_1\": \"<string>\",\n \"address_line_2\": \"<string>\",\n \"city\": \"<string>\",\n \"state\": \"<string>\",\n \"zip_code\": \"<string>\"\n }\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"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": []
}{
"code": "INVALID_PARAMETERS",
"messages": [
"The header 'x-idempotency-key' is required."
]
}{
"code": "INVALID_CREDENTIALS",
"messages": [
"Invalid credentials"
]
}This request captures one card of a payment created with
This request requires an
capture: false in Create Payment (two cards). 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.
While the payment is in
REFUND_RETRY_IN_PROCESS or CANCEL_RETRY_IN_PROCESS, a capture is rejected. See Pay with two cards.X-Idempotency-Key. See Authentication for details.Authorizations
Headers
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."
Path Parameters
The id of the payment returned by POST /v2/payments.
The id of the card transaction to operate on, from payment_method.payment_methods[].transactions[].
Body
application/json
Identification of the payment transaction defined by the merchant (MAX 255; MIN 3)
Reason for the operation. Possible values are DUPLICATE, FRAUDULENT and REQUESTED_BY_CUSTOMER.
Available options:
DUPLICATE, FRAUDULENT, REQUESTED_BY_CUSTOMER Optional. Amount to capture on this card. If you omit it, the full authorized amount of the card is captured.
Show child attributes
Show child attributes
Additional data to complement the payment capture
Show child attributes
Show child attributes
Response
The payment after the operation, in the v2 shape
A payment funded by two cards.
Aggregated status of the payment. See Pay with two cards.
Aggregated sub status, for example APPROVED, AUTHORIZED, PARTIALLY_CAPTURED, PARTIALLY_REFUNDED, REFUND_RETRY_IN_PROCESS or CANCEL_RETRY_IN_PROCESS.
true for a payment funded by two cards.
Number of cards that fund the payment: 2.
true when the SDK must continue the payment, for example to run a 3DS challenge.
Total of the payment.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
The payer, as sent in the request.
Available options:
DIRECT, REDIRECT, SDK_CHECKOUT Was this page helpful?
⌘I
Capture Authorization (two cards)
curl --request POST \
--url https://api-sandbox.y.uno/v2/payments/{payment_id}/transactions/{transaction_id}/capture \
--header 'Content-Type: application/json' \
--header 'X-Idempotency-Key: <x-idempotency-key>' \
--header 'private-secret-key: <api-key>' \
--header 'public-api-key: <api-key>' \
--data '
{
"merchant_reference": "<string>",
"additional_data": {
"order": {
"shipping_amount": 123,
"fee_amount": 123,
"items": [
{
"id": "<string>",
"name": "<string>",
"quantity": 123,
"unit_amount": 123,
"brand": "<string>",
"sku_code": "<string>",
"manufacture_part_number": "<string>"
}
]
},
"airline": {
"pnr": "<string>",
"legs": [
{
"departure_airport": "<string>",
"departure_datetime": "2023-11-07T05:31:56Z",
"departure_airport_timezone": "<string>",
"arrival_airport": "<string>",
"carrier_code": "<string>",
"flight_number": "<string>",
"fare_basis_code": "<string>",
"carrier_name": "<string>",
"base_fare": 123,
"base_fare_currency": "<string>",
"stopover_code": "<string>"
}
],
"passengers": [
{
"first_name": "<string>",
"last_name": "<string>",
"middle_name": "<string>",
"date_of_birth": "2023-12-25",
"document": {
"document_number": "<string>"
},
"loyalty_number": "<string>",
"phone": {}
}
],
"tickets": [
{
"ticket_number": "<string>",
"e_ticket": true,
"restricted": true,
"total_fare_amount": 123,
"total_tax_amount": 123,
"total_fee_amount": 123,
"issue": {
"carrier_prefix_code": "<string>",
"travel_agent_code": "<string>",
"travel_agent_name": "<string>",
"date": "2023-11-07T05:31:56Z",
"address": "<string>",
"city": "<string>"
}
}
]
},
"seller_details": {
"name": "<string>",
"email": "<string>",
"reference": 123,
"website": "<string>",
"industry": "<string>",
"merchant_category_code": "<string>",
"document": {
"document_number": "<string>"
},
"phone": {
"country_code": "<string>",
"number": "<string>"
},
"address": {
"address_line_1": "<string>",
"address_line_2": "<string>",
"city": "<string>",
"state": "<string>",
"zip_code": "<string>"
}
}
}
}
'import requests
url = "https://api-sandbox.y.uno/v2/payments/{payment_id}/transactions/{transaction_id}/capture"
payload = {
"merchant_reference": "<string>",
"additional_data": {
"order": {
"shipping_amount": 123,
"fee_amount": 123,
"items": [
{
"id": "<string>",
"name": "<string>",
"quantity": 123,
"unit_amount": 123,
"brand": "<string>",
"sku_code": "<string>",
"manufacture_part_number": "<string>"
}
]
},
"airline": {
"pnr": "<string>",
"legs": [
{
"departure_airport": "<string>",
"departure_datetime": "2023-11-07T05:31:56Z",
"departure_airport_timezone": "<string>",
"arrival_airport": "<string>",
"carrier_code": "<string>",
"flight_number": "<string>",
"fare_basis_code": "<string>",
"carrier_name": "<string>",
"base_fare": 123,
"base_fare_currency": "<string>",
"stopover_code": "<string>"
}
],
"passengers": [
{
"first_name": "<string>",
"last_name": "<string>",
"middle_name": "<string>",
"date_of_birth": "2023-12-25",
"document": { "document_number": "<string>" },
"loyalty_number": "<string>",
"phone": {}
}
],
"tickets": [
{
"ticket_number": "<string>",
"e_ticket": True,
"restricted": True,
"total_fare_amount": 123,
"total_tax_amount": 123,
"total_fee_amount": 123,
"issue": {
"carrier_prefix_code": "<string>",
"travel_agent_code": "<string>",
"travel_agent_name": "<string>",
"date": "2023-11-07T05:31:56Z",
"address": "<string>",
"city": "<string>"
}
}
]
},
"seller_details": {
"name": "<string>",
"email": "<string>",
"reference": 123,
"website": "<string>",
"industry": "<string>",
"merchant_category_code": "<string>",
"document": { "document_number": "<string>" },
"phone": {
"country_code": "<string>",
"number": "<string>"
},
"address": {
"address_line_1": "<string>",
"address_line_2": "<string>",
"city": "<string>",
"state": "<string>",
"zip_code": "<string>"
}
}
}
}
headers = {
"X-Idempotency-Key": "<x-idempotency-key>",
"public-api-key": "<api-key>",
"private-secret-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'X-Idempotency-Key': '<x-idempotency-key>',
'public-api-key': '<api-key>',
'private-secret-key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
merchant_reference: '<string>',
additional_data: {
order: {
shipping_amount: 123,
fee_amount: 123,
items: [
{
id: '<string>',
name: '<string>',
quantity: 123,
unit_amount: 123,
brand: '<string>',
sku_code: '<string>',
manufacture_part_number: '<string>'
}
]
},
airline: {
pnr: '<string>',
legs: [
{
departure_airport: '<string>',
departure_datetime: '2023-11-07T05:31:56Z',
departure_airport_timezone: '<string>',
arrival_airport: '<string>',
carrier_code: '<string>',
flight_number: '<string>',
fare_basis_code: '<string>',
carrier_name: '<string>',
base_fare: 123,
base_fare_currency: '<string>',
stopover_code: '<string>'
}
],
passengers: [
{
first_name: '<string>',
last_name: '<string>',
middle_name: '<string>',
date_of_birth: '2023-12-25',
document: {document_number: '<string>'},
loyalty_number: '<string>',
phone: {}
}
],
tickets: [
{
ticket_number: '<string>',
e_ticket: true,
restricted: true,
total_fare_amount: 123,
total_tax_amount: 123,
total_fee_amount: 123,
issue: {
carrier_prefix_code: '<string>',
travel_agent_code: '<string>',
travel_agent_name: '<string>',
date: '2023-11-07T05:31:56Z',
address: '<string>',
city: '<string>'
}
}
]
},
seller_details: {
name: '<string>',
email: '<string>',
reference: 123,
website: '<string>',
industry: '<string>',
merchant_category_code: '<string>',
document: {document_number: '<string>'},
phone: {country_code: '<string>', number: '<string>'},
address: {
address_line_1: '<string>',
address_line_2: '<string>',
city: '<string>',
state: '<string>',
zip_code: '<string>'
}
}
}
})
};
fetch('https://api-sandbox.y.uno/v2/payments/{payment_id}/transactions/{transaction_id}/capture', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api-sandbox.y.uno/v2/payments/{payment_id}/transactions/{transaction_id}/capture",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'merchant_reference' => '<string>',
'additional_data' => [
'order' => [
'shipping_amount' => 123,
'fee_amount' => 123,
'items' => [
[
'id' => '<string>',
'name' => '<string>',
'quantity' => 123,
'unit_amount' => 123,
'brand' => '<string>',
'sku_code' => '<string>',
'manufacture_part_number' => '<string>'
]
]
],
'airline' => [
'pnr' => '<string>',
'legs' => [
[
'departure_airport' => '<string>',
'departure_datetime' => '2023-11-07T05:31:56Z',
'departure_airport_timezone' => '<string>',
'arrival_airport' => '<string>',
'carrier_code' => '<string>',
'flight_number' => '<string>',
'fare_basis_code' => '<string>',
'carrier_name' => '<string>',
'base_fare' => 123,
'base_fare_currency' => '<string>',
'stopover_code' => '<string>'
]
],
'passengers' => [
[
'first_name' => '<string>',
'last_name' => '<string>',
'middle_name' => '<string>',
'date_of_birth' => '2023-12-25',
'document' => [
'document_number' => '<string>'
],
'loyalty_number' => '<string>',
'phone' => [
]
]
],
'tickets' => [
[
'ticket_number' => '<string>',
'e_ticket' => true,
'restricted' => true,
'total_fare_amount' => 123,
'total_tax_amount' => 123,
'total_fee_amount' => 123,
'issue' => [
'carrier_prefix_code' => '<string>',
'travel_agent_code' => '<string>',
'travel_agent_name' => '<string>',
'date' => '2023-11-07T05:31:56Z',
'address' => '<string>',
'city' => '<string>'
]
]
]
],
'seller_details' => [
'name' => '<string>',
'email' => '<string>',
'reference' => 123,
'website' => '<string>',
'industry' => '<string>',
'merchant_category_code' => '<string>',
'document' => [
'document_number' => '<string>'
],
'phone' => [
'country_code' => '<string>',
'number' => '<string>'
],
'address' => [
'address_line_1' => '<string>',
'address_line_2' => '<string>',
'city' => '<string>',
'state' => '<string>',
'zip_code' => '<string>'
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Idempotency-Key: <x-idempotency-key>",
"private-secret-key: <api-key>",
"public-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api-sandbox.y.uno/v2/payments/{payment_id}/transactions/{transaction_id}/capture"
payload := strings.NewReader("{\n \"merchant_reference\": \"<string>\",\n \"additional_data\": {\n \"order\": {\n \"shipping_amount\": 123,\n \"fee_amount\": 123,\n \"items\": [\n {\n \"id\": \"<string>\",\n \"name\": \"<string>\",\n \"quantity\": 123,\n \"unit_amount\": 123,\n \"brand\": \"<string>\",\n \"sku_code\": \"<string>\",\n \"manufacture_part_number\": \"<string>\"\n }\n ]\n },\n \"airline\": {\n \"pnr\": \"<string>\",\n \"legs\": [\n {\n \"departure_airport\": \"<string>\",\n \"departure_datetime\": \"2023-11-07T05:31:56Z\",\n \"departure_airport_timezone\": \"<string>\",\n \"arrival_airport\": \"<string>\",\n \"carrier_code\": \"<string>\",\n \"flight_number\": \"<string>\",\n \"fare_basis_code\": \"<string>\",\n \"carrier_name\": \"<string>\",\n \"base_fare\": 123,\n \"base_fare_currency\": \"<string>\",\n \"stopover_code\": \"<string>\"\n }\n ],\n \"passengers\": [\n {\n \"first_name\": \"<string>\",\n \"last_name\": \"<string>\",\n \"middle_name\": \"<string>\",\n \"date_of_birth\": \"2023-12-25\",\n \"document\": {\n \"document_number\": \"<string>\"\n },\n \"loyalty_number\": \"<string>\",\n \"phone\": {}\n }\n ],\n \"tickets\": [\n {\n \"ticket_number\": \"<string>\",\n \"e_ticket\": true,\n \"restricted\": true,\n \"total_fare_amount\": 123,\n \"total_tax_amount\": 123,\n \"total_fee_amount\": 123,\n \"issue\": {\n \"carrier_prefix_code\": \"<string>\",\n \"travel_agent_code\": \"<string>\",\n \"travel_agent_name\": \"<string>\",\n \"date\": \"2023-11-07T05:31:56Z\",\n \"address\": \"<string>\",\n \"city\": \"<string>\"\n }\n }\n ]\n },\n \"seller_details\": {\n \"name\": \"<string>\",\n \"email\": \"<string>\",\n \"reference\": 123,\n \"website\": \"<string>\",\n \"industry\": \"<string>\",\n \"merchant_category_code\": \"<string>\",\n \"document\": {\n \"document_number\": \"<string>\"\n },\n \"phone\": {\n \"country_code\": \"<string>\",\n \"number\": \"<string>\"\n },\n \"address\": {\n \"address_line_1\": \"<string>\",\n \"address_line_2\": \"<string>\",\n \"city\": \"<string>\",\n \"state\": \"<string>\",\n \"zip_code\": \"<string>\"\n }\n }\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Idempotency-Key", "<x-idempotency-key>")
req.Header.Add("public-api-key", "<api-key>")
req.Header.Add("private-secret-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api-sandbox.y.uno/v2/payments/{payment_id}/transactions/{transaction_id}/capture")
.header("X-Idempotency-Key", "<x-idempotency-key>")
.header("public-api-key", "<api-key>")
.header("private-secret-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"merchant_reference\": \"<string>\",\n \"additional_data\": {\n \"order\": {\n \"shipping_amount\": 123,\n \"fee_amount\": 123,\n \"items\": [\n {\n \"id\": \"<string>\",\n \"name\": \"<string>\",\n \"quantity\": 123,\n \"unit_amount\": 123,\n \"brand\": \"<string>\",\n \"sku_code\": \"<string>\",\n \"manufacture_part_number\": \"<string>\"\n }\n ]\n },\n \"airline\": {\n \"pnr\": \"<string>\",\n \"legs\": [\n {\n \"departure_airport\": \"<string>\",\n \"departure_datetime\": \"2023-11-07T05:31:56Z\",\n \"departure_airport_timezone\": \"<string>\",\n \"arrival_airport\": \"<string>\",\n \"carrier_code\": \"<string>\",\n \"flight_number\": \"<string>\",\n \"fare_basis_code\": \"<string>\",\n \"carrier_name\": \"<string>\",\n \"base_fare\": 123,\n \"base_fare_currency\": \"<string>\",\n \"stopover_code\": \"<string>\"\n }\n ],\n \"passengers\": [\n {\n \"first_name\": \"<string>\",\n \"last_name\": \"<string>\",\n \"middle_name\": \"<string>\",\n \"date_of_birth\": \"2023-12-25\",\n \"document\": {\n \"document_number\": \"<string>\"\n },\n \"loyalty_number\": \"<string>\",\n \"phone\": {}\n }\n ],\n \"tickets\": [\n {\n \"ticket_number\": \"<string>\",\n \"e_ticket\": true,\n \"restricted\": true,\n \"total_fare_amount\": 123,\n \"total_tax_amount\": 123,\n \"total_fee_amount\": 123,\n \"issue\": {\n \"carrier_prefix_code\": \"<string>\",\n \"travel_agent_code\": \"<string>\",\n \"travel_agent_name\": \"<string>\",\n \"date\": \"2023-11-07T05:31:56Z\",\n \"address\": \"<string>\",\n \"city\": \"<string>\"\n }\n }\n ]\n },\n \"seller_details\": {\n \"name\": \"<string>\",\n \"email\": \"<string>\",\n \"reference\": 123,\n \"website\": \"<string>\",\n \"industry\": \"<string>\",\n \"merchant_category_code\": \"<string>\",\n \"document\": {\n \"document_number\": \"<string>\"\n },\n \"phone\": {\n \"country_code\": \"<string>\",\n \"number\": \"<string>\"\n },\n \"address\": {\n \"address_line_1\": \"<string>\",\n \"address_line_2\": \"<string>\",\n \"city\": \"<string>\",\n \"state\": \"<string>\",\n \"zip_code\": \"<string>\"\n }\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-sandbox.y.uno/v2/payments/{payment_id}/transactions/{transaction_id}/capture")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Idempotency-Key"] = '<x-idempotency-key>'
request["public-api-key"] = '<api-key>'
request["private-secret-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"merchant_reference\": \"<string>\",\n \"additional_data\": {\n \"order\": {\n \"shipping_amount\": 123,\n \"fee_amount\": 123,\n \"items\": [\n {\n \"id\": \"<string>\",\n \"name\": \"<string>\",\n \"quantity\": 123,\n \"unit_amount\": 123,\n \"brand\": \"<string>\",\n \"sku_code\": \"<string>\",\n \"manufacture_part_number\": \"<string>\"\n }\n ]\n },\n \"airline\": {\n \"pnr\": \"<string>\",\n \"legs\": [\n {\n \"departure_airport\": \"<string>\",\n \"departure_datetime\": \"2023-11-07T05:31:56Z\",\n \"departure_airport_timezone\": \"<string>\",\n \"arrival_airport\": \"<string>\",\n \"carrier_code\": \"<string>\",\n \"flight_number\": \"<string>\",\n \"fare_basis_code\": \"<string>\",\n \"carrier_name\": \"<string>\",\n \"base_fare\": 123,\n \"base_fare_currency\": \"<string>\",\n \"stopover_code\": \"<string>\"\n }\n ],\n \"passengers\": [\n {\n \"first_name\": \"<string>\",\n \"last_name\": \"<string>\",\n \"middle_name\": \"<string>\",\n \"date_of_birth\": \"2023-12-25\",\n \"document\": {\n \"document_number\": \"<string>\"\n },\n \"loyalty_number\": \"<string>\",\n \"phone\": {}\n }\n ],\n \"tickets\": [\n {\n \"ticket_number\": \"<string>\",\n \"e_ticket\": true,\n \"restricted\": true,\n \"total_fare_amount\": 123,\n \"total_tax_amount\": 123,\n \"total_fee_amount\": 123,\n \"issue\": {\n \"carrier_prefix_code\": \"<string>\",\n \"travel_agent_code\": \"<string>\",\n \"travel_agent_name\": \"<string>\",\n \"date\": \"2023-11-07T05:31:56Z\",\n \"address\": \"<string>\",\n \"city\": \"<string>\"\n }\n }\n ]\n },\n \"seller_details\": {\n \"name\": \"<string>\",\n \"email\": \"<string>\",\n \"reference\": 123,\n \"website\": \"<string>\",\n \"industry\": \"<string>\",\n \"merchant_category_code\": \"<string>\",\n \"document\": {\n \"document_number\": \"<string>\"\n },\n \"phone\": {\n \"country_code\": \"<string>\",\n \"number\": \"<string>\"\n },\n \"address\": {\n \"address_line_1\": \"<string>\",\n \"address_line_2\": \"<string>\",\n \"city\": \"<string>\",\n \"state\": \"<string>\",\n \"zip_code\": \"<string>\"\n }\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"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": []
}{
"code": "INVALID_PARAMETERS",
"messages": [
"The header 'x-idempotency-key' is required."
]
}{
"code": "INVALID_CREDENTIALS",
"messages": [
"Invalid credentials"
]
}