Checkouts reports contain information about your checkouts, including conversion data for each checkout session.
Use them to understand how well your checkout is performing and compare conversion across different checkout configurations.
When to use
- Analyze checkout conversion
See which checkouts converted into completed transactions and calculate conversion rates over a period. - Compare checkout performance
Break activity down by theme, display mode, country, and product to see which checkout configurations convert best. - Automate reporting workflows
Generate reports via API to feed checkout performance data into your own dashboards and business intelligence tools.
Report filters
When generating checkouts reports, you can filter by:
| Field | Description | Use case |
|---|---|---|
checkout_created_at | Filter by the date range when checkouts were created. Pass an RFC 3339 datetime string with a gte or lt operator, and combine two filters to scope to a specific range. If you don't pass this filter, the report includes checkouts created in the previous month. | Reporting on checkouts for a specific period. |
customer_country_code | Filter by customer country. Pass one or more two-letter ISO 3166-1 alpha-2 country codes, like US or GB. | Analyzing checkout performance in specific markets. |
How customer country is determined
Paddle resolves a customer's country from the country they enter at checkout, falling back to the country derived from their IP address.
Because of this, the country may differ from a customer's billing country, like when a customer uses a VPN. In rare cases when we can't capture an IP address for a customer, it may be empty.
Report columns
Each row in the report is one checkout session. Columns cover the context of the checkout and its performance:
- Context: identifiers, timestamps, and details about the checkout and customer, like
checkout_id,transaction_id,customer_id,checkout_created_at, andcustomer_country_code. - Checkout performance: conversion and presentation data, like
is_checkout_converted,transaction_currency_code,display_mode, andtheme.
Column headings on checkouts reports mirror fields in the Paddle API. Data is provided in the following columns:
checkout_idstring
Unique identifier for the checkout session.
public_checkout_idstring | null
Public identifier for the checkout session, as used in checkout URLs.
null if the checkout has no public identifier.transaction_idstring | null
Example:
txn_01h04vsbhqc62t8hmd4z3b578cPaddle ID of the transaction created from this checkout, prefixed with
txn_. null if the checkout didn't create a transaction.Pattern:
^txn_[a-z\d]{26}$customer_idstring | null
Example:
ctm_01grnn4zta5a1mf02jjze7y2ysPaddle ID of the customer associated with the checkout, prefixed with
ctm_. null if the checkout isn't associated with a customer.Pattern:
^ctm_[a-z\d]{26}$checkout_created_atstring (date-time)
Example:
2026-05-12T07:20:50.52ZRFC 3339 datetime string of when the checkout was created.
checkout_updated_atstring (date-time)
Example:
2026-05-12T09:14:00.00ZRFC 3339 datetime string of when the checkout was last updated.
checkout_converted_atstring (date-time) | null
Example:
2026-05-12T07:25:11.00ZRFC 3339 datetime string of when the checkout converted into a completed transaction.
null if the checkout didn't convert.checkout_variantstring | null
Checkout experience presented to the customer, like one-page or multi-page.
transaction_originstring | null
How the transaction created from the checkout was created.
null if the checkout didn't create a transaction.Values
apiTransaction created via the Paddle API.webTransaction created automatically by Paddle.js for a checkout.
payment_service_transaction_typestring | null
Transaction type reported by the payment service for the checkout.
transaction_currency_codestring | null
Three-letter ISO 4217 currency code used for the checkout.
source_domainstring | null
Domain that the checkout was initiated from.
referrerstring | null
Referring URL or entity for the checkout.
themestring | null
Theme the checkout was displayed with, like
light or dark.display_modestring | null
How the checkout was displayed, like
inline or overlay.last_known_customer_country_codestring | null
Two-letter ISO 3166-1 alpha-2 country code last known for the customer.
null if no country is known.customer_country_namestring | null
Name of the customer's country.
null if no country is known.customer_country_codestring
Two-letter ISO 3166-1 alpha-2 country code for the customer. Resolved from the customer's entered country, falling back to their IP-derived country. Empty if no country is known.
Values
ADAndorraAEUnited Arab EmiratesAGAntigua and BarbudaAIAnguillaALAlbania
+ Show all values− Hide values
AMArmeniaAOAngolaARArgentinaASAmerican SamoaATAustriaAUAustraliaAWArubaAXÃ…land IslandsAZAzerbaijanBABosnia and HerzegovinaBBBarbadosBDBangladeshBEBelgiumBFBurkina FasoBGBulgariaBHBahrainBIBurundiBJBeninBLSaint BarthélemyBMBermudaBNBruneiBOBoliviaBQCaribbean Netherlands (Bonaire, Sint Eustatius, and Saba)BRBrazilBSBahamasBTBhutanBVBouvet IslandBWBotswanaBZBelizeCACanadaCCCocos IslandsCGRepublic of CongoCHSwitzerlandCICôte d'Ivoire (Ivory Coast)CKCook IslandsCLChileCMCameroonCNChinaCOColombiaCRCosta RicaCVCape VerdeCWCuraçaoCXChristmas IslandCYCyprusCZCzechia (Czech Republic)DEGermanyDJDjiboutiDKDenmarkDMDominicaDODominican RepublicDZAlgeriaECEcuadorEEEstoniaEGEgyptEHWestern SaharaEREritreaESSpainETEthiopiaFIFinlandFJFijiFKFalkland IslandsFMMicronesiaFOFaroe IslandsFRFranceGAGabonGBUnited KingdomGDGrenadaGEGeorgiaGFFrench GuianaGGGuernseyGHGhanaGIGibraltarGLGreenlandGMGambiaGNGuineaGPGuadeloupeGQEquatorial GuineaGRGreeceGSSouth Georgia and the South Sandwich IslandsGTGuatemalaGUGuamGWGuinea-BissauGYGuyanaHKHong KongHMHeard Island and McDonald IslandsHNHondurasHRCroatiaHUHungaryIDIndonesiaIEIrelandILIsraelIMIsle of ManINIndiaIOBritish Indian Ocean TerritoryIQIraqISIcelandITItalyJEJerseyJMJamaicaJOJordanJPJapanKEKenyaKGKyrgyzstanKHCambodiaKIKiribatiKMComorosKNSaint Kitts and NevisKRSouth KoreaKWKuwaitKYCayman IslandsKZKazakhstanLALao People's Democratic Republic (Laos)LBLebanonLCSaint LuciaLILiechtensteinLKSri LankaLRLiberiaLSLesothoLTLithuaniaLULuxembourgLVLatviaMAMoroccoMCMonacoMDMoldovaMEMontenegroMFSaint MartinMGMadagascarMHMarshall IslandsMKMacedoniaMNMongoliaMOMacaoMPNorthern Mariana IslandsMQMartiniqueMRMauritaniaMSMontserratMTMaltaMUMauritiusMVMaldivesMWMalawiMXMexicoMYMalaysiaMZMozambiqueNANamibiaNCNew CaledoniaNENigerNFNorfolk IslandNGNigeriaNLNetherlandsNONorwayNPNepalNRNauruNUNiueNZNew ZealandOMOmanPAPanamaPEPeruPFFrench PolynesiaPGPapua New GuineaPHPhilippinesPKPakistanPLPolandPMSaint Pierre and MiquelonPNPitcairnPRPuerto RicoPSPalestinian territoriesPTPortugalPWPalauPYParaguayQAQatarREReunionRORomaniaRSRepublic of SerbiaRWRwandaSASaudi ArabiaSBSolomon IslandsSCSeychellesSESwedenSGSingaporeSHSaint HelenaSISloveniaSJSvalbard and Jan MayenSKSlovakiaSLSierra LeoneSMSan MarinoSNSenegalSRSurinameSTSão Tomé and PrÃncipeSVEl SalvadorSXSint MaartenSZSwazilandTCTurks and Caicos IslandsTDChadTFFrench Southern and Antarctic LandsTGTogoTHThailandTJTajikistanTKTokelauTLTimor-LesteTMTurkmenistanTNTunisiaTOTongaTRTurkeyTTTrinidad and TobagoTVTuvaluTWTaiwanTZTanzaniaUAUkraineUGUgandaUMUnited States Minor Outlying IslandsUSUnited StatesUYUruguayUZUzbekistanVAHoly See (Vatican City)VCSaint Vincent and the GrenadinesVGBritish Virgin IslandsVIU.S. Virgin IslandsVNVietnamVUVanuatuWFWallis and FutunaWSSamoaXKKosovoYTMayotteZASouth AfricaZMZambia
customer_zip_codestring | null
Zip or postal code of the customer.
customer_ip_country_codestring | null
Two-letter ISO 3166-1 alpha-2 country code derived from the customer's IP address. May differ from the customer's billing country, for example when using a VPN.
customer_country_statestring | null
Two-letter abbreviation of the state where the checkout took place. Only for customers in the USA.
customer_tax_codestring | null
Tax identifier provided by the customer.
product_id_listarray
Array of product IDs included in the checkout.
product_name_listarray
Array of product names included in the checkout.
is_checkout_convertedboolean
Whether the checkout led to a completed transaction.
is_checkout_recoveredboolean
Whether the checkout was recovered after initially being abandoned.
is_checkout_recoverableboolean
Whether the checkout is eligible for recovery.
is_initiated_from_customer_portalboolean
Whether the checkout was started from the customer portal.
is_saved_payment_method_attemptedboolean
Whether a saved payment method was attempted during the checkout.
has_customer_emailboolean
Whether a customer email address was captured during the checkout.
transaction_amount_in_transaction_currencystring | null
Total amount of the transaction created from the checkout, in the transaction currency.
null if the checkout didn't create a transaction.