Metadata and routing logicFor routing logic to work correctly, metadata must also be set at the Checkout Session level. Setting it only on the Payment object will not trigger route logic.
string
The unique identifier of the customer (MAX 64 ; MIN 36).Example: 8546df3a-b83e-4bb5-a4b3-57aa6385924f
string
The unique identifier of the account (MAX 64; MIN 36).Example: 9104911d-5df9-429e-8488-ad41abea1a4b
string
The description of the payment (MAX 255; MIN 3).Example: Purchase on web
enum
Country where the transaction must be processed (MAX 2; MIN 2; ISO 3166-1 ).Possible enum values: Check the Country reference.
enum
The status of the transaction.Example: SUCCEEDED
enum
It is a complement to the status information.Example: DECLINED
string
The unique identifier of the customer’s order (MAX 255; MIN 3).Example: 0000023
timestamp
The date and time when the payment was created.Example: 2022-05-09T20:46:54.786342Z
timestamp
The date and time of last update for the payment.Example: 2022-05-09T20:46:54.786342Z
string
optionalThe idempotency key sent when creating the payment; present when the payment was created with an idempotency key.Example: fc0d89a1-8d18-4759-8d0a-ee1c6d0386e2
string
optionalThe account code associated with the payment (account identifier).Example: 26a6626c-d3ec-4caa-bf7c-a994b145dc00
string
optionalPresent when the payment was created via a payment link; identifies the payment link used.Example: (empty string when not from a payment link)
string | null
optionalPresent when the payment is associated with a subscription; the subscription identifier.Example: null
string
optionalThe
id of the plan the subscription was on when this payment was created. Present only on a payment created with subscription.plan_id and on the renewal payments Yuno generates for that subscription. Absent on every other payment. See Create a subscription from a plan.Example: 14898a9d-5a75-433d-ba17-f2ea5b33620cstring
optionalWhen the plan was assigned to the subscription, in UTC (ISO 8601). Present only on payments that carry
plan_id.Example: 2026-09-24T22:53:42.814482Zboolean
optionalIndicates whether the payment was created in simplified mode (e.g. for certain flows such as subscription or retry).Example: false
object
Specifies the payment amount object, with the value and currency.
Show properties
Show properties
enum
The currency used to make the payment (MAX 3; MIN 3; ISO 4217 ).Possible enum values: Check the Country reference.
number
The payment amount (multiple of 0.0001). With a Yuno promotion it is the amount you sent, before the discount: Yuno charges
value minus discount_amount.Example: 111111object
Specifies the currency conversion object.
number
The refund amount (multiple of 0.0001). With a Yuno promotion it is counted on the amount charged, so a full refund equals
value minus discount_amount.Example: 111111number
The captured amount (multiple of 0.0001). With a Yuno promotion it is counted on the amount charged.Example: 111111
object
optionalThe total discount of the Yuno promotion applied to the payment: the sum of the
YUNO_PROMOTION lines of additional_data.order.discounts. Absent when no promotion applied. The amount charged is amount.value minus this value, and it is on transactions.amount. See Promotions.object
Specifies the checkout object. This object is not mandatory for back to back payments. Required when
WORKFLOW is defined as CHECKOUT or is not sent. Not required for DIRECT
payments.array of objects
Specifies a list of custom key–value pairs associated with the payment (for internal references, segmentation, or workflow tags). You can add up to 120 metadata objects.
Show properties
Show properties
object
Specifies a metadata key and the respective value.Use to attach merchant-defined context (for example:
order_id, customer_tier). Avoid sending sensitive or personal data.object
Specifies the payment_method object.
Show properties
Show properties
string
The vaulted_token represents a securely stored payment_method associated with a previous transaction. When
utilizing a vaulted_token for creating a payment, there is no need to send an additional token; it can be set as
null (MAX: 64; MIN: 36).This field is returned in the payment response when
vault_on_success = true and the payment status is SUCCEEDED, provided the payment references an existing Yuno customer through customer_payer.id.Example: 8604911d-5ds9-229e-8468-bd41abear14senum
Payment method type. Mandatory for
DIRECT or REDIRECT workflow. Required when integrating wallets, even when using the SDK.Possible enum values:Possible enum values: check the payment type reference.boolean
Flag to enroll the card after a successful payment. Requires the payment to reference an existing Yuno customer through
customer_payer.id .When set to true and the payment status is SUCCEEDED, the payment response will include a vaulted_token that can be used for future transactions. Without a customer ID no vaulting occurs and no vaulted_token is returned, even if customer details are included inline.Possible values: True or Falsestring
The one time use payment method token provided by Yuno sdk . If a payment is created using a token,
it is not necessary to send a vaulted_token as well, it can be defined as null. Not necessary for back to back
payments (MAX: 64; MIN: 36).Example: 5104911d-5df9-229e-8468-bd41abea1a4s
object
Specifies the payment method detail object, which provides details of the different transaction category
types that are part of the payment method object.
Show properties
Show properties
object
Specifies the details of the payment method when using a card.
Show properties
Show properties
boolean
Using amount = 0 and verify = true, you can verify the user’s card without authorizing a real
amount.Possible values:
True or Falseboolean
Decides whether to authorize the payment or capture it. Authorizing a card payment allows you to
reserve funds in a customer’s bank account.Possible values:
True or Falseinteger
The card installments (MAX 50; MIN 1).Example: 3
integer
Number of months to wait to debit the first installment.Example: 1
string
Defines the type of installments.Example: string
integer
The installment amount includes interests associated with the installment and the information is
defined by the provider.Example: 3
string
The descriptor passed per transaction to our platform. It will be presented on the customer’s
physical bank statement (MAX 15; MIN 0).Example: COMPANY1
string
The acquirer’s response code.Example: 742A64
string
The unique identifier assigned by an acquirer to an authorization. In case of Brazil, you’ll receive the nsu.Example: 200000000012
string
The unique identifier assigned by the card acquirer to track the transaction through the card network. Used for reconciliation and chargebacks.For providers that return an acquirer reference (for example, Adyen), this field carries that value, and
retrieval_reference_number may be empty for those providers.Example: 7C9F8E2A1B3Dstring
The unique identifier of the payment receipt assigned by the issuing bank for a card transaction.
This field is empty if the gateway does not provide information about the transaction (MAX 255; MIN 3).Example: 43564
object
Specifies the details of the card.
Show properties
Show properties
string
Card holder’s full name as it appears on the card (MAX 26; MIN 2) only available for PCI
certified merchants.Example: Fannie Weissnat
string
User card country code (MAX 2; MIN 2).Example: US
integer
Card’s expiration month (MM) (MAX 2; MIN 2).Example: 03
integer
Card’s expiration year (YYYY) (MAX 4; MIN 2).Example: 2030
string
The issuer identification number (IIN) refers to the first few digits of the payment card
number issued by a financial institution (MAX 8; MIN 6).Example: 41961111
string
The last four digits of the card (MAX 4; MIN 4).Example: 0010
integer
The length of the card’s number (MAX 19; MIN 8).Example: 41961111
integer
The length of the card’s security code (MAX 1; MIN 1).Example: 3
string
The card’s brand information (MAX 255; MIN 3).Example: VISA
string
The card’s issuer (MAX 255; MIN 3).Example: Banco Galicia
integer
The card’s issuer identification code (MAX 255; MIN 3).
string
The category of the card’s issuer (MAX 255; MIN 3).Example: Gold
string
The type of the card’s issuer (MAX 255; MIN 3).Example: CREDIT, DEBIT, or CHARGE_CARD
string
When a customer enrolls a credit card multiple times related to one or many Yuno accounts, multiple vaulted_tokens will be generated, but the fingerprint lets you identify when the same card is used for the customer (MAX 255; MIN 3).Example: 55a7fe38-cdc3-45dc-8c5f-820751799c76
object
Specifies the details of the 3DS Transaction.
Show properties
Show properties
string
Setup ID obteined for the 3DS Direct flow.Example: 24127d61-b852-42fb-acd4-1ee661645376
enum
Refers to the protocol version of the EMV 3-D Secure specification used. 1.0, 2.0, 2.1.0,
2.2.0, 2.2.1.Example: 2.2.1
string
This field must be completed with the result of the ECI field provided by the 3d Secure
service. The Electronic Commerce Indicator (ECI) informs the card issuer if the transaction was
protected by a security protocol like VbV or MCSC. It is mandated by Visa and MasterCard that all
3-D Secure transactions have this value populated in the authorization request (MAX: 2, MIN: 0).Example: 05
string
This field must be completed with the result of the cryptogram field provided by the 3DSecure
service. In Visa transactions, it represents the Cardholder Authentication Verification Value
(CAVV), a cryptographic value generated by the Issuer as evidence of payment authentication during
online purchase to qualify for chargeback protection. MasterCard transactions have a similar value
called Accountholder Authentication Value (AAV) or the Universal Cardholder Authentication Field
(UCAF). When submitting a transaction for authorization, the merchant must include the CAVV or
AAV/UCAF to demonstrate that the cardholder has been authenticated. It is typically base64-encoded.
(MAX: 40, MIN: 0).Example: BA0BB1Z3N5Q4kjkBU3c3ELGUsJY =
string
For 3DS v1:
This is the Unique Transaction Identifier. It is automatically generated by the MPI. It is typically
28 bytes in length and base64-encoded. Is commonly referred to as XID (MAX: 40, MIN: 0).
For 3DS v2:
Universally unique transaction identifier assigned by the DS to identify a single transaction. (MAX:
36, MIN:36).Ex for V1: “TjY0MjAxRjA4MD4987DUzMzYyNjU=”
Ex for V2: “c4e59ceb-a382-4d6a-bc87-385d591fa09d”
string
Transaction ID generated by the Mastercard directory server during authentication (MAX 255;
MIN 3).Example: f38e6948-5388-41a6-bca4-b49723c19437
object
Information about the network token used for the transaction. If applicable.
Show properties
Show properties
enum
The provider associated to the token provided. VISA, MASTERCARD, AMERICAN_EXPRESS.Example: MASTERCARD
enum
Status of the token for the payment method. CREATED, ACTIVE, SUSPENDED, CANCELED.Example: ACTIVE
string
Payment account reference.Example: MCC123456789012
object
Token details.
Show properties
Show properties
number
[Mandatory] - Token’s number without any separators (MAX 19; MIN 8) only available for PCI certified merchants.Example: 450799000001234
string
Cardholder’s full name as it appears on the Token (MAX 26; MIN 2).Example: John Doe
number
The Institution identification number (IIN) refers to the first few digits of a network token number issued by a financial institution (MAX 8; MIN 6).Example: 45079900
number
Last four digits of the network token (MAX 4; MIN 4).Example: 1234
number
Network Token’s expiration month (MM) (MAX 2; MIN 2).Example: 12
number
Network Token’s expiration year (YYYY) (MAX 4; MIN 2).Example: 2027
string
[Mandatory] - The unique cryptogram generated by the issuer for the network token in use in the transaction.
string
[Only required for certain providers] - In case the token has been authenticated by Mastercard the field should be set to 02. For Visa or not authenticated tokens, is not necessary to send the field.
string
[Only required for certain providers] - Token requestor ID of the merchant
object
Indicates the processing type of the transaction.
Show properties
Show properties
enum
Indicates the processing type of the transaction.Enum:CARD_ON_FILE, SUBSCRIPTION, UNSCHEDULED_CARD_ON_FILEExample: SUBSCRIPTION
enum
This field lets you indicate if this is the first time the vaulted_token/network_token is used for a payment or if it has already been used for a previous payment. Enum: FIRST, USEDExample: USED
string
This field lets you indicate the identification of the agreement with the customer for a subscription. Mainly for MX (MAX 255; MIN 3).Example: AA0001
string
Unique identifier assigned to a transaction by the card network. It is used to track and reference specific transactions, particularly in recurring payment scenarios, ensuring consistency and traceability across the payment lifecycle (MAX 255; MIN 3).Example: 583103536844189
object
Specifies the details of the payment method when using Buy Now Pay Later (BNPL).
Show properties
Show properties
integer
The loan installments (MAX 50; MIN 1).Example: 10
string
The provider’s URL (MAX 255; MIN 3).Example: https://www.company.com/
string
The URL with the full version of the ticket in case you want to redirect your customer (MAX 255;
MIN
3).Example: https://www.company.com/ticket_1231324
timestamp
Payment methods expiration date. “yyyy-MM-dd HH:mm:ss.SSSz”Example: 2026-05-09T20:46:54.786342Z
object
Specifies the details of the customer.
Show properties
Show properties
string
The customer’s legal name (MAX 32, MIN 8).Example: Legal name
string
Customer’s username in the provider platform (MAX 32, MIN 8).Example: Legal_name_01
string
The customer’s tax identifier (MAX 32, MIN 8).Example: CUIT
string
The customer’s tax identifier number (MAX 32, MIN 8).Example: 20-34566123-7
string
The credit’s type (MAX 255; MIN 3).Example: PERSONAL/BUSINESS
string
The customer’s industry (MAX 255; MIN 3).Example: OTHERS
string
The customer’s role in the company (MAX 255; MIN 3).Example: OWNER
object
Specifies the details of the payment method when using bank transfer.
Show properties
Show properties
string
The provider’s URL (MAX 255; MIN 3).Example: https://www.company.com/
string
Type of the bank account (MAX 255; MIN 3).Example: CHECKINGS/SAVINGS
string
Name of the bank associated with the account (MAX 255; MIN 3).Example: Banco Galicia
string
Identifier of the selected bank when the provider requires choosing one (MAX 255; MIN 1). Optional.Example: galicia
string
The name of the account holder (MAX 255; MIN 3).Example: John Doe
string
The number of the bank account (MAX 255; MIN 3).Example: 54653211313333
string
The secondary number of the bank account (MAX 255; MIN 3).Example: 78900000000123
string
Document type of the account holder (MAX 255; MIN 3).Possible values: Check the
Country reference. Example: DNI
string
Document number of the account holder (MAX 255; MIN 3).Example: 54666897
string
Reference code for the user (MAX 255; MIN 3).Example: AA01234-BC
string
The unique identifier assigned by an acquirer to an authorization.In case of Brazil, you’ll receive the nsu.Example: 200000000012
string
The unique identifier assigned by the card acquirer to track the transaction through the card network. Used for reconciliation and chargebacks.For providers that return an acquirer reference (for example, Adyen), this field carries that value, and
retrieval_reference_number may be empty for those providers.Example: 7C9F8E2A1B3Dstring
Payments instructions related to the payment (MAX 255; MIN 3).Example: Go to your bank account and transfer the amount using the reference detailed
below
string
The URL with the full version of the ticket in case you want to redirect your customer (MAX 255;
MIN
3).Example: https://www.company.com/ticket_1231324
timestamp
Payment methods expiration date. “yyyy-MM-dd HH:mm:ss.SSSz”Example: 2026-05-09T20:46:54.786342Z
object
Specifies the details of the payment method when using a wallet.
Show properties
Show properties
boolean
Using amount = 0 and verify = true, you can verify the user’s card without authorizing a real
amount.Possible values:
True or Falsestring
Cryptogram for direct integrations with card wallets (MAX 526; MIN 3).
timestamp
Payment methods expiration date. “yyyy-MM-dd HH:mm:ss.SSSz”Example: 2026-05-09T20:46:54.786342Z
boolean
Decides whether to authorize the payment or capture it. Authorizing a card payment allows you to
reserve funds in a customer’s bank account.Possible values:
True or Falseinteger
The card installments (MAX 50; MIN 1).Example: 3
string
The user’s payment method used in their wallet.Example: credit_card
string
The payment method’s detail used in their wallet.Example: visa
date
Date in which the money from the provider will be available to use.Example: 2022-05-09T00:00:00.000000Z
string
Partner’s provider account (MAX 255; MIN 3).Example: 4562103
string
Acquire’s response code.Example: 742A64
object
Specifies the details of the customer.
Show properties
Show properties
string
The customer’s email (MAX 255; MIN 3).Example: john.doe@email.com
string
The customer’s first name (MAX 32, MIN 8).Example: John
string
The customer’s last name (MAX 32, MIN 8).Example: Doe
string
The customer’s username in the platform (MAX 32, MIN 8).Example: John_Doe_01
string
The customer’s document type (MAX 32, MIN 8).Check the
Country reference. Example: DNI
string
The customer’s identification number (MAX 32, MIN 8).Example: 34566123
object
Specifies the details of the fees.
Show properties
Show properties
float
Amount of the transaction (multiple of 0.0001).Example: 40.5
object
Specifies the details of the card.
Show properties
Show properties
integer
The issuer identification number (IIN) refers to the first few digits of the payment card
number issued by a financial institution (MAX 8; MIN 6).Example: 45079900
integer
The last four digits of the card (MAX 4; MIN 4).Example: 0010
integer
The length of the card’s number (MAX 2; MIN 1).Example: 16
integer
The length of the card’s security code (MAX 1; MIN 1).Example: 3
string
The card’s brand information (MAX 255; MIN 3).Example: visa
string
Card holder’s full name as it appears on the card (MAX 26; MIN 2) only available for PCI
certified merchants.Example: JOHN DOE
object
Indicates the processing type of the transaction. In the create-payment request, this is the node to use for an Apple Pay or Google Pay CIT with
vault_on_success (usage: FIRST); later charges on the resulting vaulted_token use detail.card.stored_credentials. In the response, the wallet transaction returns this field as null and the value is carried on the CARD transaction under transactions[].payment_method.detail.card.stored_credentials. See Stored credentials.Show properties
Show properties
enum
Indicates the reason for storing credentials for the transaction.Enum:CARD_ON_FILE, SUBSCRIPTION, UNSCHEDULED_CARD_ON_FILEExample: SUBSCRIPTION
enum
This field lets you indicate if this is the first time the vaulted_token/network_token is used for a payment or if it has already been used for a previous payment. Enum: FIRST, USEDExample: USED
string
This field lets you indicate the identification of the agreement with the customer for a subscription. Mainly for MX (MAX 255; MIN 3).Example: AA0001
string
Unique identifier assigned to a transaction by the card network. It is used to track and reference specific transactions, particularly in recurring payment scenarios, ensuring consistency and traceability across the payment lifecycle (MAX 255; MIN 3).Example: 583103536844189
object
This structure is used to send additional information about recurrence. It’s optional, and few providers require it (e.g. Mercado Pago). Contact your TAM to confirm if it’s needed for your integration.
Show properties
Show properties
object
object
object
Specifies the
availability object. Defines a date interval based on starting and ending dates when the subscription is available to use.Show properties
Show properties
string
The start date that the subscription plan will be available to use. If not set, the subscription is available from the moment it is created.
start_at becomes mandatory when using finish_at .string
The end date that the subscription plan will be available to use. If not set, the subscription is available indefinitely.
finish_at becomes mandatory when using start_at .object
Specifies the details of the payment method when using ticket.
Show properties
Show properties
string
The ticket’s type.Example: number, barcode, custom, reference_code, qr
enum
User´s benefit type for ticket payment method. JUNAEB, PRIVATEExample: PRIVATE
integer
The ticket’s number.Example: 13141
string
The ticket’s barcode, as a text value. For the barcode image, see
provider_logo.Example: 456789009878765u7654string
The ticket’s logo.Example: https://www.company.com/logo
string
The ticket’s format.Example: barcode, custom
string
Payments instructions related to the payment (MAX 255; MIN 3).Example: Go to your closest store and pay the total amount using the reference detailed below
string
The URL with the full version of the ticket.Example: https://www.company.com/ticket_1231324
timestamp
Payment methods expiration date. “yyyy-MM-dd HH:mm:ss.SSSz”Example: 2026-05-09T20:46:54.786342Z
object
Specifies the details of the payment method when using a payment link.
Show properties
Show properties
boolean
Using amount = 0 and verify = true, you can verify the user’s card without authorizing a real
amount.Possible values:
True or Falseboolean
Decides whether to authorize the payment or capture it. Authorizing a card payment allows you to
reserve funds in a customer’s bank account.Possible values:
True or Falsetimestamp
Payment methods expiration date. “yyyy-MM-dd HH:mm:ss.SSSz”Example: 2026-05-09T20:46:54.786342Z
integer
The card installments (MAX 50; MIN 1).Example: 3
string
The user’s payment method used in their wallet.Example: credit_card
string
The payment method’s detail used in their wallet.Example: visa
date
Date in which the money from the provider will be available to use.Example: 2022-05-09T00:00:00.000000Z
string
Partner’s provider account (MAX 255; MIN 3).Example: 4562103
string
Acquire’s response code.Example: 742A64
object
Specifies the details of the customer.
Show properties
Show properties
string
The customer’s email (MAX 255; MIN 3).Example: john.doe@email.com
string
The customer’s first name (MAX 32, MIN 8).Example: John
string
The customer’s last name (MAX 32, MIN 8).Example: Doe
string
The customer’s username in the platform (MAX 32, MIN 8).Example: John_Doe_01
string
The customer’s document type (MAX 32, MIN 8).Possible values: Check the
Country reference. Example: DNI
string
The customer’s identification number (MAX 32, MIN 8).Example: 34566123
object
Specifies the details of the fees.
Show properties
Show properties
float
Amount of the transaction (multiple of 0.0001).Example: 40.5
object
Specifies the details of the card.
Show properties
Show properties
integer
The issuer identification number (IIN) refers to the first few digits of the payment card
number issued by a financial institution (MAX 8; MIN 6).Example: 45079900
integer
The last four digits of the card (MAX 4; MIN 4).Example: 0010
integer
The length of the card’s number (MAX 2; MIN 1).Example: 16
integer
The length of the card’s security code (MAX 1; MIN 1).Example: 3
string
The card’s brand information (MAX 255; MIN 3).Example: visa
string
Card holder’s full name as it appears on the card (MAX 26; MIN 2) only available for PCI
certified merchants.Example: John Doe
integer
Card’s expiration month (MM) (MAX 2; MIN 2).Example: 03
integer
Card’s expiration year (YYYY) (MAX 4; MIN 2).Example: 30
object
Specifies customer object for payments.
Show properties
Show properties
string
The unique identifier of the customer (MAX 64; MIN 36). Specifies the checkout object. This object is not
mandatory for back to back payments. Required when
WORKFLOW is defined as CHECKOUT or
is not sent.Example: faa89e18-5a11-11ed-9b6a-0242ac120002string
The unique identifier of the customer in the external merchant (MAX 255; MIN 3).Example: 4ce6f7e1-bf2e-4e7f-bc1b-84b26082a1d3
timestamp
Customer´s registration date on the merchants platform (ISO 8601 MAX 27; MIN 27).Example: 2022-05-09T20:46:54.786342Z
object
Fraud validations for the customer payer.
Show properties
Show properties
boolean
If the customer’s account has been validated before on the merchant’s side. Defaults to true.Possible values:
True or Falseboolean
If the customer’s email has been validated before on the merchant’s side. Defaults to true.Possible values:
True or Falseboolean
If the customer’s phone has been validated before on the merchant’s side. Defaults to true.Possible values:
True or Falsestring
The customer’s first name (MAX 255; MIN 1).Example: John
string
The customer’s last name (MAX 255; MIN 1).Example: Doe
enum
The customer’s gender (MAX 1; MIN 1; (M=Male/F=Female/NA=Not applicable/NK=Not Known)).Possible enum values:
M, F, NA, or NK.string
The customer’s date of birth in the YYYY-MM-DD format (Length: 10).Example: 1990-02-28
string
The customer’s e-mail (MAX 255; MIN 3).Example: john.doe@email.com
enum
The customer’s nationality (MAX 2; MIN 2; ISO 3166-1 ).Possible enum values: Check the Country reference.
string
The customer’s device fingerprint (MAX 4000; MIN 1). For integrations using Yuno checkout the value is
obtained automatically, do not send this field.Example: hi88287gbd8d7d782ge…
array of object
In case you are using a DIRECT integration and want to support more than one fraud provider in the payment flow, you can use this object to specify the necessary information. For integrations using Yuno checkout the value is obtained automatically, do not send this field.
string
The customer’s IP address (MAX 45; MIN 7).Example: 192.168.123.167
object
Specifies the browser_info object.
Show properties
Show properties
boolean
The accept header value of the customer’s browser.Possible values:
True or Falsestring
The accept browser value of the customer’s browserPossible values:
"True" or "False"string
The accept content value of the customer’s browserPossible values:
"True" or "False"enum
The platform from which the customer is making the payment.Possible enum values:
WEB, IOS, ANDROIDfloat
The color depth of the customer’s browser in bits per pixel. This should be obtained by using the
browser’s screen.colorDepth property. Accepted values: 1, 4, 8, 15, 16, 24, 30, 32 or 48 bit color depth
(MAX
5; MIN 1).Example: 15
boolean
Indicates if Javascript is enabled or not in the device.Possible values:
True or Falseboolean
Indicates if Java is enabled or not in the device.Possible values:
True or Falsestring
Indicates the brosner time differenceExample: -3:00
string
The navigator.language value of the customer’s browser (as defined in IETF BCP 47) (MAX 5; MIN 1).Example: es-ES
string
The total height of the customer’s device screen in pixels (MAX 255; MIN 3).Example: 2048
string
The total width of the customer’s device screen in pixels (MAX 255; MIN 3).Example: 1152
string
The user agent value of the customer’s browser (MAX 255; MIN 3).Example: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_2) AppleWebKit/601.3.9 (KHTML, like
Gecko)
Version/9.0.2 Safari/601.3.9
object
Specifies the customer’s document object, including its number and type.
Show properties
Show properties
string
The customer’s document number (MAX 40; MIN 3).Example: 1093333333
enum
The customer’s document type (MAX 6, MIN 2).Possible enum values: Check the
Country reference.
object
Specifies the customer’s phone object, including number and code.
Show properties
Show properties
string
The customer’s phone number (MAX 40; MIN 3).Example: 11992149494
string
The country calling code of the customer’s phone (MAX 3; MIN 1).Possible values: Check the
Country reference.
object
Specifies the customer’s billing address object.
Show properties
Show properties
string
The primary billing address line of the customer (MAX 255; MIN 3).Example: Calle 34 # 56 - 78
string
The secondary billing address line of the customer (MAX 255; MIN 3).Example: Apartamento 502, Torre I
string
The city considered for the billing address (MAX 255; MIN 3).Example: Bogotá
enum
The country considered for the billing address (MAX 2; MIN 2; ISO
3166-1 ).Possible enum values: Check the Country reference.
string
The state considered for the billing address (MAX 255; MIN 3).Example: Cundinamarca
string
The zipcode considered for the billing address (MAX 11; MIN 4).Example: 111111
string
The neighborhood of the address line of the customer(MAX 255; MIN 2).Example: Barrio 11
object
Specifies the customer’s shipping address object.
Show properties
Show properties
string
The primary shipping address line of the customer (MAX 255; MIN 3).Example: Calle 34 # 56 - 78
string
The secondary shipping address line of the customer (MAX 255; MIN 3).Example: Apartamento 502, Torre I
string
The city considered for the shipping address (MAX 255; MIN 3).Example: Bogotá
enum
The country considered for the shipping address (MAX 2; MIN 2; ISO
3166-1 ).Possible enum values: Check the Country reference.
string
The state considered for the shipping address (MAX 255; MIN 3).Example: Cundinamarca
string
The zipcode considered for the shipping address (MAX 11; MIN 4).Example: 111111
string
The neighborhood of the address line of the customer (MAX 255; MIN 2).Example: Barrio 11
object
object
The shipping selection attached to the payment. Present only when the payment has one — for example, when the customer picks a saved shipping address and delivery method inside a wallet widget (Fast Checkout shipping). The key is omitted when the payment has no shipping selection. Returned on
GET /payments/{id} and payment webhooks. On POST /payments it is present only for one-time-token flows where the token already carries the selection — in Fast Checkout the selection arrives after creation, via the provider notification.Show properties
Show properties
object
The delivery method the customer selected.
Show properties
Show properties
string
The merchant-defined identifier of the delivery method. Matches one of the
shipping_methods[].id sent on the checkout session.Example: expressstring
The display label of the delivery method.Example: Express shipping
object
Specifies the additional_data object. This object is not mandatory. However, if you send this information, the
payment experience will be enhanced for your user.
Show properties
Show properties
object
Specifies the airline object. Passengers and tickets should have the same order information.
Show properties
Show properties
string
Passenger name record (MAX 10; MIN 1).Example: 1P-2UUGJW
enum
Type of trip.Possible values:
ONE_WAY, ROUNDTRIP, MULTIPLE_DESTINATIONSarray of objects
Specifies the legs array of objects.
Show properties
Show properties
integer
A running index (starts with 1), describing the order of legs in the same route.Example: 2
integer
A running index (starts with 1), describing the order of routes by time. E.g: If an order contains 2 Routes: New-York→London→Paris (connection in London) New-York→London should have route_order=1, order=1; London→Paris should have route_order=1, order=2; Paris→London→New-York: Paris→London should have route_order=2, order=1; London→New-York should have route_order=2, order=2.Example: 1
string
IATA airport code (MAX 3; MIN 3). See http://www.iata.org .Example: AMS
string
Country of the arrival airport (MAX 2; MIN 2; ISO 3166-1).Example: AR
string
The city considered for the arrival airport (MAX 255; MIN 3).Example: BUE
string
Airport timezone (MAX 6; MIN 6).Example: -03:00
timestamp
The arrival date and time in local time at the arrival airport.Example: 2022-05-09T24:46:54.786342Z
float
The transaction amount, excluding taxes and fees, the smallest unit of currency (multiple of
0.0001).Example: 23.5676
string
The currency used to transaction amount (MAX 3; MIN 3; ISO 4217 ).Example: Check the Country reference.
string
IATA carrier code (MAX 2; MIN 2). See http://www.iata.org .Example: KL
string
The name of the airline carrier (MAX 100; MIN 1). Optional.Example: KLM Royal Dutch Airlines
string
IATA code (MAX 3; MIN 3). See http://www.iata.org .Example: EZE
string
Country of the departure airport (MAX 2; MIN 2; ISO 3166-1).Example: AR
string
The city of the departure airport (MAX 2; MIN 2; ISO 3166-1).Example: AR
string
Airport timezone (MAX 6; MIN 6).Example: -03:00
timestamp
The departure date and time in local time at the departure airport.Example: 2022-05-09T20:46:54.786342Z
string
Code base rate provides specific information on the fare in addition to the class service, both
required for booking (MAX 15; MIN 1).Example: HL7LNR
string
The fare class code of the airline (MAX 1; MIN 1). The values can be a letter (A-Z) but may vary depending on the airline’s definition. Check the Airline information reference.Example: Y
string
The flight number assigned by the airline carrier (MAX 5; MIN 1).Example: 842
string
The stopover code (1-letter code that indicates whether the passenger is allowed to make a
stopover.
Only two types of characters are allowed: O: Stopover allowed (the letter “O”, not zero) / X: Stopover
not
allowed).Example: O
array of objects
Specifies the array of objects that represents the passengers associated to the tickets.
Show properties
Show properties
enum
Country where the document was issued (MAX 2; MIN 2; ISO 3166-1 ).Possible enum values: Check the Country reference.
string
The passenger’s date of birth in the YYYY-MM-DD format (MAX 10; MIN 10).Example: 1990-02-28
object
Specifies the document object for the passenger.
Show properties
Show properties
string
The passenger’s document number (MAX 40; MIN 3).Example: 1093333333
enum
The passenger’s document type (MAX 6, MIN 2).Possible enum values: Check the
Country reference.
object
Specifies the phone object for the passenger.
Show properties
Show properties
string
The country calling code of the passenger’s phone (MAX 3; MIN 1).Possible values: Check the
Country reference
string
The passenger’s phone number, without the country code (MAX 32; MIN 1).Example: 1130292837
string
The passenger’s email (MAX 255; MIN 3).Example: John.Doe@gmail.com
string
The passenger’s first name (MAX 255; MIN 3).Example: John
string
The passenger’s last name (MAX 255; MIN 3).Example: Doe
string
Number of passenger loyalty program (MAX 20, MIN 1).Example: 254587547
enum
Tier of passenger loyalty program (MAX 255; MIN 3).Possible enum values: Check the
Loyalty tier.
string
The passenger’s middle name (MAX 255; MIN 3).Example: Charles
enum
The passenger’s nationality (MAX 2; MIN 2; ISO 3166-1 ).Possible enum values: Check the Country reference.
enum
The type of passenger (MAX 1; MIN 1).Possible enum values: Check the Passenger type list.
array of objects
Specifies the array of tickets associated with the passengers.
Show properties
Show properties
string
Ticket number (MAX 14; MIN 1).Example: 7411823255523
boolean
Is this an e-ticket?Possible values:
True or Falseboolean
Indicates if the ticket is refundable or not.Possible values:
True or Falsefloat
Total fare amount in the smallest unit of currency (multiple of 0.0001).Example: 80000
float
Total taxes amount in the smallest unit of currency (multiple of 0.0001).Example: 14800
float
Total fee amount in the smallest unit of currency (multiple of 0.0001).Example: 25200
object
Specifies the issue object.
Show properties
Show properties
string
Address of the agent who sold the ticket (MAX 255; MIN 3).Example: Apartamento 502, Torre I
string
Zip code of the agent who sold the ticket.Example: 1636
string
Issuing or Validating carrier. This is the AWB Prefix (Air waybill) IATA 3-numeric code (MAX
3; MIN
3).Example: 044
string
City name of the agent who sold the ticket (MAX 255; MIN 3).Example: Bogotá
enum
Country code where the ticket was issued (MAX 2; MIN 2; ISO
3166-1 ).Possible enum values: Check the Country code
list.
string
Ticket issuing date.Example: 1979-01-12
string
Code of the travel agent issuing the ticket.Example: 10655823
string
The name under which the point of sale appears on the agency list or franchise name (MAX 32;
MIN
1).Example: ACME Agency Inc
string
Code of the booking system issuing the ticket. (MAX 255; MIN 1).Example: TEST001
string
Name of the booking system issuing the ticket. (MAX 255; MIN 1).Example: Booking system
object
Specifies the transport object.
Show properties
Show properties
string
The id of the transportation vehicle (MAX 255; MIN 1).Example: ASONDAKS-1234
object
Specifies the order object.
Show properties
Show properties
float
The shipping amount of the order (multiple of 0.0001).This field is for informational purposes, the shipping amount is already included in the final transaction amount and is not added separately.Example: 5190
float
The fee amount of the order (multiple of 0.0001).This field is for informational purposes, the fee amount is already included in the final transaction amount and is not added separately.Example: 789.50
float
The tip amount of the order (multiple of 0.0001). This field is for informational purposes, the tip amount is already included in the final transaction amount and is not added separately.Example: 215.10
string
Sales channel id of the payment. (MIN:3 y MAX:255)Example: AA01
array of objects
array of objects
Specifies the item’s object.
Show properties
Show properties
string
The unique identifier of the item (MAX 255; MIN 3).Example: 3214
string
The name of the item (MAX 255; MIN 3).Example: iPhone 12 Pro Max
int
The quantity of the item (MAX 999; MIN 1).Example: 1
float
The unit amount of the item (multiple of 0.0001).Example: 550
string
The category of the item (MAX 255; MIN 3).Possible values: Check the Item category list.
string
The brand of the item (MAX 255; MIN 3).Example: Apple
string
The stock keeping unit (SKU) of the item (MAX 255; MIN 3).Example: A2342
string
The manufacture part number of the item (MAX 255; MIN 3).Example: 345621234
array of objects
Specifies the order’s discounts array of objects (up to 10). When the payment carries a Yuno promotion, the
YUNO_PROMOTION line comes first and Yuno fills it. See Promotions.Show properties
Show properties
enum
The type of the discount line. Possible values, written exactly like this in capitals:
MERCHANT (a discount you computed; the default) and YUNO_PROMOTION (a promotion quote). Any other spelling returns 400. On a response it is present when the payment carries a Yuno promotion.Example: MERCHANTstring
The promotion quote id (MAX 1000, no whitespace). Required on
YUNO_PROMOTION lines and not allowed on MERCHANT lines.string
ID of the discount (MAX 255; MIN 3). Required on
MERCHANT lines and not allowed on YUNO_PROMOTION lines, where Yuno fills it with the promotion id.Example: 10OFFstring
The name of the discount (MAX 255; MIN 3). Required on
MERCHANT lines and not allowed on YUNO_PROMOTION lines, where Yuno fills it with the promotion name when it has it.Example: Offerfloat
The amount of the discount (multiple of 0.0001), in the payment currency. Required on
MERCHANT lines and not allowed on YUNO_PROMOTION lines, where Yuno fills it with the promotion discount.Example: 100enum
Whether a discount was applied to the line. Possible values:
Y and N.number
The discount rate applied to the line (multiple of 0.0001).
array of objects
Specifies the tickets object.
Show properties
Show properties
string
Id of the ticket (Min: 1, max:255)Example: 3214
string
Name of the ticket (Min: 1, max:255)Example: Concert
string
Description of the ticket (Min: 1, max:255)Example: Concert
enum
Type of ticketVIRTUAL / PHYSICAL
object
Specifies the payment amount object, with the value and currency.
Show properties
Show properties
enum
The currency used to make the payment (MAX 3; MIN 3; ISO 4217 ).Possible enum values: Check the Country reference.
number
The payment amount (multiple of 0.0001).Example: 111111
object
Specifies the event details object.
Show properties
Show properties
string
Id of the event related to the ticketExample: AA01
string
Name of the event (Min: 1, max:255)Example: Music
string
Description of the event (Min: 1, max:255)Example: festival
enum
Type of eventPARTY, UNIVERCITY, FESTIVAL, CIRCUS, SPORTS, CINEMA, THEATER, CONCERT, OTHERS.
date
Date of the eventExample: 2025-10-25
object
Specifies the event’s address object.
Show properties
Show properties
string
The primary address line of the event (MAX 255; MIN 3).Example: Calle 34 # 56 - 78
string
The secondary billing address line of the event (MAX 255; MIN 3).Example: Apartamento 502, Torre I
string
The city considered for the event’s address (MAX 255; MIN 3).Example: Bogotá
enum
The country considered for the event’s address (MAX 2; MIN 2, ISO
3166-1 ).Possible enum values: Check the Country code
list.
string
The state considered for the event’s address (MAX 255; MIN 3).Example: Cundinamarca
string
The zipcode considered for the event’s address (MAX 11; MIN 4).Example: 111111
object
Specifies the shipping details object.
Show properties
Show properties
enum
string
The description of the shipping (MAX 255; MIN 1).Example: Shipping of sample shirt
enum
timestamp
Estimated date of delivery (ISO 8601 MAX 27; MIN 27).Example: 2025-09-17T20:43:54.786342Z
object
Specifies the account funding structure for transfers and payments.
Show properties
Show properties
object
Specifies the sender’s information.
Show properties
Show properties
enum
Sender’s national entity type. Possible values:
INDIVIDUALENTITY
string
Sender’s first name (MAX 80).Example: John
string
Sender’s last name (MAX 80).Example: Doe
string
Recipient’s legal name. Required if
national_entity is ENTITY (MAX 80).Example: Arcos dorados S.A.string
Sender’s email (MAX 255; MIN 3).Example: john.doe@email.com
enum
Sender’s country (MAX 2; MIN 2; ISO 3166-1 ).Possible enum values: Check the Country reference.
date
Sender’s date of birth in the
YYYY-MM-DD format (MAX 10; MIN 10).Example: 1990-02-28object
object
object
Specifies the address object.
Show properties
Show properties
string
Primary billing address (MAX 255; MIN 3).Example: Calle 34 # 56 - 78
string
Secondary billing address (MAX 255; MIN 3).Example: Apartamento 502, Torre I
string
City for the billing address (MAX 255; MIN 3).Example: Bogota
enum
Country for the billing address (ISO 3166-1; MAX 2; MIN 2).Example: CO
string
State or province for the billing address (MAX 255; MIN 3).Example: Cundinamarca
string
ZIP code for the billing address (MAX 11; MIN 4).Example: 111111
object
Specifies the recipient’s information.
Show properties
Show properties
enum
Recipient’s national entity type. Possible values:
INDIVIDUALENTITY
string
Sender’s first name (MAX 80).Example: John
string
Sender’s last name (MAX 80).Example: Doe
string
Recipient’s legal name. Required if
national_entity is ENTITY (MAX 80).Example: Arcos dorados S.A.string
Recipient’s email (MAX 255; MIN 3).Example: recipient@example.com
enum
Recipient’s country (MAX 2; MIN 2; ISO 3166-1 ).Possible enum values: Check the Country reference.
date
Recipient’s date of birth in the
YYYY-MM-DD format (MAX 10; MIN 10).Example: 1985-07-15object
object
object
Specifies the address object.
Show properties
Show properties
string
Primary billing address (MAX 255; MIN 3).Example: Calle 34 # 56 - 78
string
Secondary billing address (MAX 255; MIN 3).Example: Apartamento 502, Torre I
string
City for the billing address (MAX 255; MIN 3).Example: Bogota
enum
Country for the billing address (ISO 3166-1; MAX 2; MIN 2).Example: CO
string
State or province for the billing address (MAX 255; MIN 3).Example: Cundinamarca
string
ZIP code for the billing address (MAX 11; MIN 4).Example: 111111
object
Specifies the seller’s details object.
Show properties
Show properties
string
The seller’s legal name (MAX 255; MIN 3).Example: Jhon Doe
string
The seller’s e-mail (MAX 255; MIN 3).Example: jhondoe@business.com
string
The seller’s identification code (MAX 255; MIN 3).Example: Seller
string
The seller’s website URL (MAX 255; MIN 3).Example: https://www.test.com/1231324
enum
The seller’s industry (MAX 255; MIN 3).Possible enum values: Check the Industry category.
string
MCC - The merchant category code (MAX 235; MIN 1).Example: 6199
enum
The seller’s country (MAX 255; MIN 3).Possible enum values: Check the Country code list.
object
Specifies the document object of the seller.
Show properties
Show properties
string
The seller’s document number (MAX 40; MIN 3).Example: 1093333333
enum
The seller’s document type (MAX 6, MIN 2).Possible enum values: Check the
Country reference.
object
Specifies the seller’s phone number object.
Show properties
Show properties
string
The country calling code of the seller’s phone (MAX 3; MIN 1). Possible values: Check the
Country reference .Example: 57
string
The seller’s phone number, without the country code (MAX 32; MIN 1).Example: 3132450765
object
Specifies the seller’s address object.
Show properties
Show properties
string
The primary address line of the seller (MAX 255; MIN 3).Example: Calle 34 # 56 - 78
string
The secondary billing address line of the seller (MAX 255; MIN 3).Example: Apartamento 502, Torre I
string
The city considered for the seller’s address (MAX 255; MIN 3).Example: Bogotá
enum
The country considered for the seller’s address (MAX 2; MIN 2, ISO
3166-1 ).Possible enum values: Check the Country code
list.
string
The state considered for the seller’s address (MAX 255; MIN 3).Example: Cundinamarca
string
The zipcode considered for the seller’s address (MAX 11; MIN 4).Example: 111111
array of objects
Specifies the transportations array of objects.
Show properties
Show properties
string
The id of the transportation booking (MAX 255; MIN 1).
string
The description of the transportation booking (MAX 255; MIN 1).
string
The type of transportation booking.
array of objects
Specifies the legs array of objects.
Show properties
Show properties
integer
A running index (starts with 1), describing the order of legs in the same route.
integer
A running index (starts with 1), describing the order of routes by time.
string
Country of the departure (MAX 2; MIN 2; ISO 3166-1).
string
The city of the departure (MAX 255; MIN 1).
string
Departure timezone (MAX 6; MIN 6).
string
The departure date and time in local time at the departure.
string
The reference of the departure (MAX 255; MIN 1).
string
Country of the arrival (MAX 2; MIN 2; ISO 3166-1).
string
The city of the arrival (MAX 255; MIN 1).
string
Arrival timezone (MAX 6; MIN 6).
string
The arrival date and time in local time at the arrival.
string
The reference of the arrival (MAX 255; MIN 1).
object
Specifies the transaction details associated with a payment. Retrieve Payment returns them as an array, one entry per transaction.
Show properties
Show properties
string
The unique identifier of the transaction (MAX 64; MIN 36).Example: 7bf8f1f6-4081-41ec-a024-a927056e00ab
string
The transaction type.Example: PURCHASE
enum
The status of the transaction.Example: SUCCEEDED
string
The category of the payment method used in the transaction.Example: CARD
number
The amount of the transaction. For a payment with a Yuno promotion it is the amount charged:
amount.value minus discount_amount.Example: 100string
The id of the provider that processed the transaction.Example: DLOCAL
boolean
When
true , Yuno automatically retries capture or cancel operations if they fail. Default is false . You may also see this field in delayed_capture_settings or delayed_cancel_settings . For the full retry schedule, see Transaction Retries and Cancel and Capture Flow .Example: falseboolean
Indicates whether a customer-facing receipt has been requested or generated for this transaction. When
true , receipt_url may be available.Example: falsestring | null
URL where you can access the generated receipt for this transaction (e.g. a PDF or hosted page).
null if no receipt is available yet. Use the Retrieve Payment by ID endpoint and check this field in the payment.transaction object.Example: nullstring | null
Language code for the generated receipt (e.g.
EN , ES , PT ). null if no receipt has been generated or no language was specified.Example: ENobject
Specifies the payment method details used in the transaction.
Show properties
Show properties
string
The vaulted token for a previously stored payment_method . If a payment is created using a
vaulted_token, it is not necessary to send a token as well, it can be defined as null (MAX: 64; MIN: 36).Example: 8604911d-5ds9-229e-8468-bd41abear14s
string
Type of the payment method. Mandatory for
DIRECT or REDIRECT workflow. Required when integrating wallets, even when using the SDK.Possible enum values:Possible enum values: Check the payment type reference.boolean
Flag to enroll the card after a successful payment.Possible values:
True or Falsestring
The one time use payment method token provided by Yuno sdk . If a payment is created using a
token, it is not necessary to send a vaulted_token as well, it can be defined as null. Not necessary for
back to back payments (MAX: 64; MIN: 36).Example: 5104911d-5df9-229e-8468-bd41abea1a4s
enum
When using a wallet for payments through a direct integration , this field indicates the provider from which the card information was obtained.Example: APPLE_PAY
object
Specifies the payment method detail object, which provides details of the different transaction
category
types that are part of the payment method object.
Show properties
Show properties
object
Specifies the details of the payment method when using a card.
Show properties
Show properties
boolean
Using amount = 0 and verify = true, you can verify the user’s card without authorizing a real
amount.Possible values:
True or Falseboolean
Decides whether to authorize the payment or capture it. Authorizing a card payment allows you
to
reserve funds in a customer’s bank account.Possible values:
True or Falseinteger
The card installments (MAX 50; MIN 1).Example: 3
integer
Number of months to wait to debit the first installment.Example: 1
string
Type of installments used in the card payment.Example: string
integer
The installment amount includes interests associated with the installment and the information
is
defined by the provider.Example: 3
string
The descriptor passed per transaction to our platform. It will be presented on the customer’s
physical bank statement (MAX 15; MIN 0).Example: COMPANY1
string
The acquirer’s response code.Example: 742A64
integer
The unique identifier assigned by an acquirer to an authorization. In case of Brazil, you’ll receive the nsu.Example: 200000000012
string
The unique identifier assigned by the card acquirer to track the transaction through the card network. Used for reconciliation and chargebacks.For providers that return an acquirer reference (for example, Adyen), this field carries that value, and
retrieval_reference_number may be empty for those providers.Example: 7C9F8E2A1B3Dstring
The unique identifier of the payment receipt assigned by the issuing bank for a card
transaction.
This field is empty if the gateway does not provide information about the transaction (MAX 255; MIN
3).Example: 43564
object
Specifies the details of the card.
Show properties
Show properties
string
Card holder’s full name as it appears on the card (MAX 26; MIN 2) only available for PCI
certified merchants.Example: Fannie Weissnat
integer
The issuer identification number (IIN) refers to the first few digits of the payment card
number issued by a financial institution (MAX 8; MIN 6).Example: 41961111
integer
The last four digits of the card (MAX 4; MIN 4).Example: 0010
integer
The length of the card’s number (MAX 2; MIN 1).Example: 16
integer
The length of the card’s security code (MAX 1; MIN 1).Example: 3
string
The card’s brand information (MAX 255; MIN 3).Example: VISA
string
The card’s issuer (MAX 255; MIN 3).Example: Banco Galicia
string
The category of the card’s issuer (MAX 255; MIN 3).Example: Gold
string
The type of the card’s issuer (MAX 255; MIN 3).Example: CREDIT, DEBIT, or CHARGE_CARD
fingerprint string
When a customer enrolls a credit card multiple times related to one or many Yuno accounts, multiple vaulted_tokens will be generated, but the fingerprint lets you identify when the same card is used for the customer (MAX 255; MIN 3).
Example: 55a7fe38-cdc3-45dc-8c5f-820751799c76object
Specifies the details of the 3DS Transaction.
Show properties
Show properties
string
Setup ID obteined for the 3DS Direct flow.Example: 24127d61-b852-42fb-acd4-1ee661645376
enum
Refers to the protocol version of the EMV 3-D Secure specification used. 1.0, 2.0, 2.1.0,
2.2.0, 2.2.1.Example: 2.2.1
string
This field must be completed with the result of the ECI field provided by the 3d Secure
service. The Electronic Commerce Indicator (ECI) informs the card issuer if the transaction was
protected by a security protocol like VbV or MCSC. It is mandated by Visa and MasterCard that
all 3-D Secure transactions have this value populated in the authorization request (MAX: 2,
MIN: 0).Example: 04
string
This field must be completed with the result of the cryptogram field provided by the
3DSecure service. In Visa transactions, it represents the Cardholder Authentication Verification
Value (CAVV), a cryptographic value generated by the Issuer as evidence of payment
authentication during online purchase to qualify for chargeback protection. MasterCard
transactions have a similar value called Accountholder Authentication Value (AAV) or the
Universal Cardholder Authentication Field (UCAF). When submitting a transaction for
authorization, the merchant must include the CAVV or AAV/UCAF to demonstrate that the cardholder
has been authenticated. It is typically base64-encoded (MAX: 40, MIN: 0).Example: BA0BB1Z3N5Q4kjkBU3c3ELGUsJY =
string
For 3DS v1:
This is the Unique Transaction Identifier. It is automatically generated by the MPI. It is
typically 28 bytes in length and base64-encoded. Is commonly referred to as XID (MAX: 40, MIN:
0).
For 3DS v2:
Universally unique transaction identifier assigned by the DS to identify a single transaction.
(MAX: 36, MIN:36).Ex for V1: “TjY0MjAxRjA4MD4987DUzMzYyNjU=”
Ex for V2: “c4e59ceb-a382-4d6a-bc87-385d591fa09d”
string
Transaction ID generated by the Mastercard directory server during authentication (MAX
255; MIN 3).Example: f38e6948-5388-41a6-bca4-b49723c19437
string
Indicates the outcome of the cardholder authentication during the 3-D Secure process. It informs you whether the authentication was successful (Y), failed (N), could not be completed (U), or was only attempted (A).Example: Y
boolean
Indicates whether a 3DS challenge occurred. When
false , the flow can be frictionless or data-only. Data-only is not explicitly flagged in the response.Example: falsestring
Unique identifier provided by the Access Control Server (ACS) during the 3-D Secure authentication process.Example: ACS-1234567890
boolean
Indicates whether fraud liability shifted from the merchant to the card issuer as a result of the 3DS authentication.
true means the issuer bears liability for fraud disputes on this transaction; false means the merchant retains it. This field can also be null, including in some successful-authentication cases; if you rely on it for chargeback handling and see null unexpectedly, contact Yuno support.Example: trueobject
Information about the network token used for the transaction. If applicable.
Show properties
Show properties
enum
The provider associated to the token provided. VISA, MASTERCARD, AMERICAN_EXPRESS.Example: MASTERCARD
enum
Status of the token for the payment method. CREATED, ACTIVE, SUSPENDED, CANCELED.Example: ACTIVE
string
Payment account reference.Example: MCC123456789012
object
Token details.
Show properties
Show properties
number
[Mandatory] Token’s number without any separators (MAX 19; MIN 8) only available for PCI certified merchants.Example: 450799000001234
string
Cardholder’s full name as it appears on the Token (MAX 26; MIN 2).Example: John Doe
number
The Institution identification number (IIN) refers to the first few digits of a network token number issued by a financial institution (MAX 8; MIN 6).Example: 45079900
number
Last four digits of the network token (MAX 4; MIN 4).Example: 1234
number
Network Token’s expiration month (MM) (MAX 2; MIN 2).Example: 12
number
Network Token’s expiration year (YYYY) (MAX 4; MIN 2).Example: 2027
string
[Mandatory] - The unique cryptogram generated by the issuer for the network token in use in the transaction.
string
[Only required for certain providers] - In case the token has been authenticated by Mastercard the field should be set to 02. For Visa or not authenticated tokens, is not necessary to send the field.
string
[Only required for certain providers] - Token requestor ID of the merchant
object
Indicates the processing type of the transaction.
Show properties
Show properties
enum
Indicates the processing type of the transaction.Enum:CARD_ON_FILE, SUBSCRIPTION, UNSCHEDULED_CARD_ON_FILEExample: SUBSCRIPTION
enum
This field Iets you indicate if this is the first time the vaulted_token/network_token is used for a payment or if it has already been used for a previous payment. Enum: FIRST, USEDExample: USED
string
This field lets you indicate the identification of the agreement with the customer for a subscription. Mainly for MX (MAX 255; MIN 3).Example: AA0001
string
Unique identifier assigned to a transaction by the card network. It is used to track and reference specific transactions, particularly in recurring payment scenarios, ensuring consistency and traceability across the payment lifecycle (MAX 255; MIN 3).Example: 583103536844189
object
Specifies the details of the payment method when using a wallet.
Show properties
Show properties
boolean
Using amount = 0 and verify = true, you can verify the user’s card without authorizing a real
amount.Possible values:
True or Falsestring
Cryptogram for direct integrations with card wallets (MAX 526; MIN 3).
boolean
Decides whether to authorize the payment or capture it. Authorizing a card payment allows you
to
reserve funds in a customer’s bank account.Possible values:
True or Falseinteger
The card installments (MAX 50; MIN 1).Example: 3
string
The user’s payment method used in their wallet.Example: credit_card
string
The payment method’s detail used in their wallet.Example: visa
date
Date in which the money from the provider will be available to use.Example: 2022-05-09T00:00:00.000000Z
string
Partner’s provider account (MAX 255; MIN 3).Example: 4562103
string
Acquire’s response code.Example: 742A64
timestamp
Payment methods expiration date. “yyyy-MM-dd HH:mm:ss.SSSz”Example: 2026-05-09T20:46:54.786342Z
string
The URL to redirect your customer to in order to complete the payment with the wallet.Example: https://www.company.com/wallet_1231324
object
Specifies the details of the customer.
Show properties
Show properties
string
The customer’s email (MAX 255; MIN 3).Example: john.doe@email.com
string
The customer’s first name (MAX 32, MIN 8).Example: John
string
The customer’s last name (MAX 32, MIN 8).Example: Doe
string
The customer’s username in the platform (MAX 32, MIN 8).Example: John_Doe_01
string
The customer’s document type (MAX 32, MIN 8).Check the
Country reference. Example: DNI
string
The customer’s identification number (MAX 32, MIN 8).Example: 34566123
object
Specifies the details of the fees.
Show properties
Show properties
float
Amount of the transaction (multiple of 0.0001).Example: 40.5
object
Specifies the details of the card.
Show properties
Show properties
integer
The issuer identification number (IIN) refers to the first few digits of the payment card
number issued by a financial institution (MAX 8; MIN 6).Example: 45079900
integer
The last four digits of the card (MAX 4; MIN 4).Example: 0010
integer
The length of the card’s number (MAX 19; MIN 8).Example: 19
integer
The length of the card’s security code (MAX 1; MIN 1).Example: 3
string
The card’s brand information (MAX 255; MIN 3).Example: visa
string
Card holder’s full name as it appears on the card (MAX 26; MIN 2) only available for PCI
certified merchants.Example: JOHN DOE
object
Specifies the details of the payment method when using BNPL.
Show properties
Show properties
integer
The loan installments (MAX 50; MIN 1).Example: 10
string
The provider’s URL (MAX 255; MIN 3).Example: https://www.company.com/
string
The URL with the full version of the ticket in case you want to redirect your customer (MAX
255;
MIN
3).Example: https://www.company.com/ticket_1231324
timestamp
Payment methods expiration date. “yyyy-MM-dd HH:mm:ss.SSSz”Example: 2026-05-09T20:46:54.786342Z
object
Specifies the details of the customer.
Show properties
Show properties
string
The customer’s legal name (MAX 32, MIN 8).Example: Legal name
string
Customer’s username in the provider platform (MAX 32, MIN 8).Example: Legal_name_01
string
The customer’s tax identifier (MAX 32, MIN 8).Example: CUIT
string
The customer’s tax identifier number (MAX 32, MIN 8).Example: 20-34566123-7
string
The credit’s type (MAX 255; MIN 3).Example: PERSONAL/BUSINESS
string
The customer’s industry (MAX 255; MIN 3).Example: OTHERS
string
The customer’s role in the company (MAX 255; MIN 3).Example: OWNER
object
Specifies the details of the payment method when using bank transfer.
Show properties
Show properties
string
The provider’s URL (MAX 255; MIN 3).Example: https://www.company.com/logo
string
Type of the bank account (MAX 255; MIN 3).Example: CHECKINGS/SAVINGS
string
Name of the bank associated with the account (MAX 255; MIN 3).Example: Banco Galicia
string
Identifier of the selected bank when the provider requires choosing one. Returned only if the merchant sent a value.Example: galicia
string
The name of the account holder (MAX 255; MIN 3).Example: John Doe
string
The number of the bank account (MAX 255; MIN 3).Example: 54653211313333
string
The secondary number of the bank account (MAX 255; MIN 3).Example: 78900000000123
string
Document type of the account holder (MAX 255; MIN 3).Possible values: Check the
Country reference. Example: DNI
string
Document number of the account holder (MAX 255; MIN 3).Example: 54666897
string
Reference code for the user (MAX 255; MIN 3).Example: AA01234-BC
string
The unique identifier assigned by an acquirer to an authorization.In case of Brazil, you’ll receive the nsu.Example: 200000000012
string
The unique identifier assigned by the card acquirer to track the transaction through the card network. Used for reconciliation and chargebacks.For providers that return an acquirer reference (for example, Adyen), this field carries that value, and
retrieval_reference_number may be empty for those providers.Example: 7C9F8E2A1B3Dstring
Payments instructions related to the payment (MAX 255; MIN 3).Example: Go to your bank account and transfer the amount using the reference detailed
below
string
The URL with the full version of the ticket in case you want to redirect your customer (MAX
255;
MIN
3).Example: https://www.company.com/ticket_1231324
timestamp
Payment methods expiration date. “yyyy-MM-dd HH:mm:ss.SSSz”Example: 2026-05-09T20:46:54.786342Z
object
Specifies the details of the payment method when using ticket.
Show properties
Show properties
string
The ticket’s type.Example: number, barcode, custom, reference_code, qr
enum
User´s benefit type for ticket payment method. JUNAEB, PRIVATEExample: PRIVATE
integer
The ticket’s number.Example: 13141
string
The ticket’s barcode, as a text value. For the barcode image, see
provider_logo.Example: 456789009878765u7654string
The ticket’s logo.Example: https://www.company.com/logo
string
The ticket’s format.Example: barcode, custom
string
Payments instructions related to the payment (MAX 255; MIN 3).Example: Go to your closest store and pay the total amount using the reference detailed below
string
The URL with the full version of the ticket.Example: https://www.company.com/ticket_1231324
timestamp
Payment methods expiration date. “yyyy-MM-dd HH:mm:ss.SSSz”Example: 2026-05-09T20:46:54.786342Z
object
Specifies the details of the payment method when using a payment link.
Show properties
Show properties
boolean
Using amount = 0 and verify = true, you can verify the user’s card without authorizing a real
amount.Possible values:
True or Falseboolean
Decides whether to authorize the payment or capture it. Authorizing a card payment allows you
to
reserve funds in a customer’s bank account.Possible values:
True or Falsetimestamp
Payment methods expiration date. “yyyy-MM-dd HH:mm:ss.SSSz”Example: 2026-05-09T20:46:54.786342Z
integer
The card installments (MAX 50; MIN 1).Example: 3
string
The user’s payment method used in their wallet.Example: credit_card
string
The payment method’s detail used in their wallet.Example: visa
date
Date in which the money from the provider will be available to use.Example: 2022-05-09T00:00:00.000000Z
string
Partner’s provider account (MAX 255; MIN 3).Example: 4562103
string
Acquire’s response code.Example: 742A64
object
Specifies the details of the customer.
Show properties
Show properties
string
The customer’s email (MAX 255; MIN 3).Example: john.doe@email.com
string
The customer’s first name (MAX 32, MIN 8).Example: John
string
The customer’s last name (MAX 32, MIN 8).Example: Doe
string
The customer’s username in the platform (MAX 32, MIN 8).Example: John_Doe_01
string
The customer’s document type (MAX 32, MIN 8).Possible values: Check the
Country Reference. Example: DNI
string
The customer’s identification number (MAX 32, MIN 8).Example: 34566123
object
Specifies the details of the fees.
Show properties
Show properties
float
Amount of the transaction (multiple of 0.0001).Example: 40.5
object
Specifies the details of the card.
Show properties
Show properties
integer
The issuer identification number (IIN) refers to the first few digits of the payment card
number issued by a financial institution (MAX 8; MIN 6).Example: 45079900
integer
The last four digits of the card (MAX 4; MIN 4).Example: 0010
integer
The length of the card’s number (MAX 19; MIN 8).Example: 19
integer
The length of the card’s security code (MAX 1; MIN 1).Example: 3
string
The card’s brand information (MAX 255; MIN 3).Example: visa
string
Card holder’s full name as it appears on the card (MAX 26; MIN 2) only available for PCI
certified merchants.Example: John Doe
string
The code that represents the response of the te outcome of the transaction.Example: SUCCEEDED
string
The description of the response_code.Example: Transaction successful
string
The reason for the transaction. Applies to secondary transactions, such as refunds or captures.Possible values:
CANCELLED, DISMISS, DUPLICATE, DUPLICATED, FRAUDULENT, MISSED, NOT_FOUND, ORDER_STOPPED, REFUNDED, REQUESTED_BY_CUSTOMER, RESOLVED, REVERSE, SERVICE_SUSPENDEDstring
The description of the payment (MAX 255; MIN 3).Example: Purchase on web
string
The reference generated by the merchant to identify the payment/transaction.Example: AA01
enum
Normalized Merchant Advice Code for declined transactions; use it to guide retry behavior and routing.Example: TRY_AGAIN_LATER
string
Human‑readable message that explains the advice returned in
merchant_advice_code .Example: Retry within 24 hoursobject
Specifies the provider data that processed the payment.
Show properties
Show properties
string
The provider id that processed the payment.Example: DLOCAL
string
The id of the transaction from the provider.Example: 5a1fa541-5fa2-496e-9fdc-29b34e09a107
string
The id of the account from the processor of the provider. If applies.Example: AA001298
string
The id of the transaction from the processor of the provider. If applies.Example: 1309982
string
The unique identifier of the account (MAX 64; MIN 36).Example: 9104911d-5df9-429e-8488-ad41abea1a4b
enum
The status of the transaction.Example: SUCCEEDED
string
The status_detail of the transaction.Example: APPROVED
string
Raw Merchant Advice Code returned by the provider for declined transactions.Example: 25
string
Provider message that explains the meaning of the raw Merchant Advice Code.Example: Retry after 24 hours
string
The code that represents the response of the te outcome of the transaction from the provider.Example: SUCCEEDED
string
Message to provide additional information regarding the operation status.Example: Successful transaction
object
The code of the international standard for financial transaction card originated interchange messaging ( ISO 8583 ).Example: 00
object
The message of the international standard for financial transaction card originated interchange messaging ( ISO 8583 ).Example: Approved or completed successfully
array of object
The direct notification from the provider for the transaction. The format of the object depends on the
provider’s response.Example: JSON, XML, string
object
Specifies the payment method detail object returned by the provider, which specifies the details of the
different transaction
category types.
Show properties
Show properties
object
Specifies the details of the payment method when using a card.
Show properties
Show properties
boolean
Using amount = 0 and verify = true, you can verify the user’s card without authorizing a real
amount.Possible values:
True or Falseboolean
Decides whether to authorize the payment or capture it. Authorizing a card payment allows you
to
reserve funds in a customer’s bank account.Possible values:
True or Falseinteger
The card installments (MAX 50; MIN 1).Example: 3
integer
Number of months to wait to debit the first installment.Example: 1
string
Type of installments used in the card payment.Example: string
integer
The installment amount includes interests associated with the installment and the information
is
defined by the provider.Example: 3
string
The descriptor passed per transaction to our platform. It will be presented on the customer’s
physical bank statement (MAX 15; MIN 0).Example: COMPANY1
string
The acquirer’s response code.Example: 742A64
integer
The unique identifier assigned by an acquirer to an authorization. In case of Brazil, you’ll receive the nsu.Example: 200000000012
string
The unique identifier assigned by the card acquirer to track the transaction through the card network. Used for reconciliation and chargebacks.For providers that return an acquirer reference (for example, Adyen), this field carries that value, and
retrieval_reference_number may be empty for those providers.Example: 7C9F8E2A1B3Dstring
The unique identifier of the payment receipt assigned by the issuing bank for a card
transaction.
This field is empty if the gateway does not provide information about the transaction (MAX 255; MIN
3).Example: 43564
object
Specifies the details of the card.
Show properties
Show properties
string
Card holder’s full name as it appears on the card (MAX 26; MIN 2) only available for PCI
certified merchants.Example: Fannie Weissnat
integer
The issuer identification number (IIN) refers to the first few digits of the payment card
number issued by a financial institution (MAX 8; MIN 6).Example: 41961111
integer
The last four digits of the card (MAX 4; MIN 4).Example: 0010
integer
The length of the card’s number (MAX 2; MIN 1).Example: 16
integer
The length of the card’s security code (MAX 1; MIN 1).Example: 3
string
The card’s brand information (MAX 255; MIN 3).Example: VISA
string
The card’s issuer (MAX 255; MIN 3).Example: Banco Galicia
string
The category of the card’s issuer (MAX 255; MIN 3).Example: Gold
string
The type of the card’s issuer (MAX 255; MIN 3).Example: CREDIT, DEBIT, or CHARGE_CARD
object
Specifies the details of the payment method when using a wallet.
Show properties
Show properties
boolean
Using amount = 0 and verify = true, you can verify the user’s card without authorizing a real
amount.Possible values:
True or Falsecryptogram string
Cryptogram for direct integrations with card wallets (MAX 526; MIN 3).boolean
Decides whether to authorize the payment or capture it. Authorizing a card payment allows you
to
reserve funds in a customer’s bank account.Possible values:
True or Falseinteger
The card installments (MAX 50; MIN 1).Example: 3
string
The user’s payment method used in their wallet.Example: credit_card
string
The payment method’s detail used in their wallet.Example: visa
date
Date in which the money from the provider will be available to use.Example: 2022-05-09T00:00:00.000000Z
string
Partner’s provider account (MAX 255; MIN 3).Example: 4562103
string
Acquire’s response code.Example: 742A64
object
Specifies the details of the customer.
Show properties
Show properties
string
The customer’s email (MAX 255; MIN 3).Example: john.doe@email.com
string
The customer’s first name (MAX 32, MIN 8).Example: John
string
The customer’s last name (MAX 32, MIN 8).Example: Doe
string
The customer’s username in the platform (MAX 32, MIN 8).Example: John_Doe_01
string
The customer’s document type (MAX 32, MIN 8).Check the
Country reference. Example: DNI
string
The customer’s identification number (MAX 32, MIN 8).Example: 34566123
object
Specifies the details of the fees.
Show properties
Show properties
float
Amount of the transaction (multiple of 0.0001).Example: 40.5
object
Specifies the details of the card.
Show properties
Show properties
integer
The issuer identification number (IIN) refers to the first few digits of the payment card
number issued by a financial institution (MAX 8; MIN 6).Example: 45079900
integer
The last four digits of the card (MAX 4; MIN 4).Example: 0010
integer
The length of the card’s number (MAX 19; MIN 8).Example: 19
integer
The length of the card’s security code (MAX 1; MIN 1).Example: 3
string
The card’s brand information (MAX 255; MIN 3).Example: visa
string
Card holder’s full name as it appears on the card (MAX 26; MIN 2) only available for PCI
certified merchants.Example: JOHN DOE
object
Specifies the details of the payment method when using BNPL.
Show properties
Show properties
integer
The loan installments (MAX 50; MIN 1).Example: 10
string
The provider’s URL (MAX 255; MIN 3).Example: https://www.company.com/logo
string
The URL with the full version of the ticket in case you want to redirect your customer (MAX
255;
MIN
3).Example: https://www.company.com/ticket_1231324
object
Specifies the details of the customer.
Show properties
Show properties
string
The customer’s legal name (MAX 32, MIN 8).Example: Legal name
string
Customer’s username in the provider platform (MAX 32, MIN 8).Example: Legal_name_01
string
The customer’s tax identifier (MAX 32, MIN 8).Example: CUIT
string
The customer’s tax identifier number (MAX 32, MIN 8).Example: 20-34566123-7
string
The credit’s type (MAX 255; MIN 3).Example: PERSONAL/BUSINESS
string
The customer’s industry (MAX 255; MIN 3).Example: OTHERS
string
The customer’s role in the company (MAX 255; MIN 3).Example: OWNER
object
Specifies the details of the payment method when using bank transfer.
Show properties
Show properties
string
The provider’s URL (MAX 255; MIN 3).Example: https://www.company.com/
string
Type of the bank account (MAX 255; MIN 3).Example: CHECKINGS/SAVINGS
string
Name of the bank associated with the account (MAX 255; MIN 3).Example: Banco Galicia
string
Identifier of the bank selected by the payer when provided in the original payment request.Example: galicia
string
The name of the account holder (MAX 255; MIN 3).Example: John Doe
string
The number of the bank account (MAX 255; MIN 3).Example: 54653211313333
string
The secondary number of the bank account (MAX 255; MIN 3).Example: 78900000000123
string
Document type of the account holder (MAX 255; MIN 3).Possible values: Check the
Country reference. Example: DNI
string
Document number of the account holder (MAX 255; MIN 3).Example: 54666897
string
Payments instructions related to the payment (MAX 255; MIN 3).Example: Go to your bank account and transfer the amount using the reference detailed
below
string
The URL with the full version of the ticket in case you want to redirect your customer (MAX
255;
MIN
3).Example: https://www.company.com/ticket_1231324
object
Specifies the details of the payment method when using ticket.
Show properties
Show properties
string
The ticket’s type.Example: number, barcode, custom, reference_code, qr
integer
The ticket’s number.Example: 13141
string
The ticket’s barcode, as a text value. For the barcode image, see
provider_logo.Example: 456789009878765u7654string
The ticket’s logo.Example: https://www.company.com/logo
string
The ticket’s format.Example: barcode, custom
string
The url with the full version of the ticket.Example: https://www.company.com/ticket_1231324
object
Specifies the details of the payment method when using a payment link.
Show properties
Show properties
boolean
Using amount = 0 and verify = true, you can verify the user’s card without authorizing a real
amount.Possible values:
True or Falseboolean
Decides whether to authorize the payment or capture it. Authorizing a card payment allows you
to
reserve funds in a customer’s bank account.Possible values:
True or Falseinteger
The card installments (MAX 50; MIN 1).Example: 3
string
The user’s payment method used in their wallet.Example: credit_card
string
The payment method’s detail used in their wallet.Example: visa
date
Date in which the money from the provider will be available to use.Example: 2022-05-09T00:00:00.000000Z
string
Partner’s provider account (MAX 255; MIN 3).Example: 4562103
string
Acquire’s response code.Example: 742A64
object
Specifies the details of the customer.
Show properties
Show properties
string
The customer’s email (MAX 255; MIN 3).Example: john.doe@email.com
string
The customer’s first name (MAX 32, MIN 8).Example: John
string
The customer’s last name (MAX 32, MIN 8).Example: Doe
string
The customer’s username in the platform (MAX 32, MIN 8).Example: John_Doe_01
string
The customer’s document type (MAX 32, MIN 8).Possible values: Check the
Country reference. Example: DNI
string
The customer’s identification number (MAX 32, MIN 8).Example: 34566123
object
Specifies the details of the fees.
Show properties
Show properties
float
Amount of the transaction (multiple of 0.0001).Example: 40.5
object
Specifies the details of the card.
Show properties
Show properties
integer
The issuer identification number (IIN) refers to the first few digits of the payment card
number issued by a financial institution (MAX 8; MIN 6).Example: 45079900
integer
The last four digits of the card (MAX 4; MIN 4).Example: 0010
integer
The length of the card’s number (MAX 19; MIN 8).Example: 19
integer
The length of the card’s security code (MAX 1; MIN 1).Example: 3
string
The card’s brand information (MAX 255; MIN 3).Example: visa
string
Card holder’s full name as it appears on the card (MAX 26; MIN 2) only available for PCI
certified merchants.Example: John Doe
object
Specifies the connection data object, which represents the connection used to process the transaction. When you operate multiple connections for the same provider, use
connection_data.id to attribute each transaction to the specific connection that processed it.Show properties
Show properties
timestamp
The date and time when the transaction was created.Example: 2022-05-09T20:46:54.786342Z
timestamp
The date and time from the last time the transaction was updated.Example: 2022-05-09T20:46:54.786342Z
array of objects
Split marketplace array of objects
Show properties
Show properties
string
The unique identifier of the recipient in the Yuno system.You must provide the recipient_id (Yuno-generated) or the ‘provider_recipient_id’ (external provider’s ID) when creating a payment.
string
The recipient ID provided by the external payment provider, if applicable.You must provide the provider_recipient_id or the recipient_id (Yuno-generated) when creating a payment.
string
The type of split.Example: PURCHASE
string
Optional unique identifier for the split transaction.
object
array of objects
The list of the transactions that are part of a payment — one entry per attempt, so it depends on how many providers your payment method route tried. This array is opt-in: it is populated only when the payment was created with
response_additional_data.transactions_history: true; otherwise it is returned as an empty array []. Chargeback events always include the full history.enum
The payment workflow. Indicates whether the integration will use Yuno´s SDK or will be a back to back
connection (Card implementation only available for PCI compliant merchants).Possible enum values:
SDK_CHECKOUT: Use Yuno SDK.DIRECT: Back to back integration with provider info for custom payment experience.REDIRECT: Back to back integration with provider redirection.
string
The URL where to redirect the customer after the payment. Only required for DIRECT integrations that have a
redirection (MAX 526; MIN 3).Example: https://www.company.com/customer_1231324
array of objects
Specifies a list of custom key–value pairs associated with the payment (for internal references, segmentation, or workflow tags). You can add up to 120 metadata objects.
Show properties
Show properties
object
Specifies a metadata key and the respective value.Use to attach merchant-defined context (for example:
order_id, customer_tier). Avoid sending sensitive or personal data.array of objects
Returns the routing rules information during the payment creation.
Show properties
Show properties
bool
Specifies if a transaction went through the smart routing feature or not.Example: false
bool
Specifies if a transaction went through the monitors feature or not.Example: false
string
The unique identifier of the subscription associated to the payment (MAX 64 ; MIN 36).Example: 7304911d-5df9-429e-8488-ad41abea1a4c
struct
array of objects
Provides information about the fraud scans used for the payment.
Show properties
Show properties
enum
The final status of the screening process of the payment.Example: SUCCEEDED
boolean
Optional field to send in the payment indicating if the fraud screening is stand alone, meaning that a payment will not be excecuted after the fraud screening is made. You can use this field while creating your CARD route.Example: false
object
Specifies the transaction details associated with a screening process of the payment.
Show properties
Show properties
string
The id of the fraud transaction (MAX 64; MIN 36).Example: ft12
enum
Type of the fraud transaction.Possible enum values:
PRE_AUTH, POS_AUTHenum
The status of the transaction (MAX 255; MIN 3).Example: SUCCEEDED
enum
The response code of the transaction.Example: FRAUD_VERIFIED
enum
The response message of the transaction.Example: Fraud approved
object
Specifies the provider data that processed the payment.
Show properties
Show properties
string
The id of the fraud prevention provider.Example: CLEARSALE
string
The id of the fraud transaction from the provider.Example: AA001234567
string
The provider fraud transaction status.Example: APM
string
The provider score for the transaction.Example: 0.7
string
The raw_response of the provider.Example: JSON
object
Obfuscated copy of the request Yuno sent to the provider. Only returned for allowlisted organizations.Example: JSON
timestamp
The date and time when the fraud screening was created.Example: 2022-05-09T20:46:54.786342Z
timestamp
The date and time from the last time the fraud screening was updated.Example: 2022-05-09T20:46:54.786342Z