The Payment Object

This object represents the payment created after generating the checkout session for a customer.

id string
The unique identifier of the customer (MAX 64 ; MIN 36).
Example: 8546df3a-b83e-4bb5-a4b3-57aa6385924f

account_id string
The unique identifier of the account (MAX 64; MIN 36).
Example: 9104911d-5df9-429e-8488-ad41abea1a4b

description string
The description of the payment (MAX 255; MIN 3).
Example: Purchase on web

country enum
Country where the transaction must be processed (MAX 2; MIN 2; ISO 3166-1).
Possible enum values: Check the Country reference.

status enum
The status of the transaction.
Example: SUCCEEDED

sub_status enum
It is a complement to the status information.
Example: DECLINED

merchant_order_id string
The unique identifier of the customer's order (MAX 255; MIN 3).
Example: 2022-05-09T20:20:54.786342Z

created_at timestamp
The date and time when the payment was created.
Example: 2022-05-09T20:46:54.786342Z

updated_at timestamp
The date and time of last update for the payment.
Example: 2022-05-09T20:46:54.786342Z

amount object

Specifies the payment amount object, with the value and currency.

currency enum
The currency used to make the payment (MAX 3; MIN 3; ISO 4217).
Possible enum values: Check the Country reference.

value number
The payment amount (multiple of 0.0001).
Example: 111111

currency_conversion object

Specifies the currency conversion object.

provider_currency_conversion_id string
The unique identifier of the conversion rate query from the provider (MAX 526 ; MIN 3).
Example: 9104911d-5df9-429e-8488-ad41abea1a4b

cardholder_currency enum
The currency to make the conversion (ISO 4217 MAX 3; MIN 3).
Example: USD

cardholder_amount number
Amount of the payment before conversion
Example: 100

refunded number
The refund amount (multiple of 0.0001).
Example: 111111

captured number
The captured amount (multiple of 0.0001).
Example: 111111

checkout 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.

session string
The checkout session has been created for the payment (MAX 64; MIN 36).
Example: 757eefc7-e28c-4333-9a07-3b16e610745d

sdk_action_required boolean
Defines if the payment is asynchronous and requires additional steps based on a request to the SDK.
Example: false

payment_method object

Specifies the payment_method object.

vaulted_token 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).
Example: 8604911d-5ds9-229e-8468-bd41abear14s

type enum
Payment method type. Mandatory for DIRECT or REDIRECT workflow.
Possible enum values:
Possible enum values: check the payment type reference.

vault_on_success boolean
Flag to enroll the card after a successful payment.
Possible values: True or False

token string
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

detail object

Specifies the payment method detail object, which provides details of the different transaction category types that are part of the payment method object.

card object

Specifies the details of the payment method when using a card.

verify boolean
Using amount = 0 and verify = true, you can verify the user's card without authorizing a real amount.
Possible values: True or False

capture 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 False

installments integer
The card installments (MAX 50; MIN 1).
Example: 3

first_installments_deferral integer
Number of months to wait to debit the first installment.
Example: 1

installments_type string
Defines the type of installments.
Example: string

installments_amount integer
The installment amount includes interests associated with the installment and the information is defined by the provider.
Example: 3

soft_descriptor string
The descriptor passed per transaction to out platform. It will be presented on the customer's physical bank statement (MAX 15; MIN 0).
Example: COMPANY1

authorization_code string
The acquirer's response code.
Example: 742A64

retrieval_reference_number string
The unique identifier assigned by an acquirer to an authorization.
Example: 200000000012

voucher string
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

card_data object

Specifies the details of the card.

holder_name string
Card holder's full name as it appears on the card (MAX 26; MIN 3) only available for PCI certified merchants.
Example: Fannie Weissnat

country_code string
User card country code (MAX 2; MIN 2).
Example: US

expiration_month integer
Card's expiration month (MM) (MAX 2; MIN 2).
Example: 03

expiration_year integer
Card's expiration year (YYYY) (MAX 4; MIN 2).
Example: 2030

iin 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

lfd string
The last four digits of the card (MAX 4; MIN 4).
Example: 0010

number_length integer
The length of the card's number (MAX 19; MIN 8).
Example: 41961111

security_code_length integer
The length of the card's security code (MAX 1; MIN 1).
Example: 3

brand string
The card's brand information (MAX 255; MIN 3).
Example: VISA

issuer_name string
The card's issuer (MAX 255; MIN 3).
Example: Banco Galicia

issuer_code integer
The card's issuer identification code (MAX 255; MIN 3).

category string
The category of the card's issuer (MAX 255; MIN 3).
Example: Gold

type 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-820751799c76

three_d_secure object

Specifies the details of the 3DS Transaction.

three_d_secure_setup_id string
Setup ID obteined for the 3DS Direct flow.
Example: 24127d61-b852-42fb-acd4-1ee661645376

version 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

electronic_commerce_indicator 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

cryptogram 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 =

transaction_id 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”

directory_server_transaction_id string
Transaction ID generated by the Mastercard directory server during authentication (MAX 255; MIN 3).
Example: f38e6948-5388-41a6-bca4-b49723c19437

network_token object

Information about the network token used for the transaction. If applicable.

network enum
The provider associated to the token provided. VISA, MASTERCARD, AMERICAN_EXPRESS.
Example: MASTERCARD

status enum
Status of the token for the payment method. CREATED, ACTIVE, SUSPENDED, CANCELED.
Example: ACTIVE

par string
Payment account reference.
Example: MCC123456789012

token_data object

Token details.

number number
[Mandatory] - Token’s number without any separators (MAX 19; MIN 8) only available for PCI certified merchants.
Example: 450799000001234

holder_name string
Cardholder’s full name as it appears on the Token (MAX 26; MIN 3).
Example: John Doe

iin 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

lfd number
Last four digits of the network token (MAX 4; MIN 4).
Example: 1234

expiration_month number
Network Token’s expiration month (MM) (MAX 2; MIN 2).
Example: 12

expiration_year number
Network Token’s expiration year (YYYY) (MAX 4; MIN 2).
Example: 2027

cryptogram string
[Mandatory] - The unique cryptogram generated by the issuer for the network token in use in the transaction.

electronic_commerce_indicator 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.

token_requestor_id string
[Only required for certain providers] - Token requestor ID of the merchant

response object

Network transaction details.

code number
Response code from the service provider.
Example: succeeded

message number
Response code from the service provider.
Example: Transaction Succeeded

stored_credentials object

Indicates the processing type of the transaction.

reason enum
Indicates the processing type of the transaction.Enum:CARD_ON_FILE, SUBSCRIPTION, UNSCHEDULED_CARD_ON_FILE
Example: SUBSCRIPTION

usage 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, USED
Example: USED

subscription_agreement_id 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

network_Transaction_id 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

bnpl object

Specifies the details of the payment method when using Buy Now Pay Later (BNPL).

installments integer
The loan installments (MAX 50; MIN 1).
Example: 10

provider_image string
The provider's URL (MAX 255; MIN 3).
Example: https://www.company.com/

redirect_url 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

customer_data object

Specifies the details of the customer.

name string
The customer's legal name (MAX 32, MIN 8).
Example: Legal name

username string
Customer's username in the provider platform (MAX 32, MIN 8).
Example: Legal_name_01

tax_id_type string
The customer's tax identifier (MAX 32, MIN 8).
Example: CUIT

tax_id string
The customer's tax identifier number (MAX 32, MIN 8).
Example: 20-34566123-7

type string
The credit's type (MAX 255; MIN 3).
Example: PERSONAL/BUSINESS

area string
The customer's industry (MAX 255; MIN 3).
Example: OTHERS

role string
The customer's role in the company (MAX 255; MIN 3).
Example: OWNER

bank_transfer object

Specifies the details of the payment method when using bank transfer.

provider_image string
The provider's URL (MAX 255; MIN 3).
Example: https://www.company.com/

account_type string
Type of the bank account (MAX 255; MIN 3).
Example: CHECKINGS/SAVINGS

bank_name string
Name of the bank associated with the account (MAX 255; MIN 3).
Example: Banco Galicia

beneficiary_name string
The name of the account holder (MAX 255; MIN 3).
Example: John Doe

bank_account string
The number of the bank account (MAX 255; MIN 3).
Example: 54653211313333

bank_account_2 string
The secondary number of the bank account (MAX 255; MIN 3).
Example: 78900000000123

beneficiary_document_type string
Document type of the account holder (MAX 255; MIN 3).
Possible values: Check the Country reference. Example: DNI

beneficiary_document string
Document number of the account holder (MAX 255; MIN 3).
Example: 54666897

reference string
Reference code for the user (MAX 255; MIN 3).
Example: AA01234-BC

retrieval_reference_number string
The unique identifier assigned by an acquirer to an authorization.
Example: 200000000012

payment_instruction 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

redirect_url 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

wallet object

Specifies the details of the payment method when using a wallet.

verify boolean
Using amount = 0 and verify = true, you can verify the user's card without authorizing a real amount.
Possible values: True or False

cryptogram string
Cryptogram for direct integrations with card wallets (MAX 526; MIN 3).

capture 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 False

installments integer
The card installments (MAX 50; MIN 1).
Example: 3

payment_method_id string
The user's payment method used in their wallet.
Example: credit_card

detail string
The payment method's detail used in their wallet.
Example: visa

date_of_expiration date
Expiration date for an offline payment method.
Example: 2022-05-09T00:00:00.000000Z

money_release_date date
Date in which the money from the provider will be available to use.
Example: 2022-05-09T00:00:00.000000Z

sponsor_id string
Partner's provider account (MAX 255; MIN 3).
Example: 4562103

authorization_code string
Acquire's response code.
Example: 742A64

customer_data object

Specifies the details of the customer.

email string
The customer's email (MAX 255; MIN 3).
Example: [email protected]

first_name string
The customer's first name (MAX 32, MIN 8).
Example: John

last_name string
The customer's last name (MAX 32, MIN 8).
Example: Doe

username string
The customer's username in the platform (MAX 32, MIN 8).
Example: John_Doe_01

identification_type string
The customer's document type (MAX 32, MIN 8).
Check the Country reference. Example: DNI

identification_number string
The customer's identification number (MAX 32, MIN 8).
Example: 34566123

fee_details object

Specifies the details of the fees.

amount float
Amount of the transaction (multiple of 0.0001).
Example: 40.5

card_data object

Specifies the details of the card.

iin 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

lfd integer
The last four digits of the card (MAX 4; MIN 4).
Example: 0010

number_length integer
The length of the card's number (MAX 2; MIN 1).
Example: 16

security_code_length integer
The length of the card's security code (MAX 1; MIN 1).
Example: 3

brand string
The card's brand information (MAX 255; MIN 3).
Example: visa

holder_name string
Card holder's full name as it appears on the card (MAX 26; MIN 3) only available for PCI certified merchants.
Example: JOHN DOE

ticket object

Specifies the details of the payment method when using ticket.

type string
The ticket's type.
Example: number, barcode, custom, reference_code, qr

benefit_type enum
User´s benefit type for ticket payment method. JUNAEB, PRIVATE
Example: PRIVATE

date_of_expiration date
The ticket's expiration date in YYYY-MM-DD.
Example: 2022-05-20

provider_number integer
The ticket's number.
Example: 13141

provider_barcode integer
The ticket's barcode.
Example: 456789009878765u7654

provider_logo string
The ticket's logo.
Example: https://www.company.com/logo

provider_format string
The ticket's format.
Example: barcode, custom

payment_instruction 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

redirect_url string
The URL with the full version of the ticket.
Example: https://www.company.com/ticket_1231324

payment_link object

Specifies the details of the payment method when using a payment link.

verify boolean
Using amount = 0 and verify = true, you can verify the user's card without authorizing a real amount.
Possible values: True or False

capture 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 False

installments integer
The card installments (MAX 50; MIN 1).
Example: 3

payment_method_id string
The user's payment method used in their wallet.
Example: credit_card

detail string
The payment method's detail used in their wallet.
Example: visa

date_of_expiration date
Expiration date for an offline payment method.
Example: 2022-05-09T00:00:00.000000Z

money_release_date date
Date in which the money from the provider will be available to use.
Example: 2022-05-09T00:00:00.000000Z

sponsor_id string
Partner's provider account (MAX 255; MIN 3).
Example: 4562103

authorization_code string
Acquire's response code.
Example: 742A64

customer_data object

Specifies the details of the customer.

email string
The customer's email (MAX 255; MIN 3).
Example: [email protected]

first_name string
The customer's first name (MAX 32, MIN 8).
Example: John

last_name string
The customer's last name (MAX 32, MIN 8).
Example: Doe

username string
The customer's username in the platform (MAX 32, MIN 8).
Example: John_Doe_01

identification_type string
The customer's document type (MAX 32, MIN 8).
Possible values: Check the Country reference. Example: DNI

identification_number string
The customer's identification number (MAX 32, MIN 8).
Example: 34566123

fee_details object

Specifies the details of the fees.

amount float
Amount of the transaction (multiple of 0.0001).
Example: 40.5

card_data object

Specifies the details of the card.

iin 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

lfd integer
The last four digits of the card (MAX 4; MIN 4).
Example: 0010

number_length integer
The length of the card's number (MAX 2; MIN 1).
Example: 16

security_code_length integer
The length of the card's security code (MAX 1; MIN 1).
Example: 3

brand string
The card's brand information (MAX 255; MIN 3).
Example: visa

holder_name string
Card holder's full name as it appears on the card (MAX 26; MIN 3) only available for PCI certified merchants.
Example: John Doe

expiration_month integer
Card's expiration month (MM) (MAX 2; MIN 2).
Example: 03

expiration_year integer
Card's expiration year (YYYY) (MAX 4; MIN 2).
Example: 30

customer_payer object

Specifies customer object for payments.

id 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-0242ac120002

merchant_customer_id string
The unique identifier of the customer in the external merchant (MAX 255; MIN 3).
Example: 4ce6f7e1-bf2e-4e7f-bc1b-84b26082a1d3

merchant_customer_created_at timestamp
Customer´s registration date on the merchants platform (ISO 8601 MAX 27; MIN 27).
Example: 2022-05-09T20:46:54.786342Z

first_name string
The customer's first name (MAX 255; MIN 1).
Example: John

last_name string
The customer's last name (MAX 255; MIN 1).
Example: Doe

gender 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.

date_of_birth string
The customer's date of birth in the YYYY-MM-DD format (Length: 10).
Example: 1990-02-28

email string
The customer's e-mail (MAX 255; MIN 3).
Example: [email protected]

nationality enum
The customer's nationality (MAX 2; MIN 2; ISO 3166-1).
Possible enum values: Check the Country reference.

device_fingerprint 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.....

device_fingerprints 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.

provider_id enum
The fraud screening provider id
Example: RISKIFIED

id string
The device fingerprint associated to the provider
Example: hi88287gbd8d7d782ge.....

ip_address string
The customer's IP address (MAX 45; MIN 7).
Example: 192.168.123.167

browser_info object

Specifies the browser_info object.

accept_header boolean
The accept header value of the customer's browser.
Possible values: True or False

color_depth float
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

javascript_enabled boolean
Indicates if Javascript is enabled or not in the device.
Possible values: True or False

language string
The navigator.language value of the customer's browser (as defined in IETF BCP 47) (MAX 5; MIN 1).
Example: es-ES

screen_height string
The total height of the customer's device screen in pixels (MAX 255; MIN 3).
Example: 2048

screen_width string
The total width of the customer's device screen in pixels (MAX 255; MIN 3).
Example: 1152

user_agent 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

document object

Specifies the customer's document object, including its number and type.

document_number string
The customer's document number (MAX 40; MIN 3).
Example: 1093333333

document_type enum
The customer's document type (MAX 6, MIN 2).
Possible enum values: Check the Country reference.

phone object

Specifies the customer's phone object, including number and code.

number string
The customer's phone number (MAX 40; MIN 3).
Example: 11992149494

country_code string
The country calling code of the customer's phone (MAX 3; MIN 1).
Possible values: Check the Country reference.

billing_address object

Specifies the customer's billing address object.

address_line_1 string
The primary billing address line of the customer (MAX 255; MIN 3).
Example: Calle 34 # 56 - 78

address_line_2 string
The secondary billing address line of the customer (MAX 255; MIN 3).
Example: Apartamento 502, Torre I

city string
The city considered for the billing address (MAX 255; MIN 3).
Example: Bogotá

country enum
The country considered for the billing address (MAX 2; MIN 2; ISO 3166-1).
Possible enum values: Check the Country reference.

state string
The state considered for the billing address (MAX 255; MIN 3).
Example: Cundinamarca

zip_code string
The zipcode considered for the billing address (MAX 11; MIN 4).
Example: 111111

neighborhood string
The neighborhood of the address line of the customer(MAX 255; MIN 2).
Example: Barrio 11

shipping_address object

Specifies the customer's shipping address object.

address_line_1 string
The primary shipping address line of the customer (MAX 255; MIN 3).
Example: Calle 34 # 56 - 78

address_line_2 string
The secondary shipping address line of the customer (MAX 255; MIN 3).
Example: Apartamento 502, Torre I

city string
The city considered for the shipping address (MAX 255; MIN 3).
Example: Bogotá

country enum
The country considered for the shipping address (MAX 2; MIN 2; ISO 3166-1).
Possible enum values: Check the Country reference.

state string
The state considered for the shipping address (MAX 255; MIN 3).
Example: Cundinamarca

zip_code string
The zipcode considered for the shipping address (MAX 11; MIN 4).
Example: 111111

neighborhood string
The neighborhood of the address line of the customer (MAX 255; MIN 2).
Example: Barrio 11

additional_data 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.

airline object

Specifies the airline object. Passengers and tickets should have the same order information.

pnr string
Passenger name record (MAX 10; MIN 1).
Example: 1P-2UUGJW

legs array of object

Specifies the legs array of objects.

arrival_airport string
IATA airport code (MAX 3; MIN 3). See http://www.iata.org.
Example: AMS

arrival_datetime timestamp
The arrival date and time in local time at the arrival airport.
Example: 2022-05-09T24:46:54.786342Z

base_fare float
The transaction amount, excluding taxes and fees, the smallest unit of currency (multiple of 0.0001).
Example: 23.5676

base_fare_currency string
The currency used to transaction amount (MAX 3; MIN 3; ISO 4217).
Example: Check the Country reference.

carrier_code string
IATA carrier code (MAX 2; MIN 2). See http://www.iata.org.
Example: KL

departure_airport string
IATA code (MAX 3; MIN 3). See http://www.iata.org.
Example: EZE

departure_airport_timezone string
Airport timezone (MAX 6; MIN 6).
Example: -03:00

departure_datetime timestamp
The departure date and time in local time at the departure airport.
Example: 2022-05-09T20:46:54.786342Z

fare_basis_code 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

fare_class_code 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

flight_number string
The flight number assigned by the airline carrier (MAX 5; MIN 1).
Example: 842

stopover_code 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

passengers array of objects

Specifies the array of objects that represents the passengers associated to the tickets.

country enum
Country where the document was issued (MAX 2; MIN 2; ISO 3166-1).
Possible enum values: Check the Country reference.

date_of_birth string
The passenger's date of birth in the YYYY-MM-DD format (MAX 10; MIN 10).
Example: 1990-02-28

document object

Specifies the document object for the passenger.

document_number string
The passenger's document number (MAX 40; MIN 3).
Example: 1093333333

document_type enum
The passenger's document type (MAX 6, MIN 2).
Possible enum values: Check the Country reference.

country enum
Country where the document was issued (MAX 2; MIN 2; ISO 3166-1).
Possible enum values: Check the Country reference.

phone object

Specifies the phone object for the passenger.

country_code string
The country calling code of the passenger's phone (MAX 3; MIN 1).
Possible values: Check the Country reference

number string
The passenger's phone number, without the country code (MAX 32; MIN 1).
Example: 1130292837

email string
The passenger's email (MAX 255; MIN 3).
Example: [email protected]

first_name string
The passenger's first name (MAX 255; MIN 3).
Example: John

last_name string
The passenger's last name (MAX 255; MIN 3).
Example: Doe

loyalty_number string
Number of passenger loyalty program (MAX 20, MIN 1).
Example: 254587547

loyalty_tier enum
Tier of passenger loyalty program (MAX 255; MIN 3).
Possible enum values: Check the Loyalty tier.

middle_name string
The passenger's middle name (MAX 255; MIN 3).
Example: Charles

nationality enum
The passenger's nationality (MAX 2; MIN 2; ISO 3166-1).
Possible enum values: Check the Country reference.

type enum
The type of passenger (MAX 1; MIN 1).
Possible enum values: Check the Passenger type list.

tickets array of objects

Specifies the array of tickets associated with the passengers.

ticket_number string
Ticket number (MAX 14; MIN 1).
Example: 7411823255523

e_ticket boolean
Is this an e-ticket?
Possible values: True or False

restricted boolean
Indicates if the ticket is refunfable or not.
Possible values: True or False

total_fare_amount float
Total fare amount in the smallest unit of currency (multiple of 0.0001).
Example: 80000

total_tax_amount float
Total taxes amount in the smallest unit of currency (multiple of 0.0001).
Example: 14800

total_fee_amount float
Total fee amount in the smallest unit of currency (multiple of 0.0001).
Example: 25200

issue object

Specifies the issue object.

address string
Address of the agent who sold the ticket (MAX 255; MIN 3).
Example: Apartamento 502, Torre I

zip_code string
Zip code of the agent who sold the ticket.
Example: 1636

carrier_prefix_code string
Issuing or Validating carrier. This is the AWB Prefix (Air waybill) IATA 3-numeric code (MAX 3; MIN 3).
Example: 044

city string
City name of the agent who sold the ticket (MAX 255; MIN 3).
Example: Bogotá

country enum
Country code where the ticket was issued (MAX 2; MIN 2; ISO 3166-1).
Possible enum values: Check the Country code list.

date string
Ticket issuing date.
Example: 1979-01-12

travel_agent_code string
Code of the travel agent issuing the ticket.
Example: 10655823

travel_agent_name 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

order object

Specifies the order object.

shipping_amount 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

fee_amount 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

tip_amount 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

taxes array of objects

Specifies the order's tax object.

type string
Type of the tax.
Example: VAT

tax_base float
The amount base to apply the tax defined.
Example: 10000

value float
The amount of the tax.
Example: 2100

percentage float
The percentage of the tax.
Example: 21

items array of object

Specifies the item's object.

id string
The unique identifier of the item (MAX 255; MIN 3).
Example: 3214

name string
The name of the item (MAX 255; MIN 3).
Example: iPhone 12 Pro Max

quantity int
The quantity of the item (MAX 999; MIN 1).
Example: 1

unit_amount float
The unit amount of the item (multiple of 0.0001).
Example: 550

category string
The category of the item (MAX 255; MIN 3).
Possible values: Check the Item category list.

brand string
The brand of the item (MAX 255; MIN 3).
Example: Apple

sku_code string
The stock keeping unit (SKU) of the item (MAX 255; MIN 3).
Example: A2342

manufacture_part_number string
The manufacture part number of the item (MAX 255; MIN 3).
Example: 345621234

shipping object

Specifies the shipping details object.

type enum
Type of shippment.
Example: STANDARD
Possible enum values: Check the Shipping reference.

description string
The description of the shipping (MAX 255; MIN 1).
Example: Shipping of sample shirt

carrier enum
The carrier used for the delivery.
Example: UPS
Possible enum values: Check the Shipping reference.

deliver_at timestamp
Estimated date of delivery (ISO 8601 MAX 27; MIN 27).
Example: 2025-09-17T20:43:54.786342Z

seller_details object

Specifies the seller's details object.

name string
The seller's legal name (MAX 255; MIN 3).
Example: Jhon Doe

email string
The seller's e-mail (MAX 255; MIN 3).
Example: [email protected]

reference string
The seller's identification code (MAX 255; MIN 3).
Example: Seller

website string
The seller's website URL (MAX 255; MIN 3).
Example: https://www.test.com/1231324

industry enum
The seller's industry (MAX 255; MIN 3).
Possible enum values: Check the Industry category.

merchant_category_code string
MCC - The merchant category code (MAX 235; MIN 1).
Example: 6199

country enum
The seller's country (MAX 255; MIN 3).
Possible enum values: Check the Country code list.

document object

Specifies the document object of the seller.

document_number string
The seller's document number (MAX 40; MIN 3).
Example: 1093333333

document_type enum
The seller's document type (MAX 6, MIN 2).
Possible enum values: Check the Country reference.

phone object

Specifies the seller's phone number object.

country_code string
The country calling code of the seller's phone (MAX 3; MIN 1). Possible values: Check the Country reference.
Example: 57

number string
The seller's phone number, without the country code (MAX 32; MIN 1).
Example: 3132450765

address object

Specifies the seller's address object.

address_line_1 string
The primary address line of the seller (MAX 255; MIN 3).
Example: Calle 34 # 56 - 78

address_line_2 string
The secondary billing address line of the seller (MAX 255; MIN 3).
Example: Apartamento 502, Torre I

city string
The city considered for the seller's address (MAX 255; MIN 3).
Example: Bogotá

country enum
The country considered for the seller's address (MAX 2; MIN 2,ISO 3166-1).
Possible enum values: Check the Country code list.

state string
The state considered for the seller's address (MAX 255; MIN 3).
Example: Cundinamarca

zip_code string
The zipcode considered for the seller's address (MAX 11; MIN 4).
Example: 111111

account_funding object

Specifies the account funding structure for transfers and payments.

sender object

Specifies the sender's information.

national_entity enum
Sender's national entity type. Possible values:

  • INDIVIDUAL
  • ENTITY

first_name string
Sender's first name (MAX 80).
Example: John

last_name string
Sender's last name (MAX 80).
Example: Doe

email string
Sender's email (MAX 255; MIN 3).
Example: [email protected]

date_of_birth date
Sender's date of birth in the YYYY-MM-DD format (MAX 10; MIN 10).
Example: 1990-02-28

phone object

Specifies the phone object.

country_code string
Sender's phone country code (MAX 3; MIN 2).
Example: 57

number string
Sender's phone number (MAX 32; MIN 1).
Example: 3132450765

document object

Specifies the document object.

document_number string
Sender's national document ID (MAX 40; MIN 3).
Example: 1093333333

document_type enum
Sender's document type (MAX 6; MIN 2).
Example: CC

address object

Specifies the address object.

address_line_1 string
Primary billing address (MAX 255; MIN 3).
Example: Calle 34 # 56 - 78

address_line_2 string
Secondary billing address (MAX 255; MIN 3).
Example: Apartamento 502, Torre I

city string
City for the billing address (MAX 255; MIN 3).
Example: Bogota

country enum
Country for the billing address (ISO 3166-1; MAX 2; MIN 2).
Example: CO

state string
State or province for the billing address (MAX 255; MIN 3).
Example: Cundinamarca

zip_code string
ZIP code for the billing address (MAX 11; MIN 4).
Example: 111111

recipient object

Specifies the recipient's information.

national_entity enum
Recipient's national entity type. Possible values:

  • INDIVIDUAL
  • ENTITY

legal_name string
Recipient's legal name. Required if national_entity is ENTITY (MAX 80).
Example: Arcos dorados S.A.

email string
Recipient's email (MAX 255; MIN 3).
Example: [email protected]

date_of_birth date
Recipient's date of birth in the YYYY-MM-DD format (MAX 10; MIN 10).
Example: 1985-07-15

phone object

Specifies the phone object.

country_code string
Recipient's phone country code (MAX 3; MIN 2).
Example: 57

number string
Recipient's phone number (MAX 32; MIN 1).
Example: 3132450765

document object

Specifies the document object.

document_number string
Recipient's national document ID (MAX 40; MIN 3).
Example: 1093333333

document_type enum
Recipient's document type (MAX 6; MIN 2).
Example: CC

address object

Specifies the address object.

address_line_1 string
Primary billing address (MAX 255; MIN 3).
Example: Calle 34 # 56 - 78

address_line_2 string
Secondary billing address (MAX 255; MIN 3).
Example: Apartamento 502, Torre I

city string
City for the billing address (MAX 255; MIN 3).
Example: Bogota

country enum
Country for the billing address (ISO 3166-1; MAX 2; MIN 2).
Example: CO

state string
State or province for the billing address (MAX 255; MIN 3).
Example: Cundinamarca

zip_code string
ZIP code for the billing address (MAX 11; MIN 4).
Example: 111111

taxes object

[Deprecated - For a correct use of the taxes object, please refer to the Taxes struct in the additional_data.order object - Changelog] Specifies the order's tax object.

type string
Type of the tax.
Example: VAT

tax_base float
The amount base to apply the tax defined.
Example: 10000

value float
The amount of the tax.
Example: 2100

percentage float
The percentage of the tax.
Example: 21

transactions object

Specifies the transaction details associated with a payment.

id string
The unique identifier of the transaction (MAX 64; MIN 36).
Example: 7bf8f1f6-4081-41ec-a024-a927056e00ab

type string
The transaction type.
Example: PURCHASE

status enum
The status of the transaction.
Example: SUCCEEDED

category string
The category of the payment method used in the transaction.
Example: CARD

amount string
The amount of the transaction.
Example: 100

provider_id string
The id of the provider that processed the transaction.
Example: DLOCAL

payment_method object

Specifies the payment method details used in the transaction.

vaulted_token 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

type string
Type of the payment method. Mandatory for DIRECT or REDIRECT workflow.
Possible enum values:
Possible enum values: Check the payment type reference.

vault_on_success boolean
Flag to enroll the card after a successful payment.
Possible values: True or False

token string
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

parent_payment_method_type 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

detail object

Specifies the payment method detail object, which provides details of the different transaction category types that are part of the payment method object.

card object

Specifies the details of the payment method when using a card.

verify boolean
Using amount = 0 and verify = true, you can verify the user's card without authorizing a real amount.
Possible values: True or False

capture 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 False

installments integer
The card installments (MAX 50; MIN 1).
Example: 3

first_installments_deferral integer
Number of months to wait to debit the first installment.
Example: 1

installments_type string
Type of installments used in the card payment.
Example: string

installments_amount integer
The installment amount includes interests associated with the installment and the information is defined by the provider.
Example: 3

soft_descriptor string
The descriptor passed per transaction to out platform. It will be presented on the customer's physical bank statement (MAX 15; MIN 0).
Example: COMPANY1

authorization_code string
The acquirer's response code.
Example: 742A64

retrieval_reference_number integer
The unique identifier assigned by an acquirer to an authorization.
Example: 200000000012

voucher string
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

card_data object

Specifies the details of the card.

holder_name string
Card holder's full name as it appears on the card (MAX 26; MIN 3) only available for PCI certified merchants.
Example: Fannie Weissnat

iin 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

lfd integer
The last four digits of the card (MAX 4; MIN 4).
Example: 0010

number_length integer
The length of the card's number (MAX 2; MIN 1).
Example: 16

security_code_length integer
The length of the card's security code (MAX 1; MIN 1).
Example: 3

brand string
The card's brand information (MAX 255; MIN 3).
Example: VISA

issuer_name string
The card's issuer (MAX 255; MIN 3).
Example: Banco Galicia

category string
The category of the card's issuer (MAX 255; MIN 3).
Example: Gold

type 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-820751799c76

three_d_secure object

Specifies the details of the 3DS Transaction.

three_d_secure_setup_id string
Setup ID obteined for the 3DS Direct flow.
Example: 24127d61-b852-42fb-acd4-1ee661645376

version 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

electronic_commerce_indicator 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

cryptogram 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 =

transaction_id 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”

directory_server_transaction_id string
Transaction ID generated by the Mastercard directory server during authentication (MAX 255; MIN 3).
Example: f38e6948-5388-41a6-bca4-b49723c19437

network_token object

Information about the network token used for the transaction. If applicable.

network enum
The provider associated to the token provided. VISA, MASTERCARD, AMERICAN_EXPRESS.
Example: MASTERCARD

status enum
Status of the token for the payment method. CREATED, ACTIVE, SUSPENDED, CANCELED.
Example: ACTIVE

par string
Payment account reference.
Example: MCC123456789012

token_data object

Token details.

number number
[Mandatory] Token’s number without any separators (MAX 19; MIN 8) only available for PCI certified merchants.
Example: 450799000001234

holder_name string
Cardholder’s full name as it appears on the Token (MAX 26; MIN 3).
Example: John Doe

iin 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

lfd number
Last four digits of the network token (MAX 4; MIN 4).
Example: 1234

expiration_month number
Network Token’s expiration month (MM) (MAX 2; MIN 2).
Example: 12

expiration_year number
Network Token’s expiration year (YYYY) (MAX 4; MIN 2).
Example: 2027

cryptogram string
[Mandatory] - The unique cryptogram generated by the issuer for the network token in use in the transaction.

electronic_commerce_indicator 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.

token_requestor_id string
[Only required for certain providers] - Token requestor ID of the merchant

response object

Network transaction details.

code number
Response code from the service provider.
Example: succeeded

message number
Response code from the service provider.
Example: Transaction Succeeded

stored_credentials object

Indicates the processing type of the transaction.

reason enum
Indicates the processing type of the transaction.Enum:CARD_ON_FILE, SUBSCRIPTION, UNSCHEDULED_CARD_ON_FILE
Example: SUBSCRIPTION

usage 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, USED
Example: USED

subscription_agreement_id 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

network_Transaction_id 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

wallet object

Specifies the details of the payment method when using a wallet.

verify boolean
Using amount = 0 and verify = true, you can verify the user's card without authorizing a real amount.
Possible values: True or False

cryptogram string
Cryptogram for direct integrations with card wallets (MAX 526; MIN 3).

capture 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 False

installments integer
The card installments (MAX 50; MIN 1).
Example: 3

payment_method_id string
The user's payment method used in their wallet.
Example: credit_card

detail string
The payment method's detail used in their wallet.
Example: visa

date_of_expiration date
Expiration date for an offline payment method.
Example: 2022-05-09T00:00:00.000000Z

money_release_date date
Date in which the money from the provider will be available to use.
Example: 2022-05-09T00:00:00.000000Z

sponsor_id string
Partner's provider account (MAX 255; MIN 3).
Example: 4562103

authorization_code string
Acquire's response code.
Example: 742A64

customer_data object

Specifies the details of the customer.

email string
The customer's email (MAX 255; MIN 3).
Example: [email protected]

first_name string
The customer's first name (MAX 32, MIN 8).
Example: John

last_name string
The customer's last name (MAX 32, MIN 8).
Example: Doe

username string
The customer's username in the platform (MAX 32, MIN 8).
Example: John_Doe_01

identification_type string
The customer's document type (MAX 32, MIN 8).
Check the Country reference. Example: DNI

identification_number string
The customer's identification number (MAX 32, MIN 8).
Example: 34566123

fee_details object

Specifies the details of the fees.

amount float
Amount of the transaction (multiple of 0.0001).
Example: 40.5

card_data object

Specifies the details of the card.

iin 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

lfd integer
The last four digits of the card (MAX 4; MIN 4).
Example: 0010

number_length integer
The length of the card's number (MAX 19; MIN 8).
Example: 19

security_code_length integer
The length of the card's security code (MAX 1; MIN 1).
Example: 3

brand string
The card's brand information (MAX 255; MIN 3).
Example: visa

holder_name string
Card holder's full name as it appears on the card (MAX 26; MIN 3) only available for PCI certified merchants.
Example: JOHN DOE

bnpl object

Specifies the details of the payment method when using BNPL.

installments integer
The loan installments (MAX 50; MIN 1).
Example: 10

provider_image string
The provider's URL (MAX 255; MIN 3).
Example: https://www.company.com/

redirect_url 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

customer_data object

Specifies the details of the customer.

name string
The customer's legal name (MAX 32, MIN 8).
Example: Legal name

username string
Customer's username in the provider platform (MAX 32, MIN 8).
Example: Legal_name_01

tax_id_type string
The customer's tax identifier (MAX 32, MIN 8).
Example: CUIT

tax_id string
The customer's tax identifier number (MAX 32, MIN 8).
Example: 20-34566123-7

type string
The credit's type (MAX 255; MIN 3).
Example: PERSONAL/BUSINESS

area string
The customer's industry (MAX 255; MIN 3).
Example: OTHERS

role string
The customer's role in the company (MAX 255; MIN 3).
Example: OWNER

bank_transfer object

Specifies the details of the payment method when using bank transfer.

provider_image string
The provider's URL (MAX 255; MIN 3).
Example: https://www.company.com/logo

account_type string
Type of the bank account (MAX 255; MIN 3).
Example: CHECKINGS/SAVINGS

bank_name string
Name of the bank associated with the account (MAX 255; MIN 3).
Example: Banco Galicia

beneficiary_name string
The name of the account holder (MAX 255; MIN 3).
Example: John Doe

bank_account string
The number of the bank account (MAX 255; MIN 3).
Example: 54653211313333

bank_account_2 string
The secondary number of the bank account (MAX 255; MIN 3).
Example: 78900000000123

beneficiary_document_type string
Document type of the account holder (MAX 255; MIN 3).
Possible values: Check the Country reference. Example: DNI

beneficiary_document string
Document number of the account holder (MAX 255; MIN 3).
Example: 54666897

reference string
Reference code for the user (MAX 255; MIN 3).
Example: AA01234-BC

retrieval_reference_number string
The unique identifier assigned by an acquirer to an authorization.
Example: 200000000012

payment_instruction 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

redirect_url 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

ticket object

Specifies the details of the payment method when using ticket.

type string
The ticket's type.
Example: number, barcode, custom, reference_code, qr

benefit_type enum
User´s benefit type for ticket payment method. JUNAEB, PRIVATE
Example: PRIVATE

date_of_expiration date
The ticket's expiration date in YYYY-MM-DD.
Example: 2022-05-20

provider_number integer
The ticket's number.
Example: 13141

provider_barcode integer
The ticket's barcode.
Example: 456789009878765u7654

provider_logo string
The ticket's logo.
Example: https://www.company.com/logo

provider_format string
The ticket's format.
Example: barcode, custom

payment_instruction 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

redirect_url string
The URL with the full version of the ticket.
Example: https://www.company.com/ticket_1231324

payment_link object

Specifies the details of the payment method when using a payment link.

verify boolean
Using amount = 0 and verify = true, you can verify the user's card without authorizing a real amount.
Possible values: True or False

capture 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 False

installments integer
The card installments (MAX 50; MIN 1).
Example: 3

payment_method_id string
The user's payment method used in their wallet.
Example: credit_card

detail string
The payment method's detail used in their wallet.
Example: visa

date_of_expiration date
Expiration date for an offline payment method.
Example: 2022-05-09T00:00:00.000000Z

money_release_date date
Date in which the money from the provider will be available to use.
Example: 2022-05-09T00:00:00.000000Z

sponsor_id string
Partner's provider account (MAX 255; MIN 3).
Example: 4562103

authorization_code string
Acquire's response code.
Example: 742A64

customer_data object

Specifies the details of the customer.

email string
The customer's email (MAX 255; MIN 3).
Example: [email protected]

first_name string
The customer's first name (MAX 32, MIN 8).
Example: John

last_name string
The customer's last name (MAX 32, MIN 8).
Example: Doe

username string
The customer's username in the platform (MAX 32, MIN 8).
Example: John_Doe_01

identification_type string
The customer's document type (MAX 32, MIN 8).
Possible values: Check the Document type list. Example: DNI

identification_number string
The customer's identification number (MAX 32, MIN 8).
Example: 34566123

fee_details object

Specifies the details of the fees.

amount float
Amount of the transaction (multiple of 0.0001).
Example: 40.5

card_data object

Specifies the details of the card.

iin 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

lfd integer
The last four digits of the card (MAX 4; MIN 4).
Example: 0010

number_length integer
The length of the card's number (MAX 19; MIN 8).
Example: 19

security_code_length integer
The length of the card's security code (MAX 1; MIN 1).
Example: 3

brand string
The card's brand information (MAX 255; MIN 3).
Example: visa

holder_name string
Card holder's full name as it appears on the card (MAX 26; MIN 3) only available for PCI certified merchants.
Example: John Doe

response_code string
The code that represents the response of the te outcome of the transaction.
Example: SUCCEEDED

response_message string
The description of the response_code.
Example: Transaction successful

reason string
The reason for the transaction. Applies to secondary transactions, such as refunds or captures.
Example: REQUESTED_BY_CUSTOMER

description string
The description of the payment (MAX 255; MIN 3).
Example: Purchase on web

merchant_reference string
The reference generated by the merchant to identify the payment/transaction.
Example: AA01

provider_data object

Specifies the provider data that processed the payment.

id string
The provider id that processed the payment.
Example: DLOCAL

transaction_id string
The id of the transaction from the provider.
Example: 5a1fa541-5fa2-496e-9fdc-29b34e09a107

third_party_account_id string
The id of the account from the processor of the provider. If applies.
Example: AA001298

third_party_transaction_id string
The id of the transaction from the processor of the provider. If applies.
Example: 1309982

account_id string
The unique identifier of the account (MAX 64; MIN 36).
Example: 9104911d-5df9-429e-8488-ad41abea1a4b

status enum
The status of the transaction.
Example: SUCCEEDED

status_detail string
The status_detail of the transaction.
Example: APPROVED

response_code string
The code that represents the response of the te outcome of the transaction from the provider.
Example: SUCCEEDED

response_message string
Message to provide additional information regarding the operation status.
Example: Successful transaction

iso8583_response_code object
The code of the international standard for financial transaction card originated interchange messaging (ISO 8583).
Example: 00

iso8583_response_message object
The message of the international standard for financial transaction card originated interchange messaging (ISO 8583).
Example: Approved or completed successfully

raw_notification 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

detail object

Specifies the payment method detail object returned by the provider, which specifies the details of the different transaction category types.

card object

Specifies the details of the payment method when using a card.

verify boolean
Using amount = 0 and verify = true, you can verify the user's card without authorizing a real amount.
Possible values: True or False

capture 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 False

installments integer
The card installments (MAX 50; MIN 1).
Example: 3

first_installments_deferral integer
Number of months to wait to debit the first installment.
Example: 1

installments_type string
Type of installments used in the card payment.
Example: string

installments_amount integer
The installment amount includes interests associated with the installment and the information is defined by the provider.
Example: 3

soft_descriptor string
The descriptor passed per transaction to out platform. It will be presented on the customer's physical bank statement (MAX 15; MIN 0).
Example: COMPANY1

authorization_code string
The acquirer's response code.
Example: 742A64

retrieval_reference_number integer
The unique identifier assigned by an acquirer to an authorization.
Example: 200000000012

voucher string
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

card_data object

Specifies the details of the card.

holder_name string
Card holder's full name as it appears on the card (MAX 26; MIN 3) only available for PCI certified merchants.
Example: Fannie Weissnat

iin 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

lfd integer
The last four digits of the card (MAX 4; MIN 4).
Example: 0010

number_length integer
The length of the card's number (MAX 2; MIN 1).
Example: 16

security_code_length integer
The length of the card's security code (MAX 1; MIN 1).
Example: 3

brand string
The card's brand information (MAX 255; MIN 3).
Example: VISA

issuer_name string
The card's issuer (MAX 255; MIN 3).
Example: Banco Galicia

category string
The category of the card's issuer (MAX 255; MIN 3).
Example: Gold

type string
The type of the card's issuer (MAX 255; MIN 3).
Example: CREDIT, DEBIT, or CHARGE_CARD

wallet object

Specifies the details of the payment method when using a wallet.

verify boolean
Using amount = 0 and verify = true, you can verify the user's card without authorizing a real amount.
Possible values: True or False

cryptogram string
Cryptogram for direct integrations with card wallets (MAX 526; MIN 3).

capture 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 False

installments integer
The card installments (MAX 50; MIN 1).
Example: 3

payment_method_id string
The user's payment method used in their wallet.
Example: credit_card

detail string
The payment method's detail used in their wallet.
Example: visa

date_of_expiration date
Expiration date for an offline payment method.
Example: 2022-05-09T00:00:00.000000Z

money_release_date date
Date in which the money from the provider will be available to use.
Example: 2022-05-09T00:00:00.000000Z

sponsor_id string
Partner's provider account (MAX 255; MIN 3).
Example: 4562103

authorization_code string
Acquire's response code.
Example: 742A64

customer_data object

Specifies the details of the customer.

email string
The customer's email (MAX 255; MIN 3).
Example: [email protected]

first_name string
The customer's first name (MAX 32, MIN 8).
Example: John

last_name string
The customer's last name (MAX 32, MIN 8).
Example: Doe

username string
The customer's username in the platform (MAX 32, MIN 8).
Example: John_Doe_01

identification_type string
The customer's document type (MAX 32, MIN 8).
Check the Country reference. Example: DNI

identification_number string
The customer's identification number (MAX 32, MIN 8).
Example: 34566123

fee_details object

Specifies the details of the fees.

amount float
Amount of the transaction (multiple of 0.0001).
Example: 40.5

card_data object

Specifies the details of the card.

iin 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

lfd integer
The last four digits of the card (MAX 4; MIN 4).
Example: 0010

number_length integer
The length of the card's number (MAX 19; MIN 8).
Example: 19

security_code_length integer
The length of the card's security code (MAX 1; MIN 1).
Example: 3

brand string
The card's brand information (MAX 255; MIN 3).
Example: visa

holder_name string
Card holder's full name as it appears on the card (MAX 26; MIN 3) only available for PCI certified merchants.
Example: JOHN DOE

bnpl object

Specifies the details of the payment method when using BNPL.

installments integer
The loan installments (MAX 50; MIN 1).
Example: 10

provider_image string
The provider's URL (MAX 255; MIN 3).
Example: https://www.company.com/logo

redirect_url 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

customer_data object

Specifies the details of the customer.

name string
The customer's legal name (MAX 32, MIN 8).
Example: Legal name

username string
Customer's username in the provider platform (MAX 32, MIN 8).
Example: Legal_name_01

tax_id_type string
The customer's tax identifier (MAX 32, MIN 8).
Example: CUIT

tax_id string
The customer's tax identifier number (MAX 32, MIN 8).
Example: 20-34566123-7

type string
The credit's type (MAX 255; MIN 3).
Example: PERSONAL/BUSINESS

area string
The customer's industry (MAX 255; MIN 3).
Example: OTHERS

role string
The customer's role in the company (MAX 255; MIN 3).
Example: OWNER

bank_transfer object

Specifies the details of the payment method when using bank transfer.

provider_image string
The provider's URL (MAX 255; MIN 3).
Example: https://www.company.com/

account_type string
Type of the bank account (MAX 255; MIN 3).
Example: CHECKINGS/SAVINGS

bank_name string
Name of the bank associated with the account (MAX 255; MIN 3).
Example: Banco Galicia

beneficiary_name string
The name of the account holder (MAX 255; MIN 3).
Example: John Doe

bank_account string
The number of the bank account (MAX 255; MIN 3).
Example: 54653211313333

bank_account_2 string
The secondary number of the bank account (MAX 255; MIN 3).
Example: 78900000000123

beneficiary_document_type string
Document type of the account holder (MAX 255; MIN 3).
Possible values: Check the Country reference. Example: DNI

beneficiary_document string
Document number of the account holder (MAX 255; MIN 3).
Example: 54666897

payment_instruction 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

redirect_url 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

ticket object

Specifies the details of the payment method when using ticket.

type string
The ticket's type.
Example: number, barcode, custom, reference_code, qr

date_of_expiration date
The ticket's expiration date in YYYY-MM-DD.
Example: 2022-05-20

provider_number integer
The ticket's number.
Example: 13141

provider_barcode integer
The ticket's barcode.
Example: 456789009878765u7654

provider_logo string
The ticket's logo.
Example: https://www.company.com/logo

provider_format string
The ticket's format.
Example: barcode, custom

redirect_url string
The url with the full version of the ticket.
Example: https://www.company.com/ticket_1231324

payment_link object

Specifies the details of the payment method when using a payment link.

verify boolean
Using amount = 0 and verify = true, you can verify the user's card without authorizing a real amount.
Possible values: True or False

capture 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 False

installments integer
The card installments (MAX 50; MIN 1).
Example: 3

payment_method_id string
The user's payment method used in their wallet.
Example: credit_card

detail string
The payment method's detail used in their wallet.
Example: visa

date_of_expiration date
Expiration date for an offline payment method.
Example: 2022-05-09T00:00:00.000000Z

money_release_date date
Date in which the money from the provider will be available to use.
Example: 2022-05-09T00:00:00.000000Z

sponsor_id string
Partner's provider account (MAX 255; MIN 3).
Example: 4562103

authorization_code string
Acquire's response code.
Example: 742A64

customer_data object

Specifies the details of the customer.

email string
The customer's email (MAX 255; MIN 3).
Example: [email protected]

first_name string
The customer's first name (MAX 32, MIN 8).
Example: John

last_name string
The customer's last name (MAX 32, MIN 8).
Example: Doe

username string
The customer's username in the platform (MAX 32, MIN 8).
Example: John_Doe_01

identification_type string
The customer's document type (MAX 32, MIN 8).
Possible values: Check the Country reference. Example: DNI

identification_number string
The customer's identification number (MAX 32, MIN 8).
Example: 34566123

fee_details object

Specifies the details of the fees.

amount float
Amount of the transaction (multiple of 0.0001).
Example: 40.5

card_data object

Specifies the details of the card.

iin 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

lfd integer
The last four digits of the card (MAX 4; MIN 4).
Example: 0010

number_length integer
The length of the card's number (MAX 19; MIN 8).
Example: 19

security_code_length integer
The length of the card's security code (MAX 1; MIN 1).
Example: 3

brand string
The card's brand information (MAX 255; MIN 3).
Example: visa

holder_name string
Card holder's full name as it appears on the card (MAX 26; MIN 3) only available for PCI certified merchants.
Example: John Doe

connection_data object

Specifies the connection data object, which represents the connection used to process the transaction.

id string
The unique identifier of the payment connection in Yuno (MAX 64 ; MIN 36).
Example: 88292fd3-bf5b-4b23-bb95-7186ba4e7f88

created_at timestamp
The date and time when the transaction was created.
Example: 2022-05-09T20:46:54.786342Z

updated_at timestamp
The date and time from the last time the transaction was updated.
Example: 2022-05-09T20:46:54.786342Z

transactions_history array of objects
The list of the transactions that are part of a payment. It is going to depend on how many providers you have set up in your payment method route.

workflow 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.

callback_url 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

metadata array of objects

Specifies a list of metadata objects. You can add up to 50 metadata objects.

metadata object object

Specifies a metadata key and the respective value.

key string
Specifies one metadata key (MAX 48).
Example: age

value string
Specifies the value for the defined metadata key (MAX 512).
Example: 28

routing_rules array of objects

Returns the routing rules information during the payment creation.

smart_routing bool
Specifies if a transaction went through the smart routing feature or not.
Example: false

condition object

Object with the corresponding information for the routing condition that applies to the payment

id string
ID of the condition corresponding to the payment.
Example: 2404911d-5df9-429e-8488-ad41abea1a4b

name string
Name of the condition.
Example: PAYMENTS_COLOMBIA

description string
Description of the condition.
Example: This condition is set for payments made only in Colombia

fraud_screening array of objects

Provides information about the fraud scans used for the payment.

status enum
The final status of the screening process of the payment.
Example: SUCCEEDED

stand_alone 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

transactions object

Specifies the transaction details associated with a screening process of the payment.

id string
The id of the fraud transaction (MAX 64; MIN 36).
Example: ft12

type enum
Type of the fraud transaction.
Possible enum values: PRE_AUTH, POS_AUTH

status enum
The status of the transaction (MAX 255; MIN 3).
Example: SUCCEEDED

response_code enum
The response code of the transaction.
Example: FRAUD_VERIFIED

response_message enum
The response message of the transaction.
Example: Fraud approved

provider_data object

Specifies the provider data that processed the payment.

provider_id string
The id of the fraud prevention provider.
Example: CLEARSALE

transaction_id string
The id of the fraud transaction from the provider.
Example: AA001234567

status string
The provider fraud transaction status.
Example: APM

score string
The provider score for the transaction.
Example: 0.7

raw_response string
The raw_response of the provider.
Example: JSON

created_at timestamp
The date and time when the fraud screening was created.
Example: 2022-05-09T20:46:54.786342Z

updated_at timestamp
The date and time from the last time the fraud screening was updated.
Example: 2022-05-09T20:46:54.786342Z