Retrieve Payment (two cards)

GET

payments

{payment_id}

Retrieve Payment (v2)

curl --request GET \
  --url https://api-sandbox.y.uno/v2/payments/{payment_id} \
  --header 'private-secret-key: <api-key>' \
  --header 'public-api-key: <api-key>'

import requests

url = "https://api-sandbox.y.uno/v2/payments/{payment_id}"

headers = {
    "public-api-key": "<api-key>",
    "private-secret-key": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'public-api-key': '<api-key>', 'private-secret-key': '<api-key>'}
};

fetch('https://api-sandbox.y.uno/v2/payments/{payment_id}', 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}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "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"
	"net/http"
	"io"
)

func main() {

	url := "https://api-sandbox.y.uno/v2/payments/{payment_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("public-api-key", "<api-key>")
	req.Header.Add("private-secret-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api-sandbox.y.uno/v2/payments/{payment_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["public-api-key"] = '<api-key>'
request["private-secret-key"] = '<api-key>'

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": "APPROVED",
  "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": true,
    "account_updater": false,
    "payment_methods": [
      {
        "sequence": 1,
        "type": "CARD",
        "amount": {
          "currency": "BRL",
          "value": 200
        },
        "transactions": [
          {
            "id": "d2a4f6b8-1c3e-4a5b-8d7f-9e0a1b2c3d4e",
            "type": "PURCHASE",
            "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": "PURCHASE",
            "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": []
}

This request retrieves a payment created with Create Payment (two cards), using the id in the request path. The base URL is https://api-sandbox.y.uno/v2 in sandbox https://api.y.uno/v2 in production (US) and https://api.eu.y.uno/v2 in production (EMEA). The response has split_payment_methods: true, payment_methods_count: 2 and one entry per card in payment_method.payment_methods, each with its sequence (1 or 2), type, amount and transactions. A card has no status of its own: read each card’s outcome from its transactions, and the payment outcome from the payment-level status and sub_status. See Pay with two cards.

For a payment created with POST /v1/payments, use the v1 request GET /v1/payments/{payment_id}. The v1 response shows a payment as a whole, not each card.

Authorizations

public-api-key

string

header

default:<Your public-api-key>

required

private-secret-key

string

header

default:<Your private-secret-key>

required

Path Parameters

payment_id

string<uuid>

required

The id of the payment returned by POST /v2/payments.

Response

The payment

A payment funded by two cards.

string<uuid>

account_id

string<uuid>

description

string

country

string

status

string

Aggregated status of the payment. See Pay with two cards.

sub_status

string

Aggregated sub status, for example APPROVED, AUTHORIZED, PARTIALLY_CAPTURED, PARTIALLY_REFUNDED, REFUND_RETRY_IN_PROCESS or CANCEL_RETRY_IN_PROCESS.

merchant_order_id

string

merchant_reference

string

created_at

string<date-time>

updated_at

string<date-time>

split_payment_methods

boolean

true for a payment funded by two cards.

payment_methods_count

integer

Number of cards that fund the payment: 2.

sdk_action_required

boolean

true when the SDK must continue the payment, for example to run a 3DS challenge.

amount

object

Total of the payment.

Show child attributes

checkout

object

Show child attributes

payment_method

object

Show child attributes

customer_payer

object

The payer, as sent in the request.

additional_data

object | null

callback_url

string

workflow

enum<string>

Available options:

DIRECT,

REDIRECT,

SDK_CHECKOUT

metadata

object[]

⌘I

Retrieve Payment (v2)

curl --request GET \
  --url https://api-sandbox.y.uno/v2/payments/{payment_id} \
  --header 'private-secret-key: <api-key>' \
  --header 'public-api-key: <api-key>'

import requests

url = "https://api-sandbox.y.uno/v2/payments/{payment_id}"

headers = {
    "public-api-key": "<api-key>",
    "private-secret-key": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'public-api-key': '<api-key>', 'private-secret-key': '<api-key>'}
};

fetch('https://api-sandbox.y.uno/v2/payments/{payment_id}', 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}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "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"
	"net/http"
	"io"
)

func main() {

	url := "https://api-sandbox.y.uno/v2/payments/{payment_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("public-api-key", "<api-key>")
	req.Header.Add("private-secret-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api-sandbox.y.uno/v2/payments/{payment_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["public-api-key"] = '<api-key>'
request["private-secret-key"] = '<api-key>'

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": "APPROVED",
  "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": true,
    "account_updater": false,
    "payment_methods": [
      {
        "sequence": 1,
        "type": "CARD",
        "amount": {
          "currency": "BRL",
          "value": 200
        },
        "transactions": [
          {
            "id": "d2a4f6b8-1c3e-4a5b-8d7f-9e0a1b2c3d4e",
            "type": "PURCHASE",
            "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": "PURCHASE",
            "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": []
}

Getting Started

Reference

Customers

Network Tokens

Customer Sessions (Enrollment)

Checkout Sessions

Payment Methods (Checkout)

Checkout Builder

Payment Methods (Direct Workflow)

PCI Proxy

Payments

Pre-Debit Notifications

3DS2 Setup

Unreferenced Refunds

Dry-run

Transaction Reporting

Routing Recommendations

Payment Links

Recipients for Marketplace

Sellers (Franchise)

Subscriptions Plans

Subscriptions

Payouts

Organizations

Reports

Installments

AI Caller

Communications Campaigns

Conversion Rate

FX Rates

Banking Connectivity

Webhooks

Authorizations

Path Parameters

Response