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
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
}