Payment 对象

amount 反对

指定payment 金额对象，包括金额和货币。

currency 枚举
用于payment 的货币（MAX 3; MIN 3； ISO 4217).
可能的枚举值：查看国家参考信息。

value 编号
payment 金额（0.0001 的倍数）。
例如：111111

currency_conversion 反对

指定货币转换对象。

provider_currency_conversion_id 字符串
提供商转换率查询的唯一标识符（最多 526 个；最少 3 个）。
Example: 9104911d-5df9-429e-8488-ad41abea1a4b

cardholder_currency 枚举
进行换算的货币（ISO 4217 MAX 3；MIN 3）。
例如美元

cardholder_amount 编号
转换前的payment 额
例如：100

refunded 编号
退款金额（0.0001 的倍数）。
例如：111111

captured 编号
捕获量（0.0001 的倍数）。
例如：111111

checkout 反对

指定结账对象。对于背对背付款，此对象不是必须的。当 WORKFLOW 定义为 CHECKOUT 或未发送。不需要 DIRECT 付款。

session 字符串
已为payment 创建结账会话（最多 64 个；最少 36 个）。
Example: 757eefc7-e28c-4333-9a07-3b16e610745d

sdk_action_required 布尔
定义payment 是否为异步payment ，是否需要根据 SDKrequest 采取额外步骤。
示例：假

payment_method 反对

指定payment对象。

vaulted_token 字符串
保险库令牌代表与之前交易相关的安全存储支付方式。当使用 vaulted_token 创建付款时，无需发送额外的token；可将其设置为空（最大值：64；最小值：36）。
该字段在支付响应中返回时 vault_on_success = true 付款状态为 SUCCEEDED只要付款时通过现有Yuno客户进行关联 customer_payer.id.
Example: 8604911d-5ds9-229e-8468-bd41abear14s

type 枚举
Payment 方式类型。必须为 DIRECT 或 REDIRECT 工作流程。集成钱包时必须使用，即使使用 SDK 也是如此。
可能的枚举值：
可能的枚举值：检查payment 类型参考。

vault_on_success 布尔
在成功付款后标记该卡进行注册。要求付款时需通过现有Yuno客户进行关联。 customer_payer.id.
当设置为 true 付款状态为 SUCCEEDED支付响应将包含一个 vaulted_token 可用于未来交易。若无客户ID，则不会发生保管操作，也不会 vaulted_token 即使客户详细信息包含在内，该字段仍会被返回。
可能的值： True 或 False

token 字符串
一次性使用支付方式token 由 Yuno sdk 提供.如果付款是使用token创建的、则无需同时发送 vaulted_token，可将其定义为空。对于背对背最大：64；最小：36）。
示例： 5104911d-5df9-229e-8468-bd41abea1a4s5104911d-5df9-229e-8468-bd41abea1a4s

detail 反对

指定payment 方法详细对象，该对象提供payment 方法对象中不同交易类型的详细资料。类型的详细信息。

card 反对

指定使用银行卡时payment 方式的详细信息。

verify 布尔
使用 amount = 0 和 verify = true，可以在不授权真实金额的情况下验证用户卡。金额。
可能的值： True 或 False

capture 布尔
决定是授权payment 还是抓取payment 。授权银行卡payment 可以在客户的银行账户中预留资金。
可能的值： True 或 False

installments 整数
卡片分期付款（最多 50；最少 1）。
例如3

first_installments_deferral 整数
从第一笔分期付款中扣款的等待月数。
示例：1

installments_type 字符串
定义分期付款的类型。
示例：字符串

installments_amount 整数
分期付款金额包括与分期付款相关的利息，信息由提供方定义。由提供方定义。
例如3

soft_descriptor 字符串
每笔交易传递给平台的描述符。它将显示在客户的实体银行对账单（最多 15 个；最少 0 个）。
示例：公司1

authorization_code 字符串
收单机构的回复代码。
例如：742A64

retrieval_reference_number 字符串
收单机构分配给授权的唯一标识符。在巴西，您将收到 nsu。
例如：200000000012

voucher 字符串
发卡银行为银行卡交易分配的付款收据的唯一标识符。如果gateway 不提供交易信息，则此字段为空（最大 255；最小 3）。
例如43564

card_data 反对

指定卡的详细信息。

holder_name 字符串
持卡人在卡上的全名（最多 26 个；最少 3 个），仅适用于 PCI 认证的商家。
范例：范妮-魏斯纳特

country_code 字符串
用户卡国家代码（最多 2 个；最少 2 个）。
例如：美国美国

expiration_month 整数
卡的到期月份（MM）（最多 2 个；最少 2 个）。
例如：03

expiration_year 整数
卡的有效年份（YYYY）（最多 4 个；最少 2 个）。
例如：2030 年

iin 字符串
发卡行识别码 (IIN) 是指金融机构发行的payment 卡号的前几位数字（最多 8 位；最少 6 位）。发卡行识别码（IIN）是指金融机构发行的支付卡卡号的前几位数字（最多 8 位；最少 6 位）。
例如41961111

lfd 字符串
密码卡的最后四位数字（最多 4 位；最少 4 位）。
例如：0010

number_length 整数
卡片号码的长度（最长 19；最短 8）。
例如41961111

security_code_length 整数
银行卡安全码的长度（最大 1；最小 1）。
例如3

brand 字符串
卡片的品牌信息（最多 255 个；最少 3 个）。
例如VISA

issuer_name 字符串
发卡机构（最多 255 个；最少 3 个）。
例如：加利西亚银行加利西亚银行

issuer_code 整数
发卡机构识别码（最多 255 个；最少 3 个）。

category 字符串
发卡机构的类别（最多 255 个；最少 3 个）。
举例说明：黄金

type 字符串
发卡机构类型（最多 255 个；最少 3 个）。
例如信用卡、借记卡或充值卡

fingerprint 字符串
当客户多次注册与一个或多个 Yuno 账户相关的信用卡时，将生成多个 vaulted_tokens，但fingerprint 可让您识别客户使用的是同一张卡（最多 255 个；最少 3 个）。
例如： 55a7fe38-cdc3-45dc-8c5f-820751799c7655a7fe38-cdc3-45dc-8c5f-820751799c76

three_d_secure 反对

指定 3DS 交易的详细信息。

three_d_secure_setup_id 字符串
为 3DS Direct 流程指定的设置 ID。
Example: 24127d61-b852-42fb-acd4-1ee661645376

version 枚举
指所使用的 EMV 3-D Secure 规范的协议版本。1.0, 2.0, 2.1.0, 2.2.0, 2.2.1.
示例：2.2.1

electronic_commerce_indicator 字符串
该字段必须根据 ECI 字段由 3d Secure 服务提供的字段。电子商务指示符 (ECI) 通知发卡机构交易是否受 VbV 或 MCSC 等安全协议保护。是否受到 VbV 或 MCSC 等安全协议的保护。威士卡和万事达卡规定，所有威士卡和万事达卡规定，所有 3-D 安全交易都必须在授权request 中填写该值（最大值：2，最小值：0）。
例如：05

cryptogram 字符串
该字段必须使用 3DSecure 服务提供的密码字段结果填写。服务提供的密码字段结果。在 Visa 交易中，它代表持卡人身份验证值（CAVV）。 (在 Visa 交易中，它代表持卡人身份验证验证值（CAVV）。在威士卡交易中，它代表持卡人验证值（CAVV），是由发卡机构生成的加密值，作为在线购买时支付验证的证据，以获得退款保护。万事达卡交易也有一个类似的值称为 "账户持有人验证值"（AAV）或 "通用持卡人验证字段"（UCAF）。 (UCAF）。在提交交易授权时，商家必须包含 CAVV 或 AAV/UCAF，以证明持卡人已通过身份验证。它通常采用 base64 编码。 (最大：40，最小：0）。
例如BA0BB1Z3N5Q4kjkBU3c3ELGUsJY =

transaction_id 字符串
用于 3DS v1：这是唯一交易标识符。它由 MPI 自动生成。它通常长度为 28 字节，采用 base64 编码。通常称为 XID（最大：40，最小：0）。对于 3DS v2：由 DS 分配的通用唯一事务标识符，用于标识单个事务。(最大：36，最小：36）： 36，最小值：36）。
Ex for V1："TjY0MjAxRjA4MD4987DUzMzYyNjU=" Ex for V2：“c4e59ceb-a382-4d6a-bc87-385d591fa09d”

directory_server_transaction_id 字符串
万事达卡目录服务器在身份验证过程中生成的交易 ID（最多 255；最小 3）。
Example: f38e6948-5388-41a6-bca4-b49723c19437

network_token 反对

交易使用的网络token 信息。如果适用。

network 枚举
与所提供的token 相关联的提供商。visa、mastercard、american_express。
例如万事达卡

status 枚举
付款方式token 的状态。CREATED、激活、暂停、取消。
例如活动

par 字符串
Payment 账户编号。
例如MCC123456789012

token_data 反对

Token 详情。

number 编号
[必填] -Token编号，不含任何分隔符（最多 19 个；最少 8 个），仅适用于 PCI 认证的商家。
例如450799000001234

holder_name 字符串
持卡人在Token 上的全名（最多 26 个；最少 3 个）。
例子无名氏

iin 编号
机构识别码 (IIN) 是指金融机构发行的网络token 号码的前几位数字（最多 8 位；最少 6 位）。
例如45079900

lfd 编号
网络token 的最后四位数字（最多 4 位；最少 4 位）。
例如：1234

expiration_month 编号
网络Token的到期月份（MM）（最多 2 个；最少 2 个）。
例如：12

expiration_year 编号
网络Token的到期年份（YYYY）（最多 4 个；最少 2 个）。
例如：2027 年

cryptogram 字符串
[必填] - 发卡机构为交易中使用的网络token 生成的唯一密码。

electronic_commerce_indicator 字符串
[仅某些提供商需要] - 如果token 已通过万事达卡验证，该字段应设置为 02。对于 Visa 或未经验证的tokens，则无需发送该字段。

token_requestor_id 字符串
[商户的Token 申请者 ID

response 反对

网络交易详情。

code 编号
服务提供商的响应代码。
示例：成功

message 编号
服务提供商的响应代码。
示例：交易成功

stored_credentials 反对

表示交易的处理类型。

reason 枚举
枚举：CARD_ON_FILE, SUBSCRIPTION, UNSCHEDULED_CARD_ON_FILE
举例说明：订阅

usage 枚举
该字段可用于说明金库令牌/网络令牌是首次用于payment ，还是已用于之前的payment。枚举：首次, 已用
举例说明：使用过

subscription_agreement_id 字符串
该字段用于标明与客户签订的订购协议的标识。主要用于 MX（最大 255；最小 3）。
示例：AA0001AA0001

network_Transaction_id 字符串
由银行卡网络分配给交易的唯一标识符。它用于跟踪和参考特定交易，特别是在循环payment 情况下，确保整个payment 周期的一致性和可追溯性（最多 255 个；最少 3 个）。
例如583103536844189

bnpl 反对

使用 "立即购买，稍后付款"（BNPL）时，指定payment 方式的详细信息。

installments 整数
贷款分期付款（最多 50；最少 1）。
例如：10

provider_image 字符串
提供商的 URL（最多 255 个；最少 3 个）。
例如：https://www.company.com/

redirect_url 字符串
包含完整版票据的 URL，以备重新定向客户使用（MAX 255.MIN）；最小 3).
例如：https://www.company.com/ticket_1231324

expires_at 时戳
Payment 方式到期日期。"yyyyy-MM-dd HH:mm:ss.SSSz"
Example: 2026-05-09T20:46:54.786342Z

customer_data 反对

指定客户的详细信息。

name 字符串
客户的法定姓名（最多 32 个，最少 8 个）。
举例说明：法定名称

username 字符串
客户在提供商平台上的用户名（最多 32 个，最少 8 个）。
示例：Legal_name_01法律名称_01

tax_id_type 字符串
客户税号标识符（最多 32 个，最少 8 个）。
例如CUIT

tax_id 字符串
客户的税务识别码（最多 32 个，最少 8 个）。
例如：20-34566123-7

type 字符串
信贷类型（最多 255 个；最少 3 个）。
举例说明：个人/企业

area 字符串
客户所属行业（最多 255 个；最少 3 个）。
举例说明：其他

role 字符串
客户在公司中的角色（最多 255 个；最少 3 个）。
例如业主

bank_transfer 反对

使用银行转账时，指定payment 方式的详细信息。

provider_image 字符串
提供商的 URL（最多 255 个；最少 3 个）。
例如：https://www.company.com/

account_type 字符串
银行账户类型（最多 255 个；最少 3 个）。
例如支票/储蓄

bank_name 字符串
与账户相关的银行名称（最多 255 个；最少 3 个）。
例如：加利西亚银行加利西亚银行

bank_id 字符串
当提供方要求选择银行时，所选银行的标识符（最大值255；最小值1）。可选。
示例：加利西亚

beneficiary_name 字符串
账户持有人姓名（最多 255 个；最少 3 个）。
例子无名氏

bank_account 字符串
银行账户号码（最多 255 个；最少 3 个）。
例如54653211313333

bank_account_2 字符串
银行账户的二级编号（最多 255 个；最少 3 个）。
例如：78900000000123

beneficiary_document_type 字符串
账户持有人的文件类型（最多 255 个；最少 3 个）。
可能的值：检查国家参考。例如DNI

beneficiary_document 字符串
账户持有人的证件号码（最多 255 个；最少 3 个）。
例如54666897

reference 字符串
用户的参考代码（最多 255 个；最少 3 个）。
示例：AA01234-BCAA01234-BC

retrieval_reference_number 字符串
收单机构分配给授权的唯一标识符。在巴西，您将收到 nsu。
例如：200000000012

payment_instruction 字符串
与payment 有关的付款指示（最多 255 个；最少 3 个）。
举例说明：转到您的银行账户，使用以下详细参考信息转账转账

redirect_url 字符串
包含完整版票据的 URL，以备重新定向客户使用（MAX 255.MIN）；最小 3).
例如：https://www.company.com/ticket_1231324

expires_at 时戳
Payment 方式到期日期。"yyyyy-MM-dd HH:mm:ss.SSSz"
Example: 2026-05-09T20:46:54.786342Z

wallet 反对

指定使用钱包时payment 方式的详细信息。

verify 布尔
使用 amount = 0 和 verify = true，可以在不授权真实金额的情况下验证用户卡。金额。
可能的值： True 或 False

cryptogram 字符串
与银行卡钱包直接集成的密码图（最多 526 个；最少 3 个）。

expires_at 时戳
Payment 方式到期日期。"yyyyy-MM-dd HH:mm:ss.SSSz"
Example: 2026-05-09T20:46:54.786342Z

capture 布尔
决定是授权payment 还是抓取payment 。授权银行卡payment 可以在客户的银行账户中预留资金。
可能的值： True 或 False

installments 整数
卡片分期付款（最多 50；最少 1）。
例如3

payment_method_id 字符串
用户钱包中使用的payment 方式。
例如：信用卡

detail 字符串
钱包中使用的payment 方式详情。
例如：签证

money_release_date 日期
供应商提供的资金可以使用的日期。
Example: 2022-05-09T00:00:00.000000Z

sponsor_id 字符串
合作伙伴的供应商账户（最多 255 个；最少 3 个）。
例如4562103

authorization_code 字符串
获取响应代码。
例如：742A64

customer_data 反对

指定客户的详细信息。

email 字符串
客户的email （最多 255 个；最少 3 个）。
例如[email protected］

first_name 字符串
客户姓名（最多 32 个，最少 8 个）。
举例说明：约翰

last_name 字符串
客户姓氏（最多 32 个，最少 8 个）。
例子无名氏

username 字符串
客户在平台中的用户名（最多 32 个，最少 8 个）。
示例：John_Doe_01约翰_多伊_01

identification_type 字符串
客户的文件类型（最多 32 个，最少 8 个）。
检查国家编号。例如DNI

identification_number 字符串
客户标识号（最多 32 个，最少 8 个）。
例如34566123

fee_details 反对

指定费用详情。

amount 浮动
交易金额（0.0001 的倍数）。
例如40.5

card_data 反对

指定卡的详细信息。

iin 整数
发卡行识别码 (IIN) 是指金融机构发行的payment 卡号的前几位数字（最多 8 位；最少 6 位）。发卡行识别码（IIN）是指金融机构发行的支付卡卡号的前几位数字（最多 8 位；最少 6 位）。
例如45079900

lfd 整数
密码卡的最后四位数字（最多 4 位；最少 4 位）。
例如：0010

number_length 整数
卡片号码的长度（最长 2；最短 1）。
例如：16

security_code_length 整数
银行卡安全码的长度（最大 1；最小 1）。
例如3

brand 字符串
卡片的品牌信息（最多 255 个；最少 3 个）。
例如：签证

holder_name 字符串
持卡人在卡上的全名（最多 26 个；最少 3 个），仅适用于 PCI 认证的商家。
示例：JOHN DOE约翰-多

store_credentials 反对

指示交易的处理类型。该对象用于发送关于循环付款的附加信息。此字段为可选项，且仅少数服务商要求提供（例如Mercado Pago）。请联系您的客户成功经理（TAM）确认您的集成是否需要此字段。

reason 枚举
表示存储交易凭证的原因。枚举值：CARD_ON_FILE、SUBSCRIPTION、UNSCHEDULED_CARD_ON_FILE
举例说明：订阅

usage 枚举
该字段可用于说明金库令牌/网络令牌是首次用于payment ，还是已用于之前的payment。枚举：首次, 已用
举例说明：使用过

subscription_agreement_id 字符串
此字段用于标识与客户签订的订阅协议。主要用于MX（最大值255；最小值3）。
示例：AA0001AA0001

network_Transaction_id 字符串
由银行卡网络分配给交易的唯一标识符。它用于跟踪和参考特定交易，特别是在循环payment 情况下，确保整个payment 周期的一致性和可追溯性（最多 255 个；最少 3 个）。
例如583103536844189

additional_data 反对

该结构用于发送有关复发的附加信息。这是可选项，只有少数提供商要求使用（如 Mercado Pago）。请联系您的 TAM，确认您的整合是否需要。

billing_cycles 反对

指定 billing_cycles object. 定义与订阅相关的费用数量。若使用此对象，必须填写所有字段的数据。

current 整数
示例：1

total 整数
订阅的总计费周期数（至少1个）。

frequency 反对

指定频率类型（例如：DAY、WEEK、MONTH、YEAR）及其数值。若使用此对象，请在所有字段中输入数据。

type 字符串
指定频率类型（例如：日、周、月、年）。
示例：月份

value 字符串
指定频率值。

availability 反对

指定 availability 对象。根据订阅可使用的起止日期定义日期间隔。

start_at 字符串
订阅计划可开始使用的起始日期。若未设置，则订阅自创建之时起即可使用。 start_at 在使用时成为强制性要求 finish_at.

finish_at 字符串
订阅计划可使用的截止日期。若未设置，则订阅永久有效。 finish_at 在使用时成为强制性要求 start_at.

ticket 反对

指定使用票据时payment 方式的详细信息。

type 字符串
机票类型。
例如：编号、条形码、自定义、参考编码、QR

benefit_type 枚举
用户payment 机票费用的福利类型。junaeb, 私人
举例说明：私人

provider_number 整数
机票号码。
例如：13141

provider_barcode 整数
机票的条形码。
例如：456789009878765u7654456789009878765u7654

provider_logo 字符串
门票的标识。
例如：https://www.company.com/logo

provider_format 字符串
门票的格式。
例如：条形码、自定义

payment_instruction 字符串
与payment 有关的付款指示（最多 255 个；最少 3 个）。
举例说明：前往最近的商店，使用以下参考支付总金额

redirect_url 字符串
包含完整版票据的 URL。
例如：https://www.company.com/ticket_1231324

expires_at 时戳
Payment 方式到期日期。"yyyyy-MM-dd HH:mm:ss.SSSz"
Example: 2026-05-09T20:46:54.786342Z

payment_link 反对

使用payment 链接时，指定payment 方式的详细信息。

verify 布尔
使用 amount = 0 和 verify = true，可以在不授权真实金额的情况下验证用户卡。金额。
可能的值： True 或 False

capture 布尔
决定是授权payment 还是抓取payment 。授权银行卡payment 可以在客户的银行账户中预留资金。
可能的值： True 或 False

expires_at 时戳
Payment 方式到期日期。"yyyyy-MM-dd HH:mm:ss.SSSz"
Example: 2026-05-09T20:46:54.786342Z

installments 整数
卡片分期付款（最多 50；最少 1）。
例如3

payment_method_id 字符串
用户钱包中使用的payment 方式。
例如：信用卡

detail 字符串
钱包中使用的payment 方式详情。
例如：签证

money_release_date 日期
供应商提供的资金可以使用的日期。
Example: 2022-05-09T00:00:00.000000Z

sponsor_id 字符串
合作伙伴的供应商账户（最多 255 个；最少 3 个）。
例如4562103

authorization_code 字符串
获取响应代码。
例如：742A64

customer_data 反对

指定客户的详细信息。

email 字符串
客户的email （最多 255 个；最少 3 个）。
例如[email protected］

first_name 字符串
客户姓名（最多 32 个，最少 8 个）。
举例说明：约翰

last_name 字符串
客户姓氏（最多 32 个，最少 8 个）。
例子无名氏

username 字符串
客户在平台中的用户名（最多 32 个，最少 8 个）。
示例：John_Doe_01约翰_多伊_01

identification_type 字符串
客户的文件类型（最多 32 个，最少 8 个）。
可能的值：检查国家参考。例如DNI

identification_number 字符串
客户标识号（最多 32 个，最少 8 个）。
例如34566123

fee_details 反对

指定费用详情。

amount 浮动
交易金额（0.0001 的倍数）。
例如40.5

card_data 反对

指定卡的详细信息。

iin 整数
发卡行识别码 (IIN) 是指金融机构发行的payment 卡号的前几位数字（最多 8 位；最少 6 位）。发卡行识别码（IIN）是指金融机构发行的支付卡卡号的前几位数字（最多 8 位；最少 6 位）。
例如45079900

lfd 整数
密码卡的最后四位数字（最多 4 位；最少 4 位）。
例如：0010

number_length 整数
卡片号码的长度（最长 2；最短 1）。
例如：16

security_code_length 整数
银行卡安全码的长度（最大 1；最小 1）。
例如3

brand 字符串
卡片的品牌信息（最多 255 个；最少 3 个）。
例如：签证

holder_name 字符串
持卡人在卡上的全名（最多 26 个；最少 3 个），仅适用于 PCI 认证的商家。
例子无名氏

expiration_month 整数
卡的到期月份（MM）（最多 2 个；最少 2 个）。
例如：03

expiration_year 整数
卡的有效年份（YYYY）（最多 4 个；最少 2 个）。
例如30

customer_payer 反对

指定用于付款的客户对象。

id 字符串
客户的唯一标识符（最多 64 个；最少 36 个）。指定结账对象。此对象不是背对背付款时必须使用。当 WORKFLOW 定义为 CHECKOUT 或不发送。
Example: faa89e18-5a11-11ed-9b6a-0242ac120002

merchant_customer_id 字符串
外部商户中客户的唯一标识符（最多 255 个；最少 3 个）。
示例4ce6f7e1-bf2e-4e7f-bc1b-84b26082a1d3

merchant_customer_created_at 时戳
客户在商家平台上的注册日期（ISO 8601 MAX 27；MIN 27）。
Example: 2022-05-09T20:46:54.786342Z

merchant_customer_validations 反对

对客户付款人进行欺诈验证。

account_is_verified 布尔
客户的账户是否已在商家处验证过。默认为 true。
可能的值： True 或 False

email_is_verified 布尔
客户的email 是否已在商家处验证过。默认为 true。
可能的值： True 或 False

phone_is_verified 布尔
顾客的手机是否已在商家处通过验证。默认为 true。
可能的值： True 或 False

first_name 字符串
客户姓名（最大 255；最小 1）。
举例说明：约翰

last_name 字符串
客户姓氏（最多 255 个；最少 1 个）。
例子无名氏

gender 枚举
客户性别（MAX 1；MIN 1；（M=男性/F=女性/NA=不适用/NK=不知道））。
可能的枚举值： M, F, NA或 NK.

date_of_birth 字符串
客户的出生日期，格式为 YYYY-MM-DD（长度：10）。
例如：1990-02-28

email 字符串
客户的电子邮件（最多 255 个；最少 3 个）。
例如[email protected］

nationality 枚举
客户的国籍（最多 2 个；最少 2 个； ISO 3166-1).
可能的枚举值：查看国家参考信息。

device_fingerprint 字符串
客户的设备fingerprint （最多 4000；最少 1）。对于使用 Yuno 结账的集成，该值会自动获取，请勿发送此字段。自动获取，请勿发送此字段。
Example: hi88287gbd8d7d782ge.....

device_fingerprints 对象数组

如果您使用的是 DIRECT 集成，并希望在payment 流程中支持多个欺诈提供商，则可以使用此对象指定必要的信息。对于使用 Yuno 结账的集成，该值会自动获取，请勿发送此字段。

provider_id 枚举
欺诈筛查提供商 ID
举例说明：风险

id 字符串
与提供商关联的设备fingerprint
Example: hi88287gbd8d7d782ge.....

ip_address 字符串
客户的 IP 地址（最多 45 个；最少 7 个）。
例如：192.168.123.167

browser_info 反对

指定 browser_info 对象。

accept_header 布尔
客户浏览器的接受header 。
可能的值： True 或 False

accept_browser 字符串
客户浏览器的接受浏览器值
可能的值： "True" 或 "False"

accept_content 字符串
客户浏览器的接受内容值
可能的值： "True" 或 "False"

platform 枚举
客户payment的平台。
可能的枚举值： WEB, IOS, ANDROID

color_depth 浮动
客户浏览器的色彩深度（单位：比特/像素）。应使用浏览器的 screen.colorDepth 属性获取。接受值：1、4、8、15、16、24、30、32 或 48 比特：1、4、8、15、16、24、30、32 或 48 位色深 (最大值 5；最小 1）。
例如：15

javascript_enabled 布尔
表示设备是否启用了 Javascript。
可能的值： True 或 False

java_enabled 布尔
表示设备是否启用 Java。
可能的值： True 或 False

browser_time_difference 字符串
表示布罗斯纳时差
例如：-3:00

language 字符串
客户浏览器的 navigator.language 值（如 IETF BCP 47 所定义）（最大 5；最小 1）。
示例：ES-ES

screen_height 字符串
客户设备屏幕的总高度，以像素为单位（最大 255；最小 3）。
例如：2048

screen_width 字符串
客户设备屏幕的总宽度，以像素为单位（最大 255；最小 3）。
例如：1152

user_agent 字符串
客户浏览器的用户代理值（最大 255；最小 3）。
示例：Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_2)Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_2) AppleWebKit/601.3.9 (KHTML, like Gecko）版本/9.0.2 Safari/601.3.9

document 反对

指定客户的文档对象，包括编号和类型。

document_number 字符串
客户文件编号（最多 40 个；最少 3 个）。
例如：1093333333

document_type 枚举
客户的文件类型（最多 6 个，最少 2 个）。
可能的枚举值：检查国家参考。

phone 反对

指定客户的电话对象，包括号码和代码。

number 字符串
客户电话号码（最多 40 个；最少 3 个）。
例如：11992149494

country_code 字符串
客户电话的国家呼叫代码（最多 3 个；最少 1 个）。
可能的值：检查国家参考。

billing_address 反对

指定客户的账单地址对象。

address_line_1 字符串
客户的主要账单地址行（最多 255 个；最少 3 个）。
例如：Calle 34 # 56 - 78Calle 34 # 56 - 78

address_line_2 字符串
客户的二级账单地址行（最多 255 个；最少 3 个）。
例如：Apartamento 502, Torre I：Apartamento 502, Torre I

city 字符串
账单地址考虑的城市（最多 255 个；最少 3 个）。
例如：波哥大波哥大

country 枚举
账单地址考虑的国家（最多 2 个；最少 2 个； ISO 3166-1).
可能的枚举值：查看国家参考信息。

state 字符串
账单地址的状态（最大 255；最小 3）。
实例：昆迪纳马卡省昆迪纳马卡

zip_code 字符串
账单地址的邮编（最多 11 个；最少 4 个）。
例如：111111

neighborhood 字符串
客户地址栏的邻近地区（MAX 255; MIN 2）。
例子巴里奥 11

shipping_address 反对

指定客户的送货地址对象。

address_line_1 字符串
客户的主要送货地址行（最多 255 个；最少 3 个）。
例如：Calle 34 # 56 - 78Calle 34 # 56 - 78

address_line_2 字符串
客户的二级送货地址行（最多 255 个；最少 3 个）。
例如：Apartamento 502, Torre I：Apartamento 502, Torre I

city 字符串
收货地址考虑的城市（最多 255 个；最少 3 个）。
例如：波哥大波哥大

country 枚举
送货地址考虑的国家（最多 2 个；最少 2 个； ISO 3166-1).
可能的枚举值：查看国家参考信息。

state 字符串
收货地址的状态（最大 255；最小 3）。
实例：昆迪纳马卡省昆迪纳马卡

zip_code 字符串
送货地址的邮编（最多 11 个；最少 4 个）。
例如：111111

neighborhood 字符串
客户地址栏的邻接区（最大 255；最小 2）。
例子巴里奥 11

geolocation 反对

客户的地理位置。

latitude 字符串
地球上赤道以南或以北位置的角距离（最小：1，最大：11）
例如-34.4905

longitude 字符串
以角度测量格林威治天文台以东或以西地球上某一位置的距离。(最小：1，最大：11）
例如-58.5555

additional_data 反对

指定 additional_data 对象。该对象不是强制性的。但是，如果发送此信息用户的payment 体验将得到提升。

airline 反对

指定航空公司对象。乘客和机票应具有相同的订单信息。

pnr 字符串
乘客姓名记录（最多 10 个；最少 1 个）。
示例：1P-2UUGJW

type 枚举
旅行类型
可能的值： ONE_WAY, ROUNDTRIP, MULTIPLE_DESTINATIONS

legs 对象数组

指定对象的脚数组。

order 整数
运行指数（以 1 开头），描述同一路线中各段的顺序。
例如：2

route_order 整数
运行索引（从 1 开始），按时间描述路线的顺序。例如：如果一个订单包含 2 条航线：纽约→伦敦→巴黎（在伦敦连接），纽约→伦敦应有 route_order=1，order=1；伦敦→巴黎应有 route_order=1，order=2；巴黎→伦敦→纽约：巴黎→伦敦应有 route_order=2，order=1；伦敦→纽约应有 route_order=2，order=2。
示例：1

arrival_airport 字符串
国际航空运输协会机场代码（最多 3 个；最少 3 个）。参见 http://www.iata.org.
举例说明：AMS

arrival_airport_country 字符串
抵达机场所在国家（最多 2 个；最少 2 个；ISO 3166-1）。
举例说明：AR

arrival_airport_city 字符串
考虑作为到达机场的城市（最多 255 个；最少 3 个）。
举例说明：BUE

arrival_airport_timezone 字符串
机场时区（MAX 6；MIN 6）。
例如：-03:00

arrival_datetime 时戳
以抵达机场当地时间计算的抵达日期和时间。
Example: 2022-05-09T24:46:54.786342Z

base_fare 浮动
交易金额，不含税费，最小货币单位（0.0001 的倍数）。 0.0001).
例如：23.5676

base_fare_currency 字符串
用于交易金额的货币（MAX 3; MIN 3； ISO 4217).
举例说明：检查国家参考信息。

carrier_code 字符串
IATA 承运商代码（最多 2 个；最少 2 个）。参见 http://www.iata.org.
例如KL

departure_airport 字符串
国际航空运输协会代码（最多 3 个；最少 3 个）。参见 http://www.iata.org.
例如EZE

departure_airport_country 字符串
出发机场所在国家（最多 2 个；最少 2 个；ISO 3166-1）。
举例说明：AR

departure_airport_city 字符串
出发机场所在城市（MAX 2；MIN 2；ISO 3166-1）。
举例说明：AR

departure_airport_timezone 字符串
机场时区（MAX 6；MIN 6）。
例如：-03:00

departure_datetime 时戳
出发机场当地时间的出发日期和时间。
Example: 2022-05-09T20:46:54.786342Z

fare_basis_code 字符串
代码基本费率除提供舱位服务外，还提供票价的具体信息，两者都是预订所必需的（MAX 15；MIN 1）。预订时需要（MAX 15；MIN 1）。
示例：HL7LNRHL7LNR

fare_class_code 字符串
航空公司的票价等级代码（最多 1 个；最少 1 个）。数值可以是字母（A-Z），但根据航空公司的定义可能会有所不同。请查看航空公司信息参考。
示例：YY

flight_number 字符串
航空公司分配的航班号（最多 5 个；最少 1 个）。
例如：842

stopover_code 字符串
中途停留代码（1 个字母的代码，表示是否允许乘客中途停留。中途停留。只允许使用两种字符：O：允许中途停留（字母 "O"，非零）/ X：中途停留不不允许中途停留）。
示例：OO

passengers 对象数组

指定代表与机票关联的乘客的对象数组。

country 枚举
文件签发国（最多 2 个；最少 2 个； ISO 3166-1).
可能的枚举值：查看国家参考信息。

date_of_birth 字符串
乘客的出生日期，格式为 YYYY-MM-DD （最大 10；最小 10）。
例如：1990-02-28

document 反对

指定乘客的文件对象。

document_number 字符串
旅客证件号码（最多 40 个；最少 3 个）。
例如：1093333333

document_type 枚举
乘客的证件类型（最多 6 个，最少 2 个）。
可能的枚举值：检查国家参考。

phone 反对

指定乘客的电话对象。

country_code 字符串
乘客电话的国家呼叫代码（最多 3 个；最少 1 个）。
可能的值：检查国家参考

number 字符串
乘客的电话号码，不含国家代码（最多 32 个；最少 1 个）。
例如：1130292837

email 字符串
乘客的email （最多 255 个；最少 3 个）。
例如[email protected］

first_name 字符串
乘客姓名（最多 255 个；最少 3 个）。
举例说明：约翰

last_name 字符串
乘客姓氏（最多 255 个；最少 3 个）。
例子无名氏

loyalty_number 字符串
乘客忠诚计划数量（最多 20 个，最少 1 个）。
例如：254587547

loyalty_tier 枚举
乘客忠诚度计划的级别（最多 255 级；最少 3 级）。
可能的枚举值：检查忠诚度层级。

middle_name 字符串
乘客的中间名（最多 255 个；最少 3 个）。
例子查尔斯

nationality 枚举
乘客的国籍（最多 2 个；最少 2 个； ISO 3166-1).
可能的枚举值：查看国家参考信息。

type 枚举
乘客类型（MAX 1；MIN 1）。
可能的枚举值：检查乘客类型列表。

tickets 对象数组

指定与乘客相关的车票数组。

ticket_number 字符串
票号（最多 14 个；最少 1 个）。
例如：7411823255523

e_ticket 布尔
这是电子机票吗？
可能的值： True 或 False

restricted 布尔
表示机票是否可以退票。
可能的值： True 或 False

total_fare_amount 浮动
以最小货币单位（0.0001 的倍数）表示的票价总额。
例如：80000

total_tax_amount 浮动
以最小货币单位（0.0001 的倍数）表示的总税额。
例如：14800

total_fee_amount 浮动
以最小货币单位（0.0001 的倍数）表示的费用总额。
例如：25200

issue 反对

指定问题对象。

address 字符串
售票代理地址（最多 255 个；最少 3 个）。
例如：Apartamento 502, Torre I：Apartamento 502, Torre I

zip_code 字符串
售票代理的邮政编码。
例如：1636

carrier_prefix_code 字符串
签发或验证承运人。这是 AWB 前缀（航空运单）IATA 3 位数字代码（MAX 3；最小 3).
例如：044

city 字符串
售票代理的城市名称（最多 255 个；最少 3 个）。
例如：波哥大波哥大

country 枚举
出票地的国家代码（最多 2 个；最少 2 个； ISO 3166-1).
可能的枚举值：检查国家代码列表。

date 字符串
出票日期。
例如：1979-01-12

travel_agent_code 字符串
出票旅行社的代码。
例如：10655823

travel_agent_name 字符串
销售点在代理列表或特许经营名称中的名称（MAX 32；最小 1).
举例说明：ACME 代理公司

booking_system_code 字符串
出票预订系统的代码。(最大 255；最小 1）。
例如TEST001

booking_system_name 字符串
出票预订系统的名称。(最大 255；最小 1）。
示例：预订系统预订系统

transport 反对

指定传输对象。

id 字符串
运输工具的 ID（最大 255；最小 1）。
示例：ASONDAKS-1234ASONDAKS-1234

order 反对

指定订单对象。

shipping_amount 浮动
订单的运费金额（0.0001 的倍数）。此字段仅供参考，运费金额已包含在最终交易金额中，不会单独添加。
例如5190

fee_amount 浮动
订单的手续费金额（0.0001 的倍数）。此字段仅供参考，手续费金额已包含在最终交易金额中，不会单独添加。
例如：789.50

tip_amount 浮动
订单的小费金额（0.0001 的倍数）。此字段仅供参考，小费金额已包含在最终交易金额中，不会单独添加。
例如：215.10

sales_channel 字符串
payment的销售渠道 ID。(最小：3，最大：255）
示例：AA01AA01

taxes 对象数组

指定订单的税务对象。

type 字符串
税种。
举例说明：增值税

tax_base 浮动
适用所定义税额的基数。
例如：10000

value 浮动
税额。
例如：2100

percentage 浮动
税款的百分比。
例如：21

items 对象数组

指定项目的对象。

id 字符串
项目的唯一标识符（最多 255 个；最少 3 个）。
例如3214

name 字符串
项目名称（最多 255 个；最少 3 个）。
示例：iPhone 12 Pro Max

quantity int
项目数量（最大 999；最小 1）。
示例：1

unit_amount 浮动
项目的单位金额（0.0001 的倍数）。
例如550

category 字符串
项目类别（最多 255 个；最少 3 个）。
可能的值：检查项目类别列表。

brand 字符串
物品的品牌（最多 255 个；最少 3 个）。
举例说明：苹果公司

sku_code 字符串
物品的库存单位 (SKU)（最多 255 个；最少 3 个）。
示例：A2342A2342

manufacture_part_number 字符串
物品的生产零件编号（最多 255 个；最少 3 个）。
例如345621234

discounts 对象数组

指定订单的折扣对象。

id 字符串
折扣 ID（最大 255；最小 3）。
例如：10OFF

name 字符串
折扣名称（最多 255 个；最少 3 个）。
举例说明：报价

unit_amount 浮动
折扣金额（0.0001 的倍数）。
例如：100

tickets 对象数组

指定机票对象。

id 字符串
票据 ID（最小：1，最大：255）
例如3214

name 字符串
票据名称（最小：1，最大：255）
例如：音乐会音乐会

description 字符串
机票描述（最小：1，最大：255）
例如：音乐会音乐会

type 枚举
机票类型
虚拟/物理

amount 反对

指定payment 金额对象，包括金额和货币。

currency 枚举
用于payment 的货币（MAX 3; MIN 3； ISO 4217).
可能的枚举值：查看国家参考信息。

value 编号
payment 金额（0.0001 的倍数）。
例如：111111

event 反对

指定事件详细信息对象。

id 字符串
与票据相关的事件的 ID
示例：AA01AA01

name 字符串
事件名称（最小：1，最大：255）
示例：音乐音乐

description 字符串
事件描述（最小：1，最大：255）
例如：节日

type 枚举
活动类型
派对、大学、节日、马戏团、体育、电影院、剧院、音乐会等。

date 日期
活动日期
例如：2025-10-25

address 反对

指定事件的地址对象。

address_line_1 字符串
事件的主地址行（最多 255；最少 3）。
例如：Calle 34 # 56 - 78Calle 34 # 56 - 78

address_line_2 字符串
事件的二级账单地址行（最多 255 个；最少 3 个）。
例如：Apartamento 502, Torre I：Apartamento 502, Torre I

city 字符串
事件地址考虑的城市（最多 255 个；最少 3 个）。
例如：波哥大波哥大

country 枚举
事件地址考虑的国家（最多 2 个；最少 2 个、ISO 3166-1).
可能的枚举值：检查国家代码列表。

state 字符串
事件地址的状态（最大 255；最小 3）。
实例：昆迪纳马卡省昆迪纳马卡

zip_code 字符串
事件地址的邮编（最多 11 个；最少 4 个）。
例如：111111

shipping 反对

指定装运详情对象。

type 枚举
运输类型。
举例说明：标准
可能的枚举值：检查发货参考。

description 字符串
运输描述（最大 255；最小 1）。
举例说明：运送样品衬衫

carrier 枚举
用于递送的承运人。
例如不间断电源
可能的枚举值：检查发货参考。

deliver_at 时戳
预计交货日期（ISO 8601 MAX 27；MIN 27）。
Example: 2025-09-17T20:43:54.786342Z

account_funding 反对

指定转账和付款的账户资金结构。

sender 反对

指定发件人信息。

national_entity 枚举
发件人的国家实体类型。可能的值：

INDIVIDUAL
ENTITY

first_name 字符串
发件人姓名（最多 80 个）。
举例说明：约翰

last_name 字符串
发件人姓氏（最多 80 个）。
例子无名氏

legal_name 字符串
收件人的法定姓名。必须填写 national_entity 是 ENTITY (MAX 80）。
例如：Arcos dorados S.A：Arcos dorados S.A.

email 字符串
发件人email （最多 255 个；最少 3 个）。
例如[email protected］

country 枚举
发件人国家（最多 2 个；最少 2 个； ISO 3166-1).
可能的枚举值：查看国家参考信息。

date_of_birth 日期
发件人在 YYYY-MM-DD 格式（最大 10；最小 10）。
例如：1990-02-28

phone 反对

指定电话对象。

country_code 字符串
发件人电话国家代码（最多 3 个；最少 2 个）。
例如57

number 字符串
发件人电话号码（最多 32 个；最少 1 个）。
例如3132450765

document 反对

指定文档对象。

document_number 字符串
发件人的国家证件 ID（最多 40 个；最少 3 个）。
例如：1093333333

document_type 枚举
发件人的文件类型（最多 6 个；最少 2 个）。
示例：CC

address 反对

指定地址对象。

address_line_1 字符串
主要账单地址（最多 255 个；最少 3 个）。
例如：Calle 34 # 56 - 78Calle 34 # 56 - 78

address_line_2 字符串
第二账单地址（最多 255 个；最少 3 个）。
例如：Apartamento 502, Torre I：Apartamento 502, Torre I

city 字符串
账单地址的城市（最多 255 个；最少 3 个）。
例如：波哥大波哥大

country 枚举
账单地址的国家（ISO 3166-1；最多 2 个；最少 2 个）。
例如二氧化碳

state 字符串
账单地址所在州或省（最多 255 个；最少 3 个）。
实例：昆迪纳马卡省昆迪纳马卡

zip_code 字符串
账单地址的邮政编码（最多 11 个；最少 4 个）。
例如：111111

recipient 反对

指定收件人信息。

national_entity 枚举
收件人的国家实体类型。可能的值：

INDIVIDUAL
ENTITY

first_name 字符串
发件人姓名（最多 80 个）。
举例说明：约翰

last_name 字符串
发件人姓氏（最多 80 个）。
例子无名氏

legal_name 字符串
收件人的法定姓名。必须填写 national_entity 是 ENTITY (MAX 80）。
例如：Arcos dorados S.A：Arcos dorados S.A.

email 字符串
收件人email （最多 255 个；最少 3 个）。
例如[email protected］

country 枚举
收件人国家（最多 2 个；最少 2 个； ISO 3166-1).
可能的枚举值：查看国家参考信息。

date_of_birth 日期
受助人的出生日期在 YYYY-MM-DD 格式（最大 10；最小 10）。
例如：1985-07-15

phone 反对

指定电话对象。

country_code 字符串
收件人电话的国家代码（最多 3 个；最少 2 个）。
例如57

number 字符串
收件人电话号码（最多 32 个；最少 1 个）。
例如3132450765

document 反对

指定文档对象。

document_number 字符串
收件人的国家证件 ID（最多 40 个；最少 3 个）。
例如：1093333333

document_type 枚举
收件人的文件类型（最多 6 个；最少 2 个）。
示例：CC

address 反对

指定地址对象。

address_line_1 字符串
主要账单地址（最多 255 个；最少 3 个）。
例如：Calle 34 # 56 - 78Calle 34 # 56 - 78

address_line_2 字符串
第二账单地址（最多 255 个；最少 3 个）。
例如：Apartamento 502, Torre I：Apartamento 502, Torre I

city 字符串
账单地址的城市（最多 255 个；最少 3 个）。
例如：波哥大波哥大

country 枚举
账单地址的国家（ISO 3166-1；最多 2 个；最少 2 个）。
例如二氧化碳

state 字符串
账单地址所在州或省（最多 255 个；最少 3 个）。
实例：昆迪纳马卡省昆迪纳马卡

zip_code 字符串
账单地址的邮政编码（最多 11 个；最少 4 个）。
例如：111111

seller_details 反对

指定卖方的详细信息对象。

name 字符串
卖方法定姓名（最多 255 个；最少 3 个）。
示例：Jhon Doe无名氏

email 字符串
卖方电子邮件（最多 255 个；最少 3 个）。
例如[email protected］

reference 字符串
卖方识别代码（最多 255 个；最少 3 个）。
举例说明：卖方

website 字符串
卖方网站 URL（最多 255 个；最少 3 个）。
例如：https://www.test.com/1231324

industry 枚举
卖方行业（最多 255 个；最少 3 个）。
可能的枚举值：检查行业类别。

merchant_category_code 字符串
MCC - 商户类别代码（最多 235 个；最少 1 个）。
例如：6199

country 枚举
卖方所在国家（最多 255 个；最少 3 个）。
可能的枚举值：检查国家代码列表。

document 反对

指定卖方的文档对象。

document_number 字符串
卖方文件编号（最多 40 个；最少 3 个）。
例如：1093333333

document_type 枚举
卖方文件类型（最多 6 个，最少 2 个）。
可能的枚举值：检查国家参考。

phone 反对

指定卖方的电话号码对象。

country_code 字符串
卖方电话的国家代码（最多 3 个；最少 1 个）。可能的值：检查国家参考.
例如57

number 字符串
卖方电话号码，不含国家代码（最多 32 个；最少 1 个）。
例如3132450765

address 反对

指定卖方的地址对象。

address_line_1 字符串
卖方的主地址行（最多 255 个；最少 3 个）。
例如：Calle 34 # 56 - 78Calle 34 # 56 - 78

address_line_2 字符串
卖方的二级账单地址行（最多 255 个；最少 3 个）。
例如：Apartamento 502, Torre I：Apartamento 502, Torre I

city 字符串
卖方地址考虑的城市（最多 255 个；最少 3 个）。
例如：波哥大波哥大

country 枚举
卖方地址考虑的国家（最多 2 个；最少 2 个、ISO 3166-1).
可能的枚举值：检查国家代码列表。

state 字符串
卖方地址的州名（最多 255 个；最少 3 个）。
实例：昆迪纳马卡省昆迪纳马卡

zip_code 字符串
卖方地址的邮编（最多 11 个；最少 4 个）。
例如：111111

transportations 对象数组

指定运输对象数组。

id 字符串
运输预订的 id（最大 255；最小 1）。

description 字符串
运输预订说明（最大 255；最小 1）。

type 字符串
预订的交通工具类型。

legs 对象数组

指定对象的脚数组。

order 整数
运行指数（以 1 开头），描述同一路线中各段的顺序。

route_order 整数
运行索引（以 1 开头），描述按时间排列的路线顺序。

departure_country 字符串
出发地国家（最多 2 个；最少 2 个；ISO 3166-1）。

departure_city 字符串
出发城市（最多 255 个；最少 1 个）。

departure_timezone 字符串
出发时区（最多 6 个；最少 6 个）。

departure_datetime 字符串
出发日期和时间（出发时的当地时间）。

departure_reference 字符串
出发的参考值（最大 255；最小 1）。

arrival_country 字符串
抵达国家（最多 2 个；最少 2 个；ISO 3166-1）。

arrival_city 字符串
到达城市（最大 255；最小 1）。

arrival_timezone 字符串
抵达时区（最多 6 个；最少 6 个）。

arrival_datetime 字符串
抵达日期和时间（当地时间）。

arrival_reference 字符串
到达的参考值（最大 255；最小 1）。

transport 反对

指定传输对象。

id 字符串
运输工具的 ID（最大 255；最小 1）。

type 字符串
运输工具的类型。

description 字符串
运输工具描述（MAX 255；MIN 1）。

transactions 反对

指定与payment相关的交易详情。

id 字符串
交易的唯一标识符（最多 64 个；最少 36 个）。
Example: 7bf8f1f6-4081-41ec-a024-a927056e00ab

type 字符串
交易类型。
例如购买

status 枚举
交易状态。
举例说明：SUCCEEDED

category 字符串
交易中使用的payment 方式类别。
举例说明：卡

amount 字符串
交易金额。
例如：100

provider_id 字符串
处理交易的提供商的 ID。
例如DLOCAL

payment_method 反对

指定交易中使用的payment 方式详细信息。

vaulted_token 字符串
穹顶的token 先前存储的payment.如果使用如果付款是使用 vaulted_token 创建的，则无需同时发送token ，可将其定义为空（最大值：64；最小值：36）。
Example: 8604911d-5ds9-229e-8468-bd41abear14s

type 字符串
payment 方式类型。必须为 DIRECT 或 REDIRECT 工作流程。集成钱包时必须使用，即使使用 SDK 也是如此。
可能的枚举值：
可能的枚举值：检查payment 类型参考。

vault_on_success 布尔
payment成功后，标记为enroll 该卡。
可能的值： True 或 False

token 字符串
一次性使用支付方式token 由 Yuno sdk 提供.如果使用 token创建支付，则无需同时发送 vaulted_token，可将其定义为空。对于背对背支付（最大：64；最小：36）。
示例： 5104911d-5df9-229e-8468-bd41abea1a4s5104911d-5df9-229e-8468-bd41abea1a4s

parent_payment_method_type 枚举
使用钱包通过直接集成该字段表示从哪个提供商获取的银行卡信息。
例如APPLE_PAY

detail 反对

指定payment 方式详情对象，该对象提供不同交易类别的详情。类别类型的详细信息。

card 反对

指定使用银行卡时payment 方式的详细信息。

verify 布尔
使用 amount = 0 和 verify = true，可以在不授权真实金额的情况下验证用户卡。金额。
可能的值： True 或 False

capture 布尔
决定是授权payment 还是抓取payment 。授权银行卡payment 可让您以在客户的银行账户中预留资金。
可能的值： True 或 False

installments 整数
卡片分期付款（最多 50；最少 1）。
例如3

first_installments_deferral 整数
从第一笔分期付款中扣款的等待月数。
示例：1

installments_type 字符串
银行卡payment中使用的分期付款类型。
示例：字符串

installments_amount 整数
分期付款金额包括与分期付款相关的利息，信息信息由提供方定义。
例如3

soft_descriptor 字符串
每笔交易传递给平台的描述符。它将显示在客户的实体银行对账单（最多 15 个；最少 0 个）。
示例：公司1

authorization_code 字符串
收单机构的回复代码。
例如：742A64

retrieval_reference_number 整数
收单机构分配给授权的唯一标识符。在巴西，您将收到 nsu。
例如：200000000012

voucher 字符串
发卡银行为银行卡交易分配的付款收据的唯一标识符。的唯一标识符。如果gateway 不提供交易信息，则此字段为空（MAX 255; MIN 3).
例如43564

card_data 反对

指定卡的详细信息。

holder_name 字符串
持卡人在卡上的全名（最多 26 个；最少 3 个），仅适用于 PCI 认证的商家。
范例：范妮-魏斯纳特

iin 整数
发卡行识别码 (IIN) 是指金融机构发行的payment 卡号的前几位数字（最多 8 位；最少 6 位）。发卡行识别码（IIN）是指金融机构发行的支付卡卡号的前几位数字（最多 8 位；最少 6 位）。
例如41961111

lfd 整数
密码卡的最后四位数字（最多 4 位；最少 4 位）。
例如：0010

number_length 整数
卡片号码的长度（最长 2；最短 1）。
例如：16

security_code_length 整数
银行卡安全码的长度（最大 1；最小 1）。
例如3

brand 字符串
卡片的品牌信息（最多 255 个；最少 3 个）。
例如VISA

issuer_name 字符串
发卡机构（最多 255 个；最少 3 个）。
例如：加利西亚银行加利西亚银行

category 字符串
发卡机构的类别（最多 255 个；最少 3 个）。
举例说明：黄金

type 字符串
发卡机构类型（最多 255 个；最少 3 个）。
例如信用卡、借记卡或充值卡

fingerprint 字符串
当客户多次注册与一个或多个 Yuno 账户相关的信用卡时，将生成多个 vaulted_tokens，但fingerprint 可让您识别客户使用的是同一张卡（最多 255 个；最少 3 个）。
例如： 55a7fe38-cdc3-45dc-8c5f-820751799c7655a7fe38-cdc3-45dc-8c5f-820751799c76

three_d_secure 反对

指定 3DS 交易的详细信息。

three_d_secure_setup_id 字符串
为 3DS Direct 流程指定的设置 ID。
Example: 24127d61-b852-42fb-acd4-1ee661645376

version 枚举
指所使用的 EMV 3-D Secure 规范的协议版本。1.0, 2.0, 2.1.0, 2.2.0, 2.2.1.
示例：2.2.1

electronic_commerce_indicator 字符串
该字段必须根据 ECI 字段由 3d Secure 服务提供的字段。电子商务指标（ECI）会告知发卡机构交易是否受 VbV 或 MCSC 等安全协议保护。是否受到 VbV 或 MCSC 等安全协议的保护。威士卡和万事达卡规定威士卡和万事达卡规定，所有 3-D 安全交易都必须在授权request 中填入该值（最大值：2，最小值：0）、最小值：0）。
例如：04

cryptogram 字符串
该字段必须使用由 3DSecure 服务。在 Visa 交易中，它代表持卡人身份验证验证值（CAVV 值 (CAVV)，这是发卡行生成的加密值，作为在线购买时payment 验证的证据，以获得payment 保护。 CAVV 是由发卡机构生成的加密值，作为在线购买时的支付验证证据，以获得退款保护。万事达卡交易有一个类似的值，称为 "持卡人验证值（AAV）"或 "通用持卡人验证字段（Universal Cardholder Authentication Field）"。通用持卡人验证字段 (UCAF)。提交交易授权时在提交交易授权时，商家必须包含 CAVV 或 AAV/UCAF，以证明持卡人已通过验证。它通常采用 base64 编码（最大值：40，最小值：0）。
例如BA0BB1Z3N5Q4kjkBU3c3ELGUsJY =

transaction_id 字符串
用于 3DS v1：这是唯一交易标识符。它由 MPI 自动生成。它通常长度为 28 字节，采用 base64 编码。通常称为 XID（最大：40，最小：0）： 0). 对于 3DS v2：由 DS 分配的通用唯一事务标识符，用于标识单个事务。 (最大：36，最小：36）。
Ex for V1："TjY0MjAxRjA4MD4987DUzMzYyNjU=" Ex for V2：“c4e59ceb-a382-4d6a-bc87-385d591fa09d”

directory_server_transaction_id 字符串
万事达目录服务器在身份验证过程中生成的交易 ID（最多 255 个；最少 3 个）。 255；最少 3）。
Example: f38e6948-5388-41a6-bca4-b49723c19437

pares_status 字符串
表示持卡人在 3-D 安全过程中的身份验证结果。它告诉你验证是否成功（Y）、失败（N）、无法完成（U）或只是尝试（A）。
示例：YY

acs_id 字符串
访问控制服务器 (ACS) 在 3-D 安全认证过程中提供的唯一标识符。
例如ACS-1234567890

network_token 反对

交易使用的网络token 信息。如果适用。

network 枚举
与所提供的token 相关联的提供商。visa、mastercard、american_express。
例如万事达卡

status 枚举
付款方式token 的状态。CREATED、激活、暂停、取消。
例如活动

par 字符串
Payment 账户编号。
例如MCC123456789012

token_data 反对

Token 详情。

number 编号
[必填] 不带任何分隔符的Token编号（最多 19 个；最少 8 个），仅适用于 PCI 认证商家。
例如450799000001234

holder_name 字符串
持卡人在Token 上的全名（最多 26 个；最少 3 个）。
例子无名氏

iin 编号
机构识别码 (IIN) 是指金融机构发行的网络token 号码的前几位数字（最多 8 位；最少 6 位）。
例如45079900

lfd 编号
网络token 的最后四位数字（最多 4 位；最少 4 位）。
例如：1234

expiration_month 编号
网络Token的到期月份（MM）（最多 2 个；最少 2 个）。
例如：12

expiration_year 编号
网络Token的到期年份（YYYY）（最多 4 个；最少 2 个）。
例如：2027 年

cryptogram 字符串
[必填] - 发卡机构为交易中使用的网络token 生成的唯一密码。

electronic_commerce_indicator 字符串
[仅某些提供商需要] - 如果token 已通过万事达卡验证，该字段应设置为 02。对于 Visa 或未经验证的tokens，则无需发送该字段。

token_requestor_id 字符串
[商户的Token 申请者 ID

response 反对

网络交易详情。

code 编号
服务提供商的响应代码。
示例：成功

message 编号
服务提供商的响应代码。
示例：交易成功

stored_credentials 反对

表示交易的处理类型。

reason 枚举
枚举：CARD_ON_FILE, SUBSCRIPTION, UNSCHEDULED_CARD_ON_FILE
举例说明：订阅

usage 枚举
该字段用于说明金库令牌/网络令牌是首次用于payment ，还是已用于之前的payment。枚举：首次, 已用
举例说明：使用过

subscription_agreement_id 字符串
该字段用于标明与客户签订的订购协议的标识。主要用于 MX（最大 255；最小 3）。
示例：AA0001AA0001

network_Transaction_id 字符串
由银行卡网络分配给交易的唯一标识符。它用于跟踪和参考特定交易，特别是在循环payment 情况下，确保整个payment 周期的一致性和可追溯性（最多 255 个；最少 3 个）。
例如583103536844189

wallet 反对

指定使用钱包时payment 方式的详细信息。

verify 布尔
使用 amount = 0 和 verify = true，可以在不授权真实金额的情况下验证用户卡。金额。
可能的值： True 或 False

cryptogram 字符串
与银行卡钱包直接集成的密码图（最多 526 个；最少 3 个）。

capture 布尔
决定是授权payment 还是抓取payment 。授权银行卡payment 可让您以在客户的银行账户中预留资金。
可能的值： True 或 False

installments 整数
卡片分期付款（最多 50；最少 1）。
例如3

payment_method_id 字符串
用户钱包中使用的payment 方式。
例如：信用卡

detail 字符串
钱包中使用的payment 方式详情。
例如：签证

money_release_date 日期
供应商提供的资金可以使用的日期。
Example: 2022-05-09T00:00:00.000000Z

sponsor_id 字符串
合作伙伴的供应商账户（最多 255 个；最少 3 个）。
例如4562103

authorization_code 字符串
获取响应代码。
例如：742A64

expires_at 时戳
Payment 方式到期日期。"yyyyy-MM-dd HH:mm:ss.SSSz"
Example: 2026-05-09T20:46:54.786342Z

customer_data 反对

指定客户的详细信息。

email 字符串
客户的email （最多 255 个；最少 3 个）。
例如[email protected］

first_name 字符串
客户姓名（最多 32 个，最少 8 个）。
举例说明：约翰

last_name 字符串
客户姓氏（最多 32 个，最少 8 个）。
例子无名氏

username 字符串
客户在平台中的用户名（最多 32 个，最少 8 个）。
示例：John_Doe_01约翰_多伊_01

identification_type 字符串
客户的文件类型（最多 32 个，最少 8 个）。
检查国家编号。例如DNI

identification_number 字符串
客户标识号（最多 32 个，最少 8 个）。
例如34566123

fee_details 反对

指定费用详情。

amount 浮动
交易金额（0.0001 的倍数）。
例如40.5

card_data 反对

指定卡的详细信息。

iin 整数
发卡行识别码 (IIN) 是指金融机构发行的payment 卡号的前几位数字（最多 8 位；最少 6 位）。发卡行识别码（IIN）是指金融机构发行的支付卡卡号的前几位数字（最多 8 位；最少 6 位）。
例如45079900

lfd 整数
密码卡的最后四位数字（最多 4 位；最少 4 位）。
例如：0010

number_length 整数
卡片号码的长度（最长 19；最短 8）。
示例：19

security_code_length 整数
银行卡安全码的长度（最大 1；最小 1）。
例如3

brand 字符串
卡片的品牌信息（最多 255 个；最少 3 个）。
例如：签证

holder_name 字符串
持卡人在卡上的全名（最多 26 个；最少 3 个），仅适用于 PCI 认证的商家。
示例：JOHN DOE约翰-多

bnpl 反对

指定使用 BNPL 时payment 方式的详细信息。

installments 整数
贷款分期付款（最多 50；最少 1）。
例如：10

provider_image 字符串
提供商的 URL（最多 255 个；最少 3 个）。
例如：https://www.company.com/

redirect_url 字符串
包含完整版票据的 URL，以防您想将客户重定向（MAX 255; 最小 3).
例如：https://www.company.com/ticket_1231324

expires_at 时戳
Payment 方式到期日期。"yyyyy-MM-dd HH:mm:ss.SSSz"
Example: 2026-05-09T20:46:54.786342Z

customer_data 反对

指定客户的详细信息。

name 字符串
客户的法定姓名（最多 32 个，最少 8 个）。
举例说明：法定名称

username 字符串
客户在提供商平台上的用户名（最多 32 个，最少 8 个）。
示例：Legal_name_01法律名称_01

tax_id_type 字符串
客户税号标识符（最多 32 个，最少 8 个）。
例如CUIT

tax_id 字符串
客户的税务识别码（最多 32 个，最少 8 个）。
例如：20-34566123-7

type 字符串
信贷类型（最多 255 个；最少 3 个）。
举例说明：个人/企业

area 字符串
客户所属行业（最多 255 个；最少 3 个）。
举例说明：其他

role 字符串
客户在公司中的角色（最多 255 个；最少 3 个）。
例如业主

bank_transfer 反对

使用银行转账时，指定payment 方式的详细信息。

provider_image 字符串
提供商的 URL（最多 255 个；最少 3 个）。
例如：https://www.company.com/logo

account_type 字符串
银行账户类型（最多 255 个；最少 3 个）。
例如支票/储蓄

bank_name 字符串
与账户相关的银行名称（最多 255 个；最少 3 个）。
例如：加利西亚银行加利西亚银行

bank_id 字符串
当服务商要求选择银行时，所选银行的标识符。仅当商户发送了值时返回。
示例：加利西亚