Cards

This page presents examples of requests and responses for creating payments and authorizations using the Create Payment endpoint and Card as payment method.

To test the creation of each payment, you can copy the content from the request code and use it on your machine or paste it on the Create Payment endpoint to test using Readme.

Cards available examples

Card Direct for authorization
Card Direct for authorization with airline data
Card Direct with installments
Card Direct with vault on success
Card Direct with vaulted token
Card Direct with 3DS
Card Direct with customer, billing, shipping and order items

Card Direct for authorization

Example of a request for authorization using Card Direct. Below are examples of a request and the received response for successful payment creation. The request is presented using the cURL format, and the response is a JSON object.

curl --request POST \
     --url https://api-sandbox.y.uno/v1/payments \
     --header 'X-Idempotency-Key: <your-X-idempotency-key>' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'private-secret-key: <your-private-secret-key>' \
     --header 'public-api-key: <your-public-api-key>' \
     --data '
{
  "country": "US",
  "amount": {
    "currency": "USD",
    "value": "200"
  },
  "customer_payer": {
    "first_name": "JOHN",
    "last_name": "DOE",
    "email": "[email protected]",
    "country": "US",
    "gender": "M",
    "date_of_birth": "1998-07-20",
    "nationality": "US",
    "document": {
      "document_type": "PASSPORT",
      "document_number": "123456789"
    }
  },
  "payment_method": {
    "detail": {
      "card": {
        "card_data": {
          "number": "4111111111111111",
          "expiration_month": 11,
          "expiration_year": 28,
          "security_code": "123",
          "holder_name": "JOHN DOE"
        },
        "capture": false
      }
    },
    "type": "CARD"
  },
  "account_id": "<account_id>",
  "description": "Card payment for authorization",
  "merchant_order_id": "000022",
  "merchant_reference": "reference-0001",
  "workflow": "DIRECT"
}
'
{
    "id": "d9b4e33a-5c9f-4f1a-9ccb-ee13cc432390",
    "account_id": "5beead35-0cd5-4e1c-9a13-b8f48f7f8f3a",
    "description": "Online purchase",
    "country": "US",
    "status": "SUCCEEDED",
    "sub_status": "APPROVED",
    "merchant_order_id": "00000233",
    "created_at": "2025-06-19T18:48:36.294677Z",
    "updated_at": "2025-06-19T18:48:36.591107Z",
    "amount": {
        "captured": 0.00,
        "currency": "USD",
        "currency_conversion": null,
        "refunded": 0.00,
        "value": 55.75
    },
    "checkout": {
        "session": "",
        "sdk_action_required": false
    },
    "payment_method": {
        "vaulted_token": "",
        "type": "CARD",
        "vault_on_success": false,
        "token": "",
        "parent_payment_method_type": null,
        "payment_method_detail": {
            "card": {
                "verify": false,
                "capture": true,
                "installments": 1,
                "installments_plan_id": null,
                "first_installment_deferral": 0,
                "installments_type": "",
                "installment_amount": null,
                "soft_descriptor": "",
                "authorization_code": "554791",
                "retrieval_reference_number": "",
                "voucher": null,
                "card_data": {
                    "holder_name": "JANE SMITH",
                    "iin": "41234567",
                    "lfd": "2345",
                    "number_length": 16,
                    "security_code_length": 3,
                    "brand": "VISA",
                    "issuer_name": "INTL HDQTRSCENTER OWNED",
                    "issuer_code": null,
                    "country_code": "VN",
                    "category": "CLASSIC",
                    "type": "CREDIT",
                    "three_d_secure": {
                        "version": null,
                        "electronic_commerce_indicator": null,
                        "cryptogram": null,
                        "transaction_id": null,
                        "directory_server_transaction_id": null,
                        "pares_status": null,
                        "acs_id": null
                    },
                    "fingerprint": "e5fb7cbd-c42b-4ec2-ab9c-a421f049a3b8",
                    "expiration_month": 10,
                    "expiration_year": 29
                },
                "stored_credentials": {
                    "reason": null,
                    "usage": null,
                    "subscription_agreement_id": null,
                    "network_transaction_id": null
                }
            }
        }
    },
    "customer_payer": {
        "id": null,
        "merchant_customer_id": "1750358916",
        "first_name": "JANE",
        "last_name": "SMITH",
        "gender": "F",
        "date_of_birth": "1985-07-20",
        "email": "[email protected]",
        "nationality": "US",
        "ip_address": null,
        "device_fingerprint": null,
        "device_fingerprints": [],
        "browser_info": {
            "user_agent": "",
            "accept_header": "",
            "accept_content": null,
            "accept_browser": null,
            "color_depth": "",
            "screen_height": "",
            "screen_width": "",
            "javascript_enabled": null,
            "java_enabled": null,
            "browser_time_difference": null,
            "language": "",
            "platform": null
        },
        "document": {
            "document_type": "PASSPORT",
            "document_number": "123456789"
        },
        "phone": null,
        "billing_address": null,
        "shipping_address": null,
        "merchant_customer_created_at": null
    },
    "additional_data": null,
    "transactions": {
        "id": "8ec993f5-20a4-4aae-9cc9-d830adfa6948",
        "type": "PURCHASE",
        "status": "SUCCEEDED",
        "category": "CARD",
        "amount": 55.75,
        "provider_id": "YUNO_TEST_PAYMENT_GW",
        "payment_method": {
            "vaulted_token": "",
            "type": "CARD",
            "vault_on_success": false,
            "token": "",
            "parent_payment_method_type": null,
            "detail": {
                "card": {
                    "verify": false,
                    "capture": true,
                    "installments": 1,
                    "installments_plan_id": null,
                    "first_installment_deferral": 0,
                    "installments_type": "",
                    "installment_amount": null,
                    "soft_descriptor": "",
                    "authorization_code": "554791",
                    "retrieval_reference_number": "",
                    "voucher": null,
                    "card_data": {
                        "holder_name": "JANE SMITH",
                        "iin": "41234567",
                        "lfd": "2345",
                        "number_length": 16,
                        "security_code_length": 3,
                        "brand": "VISA",
                        "issuer_name": "INTL HDQTRSCENTER OWNED",
                        "issuer_code": null,
                        "country_code": "VN",
                        "category": "CLASSIC",
                        "type": "CREDIT",
                        "three_d_secure": {
                            "version": null,
                            "electronic_commerce_indicator": null,
                            "cryptogram": null,
                            "transaction_id": null,
                            "directory_server_transaction_id": null,
                            "pares_status": null,
                            "acs_id": null
                        },
                        "fingerprint": "e5fb7cbd-c42b-4ec2-ab9c-a421f049a3b8",
                        "expiration_month": 10,
                        "expiration_year": 29
                    },
                    "stored_credentials": {
                        "reason": null,
                        "usage": null,
                        "subscription_agreement_id": null,
                        "network_transaction_id": null
                    }
                }
            }
        },
        "response_code": "SUCCEEDED",
        "response_message": "Transaction successful",
        "reason": null,
        "description": "Online purchase",
        "merchant_reference": "reference-d84c8065-06d6-4caf-9fcd-a7fede9f22c2",
        "provider_data": {
            "id": "YUNO_TEST_PAYMENT_GW",
            "transaction_id": "26a91a1a-674a-425f-8bc1-d33c8f43975c",
            "account_id": "",
            "status": "SUCCEEDED",
            "sub_status": "",
            "status_detail": "",
            "response_message": null,
            "response_code": null,
            "raw_response": {
                "amount": {
                    "currency": "BRL",
                    "value": 2100
                },
                "merchantAccount": "YunoPaymentsECOM",
                "paymentPspReference": "ZKHXKZGXMLBX8N82",
                "pspReference": "VKJTCWZ9575ZGN82",
                "reference": "34343434",
                "status": "received"
            },
            "third_party_transaction_id": "",
            "third_party_account_id": null,
            "iso8583_response_code": null,
            "iso8583_response_message": null
        },
        "connection_data": {
            "id": "a2ee2f97-8ba0-4198-a821-3b750bc97872",
            "name": null
        },
        "created_at": "2025-06-19T18:48:36.492840Z",
        "updated_at": "2025-06-19T18:48:36.552678Z"
    },
    "transactions_history": [
        {
            "id": "8ec993f5-20a4-4aae-9cc9-d830adfa6948",
            "type": "PURCHASE",
            "status": "SUCCEEDED",
            "category": "CARD",
            "amount": 55.75,
            "provider_id": "YUNO_TEST_PAYMENT_GW",
            "payment_method": {
                "vaulted_token": "",
                "type": "CARD",
                "vault_on_success": false,
                "token": "",
                "parent_payment_method_type": null,
                "detail": {
                    "card": {
                        "verify": false,
                        "capture": true,
                        "installments": 1,
                        "installments_plan_id": null,
                        "first_installment_deferral": 0,
                        "installments_type": "",
                        "installment_amount": null,
                        "soft_descriptor": "",
                        "authorization_code": "554791",
                        "retrieval_reference_number": "",
                        "voucher": null,
                        "card_data": {
                            "holder_name": "JANE SMITH",
                            "iin": "41234567",
                            "lfd": "2345",
                            "number_length": 16,
                            "security_code_length": 3,
                            "brand": "VISA",
                            "issuer_name": "INTL HDQTRSCENTER OWNED",
                            "issuer_code": null,
                            "country_code": "VN",
                            "category": "CLASSIC",
                            "type": "CREDIT",
                            "three_d_secure": {
                                "version": null,
                                "electronic_commerce_indicator": null,
                                "cryptogram": null,
                                "transaction_id": null,
                                "directory_server_transaction_id": null,
                                "pares_status": null,
                                "acs_id": null
                            },
                            "fingerprint": "e5fb7cbd-c42b-4ec2-ab9c-a421f049a3b8",
                            "expiration_month": 10,
                            "expiration_year": 29
                        },
                        "stored_credentials": {
                            "reason": null,
                            "usage": null,
                            "subscription_agreement_id": null,
                            "network_transaction_id": null
                        }
                    }
                }
            },
            "response_code": "SUCCEEDED",
            "response_message": "Transaction successful",
            "reason": null,
            "description": "Online purchase",
            "merchant_reference": "reference-d84c8065-06d6-4caf-9fcd-a7fede9f22c2",
            "provider_data": {
                "id": "YUNO_TEST_PAYMENT_GW",
                "transaction_id": "26a91a1a-674a-425f-8bc1-d33c8f43975c",
                "account_id": "",
                "status": "SUCCEEDED",
                "sub_status": "",
                "status_detail": "",
                "response_message": null,
                "response_code": null,
                "raw_response": {
                    "amount": {
                        "currency": "BRL",
                        "value": 2100
                    },
                    "merchantAccount": "YunoPaymentsECOM",
                    "paymentPspReference": "ZKHXKZGXMLBX8N82",
                    "pspReference": "VKJTCWZ9575ZGN82",
                    "reference": "34343434",
                    "status": "received"
                },
                "third_party_transaction_id": "",
                "third_party_account_id": null,
                "iso8583_response_code": null,
                "iso8583_response_message": null
            },
            "connection_data": {
                "id": "a2ee2f97-8ba0-4198-a821-3b750bc97872",
                "name": null
            },
            "created_at": "2025-06-19T18:48:36.492840Z",
            "updated_at": "2025-06-19T18:48:36.552678Z"
        }
    ],
    "workflow": "DIRECT",
    "metadata": [],
    "fraud_screening": null,
    "payment_link_id": "",
    "subscription_code": null,
    "routing_rules": {
        "smart_routing": false,
        "monitors": false,
        "condition": {
            "id": 192539,
            "name": "Card",
            "description": ""
        }
    },
    "simplified_mode": false
}

Card Direct for authorization with airline data

Example of a request for authorization with airline data using Card Direct. Below are examples of a request and the received response for successful payment creation. The request is presented using the cURL format, and the response is a JSON object.

curl --request POST \
     --url https://api-sandbox.y.uno/v1/payments \
     --header 'X-Idempotency-Key: <your-X-idempotency-key>' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'private-secret-key: <your-private-secret-key>' \
     --header 'public-api-key: <your-public-api-key>' \
     --data '
{
  "account_id": "<accound_id>",
  "description": "Card payment with airline data",
  "merchant_order_id": "00024",
  "merchant_reference": "Example_Merchant_Reference",
  "country": "US",
  "amount": {
    "currency": "USD",
    "value": "2350"
  },
  "additional_data": {
    "airline": {
      "legs": [
        {
          "departure_airport": "JFK",
          "departure_datetime": "2024-07-03T05:00:00",
          "departure_airport_timezone": "GMT-04",
          "arrival_airport": "BOM",
          "carrier_code": "PR",
          "flight_number": "AV348",
          "fare_basis_code": "Y",
          "fare_class_code": "S",
          "base_fare": 950,
          "base_fare_currency": "USD",
          "stopover_code": "O"
        }
      ],
      "passengers": [
        {
          "document": {
            "document_number": "1092456327",
            "document_type": "PASSPORT%",
            "country": "US"
          },
          "first_name": "JOHN",
          "last_name": "DOE",
          "middle_name": "STEPHEN",
          "type": "A",
          "date_of_birth": "1998-01-01",
          "nationality": "US",
          "loyalty_number": "79250001",
          "loyalty_tier": "DIAMOND"
        }
      ],
      "tickets": [
        {
          "issue": {
            "carrier_prefix_code": "016",
            "travel_agent_code": "B987654",
            "travel_agent_name": "GLOBAL TRAVELS",
            "date": "2024-12-01 10:00:00",
            "address": "789 Broadway Ave",
            "city": "NEW YORK",
            "country": "US",
            "zip_code": "10003"
          },
          "ticket_number": "BRB0001",
          "e_ticket": true,
          "restricted": false,
          "total_fare_amount": 1000,
          "total_tax_amount": 150,
          "total_fee_amount": 25
        },
        {
          "issue": {
            "carrier_prefix_code": "016",
            "travel_agent_code": "B987654",
            "travel_agent_name": "GLOBAL TRAVELS",
            "date": "2024-12-01 10:00:00",
            "address": "789 Broadway Ave",
            "city": "NEW YORK",
            "country": "US",
            "zip_code": "10003"
          },
          "ticket_number": "BRB0002",
          "e_ticket": true,
          "restricted": false,
          "total_fare_amount": 1000,
          "total_tax_amount": 150,
          "total_fee_amount": 25
        }
      ],
      "pnr": "ABC123"
    }
  },
  "customer_payer": {
    "document": {
      "document_number": "1092345673",
      "document_type": "PASS"
    },
    "billing_address": {
      "address_line_1": "123 Main Street",
      "address_line_2": "Apt 4B",
      "country": "US",
      "state": "NY",
      "city": "NEW YORK",
      "zip_code": "10001"
    },
    "first_name": "JOHN",
    "last_name": "DOE",
    "gender": "M",
    "date_of_birth": "1998-01-01",
    "email": "[email protected]",
    "nationality": "US",
    "ip_address": "192.0.0.1"
  },
  "workflow": "DIRECT",
  "payment_method": {
    "detail": {
      "card": {
        "card_data": {
          "number": "4111111111111111",
          "expiration_month": 11,
          "expiration_year": 28,
          "security_code": "123",
          "holder_name": "JOHN DOE"
        },
        "capture": false
      }
    },
    "type": "CARD"
  } 
}
'
{
    "id": "16402f10-228b-4868-97e3-c3d1d73ab987",
    "account_id": "5beead35-0cd5-4e1c-9a13-b8f48f7f8f3a",
    "description": "Flight booking to India",
    "country": "US",
    "status": "SUCCEEDED",
    "sub_status": "APPROVED",
    "merchant_order_id": "0000024",
    "created_at": "2025-06-19T18:51:38.094726Z",
    "updated_at": "2025-06-19T18:51:38.549591Z",
    "amount": {
        "captured": 0.00,
        "currency": "USD",
        "currency_conversion": null,
        "refunded": 0.00,
        "value": 1175.00
    },
    "checkout": {
        "session": "",
        "sdk_action_required": false
    },
    "payment_method": {
        "vaulted_token": "",
        "type": "CARD",
        "vault_on_success": false,
        "token": "",
        "parent_payment_method_type": null,
        "payment_method_detail": {
            "card": {
                "verify": false,
                "capture": true,
                "installments": 1,
                "installments_plan_id": null,
                "first_installment_deferral": 0,
                "installments_type": "",
                "installment_amount": null,
                "soft_descriptor": "",
                "authorization_code": "349399",
                "retrieval_reference_number": "",
                "voucher": null,
                "card_data": {
                    "holder_name": "SARAH CONNOR",
                    "iin": "41234567",
                    "lfd": "2345",
                    "number_length": 16,
                    "security_code_length": 3,
                    "brand": "VISA",
                    "issuer_name": "INTL HDQTRSCENTER OWNED",
                    "issuer_code": null,
                    "country_code": "VN",
                    "category": "CLASSIC",
                    "type": "CREDIT",
                    "three_d_secure": {
                        "version": null,
                        "electronic_commerce_indicator": null,
                        "cryptogram": null,
                        "transaction_id": null,
                        "directory_server_transaction_id": null,
                        "pares_status": null,
                        "acs_id": null
                    },
                    "fingerprint": "e5fb7cbd-c42b-4ec2-ab9c-a421f049a3b8",
                    "expiration_month": 12,
                    "expiration_year": 29
                },
                "stored_credentials": {
                    "reason": null,
                    "usage": null,
                    "subscription_agreement_id": null,
                    "network_transaction_id": null
                }
            }
        }
    },
    "customer_payer": {
        "id": null,
        "merchant_customer_id": "1750359097",
        "first_name": "SARAH",
        "last_name": "CONNOR",
        "gender": "F",
        "date_of_birth": "1990-03-20",
        "email": "[email protected]",
        "nationality": "US",
        "ip_address": "192.168.1.100",
        "device_fingerprint": null,
        "device_fingerprints": [],
        "browser_info": {
            "user_agent": "",
            "accept_header": "",
            "accept_content": "True",
            "accept_browser": "True",
            "color_depth": "",
            "screen_height": "",
            "screen_width": "",
            "javascript_enabled": true,
            "java_enabled": null,
            "browser_time_difference": null,
            "language": "",
            "platform": null
        },
        "document": {
            "document_type": "PASSPORT",
            "document_number": "543210987"
        },
        "phone": {
            "number": "5551234567",
            "country_code": "1"
        },
        "billing_address": {
            "address_line_1": "123 Main Street",
            "address_line_2": "Apt 4B",
            "country": "US",
            "state": "NY",
            "city": "NEW YORK",
            "zip_code": "10001",
            "neighborhood": null
        },
        "shipping_address": {
            "address_line_1": "Flat 101, Green Apartments",
            "address_line_2": "MG Road",
            "country": "IN",
            "state": "KA",
            "city": "BENGALURU",
            "zip_code": "560001",
            "neighborhood": null
        },
        "merchant_customer_created_at": null
    },
    "additional_data": {
        "airline": {
            "pnr": "XYZZZY",
            "legs": [
                {
                    "departure_airport": "JFK",
                    "departure_datetime": "2025-08-15 10:00:00",
                    "departure_airport_timezone": "-04:00",
                    "arrival_airport": "DEL",
                    "arrival_airport_timezone": "+00:00",
                    "arrival_datetime": "",
                    "carrier_code": "AI",
                    "flight_number": "AI102",
                    "fare_basis_code": "Q",
                    "fare_class_code": "L",
                    "base_fare": 950.00,
                    "base_fare_currency": "USD",
                    "stopover_code": "N",
                    "departure_airport_country": null,
                    "departure_airport_city": null,
                    "arrival_airport_country": null,
                    "arrival_airport_city": null
                }
            ],
            "passengers": [
                {
                    "first_name": "SARAH",
                    "last_name": "CONNOR",
                    "middle_name": "JANE",
                    "type": "A",
                    "date_of_birth": "1990-03-20",
                    "nationality": "US",
                    "document": {
                        "document_type": "PASSPORT",
                        "document_number": "543210987"
                    },
                    "country": null,
                    "loyalty_number": "AERO2025",
                    "loyalty_tier": "PLATINUM",
                    "email": null,
                    "phone": null
                }
            ],
            "ticket": {
                "ticket_number": "GLTICKET001",
                "e_ticket": true,
                "restricted": false,
                "total_fare_amount": 1000.00,
                "total_tax_amount": 150.00,
                "total_fee_amount": 25.00,
                "issue": {
                    "carrier_prefix_code": "016",
                    "travel_agent_code": "B987654",
                    "travel_agent_name": "GLOBAL TRAVELS",
                    "date": "2024-12-01 10:00:00",
                    "address": "789 Broadway Ave",
                    "city": "NEW YORK",
                    "country": "US",
                    "zip_code": "10003",
                    "booking_system_code": null,
                    "booking_system_name": null
                }
            },
            "tickets": null
        },
        "order": {
            "fee_amount": 5,
            "shipping_amount": 5.76,
            "tip_amount": null,
            "items": [
                {
                    "id": "SKU-98765",
                    "name": "Denim Skirt",
                    "quantity": 1,
                    "unit_amount": 49.99,
                    "category": "Apparel",
                    "brand": "Fashionista",
                    "sku_code": "SKT-DNM-BLK-28",
                    "manufacture_part_number": "FASH-SKIRT-001"
                }
            ],
            "account_funding": null,
            "tickets": null,
            "fulfillment": null,
            "discounts": null,
            "sales_channel": null
        },
        "seller_details": null
    },
    "transactions": {
        "id": "ea7ca4c3-c69d-4390-a1ab-60fa9f82e1a3",
        "type": "PURCHASE",
        "status": "SUCCEEDED",
        "category": "CARD",
        "amount": 1175.00,
        "provider_id": "YUNO_TEST_PAYMENT_GW",
        "payment_method": {
            "vaulted_token": "",
            "type": "CARD",
            "vault_on_success": false,
            "token": "",
            "parent_payment_method_type": null,
            "detail": {
                "card": {
                    "verify": false,
                    "capture": true,
                    "installments": 1,
                    "installments_plan_id": null,
                    "first_installment_deferral": 0,
                    "installments_type": "",
                    "installment_amount": null,
                    "soft_descriptor": "",
                    "authorization_code": "349399",
                    "retrieval_reference_number": "",
                    "voucher": null,
                    "card_data": {
                        "holder_name": "SARAH CONNOR",
                        "iin": "41234567",
                        "lfd": "2345",
                        "number_length": 16,
                        "security_code_length": 3,
                        "brand": "VISA",
                        "issuer_name": "INTL HDQTRSCENTER OWNED",
                        "issuer_code": null,
                        "country_code": "VN",
                        "category": "CLASSIC",
                        "type": "CREDIT",
                        "three_d_secure": {
                            "version": null,
                            "electronic_commerce_indicator": null,
                            "cryptogram": null,
                            "transaction_id": null,
                            "directory_server_transaction_id": null,
                            "pares_status": null,
                            "acs_id": null
                        },
                        "fingerprint": "e5fb7cbd-c42b-4ec2-ab9c-a421f049a3b8",
                        "expiration_month": 12,
                        "expiration_year": 29
                    },
                    "stored_credentials": {
                        "reason": null,
                        "usage": null,
                        "subscription_agreement_id": null,
                        "network_transaction_id": null
                    }
                }
            }
        },
        "response_code": "SUCCEEDED",
        "response_message": "Transaction successful",
        "reason": null,
        "description": "Flight booking to India",
        "merchant_reference": "FlightBooking_REF_98765",
        "provider_data": {
            "id": "YUNO_TEST_PAYMENT_GW",
            "transaction_id": "21e6d532-d41c-4205-b1c5-05cc41a223d9",
            "account_id": "",
            "status": "SUCCEEDED",
            "sub_status": "",
            "status_detail": "",
            "response_message": null,
            "response_code": null,
            "raw_response": {
                "amount": {
                    "currency": "BRL",
                    "value": 2100
                },
                "merchantAccount": "YunoPaymentsECOM",
                "paymentPspReference": "ZKHXKZGXMLBX8N82",
                "pspReference": "VKJTCWZ9575ZGN82",
                "reference": "34343434",
                "status": "received"
            },
            "third_party_transaction_id": "",
            "third_party_account_id": null,
            "iso8583_response_code": null,
            "iso8583_response_message": null
        },
        "connection_data": {
            "id": "a2ee2f97-8ba0-4198-a821-3b750bc97872",
            "name": null
        },
        "created_at": "2025-06-19T18:51:38.452839Z",
        "updated_at": "2025-06-19T18:51:38.504087Z"
    },
    "transactions_history": [
        {
            "id": "ea7ca4c3-c69d-4390-a1ab-60fa9f82e1a3",
            "type": "PURCHASE",
            "status": "SUCCEEDED",
            "category": "CARD",
            "amount": 1175.00,
            "provider_id": "YUNO_TEST_PAYMENT_GW",
            "payment_method": {
                "vaulted_token": "",
                "type": "CARD",
                "vault_on_success": false,
                "token": "",
                "parent_payment_method_type": null,
                "detail": {
                    "card": {
                        "verify": false,
                        "capture": true,
                        "installments": 1,
                        "installments_plan_id": null,
                        "first_installment_deferral": 0,
                        "installments_type": "",
                        "installment_amount": null,
                        "soft_descriptor": "",
                        "authorization_code": "349399",
                        "retrieval_reference_number": "",
                        "voucher": null,
                        "card_data": {
                            "holder_name": "SARAH CONNOR",
                            "iin": "41234567",
                            "lfd": "2345",
                            "number_length": 16,
                            "security_code_length": 3,
                            "brand": "VISA",
                            "issuer_name": "INTL HDQTRSCENTER OWNED",
                            "issuer_code": null,
                            "country_code": "VN",
                            "category": "CLASSIC",
                            "type": "CREDIT",
                            "three_d_secure": {
                                "version": null,
                                "electronic_commerce_indicator": null,
                                "cryptogram": null,
                                "transaction_id": null,
                                "directory_server_transaction_id": null,
                                "pares_status": null,
                                "acs_id": null
                            },
                            "fingerprint": "e5fb7cbd-c42b-4ec2-ab9c-a421f049a3b8",
                            "expiration_month": 12,
                            "expiration_year": 29
                        },
                        "stored_credentials": {
                            "reason": null,
                            "usage": null,
                            "subscription_agreement_id": null,
                            "network_transaction_id": null
                        }
                    }
                }
            },
            "response_code": "SUCCEEDED",
            "response_message": "Transaction successful",
            "reason": null,
            "description": "Flight booking to India",
            "merchant_reference": "FlightBooking_REF_98765",
            "provider_data": {
                "id": "YUNO_TEST_PAYMENT_GW",
                "transaction_id": "21e6d532-d41c-4205-b1c5-05cc41a223d9",
                "account_id": "",
                "status": "SUCCEEDED",
                "sub_status": "",
                "status_detail": "",
                "response_message": null,
                "response_code": null,
                "raw_response": {
                    "amount": {
                        "currency": "BRL",
                        "value": 2100
                    },
                    "merchantAccount": "YunoPaymentsECOM",
                    "paymentPspReference": "ZKHXKZGXMLBX8N82",
                    "pspReference": "VKJTCWZ9575ZGN82",
                    "reference": "34343434",
                    "status": "received"
                },
                "third_party_transaction_id": "",
                "third_party_account_id": null,
                "iso8583_response_code": null,
                "iso8583_response_message": null
            },
            "connection_data": {
                "id": "a2ee2f97-8ba0-4198-a821-3b750bc97872",
                "name": null
            },
            "created_at": "2025-06-19T18:51:38.452839Z",
            "updated_at": "2025-06-19T18:51:38.504087Z"
        }
    ],
    "workflow": "DIRECT",
    "metadata": [],
    "fraud_screening": null,
    "payment_link_id": "",
    "subscription_code": null,
    "routing_rules": {
        "smart_routing": false,
        "monitors": false,
        "condition": {
            "id": 192539,
            "name": "Card",
            "description": ""
        }
    },
    "simplified_mode": false
}

Card Direct with installments

Example of a request for payment with installments using Card Direct. Below are examples of a request and the received response for successful payment creation. The request is presented using the cURL format, and the response is a JSON object.

curl --request POST \
     --url https://api-sandbox.y.uno/v1/payments \
     --header 'X-Idempotency-Key: <your-X-idempotency-key>' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'private-secret-key: <your-private-secret-key>' \
     --header 'public-api-key: <your-public-api-key>' \
     --data '
{
  "account_id": "<account_id>",
  "description": "Card payment with installments",
  "merchant_order_id": "0000022",
  "merchant_reference": "ref-0001",
  "country": "US",
  "amount": {
    "currency": "USD",
    "value": 250.75
  },
  "customer_payer": {
    "first_name": "JOHN",
    "last_name": "DOE",
    "email": "[email protected]"
  },
  "payment_method": {
    "detail": {
      "card": {
        "card_data": {
          "number": "4111111111111111",
          "expiration_month": 11,
          "expiration_year": 28,
          "security_code": "123",
          "holder_name": "JOHN DOE"
        },
        "installments": 6
      }
    },
    "type": "CARD"
  },
  "workflow": "DIRECT"
}
'
{
    "id": "bb3a6aec-1704-4c61-a035-320f75f500e7",
    "account_id": "5beead35-0cd5-4e1c-9a13-b8f48f7f8f3a",
    "description": "Card payment with installments",
    "country": "US",
    "status": "SUCCEEDED",
    "sub_status": "APPROVED",
    "merchant_order_id": "0000022",
    "created_at": "2025-06-19T19:02:37.809761Z",
    "updated_at": "2025-06-19T19:02:38.151822Z",
    "amount": {
        "captured": 0.00,
        "currency": "USD",
        "currency_conversion": null,
        "refunded": 0.00,
        "value": 250.75
    },
    "checkout": {
        "session": "",
        "sdk_action_required": false
    },
    "payment_method": {
        "vaulted_token": "",
        "type": "CARD",
        "vault_on_success": false,
        "token": "",
        "parent_payment_method_type": null,
        "payment_method_detail": {
            "card": {
                "verify": false,
                "capture": true,
                "installments": 6,
                "installments_plan_id": null,
                "first_installment_deferral": 0,
                "installments_type": "",
                "installment_amount": null,
                "soft_descriptor": "",
                "authorization_code": "330936",
                "retrieval_reference_number": "",
                "voucher": null,
                "card_data": {
                    "holder_name": "JOHN DOE",
                    "iin": "41111111",
                    "lfd": "1111",
                    "number_length": 16,
                    "security_code_length": 3,
                    "brand": "VISA",
                    "issuer_name": "CONOTOXIA SP Z O O",
                    "issuer_code": null,
                    "country_code": "PL",
                    "category": "CLASSIC",
                    "type": "DEBIT",
                    "three_d_secure": {
                        "version": null,
                        "electronic_commerce_indicator": null,
                        "cryptogram": null,
                        "transaction_id": null,
                        "directory_server_transaction_id": null,
                        "pares_status": null,
                        "acs_id": null
                    },
                    "fingerprint": "a2ede54f-4b2a-4673-ae2c-c0704338ec7d",
                    "expiration_month": 11,
                    "expiration_year": 28
                },
                "stored_credentials": {
                    "reason": null,
                    "usage": null,
                    "subscription_agreement_id": null,
                    "network_transaction_id": null
                }
            }
        }
    },
    "customer_payer": {
        "id": null,
        "merchant_customer_id": null,
        "first_name": "JOHN",
        "last_name": "DOE",
        "gender": null,
        "date_of_birth": null,
        "email": "[email protected]",
        "nationality": null,
        "ip_address": null,
        "device_fingerprint": null,
        "device_fingerprints": [],
        "browser_info": {
            "user_agent": "",
            "accept_header": "",
            "accept_content": null,
            "accept_browser": null,
            "color_depth": "",
            "screen_height": "",
            "screen_width": "",
            "javascript_enabled": null,
            "java_enabled": null,
            "browser_time_difference": null,
            "language": "",
            "platform": null
        },
        "document": null,
        "phone": null,
        "billing_address": null,
        "shipping_address": null,
        "merchant_customer_created_at": null
    },
    "additional_data": null,
    "transactions": {
        "id": "db2f176e-c15f-46ca-9a5b-103bea203509",
        "type": "PURCHASE",
        "status": "SUCCEEDED",
        "category": "CARD",
        "amount": 250.75,
        "provider_id": "YUNO_TEST_PAYMENT_GW",
        "payment_method": {
            "vaulted_token": "",
            "type": "CARD",
            "vault_on_success": false,
            "token": "",
            "parent_payment_method_type": null,
            "detail": {
                "card": {
                    "verify": false,
                    "capture": true,
                    "installments": 6,
                    "installments_plan_id": null,
                    "first_installment_deferral": 0,
                    "installments_type": "",
                    "installment_amount": null,
                    "soft_descriptor": "",
                    "authorization_code": "330936",
                    "retrieval_reference_number": "",
                    "voucher": null,
                    "card_data": {
                        "holder_name": "JOHN DOE",
                        "iin": "41111111",
                        "lfd": "1111",
                        "number_length": 16,
                        "security_code_length": 3,
                        "brand": "VISA",
                        "issuer_name": "CONOTOXIA SP Z O O",
                        "issuer_code": null,
                        "country_code": "PL",
                        "category": "CLASSIC",
                        "type": "DEBIT",
                        "three_d_secure": {
                            "version": null,
                            "electronic_commerce_indicator": null,
                            "cryptogram": null,
                            "transaction_id": null,
                            "directory_server_transaction_id": null,
                            "pares_status": null,
                            "acs_id": null
                        },
                        "fingerprint": "a2ede54f-4b2a-4673-ae2c-c0704338ec7d",
                        "expiration_month": 11,
                        "expiration_year": 28
                    },
                    "stored_credentials": {
                        "reason": null,
                        "usage": null,
                        "subscription_agreement_id": null,
                        "network_transaction_id": null
                    }
                }
            }
        },
        "response_code": "SUCCEEDED",
        "response_message": "Transaction successful",
        "reason": null,
        "description": "Card payment with installments",
        "merchant_reference": "ref-0001",
        "provider_data": {
            "id": "YUNO_TEST_PAYMENT_GW",
            "transaction_id": "c2696806-3e68-4cd4-99f1-e2ceb2b23aae",
            "account_id": "",
            "status": "SUCCEEDED",
            "sub_status": "",
            "status_detail": "",
            "response_message": null,
            "response_code": null,
            "raw_response": {
                "amount": {
                    "currency": "BRL",
                    "value": 2100
                },
                "merchantAccount": "YunoPaymentsECOM",
                "paymentPspReference": "ZKHXKZGXMLBX8N82",
                "pspReference": "VKJTCWZ9575ZGN82",
                "reference": "34343434",
                "status": "received"
            },
            "third_party_transaction_id": "",
            "third_party_account_id": null,
            "iso8583_response_code": null,
            "iso8583_response_message": null
        },
        "connection_data": {
            "id": "a2ee2f97-8ba0-4198-a821-3b750bc97872",
            "name": null
        },
        "created_at": "2025-06-19T19:02:38.058354Z",
        "updated_at": "2025-06-19T19:02:38.110167Z"
    },
    "transactions_history": [
        {
            "id": "db2f176e-c15f-46ca-9a5b-103bea203509",
            "type": "PURCHASE",
            "status": "SUCCEEDED",
            "category": "CARD",
            "amount": 250.75,
            "provider_id": "YUNO_TEST_PAYMENT_GW",
            "payment_method": {
                "vaulted_token": "",
                "type": "CARD",
                "vault_on_success": false,
                "token": "",
                "parent_payment_method_type": null,
                "detail": {
                    "card": {
                        "verify": false,
                        "capture": true,
                        "installments": 6,
                        "installments_plan_id": null,
                        "first_installment_deferral": 0,
                        "installments_type": "",
                        "installment_amount": null,
                        "soft_descriptor": "",
                        "authorization_code": "330936",
                        "retrieval_reference_number": "",
                        "voucher": null,
                        "card_data": {
                            "holder_name": "JOHN DOE",
                            "iin": "41111111",
                            "lfd": "1111",
                            "number_length": 16,
                            "security_code_length": 3,
                            "brand": "VISA",
                            "issuer_name": "CONOTOXIA SP Z O O",
                            "issuer_code": null,
                            "country_code": "PL",
                            "category": "CLASSIC",
                            "type": "DEBIT",
                            "three_d_secure": {
                                "version": null,
                                "electronic_commerce_indicator": null,
                                "cryptogram": null,
                                "transaction_id": null,
                                "directory_server_transaction_id": null,
                                "pares_status": null,
                                "acs_id": null
                            },
                            "fingerprint": "a2ede54f-4b2a-4673-ae2c-c0704338ec7d",
                            "expiration_month": 11,
                            "expiration_year": 28
                        },
                        "stored_credentials": {
                            "reason": null,
                            "usage": null,
                            "subscription_agreement_id": null,
                            "network_transaction_id": null
                        }
                    }
                }
            },
            "response_code": "SUCCEEDED",
            "response_message": "Transaction successful",
            "reason": null,
            "description": "Card payment with installments",
            "merchant_reference": "ref-0001",
            "provider_data": {
                "id": "YUNO_TEST_PAYMENT_GW",
                "transaction_id": "c2696806-3e68-4cd4-99f1-e2ceb2b23aae",
                "account_id": "",
                "status": "SUCCEEDED",
                "sub_status": "",
                "status_detail": "",
                "response_message": null,
                "response_code": null,
                "raw_response": {
                    "amount": {
                        "currency": "BRL",
                        "value": 2100
                    },
                    "merchantAccount": "YunoPaymentsECOM",
                    "paymentPspReference": "ZKHXKZGXMLBX8N82",
                    "pspReference": "VKJTCWZ9575ZGN82",
                    "reference": "34343434",
                    "status": "received"
                },
                "third_party_transaction_id": "",
                "third_party_account_id": null,
                "iso8583_response_code": null,
                "iso8583_response_message": null
            },
            "connection_data": {
                "id": "a2ee2f97-8ba0-4198-a821-3b750bc97872",
                "name": null
            },
            "created_at": "2025-06-19T19:02:38.058354Z",
            "updated_at": "2025-06-19T19:02:38.110167Z"
        }
    ],
    "workflow": "DIRECT",
    "metadata": [],
    "fraud_screening": null,
    "payment_link_id": "",
    "subscription_code": null,
    "routing_rules": {
        "smart_routing": false,
        "monitors": false,
        "condition": {
            "id": 192539,
            "name": "Card",
            "description": ""
        }
    },
    "simplified_mode": false
}

Card Direct with customer, billing, shipping and order items

Example of a request for payment using Card Direct. Below are examples of a request and the received response for successful payment creation. The request is presented using the cURL format, and the response is a JSON object.

curl --request POST \
     --url https://api-sandbox.y.uno/v1/payments \
     --header 'X-Idempotency-Key: <your-X-idempotency-key>' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'private-secret-key: <your-private-secret-key>' \
     --header 'public-api-key: <your-public-api-key>' \
     --data '
{
    "description": "Card payment with shipping and order",
    "account_id": "<account_code>",
    "merchant_order_id": "00000023",
    "country": "US",
    "merchant_reference" : "reference-0001",
    "amount": {
        "currency": "USD",
        "value": 49.99
    },
    "additional_data": {
        "order": {
            "fee_amount": 0,
            "items": [
                {
                    "brand": "XYZ",
                    "category": "Clothes",
                    "id": "123AD",
                    "manufacture_part_number": "XYZ123456",
                    "name": "Skirt",
                    "quantity": 1,
                    "sku_code": "8765432109",
                    "unit_amount": 49.99
                }
            ],
            "shipping_amount": 0
        }
    },
    "customer_payer": {
        "merchant_customer_id": "{{$timestamp}}",
        "first_name": "JANE",
        "last_name": "SMITH",
        "gender": "F",
        "date_of_birth": "1985-07-22",
        "email": "[email protected]",
        "nationality": "US",
        "ip_address": "73.19.200.15",
        "device_fingerprint": "xyzabc123def456ghi789",
        "document": {
            "document_type": "DRIVERS_LICENSE",
            "document_number": "D987654321"
        },
        "phone": {
            "number": "2125550100",
            "country_code": "1"
        },
        "billing_address": {
            "address_line_1": "123 Maple Drive",
            "address_line_2": "Apt 10A",
            "country": "US",
            "state": "CA",
            "city": "Los Angeles",
            "zip_code": "90001"
        },
        "shipping_address": {
            "address_line_1": "123 Maple Drive",
            "address_line_2": "Apt 10A",
            "country": "US",
            "state": "CA",
            "city": "Los Angeles",
            "zip_code": "90001"
        }
    },
    "workflow": "DIRECT",
    "payment_method": {
        "type": "CARD",
        "detail": {
            "card": {
                "card_data": {
                    "number": "4051885600446623",
                    "holder_name": "JOHN DOE",
                    "expiration_month": 10,
                    "expiration_year": 26,
                    "security_code": "456"
                }
            }
        }
    }
}
'
{
    "id": "7896f300-96bd-4ccc-b15d-6a6541ef4658",
    "account_id": "5beead35-0cd5-4e1c-9a13-b8f48f7f8f3a",
    "description": "Card payment with shipping and order",
    "country": "US",
    "status": "SUCCEEDED",
    "sub_status": "APPROVED",
    "merchant_order_id": "00000023",
    "created_at": "2025-06-19T19:23:52.577766Z",
    "updated_at": "2025-06-19T19:23:52.995825Z",
    "amount": {
        "captured": 0.00,
        "currency": "USD",
        "currency_conversion": null,
        "refunded": 0.00,
        "value": 49.99
    },
    "checkout": {
        "session": "",
        "sdk_action_required": false
    },
    "payment_method": {
        "vaulted_token": "",
        "type": "CARD",
        "vault_on_success": false,
        "token": "",
        "parent_payment_method_type": null,
        "payment_method_detail": {
            "card": {
                "verify": false,
                "capture": true,
                "installments": 1,
                "installments_plan_id": null,
                "first_installment_deferral": 0,
                "installments_type": "",
                "installment_amount": null,
                "soft_descriptor": "",
                "authorization_code": "226813",
                "retrieval_reference_number": "",
                "voucher": null,
                "card_data": {
                    "holder_name": "JOHN DOE",
                    "iin": "40518856",
                    "lfd": "6623",
                    "number_length": 16,
                    "security_code_length": 3,
                    "brand": "VISA",
                    "issuer_name": "INTL HDQTRSCENTER OWNED",
                    "issuer_code": null,
                    "country_code": "US",
                    "category": "TRADITIONAL",
                    "type": "CREDIT",
                    "three_d_secure": {
                        "version": null,
                        "electronic_commerce_indicator": null,
                        "cryptogram": null,
                        "transaction_id": null,
                        "directory_server_transaction_id": null,
                        "pares_status": null,
                        "acs_id": null
                    },
                    "fingerprint": "a3193974-8154-45b7-9e1c-8d942b96188c",
                    "expiration_month": 10,
                    "expiration_year": 26
                },
                "stored_credentials": {
                    "reason": null,
                    "usage": null,
                    "subscription_agreement_id": null,
                    "network_transaction_id": null
                }
            }
        }
    },
    "customer_payer": {
        "id": null,
        "merchant_customer_id": "1750361032",
        "first_name": "JANE",
        "last_name": "SMITH",
        "gender": "F",
        "date_of_birth": "1985-07-22",
        "email": "[email protected]",
        "nationality": "US",
        "ip_address": "73.19.200.15",
        "device_fingerprint": "xyzabc123def456ghi789",
        "device_fingerprints": [],
        "browser_info": {
            "user_agent": "",
            "accept_header": "",
            "accept_content": null,
            "accept_browser": null,
            "color_depth": "",
            "screen_height": "",
            "screen_width": "",
            "javascript_enabled": null,
            "java_enabled": null,
            "browser_time_difference": null,
            "language": "",
            "platform": null
        },
        "document": {
            "document_type": "DRIVERS_LICENSE",
            "document_number": "D987654321"
        },
        "phone": {
            "number": "2125550100",
            "country_code": "1"
        },
        "billing_address": {
            "address_line_1": "123 Maple Drive",
            "address_line_2": "Apt 10A",
            "country": "US",
            "state": "CA",
            "city": "Los Angeles",
            "zip_code": "90001",
            "neighborhood": null
        },
        "shipping_address": {
            "address_line_1": "123 Maple Drive",
            "address_line_2": "Apt 10A",
            "country": "US",
            "state": "CA",
            "city": "Los Angeles",
            "zip_code": "90001",
            "neighborhood": null
        },
        "merchant_customer_created_at": null
    },
    "additional_data": {
        "airline": null,
        "order": {
            "fee_amount": 0,
            "shipping_amount": 0,
            "tip_amount": null,
            "items": [
                {
                    "id": "123AD",
                    "name": "Skirt",
                    "quantity": 1,
                    "unit_amount": 49.99,
                    "category": "Clothes",
                    "brand": "XYZ",
                    "sku_code": "8765432109",
                    "manufacture_part_number": "XYZ123456"
                }
            ],
            "account_funding": null,
            "tickets": null,
            "fulfillment": null,
            "discounts": null,
            "sales_channel": null
        },
        "seller_details": null
    },
    "transactions": {
        "id": "d073ccdf-6f2c-46ce-b014-647746be2f50",
        "type": "PURCHASE",
        "status": "SUCCEEDED",
        "category": "CARD",
        "amount": 49.99,
        "provider_id": "YUNO_TEST_PAYMENT_GW",
        "payment_method": {
            "vaulted_token": "",
            "type": "CARD",
            "vault_on_success": false,
            "token": "",
            "parent_payment_method_type": null,
            "detail": {
                "card": {
                    "verify": false,
                    "capture": true,
                    "installments": 1,
                    "installments_plan_id": null,
                    "first_installment_deferral": 0,
                    "installments_type": "",
                    "installment_amount": null,
                    "soft_descriptor": "",
                    "authorization_code": "226813",
                    "retrieval_reference_number": "",
                    "voucher": null,
                    "card_data": {
                        "holder_name": "JOHN DOE",
                        "iin": "40518856",
                        "lfd": "6623",
                        "number_length": 16,
                        "security_code_length": 3,
                        "brand": "VISA",
                        "issuer_name": "INTL HDQTRSCENTER OWNED",
                        "issuer_code": null,
                        "country_code": "US",
                        "category": "TRADITIONAL",
                        "type": "CREDIT",
                        "three_d_secure": {
                            "version": null,
                            "electronic_commerce_indicator": null,
                            "cryptogram": null,
                            "transaction_id": null,
                            "directory_server_transaction_id": null,
                            "pares_status": null,
                            "acs_id": null
                        },
                        "fingerprint": "a3193974-8154-45b7-9e1c-8d942b96188c",
                        "expiration_month": 10,
                        "expiration_year": 26
                    },
                    "stored_credentials": {
                        "reason": null,
                        "usage": null,
                        "subscription_agreement_id": null,
                        "network_transaction_id": null
                    }
                }
            }
        },
        "response_code": "SUCCEEDED",
        "response_message": "Transaction successful",
        "reason": null,
        "description": "Card payment with shipping and order",
        "merchant_reference": "reference-0001",
        "provider_data": {
            "id": "YUNO_TEST_PAYMENT_GW",
            "transaction_id": "9d61ba94-f722-4f51-85fe-c28065d1e1f4",
            "account_id": "",
            "status": "SUCCEEDED",
            "sub_status": "",
            "status_detail": "",
            "response_message": null,
            "response_code": null,
            "raw_response": {
                "amount": {
                    "currency": "BRL",
                    "value": 2100
                },
                "merchantAccount": "YunoPaymentsECOM",
                "paymentPspReference": "ZKHXKZGXMLBX8N82",
                "pspReference": "VKJTCWZ9575ZGN82",
                "reference": "34343434",
                "status": "received"
            },
            "third_party_transaction_id": "",
            "third_party_account_id": null,
            "iso8583_response_code": null,
            "iso8583_response_message": null
        },
        "connection_data": {
            "id": "a2ee2f97-8ba0-4198-a821-3b750bc97872",
            "name": null
        },
        "created_at": "2025-06-19T19:23:52.803162Z",
        "updated_at": "2025-06-19T19:23:52.913047Z"
    },
    "transactions_history": [
        {
            "id": "d073ccdf-6f2c-46ce-b014-647746be2f50",
            "type": "PURCHASE",
            "status": "SUCCEEDED",
            "category": "CARD",
            "amount": 49.99,
            "provider_id": "YUNO_TEST_PAYMENT_GW",
            "payment_method": {
                "vaulted_token": "",
                "type": "CARD",
                "vault_on_success": false,
                "token": "",
                "parent_payment_method_type": null,
                "detail": {
                    "card": {
                        "verify": false,
                        "capture": true,
                        "installments": 1,
                        "installments_plan_id": null,
                        "first_installment_deferral": 0,
                        "installments_type": "",
                        "installment_amount": null,
                        "soft_descriptor": "",
                        "authorization_code": "226813",
                        "retrieval_reference_number": "",
                        "voucher": null,
                        "card_data": {
                            "holder_name": "JOHN DOE",
                            "iin": "40518856",
                            "lfd": "6623",
                            "number_length": 16,
                            "security_code_length": 3,
                            "brand": "VISA",
                            "issuer_name": "INTL HDQTRSCENTER OWNED",
                            "issuer_code": null,
                            "country_code": "US",
                            "category": "TRADITIONAL",
                            "type": "CREDIT",
                            "three_d_secure": {
                                "version": null,
                                "electronic_commerce_indicator": null,
                                "cryptogram": null,
                                "transaction_id": null,
                                "directory_server_transaction_id": null,
                                "pares_status": null,
                                "acs_id": null
                            },
                            "fingerprint": "a3193974-8154-45b7-9e1c-8d942b96188c",
                            "expiration_month": 10,
                            "expiration_year": 26
                        },
                        "stored_credentials": {
                            "reason": null,
                            "usage": null,
                            "subscription_agreement_id": null,
                            "network_transaction_id": null
                        }
                    }
                }
            },
            "response_code": "SUCCEEDED",
            "response_message": "Transaction successful",
            "reason": null,
            "description": "Card payment with shipping and order",
            "merchant_reference": "reference-0001",
            "provider_data": {
                "id": "YUNO_TEST_PAYMENT_GW",
                "transaction_id": "9d61ba94-f722-4f51-85fe-c28065d1e1f4",
                "account_id": "",
                "status": "SUCCEEDED",
                "sub_status": "",
                "status_detail": "",
                "response_message": null,
                "response_code": null,
                "raw_response": {
                    "amount": {
                        "currency": "BRL",
                        "value": 2100
                    },
                    "merchantAccount": "YunoPaymentsECOM",
                    "paymentPspReference": "ZKHXKZGXMLBX8N82",
                    "pspReference": "VKJTCWZ9575ZGN82",
                    "reference": "34343434",
                    "status": "received"
                },
                "third_party_transaction_id": "",
                "third_party_account_id": null,
                "iso8583_response_code": null,
                "iso8583_response_message": null
            },
            "connection_data": {
                "id": "a2ee2f97-8ba0-4198-a821-3b750bc97872",
                "name": null
            },
            "created_at": "2025-06-19T19:23:52.803162Z",
            "updated_at": "2025-06-19T19:23:52.913047Z"
        }
    ],
    "workflow": "DIRECT",
    "metadata": [],
    "fraud_screening": null,
    "payment_link_id": "",
    "subscription_code": null,
    "routing_rules": {
        "smart_routing": false,
        "monitors": false,
        "condition": {
            "id": 192539,
            "name": "Card",
            "description": ""
        }
    },
    "simplified_mode": false
}

Card Direct with vault on success

Example of a successful request for payment using Card Direct. Below are examples of a request and the received response for successful payment creation. The request is presented using the cURL format, and the response is a JSON object.

curl --request POST \
     --url https://api-sandbox.y.uno/v1/payments \
     --header 'X-Idempotency-Key: <your-X-idempotency-key>' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'private-secret-key: <your-private-secret-key>' \
     --header 'public-api-key: <your-public-api-key>' \
     --data '
{
    "description": "Card payment with vault on success",
    "account_id": "<account_id>",
    "merchant_order_id": "0000023",
    "country": "US",
    "merchant_reference": "reference-{{$randomUUID}}",
    "amount": {
      "currency": "USD",
      "value": 75.50
    },
    "customer_payer": {
        "id":"<customer_id>",
        "merchant_customer_id": "20250616142356",
        "first_name": "JANE",
        "last_name": "SMITH",
        "email": "[email protected]"
    },
    "workflow": "DIRECT",
    "payment_method": {
        "type": "CARD",
        "vault_on_success":true,
        "detail": {
            "card": {
                "card_data": {
                    "number": "4051885600446623",
                    "holder_name": "JOHN DOE",
                    "expiration_month": 10,
                    "expiration_year": 26,
                    "security_code": "456"
                }
            }
        }
    }
}
'
{
    "id": "220af2b0-22ea-4ee9-b1ec-32a93980aa5c",
    "account_id": "5beead35-0cd5-4e1c-9a13-b8f48f7f8f3a",
    "description": "Card payment with vault on success",
    "country": "US",
    "status": "SUCCEEDED",
    "sub_status": "APPROVED",
    "merchant_order_id": "0000023",
    "created_at": "2025-06-19T19:27:16.407972Z",
    "updated_at": "2025-06-19T19:27:16.772684Z",
    "amount": {
        "captured": 0.00,
        "currency": "USD",
        "currency_conversion": null,
        "refunded": 0.00,
        "value": 75.50
    },
    "checkout": {
        "session": "",
        "sdk_action_required": false
    },
    "payment_method": {
        "vaulted_token": "eedc0442-86e9-4e52-9439-7360e4dc6859",
        "type": "CARD",
        "vault_on_success": true,
        "token": "",
        "parent_payment_method_type": null,
        "payment_method_detail": {
            "card": {
                "verify": false,
                "capture": true,
                "installments": 1,
                "installments_plan_id": null,
                "first_installment_deferral": 0,
                "installments_type": "",
                "installment_amount": null,
                "soft_descriptor": "",
                "authorization_code": "206417",
                "retrieval_reference_number": "",
                "voucher": null,
                "card_data": {
                    "holder_name": "JOHN DOE",
                    "iin": "40518856",
                    "lfd": "6623",
                    "number_length": 16,
                    "security_code_length": 3,
                    "brand": "VISA",
                    "issuer_name": "INTL HDQTRSCENTER OWNED",
                    "issuer_code": null,
                    "country_code": "US",
                    "category": "TRADITIONAL",
                    "type": "CREDIT",
                    "three_d_secure": {
                        "version": null,
                        "electronic_commerce_indicator": null,
                        "cryptogram": null,
                        "transaction_id": null,
                        "directory_server_transaction_id": null,
                        "pares_status": null,
                        "acs_id": null
                    },
                    "fingerprint": "a3193974-8154-45b7-9e1c-8d942b96188c",
                    "expiration_month": 10,
                    "expiration_year": 26
                },
                "stored_credentials": {
                    "reason": null,
                    "usage": null,
                    "subscription_agreement_id": null,
                    "network_transaction_id": null
                }
            }
        }
    },
    "customer_payer": {
        "id": "33a9e979-6558-4694-b00c-3d0844524681",
        "merchant_customer_id": "20250616142356",
        "first_name": "JANE",
        "last_name": "SMITH",
        "gender": "F",
        "date_of_birth": "1990-02-28",
        "email": "[email protected]",
        "nationality": "CO",
        "ip_address": null,
        "device_fingerprint": null,
        "device_fingerprints": [],
        "browser_info": {
            "user_agent": "",
            "accept_header": "",
            "accept_content": null,
            "accept_browser": null,
            "color_depth": "",
            "screen_height": "",
            "screen_width": "",
            "javascript_enabled": null,
            "java_enabled": null,
            "browser_time_difference": null,
            "language": "",
            "platform": null
        },
        "document": {
            "document_type": "CC",
            "document_number": "1010268952"
        },
        "phone": {
            "number": "3132450765",
            "country_code": "57"
        },
        "billing_address": {
            "address_line_1": "Calle 34 # 56 - 78",
            "address_line_2": "Apartamento 502, Torre I",
            "country": "CO",
            "state": "Cundinamarca",
            "city": "Bogotá",
            "zip_code": "111111",
            "neighborhood": null
        },
        "shipping_address": {
            "address_line_1": "Calle 34 # 56 - 78",
            "address_line_2": "Apartamento 502, Torre I",
            "country": "CO",
            "state": "Cundinamarca",
            "city": "Bogotá",
            "zip_code": "111111",
            "neighborhood": null
        },
        "merchant_customer_created_at": null
    },
    "additional_data": null,
    "transactions": {
        "id": "62fadf60-fe84-43c4-8554-1c590ecee86b",
        "type": "PURCHASE",
        "status": "SUCCEEDED",
        "category": "CARD",
        "amount": 75.5,
        "provider_id": "YUNO_TEST_PAYMENT_GW",
        "payment_method": {
            "vaulted_token": "eedc0442-86e9-4e52-9439-7360e4dc6859",
            "type": "CARD",
            "vault_on_success": true,
            "token": "",
            "parent_payment_method_type": null,
            "detail": {
                "card": {
                    "verify": false,
                    "capture": true,
                    "installments": 1,
                    "installments_plan_id": null,
                    "first_installment_deferral": 0,
                    "installments_type": "",
                    "installment_amount": null,
                    "soft_descriptor": "",
                    "authorization_code": "206417",
                    "retrieval_reference_number": "",
                    "voucher": null,
                    "card_data": {
                        "holder_name": "JOHN DOE",
                        "iin": "40518856",
                        "lfd": "6623",
                        "number_length": 16,
                        "security_code_length": 3,
                        "brand": "VISA",
                        "issuer_name": "INTL HDQTRSCENTER OWNED",
                        "issuer_code": null,
                        "country_code": "US",
                        "category": "TRADITIONAL",
                        "type": "CREDIT",
                        "three_d_secure": {
                            "version": null,
                            "electronic_commerce_indicator": null,
                            "cryptogram": null,
                            "transaction_id": null,
                            "directory_server_transaction_id": null,
                            "pares_status": null,
                            "acs_id": null
                        },
                        "fingerprint": "a3193974-8154-45b7-9e1c-8d942b96188c",
                        "expiration_month": 10,
                        "expiration_year": 26
                    },
                    "stored_credentials": {
                        "reason": null,
                        "usage": null,
                        "subscription_agreement_id": null,
                        "network_transaction_id": null
                    }
                }
            }
        },
        "response_code": "SUCCEEDED",
        "response_message": "Transaction successful",
        "reason": null,
        "description": "Card payment with vault on success",
        "merchant_reference": "reference-c3138171-fc19-4e8e-b60e-1c8ea80dd0ce",
        "provider_data": {
            "id": "YUNO_TEST_PAYMENT_GW",
            "transaction_id": "6ddcb236-ca90-41a2-ae66-3f09f6e9bfc9",
            "account_id": "",
            "status": "SUCCEEDED",
            "sub_status": "",
            "status_detail": "",
            "response_message": null,
            "response_code": null,
            "raw_response": {
                "amount": {
                    "currency": "BRL",
                    "value": 2100
                },
                "merchantAccount": "YunoPaymentsECOM",
                "paymentPspReference": "ZKHXKZGXMLBX8N82",
                "pspReference": "VKJTCWZ9575ZGN82",
                "reference": "34343434",
                "status": "received"
            },
            "third_party_transaction_id": "",
            "third_party_account_id": null,
            "iso8583_response_code": null,
            "iso8583_response_message": null
        },
        "connection_data": {
            "id": "a2ee2f97-8ba0-4198-a821-3b750bc97872",
            "name": null
        },
        "created_at": "2025-06-19T19:27:16.582119Z",
        "updated_at": "2025-06-19T19:27:16.638038Z"
    },
    "transactions_history": [
        {
            "id": "62fadf60-fe84-43c4-8554-1c590ecee86b",
            "type": "PURCHASE",
            "status": "SUCCEEDED",
            "category": "CARD",
            "amount": 75.5,
            "provider_id": "YUNO_TEST_PAYMENT_GW",
            "payment_method": {
                "vaulted_token": "eedc0442-86e9-4e52-9439-7360e4dc6859",
                "type": "CARD",
                "vault_on_success": true,
                "token": "",
                "parent_payment_method_type": null,
                "detail": {
                    "card": {
                        "verify": false,
                        "capture": true,
                        "installments": 1,
                        "installments_plan_id": null,
                        "first_installment_deferral": 0,
                        "installments_type": "",
                        "installment_amount": null,
                        "soft_descriptor": "",
                        "authorization_code": "206417",
                        "retrieval_reference_number": "",
                        "voucher": null,
                        "card_data": {
                            "holder_name": "JOHN DOE",
                            "iin": "40518856",
                            "lfd": "6623",
                            "number_length": 16,
                            "security_code_length": 3,
                            "brand": "VISA",
                            "issuer_name": "INTL HDQTRSCENTER OWNED",
                            "issuer_code": null,
                            "country_code": "US",
                            "category": "TRADITIONAL",
                            "type": "CREDIT",
                            "three_d_secure": {
                                "version": null,
                                "electronic_commerce_indicator": null,
                                "cryptogram": null,
                                "transaction_id": null,
                                "directory_server_transaction_id": null,
                                "pares_status": null,
                                "acs_id": null
                            },
                            "fingerprint": "a3193974-8154-45b7-9e1c-8d942b96188c",
                            "expiration_month": 10,
                            "expiration_year": 26
                        },
                        "stored_credentials": {
                            "reason": null,
                            "usage": null,
                            "subscription_agreement_id": null,
                            "network_transaction_id": null
                        }
                    }
                }
            },
            "response_code": "SUCCEEDED",
            "response_message": "Transaction successful",
            "reason": null,
            "description": "Card payment with vault on success",
            "merchant_reference": "reference-c3138171-fc19-4e8e-b60e-1c8ea80dd0ce",
            "provider_data": {
                "id": "YUNO_TEST_PAYMENT_GW",
                "transaction_id": "6ddcb236-ca90-41a2-ae66-3f09f6e9bfc9",
                "account_id": "",
                "status": "SUCCEEDED",
                "sub_status": "",
                "status_detail": "",
                "response_message": null,
                "response_code": null,
                "raw_response": {
                    "amount": {
                        "currency": "BRL",
                        "value": 2100
                    },
                    "merchantAccount": "YunoPaymentsECOM",
                    "paymentPspReference": "ZKHXKZGXMLBX8N82",
                    "pspReference": "VKJTCWZ9575ZGN82",
                    "reference": "34343434",
                    "status": "received"
                },
                "third_party_transaction_id": "",
                "third_party_account_id": null,
                "iso8583_response_code": null,
                "iso8583_response_message": null
            },
            "connection_data": {
                "id": "a2ee2f97-8ba0-4198-a821-3b750bc97872",
                "name": null
            },
            "created_at": "2025-06-19T19:27:16.582119Z",
            "updated_at": "2025-06-19T19:27:16.638038Z"
        }
    ],
    "workflow": "DIRECT",
    "metadata": [],
    "fraud_screening": null,
    "payment_link_id": "",
    "subscription_code": null,
    "routing_rules": {
        "smart_routing": false,
        "monitors": false,
        "condition": {
            "id": 192539,
            "name": "Card",
            "description": ""
        }
    },
    "simplified_mode": false
}

Card Direct with vaulted token

Example of a request for payment using Card Direct with a vaulted token. Below are examples of a request and the received response for successful payment creation. The request is presented using the cURL format, and the response is a JSON object.

curl --request POST \
     --url https://api-sandbox.y.uno/v1/payments \
     --header 'X-Idempotency-Key: <your-X-idempotency-key>' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'private-secret-key: <your-private-secret-key>' \
     --header 'public-api-key: <your-public-api-key>' \
     --data '
{
    "description": "Card payment with vaulted token",
    "account_id": "<account_id>",
    "merchant_order_id": "0000022",
    "country": "US",
    "merchant_reference": "reference-0001",
    "amount": {
      "currency": "USD",
      "value": 125.00
    },
    "customer_payer": {
      "id": "<customer_id>",
      "merchant_customer_id": "1234567",
      "first_name": "JOHN",
      "last_name": "DOE",
      "email": "[email protected]"
    },
    "workflow": "DIRECT",
    "payment_method": {
        "type":"CARD",
        "vaulted_token": "<your_vaulted_token>"
    }
}
'
{
    "id": "d1ba99e3-cfe4-44d0-8ff2-7393f5ca4dcc",
    "account_id": "5beead35-0cd5-4e1c-9a13-b8f48f7f8f3a",
    "description": "Card payment with vaulted token",
    "country": "US",
    "status": "SUCCEEDED",
    "sub_status": "APPROVED",
    "merchant_order_id": "0000022",
    "created_at": "2025-06-19T19:30:26.190706Z",
    "updated_at": "2025-06-19T19:30:26.543078Z",
    "amount": {
        "captured": 0.00,
        "currency": "USD",
        "currency_conversion": null,
        "refunded": 0.00,
        "value": 125.00
    },
    "checkout": {
        "session": "",
        "sdk_action_required": false
    },
    "payment_method": {
        "vaulted_token": "b813ce30-c261-4341-8d33-b85698491d18",
        "type": "CARD",
        "vault_on_success": false,
        "token": "",
        "parent_payment_method_type": null,
        "payment_method_detail": {
            "card": {
                "verify": false,
                "capture": true,
                "installments": 1,
                "installments_plan_id": null,
                "first_installment_deferral": 0,
                "installments_type": "",
                "installment_amount": null,
                "soft_descriptor": "",
                "authorization_code": "819502",
                "retrieval_reference_number": "",
                "voucher": null,
                "card_data": {
                    "holder_name": "JOHN DOE",
                    "iin": "41234567",
                    "lfd": "2345",
                    "number_length": 16,
                    "security_code_length": 0,
                    "brand": "VISA",
                    "issuer_name": "INTL HDQTRSCENTER OWNED",
                    "issuer_code": null,
                    "country_code": "VN",
                    "category": "CLASSIC",
                    "type": "CREDIT",
                    "three_d_secure": {
                        "version": null,
                        "electronic_commerce_indicator": null,
                        "cryptogram": null,
                        "transaction_id": null,
                        "directory_server_transaction_id": null,
                        "pares_status": null,
                        "acs_id": null
                    },
                    "fingerprint": "e5fb7cbd-c42b-4ec2-ab9c-a421f049a3b8",
                    "expiration_month": 10,
                    "expiration_year": 29
                },
                "stored_credentials": {
                    "reason": null,
                    "usage": null,
                    "subscription_agreement_id": null,
                    "network_transaction_id": null
                }
            }
        }
    },
    "customer_payer": {
        "id": "33a9e979-6558-4694-b00c-3d0844524681",
        "merchant_customer_id": "1234567",
        "first_name": "JOHN",
        "last_name": "DOE",
        "gender": "F",
        "date_of_birth": "1990-02-28",
        "email": "[email protected]",
        "nationality": "CO",
        "ip_address": null,
        "device_fingerprint": null,
        "device_fingerprints": [],
        "browser_info": {
            "user_agent": "",
            "accept_header": "",
            "accept_content": null,
            "accept_browser": null,
            "color_depth": "",
            "screen_height": "",
            "screen_width": "",
            "javascript_enabled": null,
            "java_enabled": null,
            "browser_time_difference": null,
            "language": "",
            "platform": null
        },
        "document": {
            "document_type": "CC",
            "document_number": "1010268952"
        },
        "phone": {
            "number": "3132450765",
            "country_code": "57"
        },
        "billing_address": {
            "address_line_1": "Calle 34 # 56 - 78",
            "address_line_2": "Apartamento 502, Torre I",
            "country": "CO",
            "state": "Cundinamarca",
            "city": "Bogotá",
            "zip_code": "111111",
            "neighborhood": null
        },
        "shipping_address": {
            "address_line_1": "Calle 34 # 56 - 78",
            "address_line_2": "Apartamento 502, Torre I",
            "country": "CO",
            "state": "Cundinamarca",
            "city": "Bogotá",
            "zip_code": "111111",
            "neighborhood": null
        },
        "merchant_customer_created_at": null
    },
    "additional_data": null,
    "transactions": {
        "id": "044a1535-43d9-44c7-8dfa-4bcc67e11ec6",
        "type": "PURCHASE",
        "status": "SUCCEEDED",
        "category": "CARD",
        "amount": 125.00,
        "provider_id": "YUNO_TEST_PAYMENT_GW",
        "payment_method": {
            "vaulted_token": "b813ce30-c261-4341-8d33-b85698491d18",
            "type": "CARD",
            "vault_on_success": false,
            "token": "",
            "parent_payment_method_type": null,
            "detail": {
                "card": {
                    "verify": false,
                    "capture": true,
                    "installments": 1,
                    "installments_plan_id": null,
                    "first_installment_deferral": 0,
                    "installments_type": "",
                    "installment_amount": null,
                    "soft_descriptor": "",
                    "authorization_code": "819502",
                    "retrieval_reference_number": "",
                    "voucher": null,
                    "card_data": {
                        "holder_name": "JOHN DOE",
                        "iin": "41234567",
                        "lfd": "2345",
                        "number_length": 16,
                        "security_code_length": 0,
                        "brand": "VISA",
                        "issuer_name": "INTL HDQTRSCENTER OWNED",
                        "issuer_code": null,
                        "country_code": "VN",
                        "category": "CLASSIC",
                        "type": "CREDIT",
                        "three_d_secure": {
                            "version": null,
                            "electronic_commerce_indicator": null,
                            "cryptogram": null,
                            "transaction_id": null,
                            "directory_server_transaction_id": null,
                            "pares_status": null,
                            "acs_id": null
                        },
                        "fingerprint": "e5fb7cbd-c42b-4ec2-ab9c-a421f049a3b8",
                        "expiration_month": 10,
                        "expiration_year": 29
                    },
                    "stored_credentials": {
                        "reason": null,
                        "usage": null,
                        "subscription_agreement_id": null,
                        "network_transaction_id": null
                    }
                }
            }
        },
        "response_code": "SUCCEEDED",
        "response_message": "Transaction successful",
        "reason": null,
        "description": "Card payment with vaulted token",
        "merchant_reference": "reference-0001",
        "provider_data": {
            "id": "YUNO_TEST_PAYMENT_GW",
            "transaction_id": "ba96ce21-3808-44c3-bdf3-c8838598e19c",
            "account_id": "",
            "status": "SUCCEEDED",
            "sub_status": "",
            "status_detail": "",
            "response_message": null,
            "response_code": null,
            "raw_response": {
                "amount": {
                    "currency": "BRL",
                    "value": 2100
                },
                "merchantAccount": "YunoPaymentsECOM",
                "paymentPspReference": "ZKHXKZGXMLBX8N82",
                "pspReference": "VKJTCWZ9575ZGN82",
                "reference": "34343434",
                "status": "received"
            },
            "third_party_transaction_id": "",
            "third_party_account_id": null,
            "iso8583_response_code": null,
            "iso8583_response_message": null
        },
        "connection_data": {
            "id": "a2ee2f97-8ba0-4198-a821-3b750bc97872",
            "name": null
        },
        "created_at": "2025-06-19T19:30:26.395712Z",
        "updated_at": "2025-06-19T19:30:26.493844Z"
    },
    "transactions_history": [
        {
            "id": "044a1535-43d9-44c7-8dfa-4bcc67e11ec6",
            "type": "PURCHASE",
            "status": "SUCCEEDED",
            "category": "CARD",
            "amount": 125.00,
            "provider_id": "YUNO_TEST_PAYMENT_GW",
            "payment_method": {
                "vaulted_token": "b813ce30-c261-4341-8d33-b85698491d18",
                "type": "CARD",
                "vault_on_success": false,
                "token": "",
                "parent_payment_method_type": null,
                "detail": {
                    "card": {
                        "verify": false,
                        "capture": true,
                        "installments": 1,
                        "installments_plan_id": null,
                        "first_installment_deferral": 0,
                        "installments_type": "",
                        "installment_amount": null,
                        "soft_descriptor": "",
                        "authorization_code": "819502",
                        "retrieval_reference_number": "",
                        "voucher": null,
                        "card_data": {
                            "holder_name": "JOHN DOE",
                            "iin": "41234567",
                            "lfd": "2345",
                            "number_length": 16,
                            "security_code_length": 0,
                            "brand": "VISA",
                            "issuer_name": "INTL HDQTRSCENTER OWNED",
                            "issuer_code": null,
                            "country_code": "VN",
                            "category": "CLASSIC",
                            "type": "CREDIT",
                            "three_d_secure": {
                                "version": null,
                                "electronic_commerce_indicator": null,
                                "cryptogram": null,
                                "transaction_id": null,
                                "directory_server_transaction_id": null,
                                "pares_status": null,
                                "acs_id": null
                            },
                            "fingerprint": "e5fb7cbd-c42b-4ec2-ab9c-a421f049a3b8",
                            "expiration_month": 10,
                            "expiration_year": 29
                        },
                        "stored_credentials": {
                            "reason": null,
                            "usage": null,
                            "subscription_agreement_id": null,
                            "network_transaction_id": null
                        }
                    }
                }
            },
            "response_code": "SUCCEEDED",
            "response_message": "Transaction successful",
            "reason": null,
            "description": "Card payment with vaulted token",
            "merchant_reference": "reference-0001",
            "provider_data": {
                "id": "YUNO_TEST_PAYMENT_GW",
                "transaction_id": "ba96ce21-3808-44c3-bdf3-c8838598e19c",
                "account_id": "",
                "status": "SUCCEEDED",
                "sub_status": "",
                "status_detail": "",
                "response_message": null,
                "response_code": null,
                "raw_response": {
                    "amount": {
                        "currency": "BRL",
                        "value": 2100
                    },
                    "merchantAccount": "YunoPaymentsECOM",
                    "paymentPspReference": "ZKHXKZGXMLBX8N82",
                    "pspReference": "VKJTCWZ9575ZGN82",
                    "reference": "34343434",
                    "status": "received"
                },
                "third_party_transaction_id": "",
                "third_party_account_id": null,
                "iso8583_response_code": null,
                "iso8583_response_message": null
            },
            "connection_data": {
                "id": "a2ee2f97-8ba0-4198-a821-3b750bc97872",
                "name": null
            },
            "created_at": "2025-06-19T19:30:26.395712Z",
            "updated_at": "2025-06-19T19:30:26.493844Z"
        }
    ],
    "workflow": "DIRECT",
    "metadata": [],
    "fraud_screening": null,
    "payment_link_id": "",
    "subscription_code": null,
    "routing_rules": {
        "smart_routing": false,
        "monitors": false,
        "condition": {
            "id": 192539,
            "name": "Card",
            "description": ""
        }
    },
    "simplified_mode": false
}

Card Direct with 3DS

Example of a request for payment using Card Direct with the 3DS implementation that requires the Yuno Setup. Below are examples of a request and the received response for successful payment creation. The request is presented using the cURL format, and the response is a JSON object.

curl --request POST \
     --url https://api-sandbox.y.uno/v1/payments \
     --header 'X-Idempotency-Key: <your-X-idempotency-key>' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'private-secret-key: <your-private-secret-key>' \
     --header 'public-api-key: <your-public-api-key>' \
     --data '
{
  "country": "US",
  "amount": {
    "currency": "USD",
    "value": 75.50
  },
  "customer_payer": {
    "id": "<account_id>",
    "first_name": "JOHN",
    "last_name": "DOE",
    "email": "[email protected]"
  },
  "payment_method": {
    "detail": {
      "card": {
        "card_data": {
          "number": "4111111111111111",
          "expiration_month": 11,
          "expiration_year": 28,
          "security_code": "123",
          "holder_name": "JOHN DOE"
        },
        "three_d_secure":{
          "three_d_secure_setup_id":"24127d61-b852-42fb-acd4-1ee661645376"
        }
      }
    },
    "type": "CARD"
  },
  "account_id": "<account_id>",
  "description": "Card payment with 3DS",
  "merchant_order_id": "000022",
  "callback_url":"www.google.com",
  "workflow": "DIRECT"
}
'
{
    "id": "b29ad2ec-3f39-4317-bd91-b5e32225ac6c",
    "account_id": "5beead35-0cd5-4e1c-9a13-b8f48f7f8f3a",
    "description": "Card payment with 3DS",
    "country": "US",
    "status": "SUCCEEDED",
    "sub_status": "APPROVED",
    "merchant_order_id": "000022",
    "created_at": "2025-06-19T19:37:53.686162Z",
    "updated_at": "2025-06-19T19:37:53.903636Z",
    "amount": {
        "captured": 0.00,
        "currency": "USD",
        "currency_conversion": null,
        "refunded": 0.00,
        "value": 75.50
    },
    "checkout": {
        "session": "",
        "sdk_action_required": false
    },
    "payment_method": {
        "vaulted_token": "",
        "type": "CARD",
        "vault_on_success": false,
        "token": "",
        "parent_payment_method_type": null,
        "payment_method_detail": {
            "card": {
                "verify": false,
                "capture": true,
                "installments": 1,
                "installments_plan_id": null,
                "first_installment_deferral": 0,
                "installments_type": "",
                "installment_amount": null,
                "soft_descriptor": "",
                "authorization_code": "422885",
                "retrieval_reference_number": "",
                "voucher": null,
                "card_data": {
                    "holder_name": "JOHN DOE",
                    "iin": "41111111",
                    "lfd": "1111",
                    "number_length": 16,
                    "security_code_length": 3,
                    "brand": "VISA",
                    "issuer_name": "CONOTOXIA SP Z O O",
                    "issuer_code": null,
                    "country_code": "PL",
                    "category": "CLASSIC",
                    "type": "DEBIT",
                    "three_d_secure": {
                        "version": null,
                        "electronic_commerce_indicator": null,
                        "cryptogram": null,
                        "transaction_id": null,
                        "directory_server_transaction_id": null,
                        "pares_status": null,
                        "acs_id": null
                    },
                    "fingerprint": "a2ede54f-4b2a-4673-ae2c-c0704338ec7d",
                    "expiration_month": 11,
                    "expiration_year": 28
                },
                "stored_credentials": {
                    "reason": null,
                    "usage": null,
                    "subscription_agreement_id": null,
                    "network_transaction_id": null
                }
            }
        }
    },
    "customer_payer": {
        "id": "33a9e979-6558-4694-b00c-3d0844524681",
        "merchant_customer_id": "1749820178",
        "first_name": "JOHN",
        "last_name": "DOE",
        "gender": "F",
        "date_of_birth": "1990-02-28",
        "email": "[email protected]",
        "nationality": "CO",
        "ip_address": null,
        "device_fingerprint": null,
        "device_fingerprints": [],
        "browser_info": {
            "user_agent": "",
            "accept_header": "",
            "accept_content": null,
            "accept_browser": null,
            "color_depth": "",
            "screen_height": "",
            "screen_width": "",
            "javascript_enabled": null,
            "java_enabled": null,
            "browser_time_difference": null,
            "language": "",
            "platform": null
        },
        "document": {
            "document_type": "CC",
            "document_number": "1010268952"
        },
        "phone": {
            "number": "3132450765",
            "country_code": "57"
        },
        "billing_address": {
            "address_line_1": "Calle 34 # 56 - 78",
            "address_line_2": "Apartamento 502, Torre I",
            "country": "CO",
            "state": "Cundinamarca",
            "city": "Bogotá",
            "zip_code": "111111",
            "neighborhood": null
        },
        "shipping_address": {
            "address_line_1": "Calle 34 # 56 - 78",
            "address_line_2": "Apartamento 502, Torre I",
            "country": "CO",
            "state": "Cundinamarca",
            "city": "Bogotá",
            "zip_code": "111111",
            "neighborhood": null
        },
        "merchant_customer_created_at": null
    },
    "additional_data": null,
    "transactions": {
        "id": "c8dd3355-ad7c-40e7-95a4-c41bd34f994b",
        "type": "PURCHASE",
        "status": "SUCCEEDED",
        "category": "CARD",
        "amount": 75.5,
        "provider_id": "YUNO_TEST_PAYMENT_GW",
        "payment_method": {
            "vaulted_token": "",
            "type": "CARD",
            "vault_on_success": false,
            "token": "",
            "parent_payment_method_type": null,
            "detail": {
                "card": {
                    "verify": false,
                    "capture": true,
                    "installments": 1,
                    "installments_plan_id": null,
                    "first_installment_deferral": 0,
                    "installments_type": "",
                    "installment_amount": null,
                    "soft_descriptor": "",
                    "authorization_code": "422885",
                    "retrieval_reference_number": "",
                    "voucher": null,
                    "card_data": {
                        "holder_name": "JOHN DOE",
                        "iin": "41111111",
                        "lfd": "1111",
                        "number_length": 16,
                        "security_code_length": 3,
                        "brand": "VISA",
                        "issuer_name": "CONOTOXIA SP Z O O",
                        "issuer_code": null,
                        "country_code": "PL",
                        "category": "CLASSIC",
                        "type": "DEBIT",
                        "three_d_secure": {
                            "version": null,
                            "electronic_commerce_indicator": null,
                            "cryptogram": null,
                            "transaction_id": null,
                            "directory_server_transaction_id": null,
                            "pares_status": null,
                            "acs_id": null
                        },
                        "fingerprint": "a2ede54f-4b2a-4673-ae2c-c0704338ec7d",
                        "expiration_month": 11,
                        "expiration_year": 28
                    },
                    "stored_credentials": {
                        "reason": null,
                        "usage": null,
                        "subscription_agreement_id": null,
                        "network_transaction_id": null
                    }
                }
            }
        },
        "response_code": "SUCCEEDED",
        "response_message": "Transaction successful",
        "reason": null,
        "description": "Card payment with 3DS",
        "merchant_reference": "000022",
        "provider_data": {
            "id": "YUNO_TEST_PAYMENT_GW",
            "transaction_id": "19a36e27-5448-48f8-9b6b-20c28735fef7",
            "account_id": "",
            "status": "SUCCEEDED",
            "sub_status": "",
            "status_detail": "",
            "response_message": null,
            "response_code": null,
            "raw_response": {
                "amount": {
                    "currency": "BRL",
                    "value": 2100
                },
                "merchantAccount": "YunoPaymentsECOM",
                "paymentPspReference": "ZKHXKZGXMLBX8N82",
                "pspReference": "VKJTCWZ9575ZGN82",
                "reference": "34343434",
                "status": "received"
            },
            "third_party_transaction_id": "",
            "third_party_account_id": null,
            "iso8583_response_code": null,
            "iso8583_response_message": null
        },
        "connection_data": {
            "id": "a2ee2f97-8ba0-4198-a821-3b750bc97872",
            "name": null
        },
        "created_at": "2025-06-19T19:37:53.815080Z",
        "updated_at": "2025-06-19T19:37:53.868518Z"
    },
    "transactions_history": [
        {
            "id": "c8dd3355-ad7c-40e7-95a4-c41bd34f994b",
            "type": "PURCHASE",
            "status": "SUCCEEDED",
            "category": "CARD",
            "amount": 75.5,
            "provider_id": "YUNO_TEST_PAYMENT_GW",
            "payment_method": {
                "vaulted_token": "",
                "type": "CARD",
                "vault_on_success": false,
                "token": "",
                "parent_payment_method_type": null,
                "detail": {
                    "card": {
                        "verify": false,
                        "capture": true,
                        "installments": 1,
                        "installments_plan_id": null,
                        "first_installment_deferral": 0,
                        "installments_type": "",
                        "installment_amount": null,
                        "soft_descriptor": "",
                        "authorization_code": "422885",
                        "retrieval_reference_number": "",
                        "voucher": null,
                        "card_data": {
                            "holder_name": "JOHN DOE",
                            "iin": "41111111",
                            "lfd": "1111",
                            "number_length": 16,
                            "security_code_length": 3,
                            "brand": "VISA",
                            "issuer_name": "CONOTOXIA SP Z O O",
                            "issuer_code": null,
                            "country_code": "PL",
                            "category": "CLASSIC",
                            "type": "DEBIT",
                            "three_d_secure": {
                                "version": null,
                                "electronic_commerce_indicator": null,
                                "cryptogram": null,
                                "transaction_id": null,
                                "directory_server_transaction_id": null,
                                "pares_status": null,
                                "acs_id": null
                            },
                            "fingerprint": "a2ede54f-4b2a-4673-ae2c-c0704338ec7d",
                            "expiration_month": 11,
                            "expiration_year": 28
                        },
                        "stored_credentials": {
                            "reason": null,
                            "usage": null,
                            "subscription_agreement_id": null,
                            "network_transaction_id": null
                        }
                    }
                }
            },
            "response_code": "SUCCEEDED",
            "response_message": "Transaction successful",
            "reason": null,
            "description": "Card payment with 3DS",
            "merchant_reference": "000022",
            "provider_data": {
                "id": "YUNO_TEST_PAYMENT_GW",
                "transaction_id": "19a36e27-5448-48f8-9b6b-20c28735fef7",
                "account_id": "",
                "status": "SUCCEEDED",
                "sub_status": "",
                "status_detail": "",
                "response_message": null,
                "response_code": null,
                "raw_response": {
                    "amount": {
                        "currency": "BRL",
                        "value": 2100
                    },
                    "merchantAccount": "YunoPaymentsECOM",
                    "paymentPspReference": "ZKHXKZGXMLBX8N82",
                    "pspReference": "VKJTCWZ9575ZGN82",
                    "reference": "34343434",
                    "status": "received"
                },
                "third_party_transaction_id": "",
                "third_party_account_id": null,
                "iso8583_response_code": null,
                "iso8583_response_message": null
            },
            "connection_data": {
                "id": "a2ee2f97-8ba0-4198-a821-3b750bc97872",
                "name": null
            },
            "created_at": "2025-06-19T19:37:53.815080Z",
            "updated_at": "2025-06-19T19:37:53.868518Z"
        }
    ],
    "callback_url": "www.google.com",
    "workflow": "DIRECT",
    "metadata": [],
    "fraud_screening": null,
    "payment_link_id": "",
    "subscription_code": null,
    "routing_rules": {
        "smart_routing": false,
        "monitors": false,
        "condition": {
            "id": 192539,
            "name": "Card",
            "description": ""
        }
    },
    "simplified_mode": false
}