Checkout sessions represent a temporary, tokenized context in which a payer completes a payment flow.
Objects
Checkout session object
Unique identifier for the internal service.
Reference Payment Link ID
Reference for checkout url
currencystringrequiredCurrency code enabled for the checkout session
productstringrequiredProduct conversion of the checkout session
exchangeRatestringrequiredProduct's exchange rate
paymentMethodsobject[]requiredPayment methods config list
idstringrequiredID specific type of Payment method
typestringrequiredGeneric type of Payment method
enabledbooleanrequiredEnabled boolean
requiredFieldsstring[]requiredList of required fields for the provider
purchaseAmountstringrequiredCalculated amount to pay for the Payment Method
When the link expires
ATTEMPTACTIVEEXPIREDFINISHEDPROCESSING_PAYMENTFAILEDList of items to pay for
preTaxAmountstringrequiredThe amount of the item
totalAmountstringrequiredamount + tax.amount, if no tax it's equal to amount
descriptionstringrequiredThe description of the item
taxobjectnullablenamestringrequiredThe name of the fee.
typestringrequiredFIXEDPERCENTAGEvaluestringrequiredThe value of the fee.
amountstringrequiredThe calculated amount of the fee.
Specifies the currency used, following the ISO 4217 standard for fiat currencies (e.g., CLP, ARS, MXN). Go to the currencies page for the complete list of supported values.
Addition of all items preTaxAmounts
Addition of all items totalAmounts
Url to open checkout flow
Allowed payment methods.
Optional customer to pass into the checkout session
idstringUnique identifier for the internal service.
firstNamestringPayer's name
emailstringPayer's email
lastNamestringPayer's last name
phoneNumberstringPayer's phone number without prefix
phoneNumberPrefixstringPhone number prefix (e.g., +57)
documentTypestringDocumeny type of the entity (e.g., RUT, CURP, CURL). Go to the Supported Identity document types page for the complete list of supported values.
documentNumberstringThe document number associated with the documentType
addressobjectThe entity’s address information.
administrativeAreaLevel1stringThe first-level administrative division.
administrativeAreaLevel2stringThe second-level administrative division.
administrativeAreaLevel3stringThe third-level administrative division.
streetstringThe name of the street.
streetNumberstringThe street number.
optionalAddressstringAdditional address details.
countrystringCountry of operations for the entity, specified using the ISO 3166-1 alpha-3 standard (e.g., CHL, USA, MEX). Go to the countries page for the complete list of supported values.
zipcodestringZipcode f the address
The URL to which the end user will be redirected after completing the payment.
A list of destinations for the transaction.
namestringThe name of the source or destination of the transaction.
typestringrequiredACCOUNTexternalIdstringExternal reference identifier for integrations.
amountstringrequiredThe amount involved in the transaction.
metadataobjectAdditional metadata related to the transaction source or destination.
imagestringrequiredAn image representing the source or destination.
descriptionstringrequiredA brief description of the source or destination.
categorystringrequiredThe category or grouping of the source or destination.
accountobjectrequiredtypestringrequiredCHECKINGFiat liquid account used for spending, withdrawals, or operations.ASSETTracks non-operational or financial assets.SAVINGSHolds funds intended for savings or long-term storage.ESCROWTemporary routing account for incoming funds.FEEHolds all fees collected via FEE or FEE_INVOICE.currencystringrequiredSpecifies the currency used, following the ISO 4217 standard for fiat currencies (e.g., CLP, ARS, MXN). Go to the currencies page for the complete list of supported values.
accountNumberstringrequiredInternal reference number for the account.
accountHolderstringrequiredName of the entity or user owning the internal account.
Identity reference object used inside account nodes.
identityIdstringrequiredUser unique identifier
namestringUser name
lastnamestringUser lastname
nicknamestringUser nickname
documentNumberstringUser DNI
entityTypestringEntity type of identity
Checkout session payment object
A brief description of the transaction.
A list of sources for the transaction.
namestringThe name of the source or destination of the transaction.
typestringrequiredCARDRepresents a card payment. Opens the card node.CRYPTOCryptocurrency wallet rail (global). Supports both pay-in and pay-out flows. Opens the wallet node.ACCOUNTRepresents an internal platform account. Opens the account node.BANK_ACCOUNTGeneric external bank account for payouts. Opens the bank node.PIXPIX QR code or copy-paste code in Brazil (BRL). Opens the pix node.PCTInteroperable QR payment in Argentina (ARS) under BCRA PCT standard. Opens the pct node.CVUVirtual account / CBU bank transfer pay-in in Argentina (ARS). Opens the cvu node.ETPAYOpen banking pay-in for Chile (CLP) via Etpay. Opens the etpay node.FINTOCOpen banking pay-in for Chile (CLP) via Fintoc widget. Opens the fintoc node.WEBPAYCard payment in Chile (CLP) via Transbank. Opens the webpay node.SPEIElectronic Interbank Payment System for Mexico (MXN). Opens the spei node.PSEOnline secure bank transfer pay-in for Colombia (COP). Opens the pse node.BANCOLOMBIABancolombia direct payment pay-in for Colombia (COP). Opens the bancolombia node.DAVIVIENDADavivienda direct payment pay-in for Colombia (COP). Opens the davivienda node.DAVIPLATADaviplata mobile wallet for Colombia (COP). Opens the daviplata node.NEQUINequi digital wallet for Colombia (COP). Opens the nequi node.BREBBank account transfer payout for Colombia (COP). Opens the breb node.WOMPIWompi payment gateway pay-in for Colombia (COP). Opens the wompi node.LIGOQR-based payment system pay-in for Peru (PEN). Opens the ligo node.SIPInteroperable payment system for Peru (PEN) and Bolivia (BOB). Opens the sip node.ACHAutomated Clearing House bank transfers for USA (USD). Opens the ach node.WIREWire transfer via correspondent banks for USA (USD). Opens the wire node.FEDNOWFedNow instant payment service for USA (USD). Opens the fedNow node.RTPReal-time payments network pay-in for USA (USD). Opens the rtp node.SEPASingle Euro Payments Area payout for Europe (EUR). Opens the sepa node.FPEFaster Payments near-instant bank transfer payout for UK (GBP). Opens the fpe node.SWIFTInternational bank wire transfer rail (global). Pay-out only. Opens the swift node.externalIdstringExternal reference identifier for integrations.
amountstringThe amount involved in the transaction.
amountOutstringCalculated amount - fees
currencystringrequiredSpecifies the currency used, following the ISO 4217 standard for fiat currencies (e.g., CLP, ARS, MXN). Go to the currencies page for the complete list of supported values.
settlementstringIndicates the settlement period.
feeobjectDetails about any fees applied to the transaction.
namestringrequiredThe name of the fee.
typestringrequiredFIXEDPERCENTAGEvaluestringrequiredThe value of the fee.
amountstringrequiredThe calculated amount of the fee.
currencystringrequiredSpecifies the currency used, following the ISO 4217 standard for fiat currencies (e.g., CLP, ARS, MXN). Go to the currencies page for the complete list of supported values.
identityobjectThe entity associated with the source or destination.
namestringThe name of the entity (for users) or the official name (for organizations).
documentNumberstringThe document number associated with the entity for identification purposes.
externalIdstringExternal reference ID (client purpose).
lastnamestringThe last name of the user (if applicable).
metadataobjectAdditional metadata related to the transaction source or destination.
imagestringrequiredAn image representing the source or destination.
descriptionstringrequiredA brief description of the source or destination.
categorystringrequiredThe category or grouping of the source or destination.
One of
cardobjectrequired