Ce que votre client doit encore faire. Décidez selon type, pas selon la seule présence du champ : un futur moyen de paiement pourra ajouter son propre type.
Hide child attributes
data.payment.next_action.type
enum<string>
card_payment (confirmer une carte depuis votre formulaire) ou redirect (envoyer le client sur redirect_url).
Available options:
card_payment,
redirect
data.payment.next_action.client_secret
string
card_payment : secret qui confirme le paiement depuis votre formulaire.
data.payment.next_action.redirect_url
string<uri>
redirect : page hébergée où le client termine.
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Mercy Pay","description":"Documentation de l'API Mercy Pay, encaissements, soldes et retraits pour prestataires de services.","colors":{"primary":"#FF9D00","light":"#FFC266","dark":"#CC7D00"},"logo":{"light":"https://mintcdn.com/mercy-pay-docs/C4bFF0BtqkbS1HgA/logo/light.svg?fit=max\u0026auto=format\u0026n=C4bFF0BtqkbS1HgA\u0026q=85\u0026s=fdfdcf01b6c0787ec76fcfbe7ce24162","dark":"https://mintcdn.com/mercy-pay-docs/C4bFF0BtqkbS1HgA/logo/dark.svg?fit=max\u0026auto=format\u0026n=C4bFF0BtqkbS1HgA\u0026q=85\u0026s=2c398d4f83e3adbb9bad6517c9747dc5"},"favicon":"https://mintcdn.com/mercy-pay-docs/C4bFF0BtqkbS1HgA/logo/favicon-96x96.png?fit=max\u0026auto=format\u0026n=C4bFF0BtqkbS1HgA\u0026q=85\u0026s=05eb70d90621b464cda81eb86844d442","api":{"openapi":"openapi.json","params":{"expanded":"all"},"playground":{"display":"interactive","proxy":true},"examples":{"languages":["curl","php","javascript","python"]},"mdx":{"auth":{"method":"bearer"},"server":"https://mercy-pay.com"}},"appearance":{"default":"system"},"background":{"decoration":"gradient","color":{"light":"#FFFFFF","dark":"#0B0B0E"}},"navbar":{"links":[{"href":"mailto:support@mercy-pay.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://mercy-pay.com/dashboard"}},"footer":{"socials":{"website":"https://mercy-pay.com"},"links":[{"header":"Mercy Pay","items":[{"label":"Site","href":"https://mercy-pay.com"},{"label":"Tarifs","href":"https://mercy-pay.com/tarifs"},{"label":"Statut","href":"https://mercy-pay.com/statut"},{"label":"Charte graphique","href":"https://mercy-pay.com/documents/mercy-pay-charte-graphique.pdf"}]},{"header":"Légal","items":[{"label":"Conditions générales","href":"https://mercy-pay.com/cgu"},{"label":"Conditions de l'API","href":"https://mercy-pay.com/conditions-api"},{"label":"Confidentialité","href":"https://mercy-pay.com/confidentialite"}]},{"header":"Pour les IA","items":[{"label":"llms.txt","href":"https://docs.mercy-pay.com/llms.txt"},{"label":"llms-full.txt","href":"https://docs.mercy-pay.com/llms-full.txt"}]}]},"fonts":{"family":"Nunito"},"icons":{"library":"lucide"},"styling":{"eyebrows":"breadcrumbs","codeblocks":{"theme":{"light":"github-light","dark":"github-dark"}},"latex":false},"contextual":{"options":["copy","view","chatgpt","claude","cursor"],"display":"header"},"navigation":{"global":{"anchors":[{"anchor":"Tableau de bord","icon":"layout-dashboard","href":"https://mercy-pay.com/dashboard"},{"anchor":"État des services","icon":"activity","href":"https://mercy-pay.com/statut"},{"anchor":"Support","icon":"life-buoy","href":"mailto:support@mercy-pay.com"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"mercy-pay-docs","hasAudioNarration":false,"actualSubdomain":"mercy-pay-docs","customDomains":["docs.mercy-pay.com"],"gitSource":{"type":"github","owner":"gessyken","repo":"mercy-pay","deployBranch":"main","contentDirectory":"docs.mercy-pay.com","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6af8eec02e6041f078d8c05a","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"Référence API","count":75},{"language":"default","tag":"Abonnements","count":48},{"language":"default","tag":"Documentation","count":37},{"language":"default","tag":"Paiements","count":23},{"language":"default","tag":"Webhooks","count":15},{"language":"default","tag":"Développeurs","count":14},{"language":"default","tag":"Liens de paiement","count":11},{"language":"default","tag":"Soldes et retraits","count":10},{"language":"default","tag":"Clients","count":8},{"language":"default","tag":"Plans","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":"@media (min-width: 1280px){#content-container{padding-left:3rem!important;column-gap:2.5rem!important}#content-area{flex:1 1 0%!important;min-width:0!important;width:auto!important}#content-side-layout{flex:0 0 21rem!important;width:21rem!important;max-width:21rem!important}#content-side-layout>*{width:100%!important;max-width:100%!important;min-width:0!important}#content-side-layout:has(#table-of-contents){flex-basis:15rem!important;width:15rem!important;max-width:15rem!important}}.mp-device-pair{display:flex;flex-direction:column;gap:1rem;align-items:center}.mp-device-desktop{width:100%}.mp-device-mobile{width:60%;max-width:280px}@media (min-width: 768px){.mp-device-pair{flex-direction:row;align-items:flex-end}.mp-device-desktop{flex:1 1 auto;min-width:0}.mp-device-mobile{flex:0 0 24%;width:24%}}#navbar .max-w-8xl,#body-content,#content-container{max-width:none!important}#navbar .max-w-8xl{padding-left:1.5rem!important;padding-right:1.5rem!important}.mp-shot-frame,.mp-shot-box{border-radius:14px;overflow:hidden;border:1px solid rgba(127, 127, 127, 0.22);box-shadow:0 12px 32px -12px rgba(255, 157, 0, 0.25)}.mp-shot-frame,.mp-shot-box{line-height:0}.mp-shot-frame img,.mp-shot-box img{width:100%;margin:0!important}.mp-shot-frame{width:100%;max-width:720px;margin-left:auto;margin-right:auto}.mp-shot-narrow{max-width:480px}.mp-shot-mobile{max-width:240px}.mp-shot-pair{max-width:880px;margin-left:auto!important;margin-right:auto!important}.mp-shot-zoom{display:block;width:100%;padding:0;border:0;background:none;cursor:zoom-in}.mp-shot-zoom:focus-visible{outline:2px solid #ff9d00;outline-offset:2px}dialog.mp-shot-overlay{width:100vw;height:100dvh;max-width:none;max-height:none;margin:0;padding:2rem;border:0;background:transparent;cursor:zoom-out}dialog.mp-shot-overlay[open]{display:flex;align-items:center;justify-content:center}dialog.mp-shot-overlay::backdrop{background:rgba(10, 10, 10, 0.85)}dialog.mp-shot-overlay img{max-width:100%;max-height:100%;width:auto;height:auto;object-fit:contain;border-radius:8px;margin:0!important}"}],"page":{"pagePath":"api/checkout-sessions/list","slug":"/api/checkout-sessions/list","pageMetadata":{"openapi":"GET /api/v1/checkout_sessions","title":"Lister les sessions","description":"Vos sessions, de la plus récente à la plus ancienne.","href":"/api/checkout-sessions/list"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Vos sessions, de la plus récente à la plus ancienne.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,..._provideComponents(),...props.components};return _jsxs(_components.p,{children:[`Chaque session porte `,_jsx(_components.code,{children:`payment`}),`, la dernière tentative de paiement du client. Voir `,_jsx(_components.a,{href:`/developers/pagination`,children:`Pagination`}),`.`]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":{"theme":{"light":"github-light","dark":"github-dark"}},"config":{},"pageMetadata":{"openapi":"GET /api/v1/checkout_sessions","title":"Lister les sessions","description":"Vos sessions, de la plus récente à la plus ancienne.","href":"/api/checkout-sessions/list"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/mercy-pay-docs/bf93ee4a8fbaf22f/kenn-hosting-footer.js"],"openApiReferenceData":{"operation":{"tags":["Sessions de paiement"],"operationId":"listCheckoutSessions","summary":"Lister les sessions","description":"Vos sessions, de la plus récente à la plus ancienne.","parameters":["69710250-5702-4720-a3c6-5e0b19772f27","a746f4fd-8e92-454c-afee-1ab8aa742e9d","69317632-610b-48a1-97f5-06d0657267d0","2fabffdb-64d1-4dfd-a142-d0313cb13f50","a508245e-59ee-4b8d-9dbc-6435149e7a47","b6e573e2-ec7e-4664-a9dd-c14e4fd640ff","ba871f2a-ce19-44f3-bfc8-ae1a2a03e57f","c36d4858-986a-4686-b0fa-5315cb83fbcb"],"responses":{"200":"1d7b2d96-f7d1-4131-a954-fbedf2487451","401":"ca5e1198-ddd1-417a-a795-1ecccd9e2617","422":"7451a14a-b245-411b-908e-a284188190b9","429":"e4a678a3-e7e4-4013-8a40-de1182a71472"},"method":"get","type":"path","servers":["f7be4ff8-7197-43fa-8ad0-8aaccd4a6a44"],"security":["9b9d2556-aa0c-405e-9134-3a7261b24bce"],"path":"/api/v1/checkout_sessions","baseUrlOptions":["https://mercy-pay.com"],"title":"Lister les sessions","codeSamples":[],"requestExampleLanguages":["bash","php","javascript","python"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"69710250-5702-4720-a3c6-5e0b19772f27":{"name":"status","in":"query","schema":{"type":"string","enum":["created","pending_payment","completed","expired","cancelled"],"description":"Filtre par statut","uniqueKey":"","typeLabel":"enum\u003cstring>"},"description":"Filtre par statut"},"a746f4fd-8e92-454c-afee-1ab8aa742e9d":{"name":"from","in":"query","schema":{"type":"string","format":"date","description":"Créés à partir de cette date `AAAA-MM-JJ`, incluse","uniqueKey":"","typeLabel":"string\u003cdate>"},"description":"Créés à partir de cette date `AAAA-MM-JJ`, incluse"},"69317632-610b-48a1-97f5-06d0657267d0":{"name":"to","in":"query","schema":{"type":"string","format":"date","description":"Créés jusqu'à cette date `AAAA-MM-JJ`, incluse","uniqueKey":"","typeLabel":"string\u003cdate>"},"description":"Créés jusqu'à cette date `AAAA-MM-JJ`, incluse"},"2fabffdb-64d1-4dfd-a142-d0313cb13f50":{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Nombre d'objets. Voir [Pagination](/developers/pagination)","uniqueKey":"","typeLabel":"integer"},"description":"Nombre d'objets. Voir [Pagination](/developers/pagination)"},"a508245e-59ee-4b8d-9dbc-6435149e7a47":{"name":"starting_after","in":"query","schema":{"type":"string","description":"Le `next_cursor` de la page précédente","uniqueKey":"","typeLabel":"string"},"description":"Le `next_cursor` de la page précédente"},"b6e573e2-ec7e-4664-a9dd-c14e4fd640ff":{"name":"ending_before","in":"query","schema":{"type":"string","description":"Un id, pour la page qui le précède","uniqueKey":"","typeLabel":"string"},"description":"Un id, pour la page qui le précède"},"ba871f2a-ce19-44f3-bfc8-ae1a2a03e57f":{"name":"created[gte]","in":"query","schema":{"type":"string","description":"Créés à partir de cette date (ISO 8601 ou horodatage Unix)","uniqueKey":"","typeLabel":"string"},"description":"Créés à partir de cette date (ISO 8601 ou horodatage Unix)"},"c36d4858-986a-4686-b0fa-5315cb83fbcb":{"name":"created[lte]","in":"query","schema":{"type":"string","description":"Créés jusqu'à cette date","uniqueKey":"","typeLabel":"string"},"description":"Créés jusqu'à cette date"}},"responses":{"1d7b2d96-f7d1-4131-a954-fbedf2487451":{"description":"Une page de sessions","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","const":"list","uniqueKey":"object","typeLabel":"string"},"url":{"type":"string","uniqueKey":"url","typeLabel":"string"},"has_more":{"type":"boolean","uniqueKey":"has_more","typeLabel":"boolean"},"next_cursor":{"oneOf":[{"type":"string","description":"À passer en `starting_after` pour la page suivante","uniqueKey":"next_cursor.oneOf.0","typeLabel":"string"},{"type":"null","description":"À passer en `starting_after` pour la page suivante","uniqueKey":"next_cursor.oneOf.1","typeLabel":"null"}],"uniqueKey":"next_cursor","typeLabel":"string | null"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identifiant de la session (`cs_…`)","uniqueKey":"data.items.[INDEX].id","typeLabel":"string"},"object":{"type":"string","const":"checkout_session","uniqueKey":"data.items.[INDEX].object","typeLabel":"string"},"livemode":{"type":"boolean","description":"`true` pour de l'argent réel (clé live), `false` en sandbox","uniqueKey":"data.items.[INDEX].livemode","typeLabel":"boolean"},"created":{"oneOf":[{"type":"string","format":"date-time","description":"Date de création, ISO 8601","uniqueKey":"data.items.[INDEX].created.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Date de création, ISO 8601","uniqueKey":"data.items.[INDEX].created.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].created","typeLabel":"string\u003cdate-time> | null"},"amount":{"type":"integer","description":"Montant demandé, en unités mineures.","uniqueKey":"data.items.[INDEX].amount","typeLabel":"integer"},"currency":{"type":"string","description":"Devise du montant","uniqueKey":"data.items.[INDEX].currency","typeLabel":"string"},"description":{"oneOf":[{"type":"string","description":"Affichée au client","uniqueKey":"data.items.[INDEX].description.oneOf.0","typeLabel":"string"},{"type":"null","description":"Affichée au client","uniqueKey":"data.items.[INDEX].description.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].description","typeLabel":"string | null"},"payer_name":{"oneOf":[{"type":"string","description":"Nom du payeur","uniqueKey":"data.items.[INDEX].payer_name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Nom du payeur","uniqueKey":"data.items.[INDEX].payer_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].payer_name","typeLabel":"string | null"},"payer_email":{"oneOf":[{"type":"string","description":"E-mail du payeur","uniqueKey":"data.items.[INDEX].payer_email.oneOf.0","typeLabel":"string"},{"type":"null","description":"E-mail du payeur","uniqueKey":"data.items.[INDEX].payer_email.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].payer_email","typeLabel":"string | null"},"payer_phone":{"oneOf":[{"type":"string","description":"Téléphone du payeur","uniqueKey":"data.items.[INDEX].payer_phone.oneOf.0","typeLabel":"string"},{"type":"null","description":"Téléphone du payeur","uniqueKey":"data.items.[INDEX].payer_phone.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].payer_phone","typeLabel":"string | null"},"payer_address":{"oneOf":[{"type":"object","description":"Adresse saisie, si un lien de paiement la demande : `line1`, `city`, `country`.","uniqueKey":"data.items.[INDEX].payer_address.oneOf.0","typeLabel":"object"},{"type":"null","description":"Adresse saisie, si un lien de paiement la demande : `line1`, `city`, `country`.","uniqueKey":"data.items.[INDEX].payer_address.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].payer_address","typeLabel":"object | null"},"payment_link":{"oneOf":[{"type":"string","description":"Lien de paiement d'origine (`plink_…`), `null` sinon","uniqueKey":"data.items.[INDEX].payment_link.oneOf.0","typeLabel":"string"},{"type":"null","description":"Lien de paiement d'origine (`plink_…`), `null` sinon","uniqueKey":"data.items.[INDEX].payment_link.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].payment_link","typeLabel":"string | null"},"custom_fields":{"type":"object","additionalProperties":true,"description":"Réponses aux champs personnalisés d'un lien de paiement, par `id` de champ. Pour un fichier, son nom.","uniqueKey":"data.items.[INDEX].custom_fields","typeLabel":"object"},"success_url":{"oneOf":[{"type":"string","description":"Retour après paiement réussi","uniqueKey":"data.items.[INDEX].success_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"Retour après paiement réussi","uniqueKey":"data.items.[INDEX].success_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].success_url","typeLabel":"string | null"},"cancel_url":{"oneOf":[{"type":"string","description":"Retour si le client abandonne","uniqueKey":"data.items.[INDEX].cancel_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"Retour si le client abandonne","uniqueKey":"data.items.[INDEX].cancel_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].cancel_url","typeLabel":"string | null"},"payment_method_types":{"oneOf":[{"type":"array","items":{"type":"string","enum":["mobile_money","card"],"uniqueKey":"data.items.[INDEX].payment_method_types.oneOf.0.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"Moyens proposés sur la page de paiement. `null` : tous les moyens ouverts.","uniqueKey":"data.items.[INDEX].payment_method_types.oneOf.0","typeLabel":"enum\u003cstring>[]"},{"type":"null","items":{"type":"string","enum":["mobile_money","card"]},"description":"Moyens proposés sur la page de paiement. `null` : tous les moyens ouverts.","uniqueKey":"data.items.[INDEX].payment_method_types.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].payment_method_types","typeLabel":"enum\u003cstring>[] | null"},"allowed_countries":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"data.items.[INDEX].allowed_countries.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"Pays mobile money proposés. `null` : tous les pays ouverts.","uniqueKey":"data.items.[INDEX].allowed_countries.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"description":"Pays mobile money proposés. `null` : tous les pays ouverts.","uniqueKey":"data.items.[INDEX].allowed_countries.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].allowed_countries","typeLabel":"string[] | null"},"status":{"type":"string","description":"Voir [Sessions de paiement](/payments/checkout-sessions#cycle-de-vie).","enum":["created","pending_payment","completed","expired","cancelled"],"uniqueKey":"data.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"metadata":{"oneOf":[{"type":"object","additionalProperties":true,"description":"Vos données libres. Voir [Metadata](/developers/metadata).","uniqueKey":"data.items.[INDEX].metadata.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":true,"description":"Vos données libres. Voir [Metadata](/developers/metadata).","uniqueKey":"data.items.[INDEX].metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].metadata","typeLabel":"object | null"},"checkout_url":{"type":"string","description":"Page de paiement hébergée où rediriger votre client.","format":"uri","uniqueKey":"data.items.[INDEX].checkout_url","typeLabel":"string\u003curi>"},"expires_at":{"oneOf":[{"type":"string","format":"date-time","description":"Fin de validité, 30 minutes après la création.","uniqueKey":"data.items.[INDEX].expires_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Fin de validité, 30 minutes après la création.","uniqueKey":"data.items.[INDEX].expires_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].expires_at","typeLabel":"string\u003cdate-time> | null"},"payment":{"oneOf":[{"type":"object","description":"Dernière tentative de paiement du client, `null` tant qu'il n'a rien lancé.","properties":{"id":{"type":"string","description":"Identifiant du paiement (`pay_…`)","uniqueKey":"data.items.[INDEX].payment.oneOf.0.id","typeLabel":"string"},"object":{"type":"string","const":"payment","uniqueKey":"data.items.[INDEX].payment.oneOf.0.object","typeLabel":"string"},"livemode":{"type":"boolean","description":"`true` pour de l'argent réel (clé live), `false` en sandbox","uniqueKey":"data.items.[INDEX].payment.oneOf.0.livemode","typeLabel":"boolean"},"created":{"oneOf":[{"type":"string","format":"date-time","description":"Date de création, ISO 8601","uniqueKey":"data.items.[INDEX].payment.oneOf.0.created.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Date de création, ISO 8601","uniqueKey":"data.items.[INDEX].payment.oneOf.0.created.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].payment.oneOf.0.created","typeLabel":"string\u003cdate-time> | null"},"checkout_session":{"oneOf":[{"type":"string","description":"Session de checkout d'origine (`cs_…`), `null` pour un paiement direct. Avec `expand[]=checkout_session`, la session complète","uniqueKey":"data.items.[INDEX].payment.oneOf.0.checkout_session.oneOf.0","typeLabel":"string"},{"type":"null","description":"Session de checkout d'origine (`cs_…`), `null` pour un paiement direct. Avec `expand[]=checkout_session`, la session complète","uniqueKey":"data.items.[INDEX].payment.oneOf.0.checkout_session.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].payment.oneOf.0.checkout_session","typeLabel":"string | null"},"amount":{"type":"integer","description":"Montant payé par le payeur, en unités mineures","uniqueKey":"data.items.[INDEX].payment.oneOf.0.amount","typeLabel":"integer"},"fee_amount":{"type":"integer","description":"Frais retenus","uniqueKey":"data.items.[INDEX].payment.oneOf.0.fee_amount","typeLabel":"integer"},"net_amount":{"type":"integer","description":"Montant versé sur votre solde","uniqueKey":"data.items.[INDEX].payment.oneOf.0.net_amount","typeLabel":"integer"},"fee_paid_by":{"type":"string","enum":["merchant","customer"],"description":"Qui a payé les frais. `merchant` : ils sont déduits de `net_amount`. `customer` : ils sont ajoutés à `amount`, et `net_amount` est le prix demandé.","uniqueKey":"data.items.[INDEX].payment.oneOf.0.fee_paid_by","typeLabel":"enum\u003cstring>"},"amount_refunded":{"type":"integer","description":"Ce qui a déjà été rendu au client par des remboursements, en unités mineures. Le paiement passe à `refunded` quand il atteint `amount`.","uniqueKey":"data.items.[INDEX].payment.oneOf.0.amount_refunded","typeLabel":"integer"},"currency":{"type":"string","description":"Devise réellement encaissée. En mobile money, celle de l'opérateur, après conversion si besoin.","uniqueKey":"data.items.[INDEX].payment.oneOf.0.currency","typeLabel":"string"},"payment_method":{"type":"string","description":"Canal de paiement","enum":["mobile_money","card"],"uniqueKey":"data.items.[INDEX].payment.oneOf.0.payment_method","typeLabel":"enum\u003cstring>"},"mobile_money_country":{"oneOf":[{"type":"string","description":"Pays de l'opérateur, `null` pour une carte.","uniqueKey":"data.items.[INDEX].payment.oneOf.0.mobile_money_country.oneOf.0","typeLabel":"string"},{"type":"null","description":"Pays de l'opérateur, `null` pour une carte.","uniqueKey":"data.items.[INDEX].payment.oneOf.0.mobile_money_country.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].payment.oneOf.0.mobile_money_country","typeLabel":"string | null"},"mobile_money_provider":{"oneOf":[{"type":"string","description":"Opérateur, `null` pour une carte.","uniqueKey":"data.items.[INDEX].payment.oneOf.0.mobile_money_provider.oneOf.0","typeLabel":"string"},{"type":"null","description":"Opérateur, `null` pour une carte.","uniqueKey":"data.items.[INDEX].payment.oneOf.0.mobile_money_provider.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].payment.oneOf.0.mobile_money_provider","typeLabel":"string | null"},"payer":{"type":"object","description":"Le payeur, tel que saisi sur la page de paiement ou transmis à la création. Pour le mobile money, `phone` est le numéro réellement débité.","properties":{"name":{"oneOf":[{"type":"string","uniqueKey":"data.items.[INDEX].payment.oneOf.0.payer.name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.items.[INDEX].payment.oneOf.0.payer.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].payment.oneOf.0.payer.name","typeLabel":"string | null"},"email":{"oneOf":[{"type":"string","uniqueKey":"data.items.[INDEX].payment.oneOf.0.payer.email.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.items.[INDEX].payment.oneOf.0.payer.email.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].payment.oneOf.0.payer.email","typeLabel":"string | null"},"phone":{"oneOf":[{"type":"string","description":"Indicatif compris, sans `+`, par exemple `237677123456`.","uniqueKey":"data.items.[INDEX].payment.oneOf.0.payer.phone.oneOf.0","typeLabel":"string"},{"type":"null","description":"Indicatif compris, sans `+`, par exemple `237677123456`.","uniqueKey":"data.items.[INDEX].payment.oneOf.0.payer.phone.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].payment.oneOf.0.payer.phone","typeLabel":"string | null"}},"uniqueKey":"data.items.[INDEX].payment.oneOf.0.payer","typeLabel":"object"},"status":{"type":"string","description":"Voir [Paiements](/payments/payment-object#statuts).","enum":["pending","processing","succeeded","failed","canceled","expired","refunded","disputed"],"uniqueKey":"data.items.[INDEX].payment.oneOf.0.status","typeLabel":"enum\u003cstring>"},"failure_code":{"oneOf":[{"type":"string","description":"Code stable de l'échec quand `status` vaut `failed`, sinon `null`. Voir [la liste](/api/payments/create#failure_code).","uniqueKey":"data.items.[INDEX].payment.oneOf.0.failure_code.oneOf.0","typeLabel":"string"},{"type":"null","description":"Code stable de l'échec quand `status` vaut `failed`, sinon `null`. Voir [la liste](/api/payments/create#failure_code).","uniqueKey":"data.items.[INDEX].payment.oneOf.0.failure_code.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].payment.oneOf.0.failure_code","typeLabel":"string | null"},"failure_reason":{"oneOf":[{"type":"string","description":"Raison de l'échec en français, à afficher telle quelle.","uniqueKey":"data.items.[INDEX].payment.oneOf.0.failure_reason.oneOf.0","typeLabel":"string"},{"type":"null","description":"Raison de l'échec en français, à afficher telle quelle.","uniqueKey":"data.items.[INDEX].payment.oneOf.0.failure_reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].payment.oneOf.0.failure_reason","typeLabel":"string | null"},"metadata":{"oneOf":[{"type":"object","additionalProperties":true,"description":"Vos données libres. Voir [Metadata](/developers/metadata).","uniqueKey":"data.items.[INDEX].payment.oneOf.0.metadata.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":true,"description":"Vos données libres. Voir [Metadata](/developers/metadata).","uniqueKey":"data.items.[INDEX].payment.oneOf.0.metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].payment.oneOf.0.metadata","typeLabel":"object | null"},"next_action":{"oneOf":[{"type":"object","description":"Ce que votre client doit encore faire. Décidez selon `type`, pas selon la seule présence du champ : un futur moyen de paiement pourra ajouter son propre `type`.","properties":{"type":{"type":"string","description":"`card_payment` (confirmer une carte depuis votre formulaire) ou `redirect` (envoyer le client sur `redirect_url`).","enum":["card_payment","redirect"],"uniqueKey":"data.items.[INDEX].payment.oneOf.0.next_action.oneOf.0.type","typeLabel":"enum\u003cstring>"},"client_secret":{"type":"string","description":"`card_payment` : secret qui confirme le paiement depuis votre formulaire.","uniqueKey":"data.items.[INDEX].payment.oneOf.0.next_action.oneOf.0.client_secret","typeLabel":"string"},"redirect_url":{"type":"string","description":"`redirect` : page hébergée où le client termine.","format":"uri","uniqueKey":"data.items.[INDEX].payment.oneOf.0.next_action.oneOf.0.redirect_url","typeLabel":"string\u003curi>"}},"uniqueKey":"data.items.[INDEX].payment.oneOf.0.next_action.oneOf.0","typeLabel":"object"},{"type":"null","description":"Ce que votre client doit encore faire. Décidez selon `type`, pas selon la seule présence du champ : un futur moyen de paiement pourra ajouter son propre `type`.","properties":{"type":{"type":"string","description":"`card_payment` (confirmer une carte depuis votre formulaire) ou `redirect` (envoyer le client sur `redirect_url`).","enum":["card_payment","redirect"]},"client_secret":{"type":"string","description":"`card_payment` : secret qui confirme le paiement depuis votre formulaire."},"redirect_url":{"type":"string","description":"`redirect` : page hébergée où le client termine.","format":"uri"}},"uniqueKey":"data.items.[INDEX].payment.oneOf.0.next_action.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].payment.oneOf.0.next_action","typeLabel":"object | null"}},"uniqueKey":"data.items.[INDEX].payment.oneOf.0","typeLabel":"object"},{"type":"null","description":"Dernière tentative de paiement du client, `null` tant qu'il n'a rien lancé.","uniqueKey":"data.items.[INDEX].payment.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].payment","typeLabel":"object | null"}},"uniqueKey":"data.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"object":"list","url":"/api/v1/checkout_sessions","has_more":false,"next_cursor":null,"data":[{"id":"cs_01J9Z3V8QK4M2XW7R6TB5N0HYD","object":"checkout_session","livemode":false,"created":"2026-10-03T10:20:00+00:00","amount":15000,"currency":"XAF","description":"Commande 4821","payer_name":null,"payer_email":null,"payer_phone":null,"payer_address":null,"success_url":"https://boutique-ada.example/merci","cancel_url":"https://boutique-ada.example/panier","status":"created","metadata":{"order_id":"4821"},"checkout_url":"https://mercy-pay.com/paiement/01J9Z3V8QK4M2XW7R6TB5N0HYD","expires_at":"2026-10-03T10:50:00+00:00","payment":null}]},"examples":{"Example":{"title":"Example","value":{"object":"list","url":"/api/v1/checkout_sessions","has_more":false,"next_cursor":null,"data":[{"id":"cs_01J9Z3V8QK4M2XW7R6TB5N0HYD","object":"checkout_session","livemode":false,"created":"2026-10-03T10:20:00+00:00","amount":15000,"currency":"XAF","description":"Commande 4821","payer_name":null,"payer_email":null,"payer_phone":null,"payer_address":null,"success_url":"https://boutique-ada.example/merci","cancel_url":"https://boutique-ada.example/panier","status":"created","metadata":{"order_id":"4821"},"checkout_url":"https://mercy-pay.com/paiement/01J9Z3V8QK4M2XW7R6TB5N0HYD","expires_at":"2026-10-03T10:50:00+00:00","payment":null}]}}},"exampleType":"examples"}},"exampleType":"examples"},"ca5e1198-ddd1-417a-a795-1ecccd9e2617":{"description":"Clé absente, invalide ou révoquée","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","enum":["authentication_error","invalid_request_error","idempotency_error","payment_error","rate_limit_error","api_error"],"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","description":"Code stable, à tester dans votre code","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Explication en français, pour un humain","uniqueKey":"error.message","typeLabel":"string"},"param":{"oneOf":[{"type":"string","description":"Le premier champ en cause","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"Le premier champ en cause","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"doc_url":{"type":"string","description":"Explication de ce code","uniqueKey":"error.doc_url","typeLabel":"string"},"request_id":{"type":"string","description":"Identifiant de la requête (`req_…`), aussi dans l'en-tête `Request-Id`","uniqueKey":"error.request_id","typeLabel":"string"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"error.errors.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"error.errors.additionalProperties","typeLabel":"string[]"},"description":"Détail par champ refusé, sur une erreur `422`","uniqueKey":"error.errors","typeLabel":"object"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"type":"authentication_error","code":"api_key_invalid","message":"Clé API invalide.","param":null,"doc_url":"https://docs.mercy-pay.com/developers/errors#api_key_invalid","request_id":"req_01jc8x4m2v7t9qk3n5w6y8z0ab"}},"examples":{"Example":{"title":"Example","value":{"error":{"type":"authentication_error","code":"api_key_invalid","message":"Clé API invalide.","param":null,"doc_url":"https://docs.mercy-pay.com/developers/errors#api_key_invalid","request_id":"req_01jc8x4m2v7t9qk3n5w6y8z0ab"}}}},"exampleType":"examples"}},"exampleType":"examples"},"7451a14a-b245-411b-908e-a284188190b9":{"description":"Données invalides, avec le détail dans `errors`","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","enum":["authentication_error","invalid_request_error","idempotency_error","payment_error","rate_limit_error","api_error"],"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","description":"Code stable, à tester dans votre code","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Explication en français, pour un humain","uniqueKey":"error.message","typeLabel":"string"},"param":{"oneOf":[{"type":"string","description":"Le premier champ en cause","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"Le premier champ en cause","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"doc_url":{"type":"string","description":"Explication de ce code","uniqueKey":"error.doc_url","typeLabel":"string"},"request_id":{"type":"string","description":"Identifiant de la requête (`req_…`), aussi dans l'en-tête `Request-Id`","uniqueKey":"error.request_id","typeLabel":"string"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"error.errors.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"error.errors.additionalProperties","typeLabel":"string[]"},"description":"Détail par champ refusé, sur une erreur `422`","uniqueKey":"error.errors","typeLabel":"object"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"type":"invalid_request_error","code":"validation_failed","message":"Le champ amount est obligatoire.","param":"amount","doc_url":"https://docs.mercy-pay.com/developers/errors#validation_failed","request_id":"req_01jc8x4m2v7t9qk3n5w6y8z0ab","errors":{"amount":["Le champ amount est obligatoire."]}}},"examples":{"Example":{"title":"Example","value":{"error":{"type":"invalid_request_error","code":"validation_failed","message":"Le champ amount est obligatoire.","param":"amount","doc_url":"https://docs.mercy-pay.com/developers/errors#validation_failed","request_id":"req_01jc8x4m2v7t9qk3n5w6y8z0ab","errors":{"amount":["Le champ amount est obligatoire."]}}}}},"exampleType":"examples"}},"exampleType":"examples"},"e4a678a3-e7e4-4013-8a40-de1182a71472":{"description":"Plus de 60 requêtes par minute avec cette clé","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","enum":["authentication_error","invalid_request_error","idempotency_error","payment_error","rate_limit_error","api_error"],"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","description":"Code stable, à tester dans votre code","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Explication en français, pour un humain","uniqueKey":"error.message","typeLabel":"string"},"param":{"oneOf":[{"type":"string","description":"Le premier champ en cause","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"Le premier champ en cause","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"doc_url":{"type":"string","description":"Explication de ce code","uniqueKey":"error.doc_url","typeLabel":"string"},"request_id":{"type":"string","description":"Identifiant de la requête (`req_…`), aussi dans l'en-tête `Request-Id`","uniqueKey":"error.request_id","typeLabel":"string"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"error.errors.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"error.errors.additionalProperties","typeLabel":"string[]"},"description":"Détail par champ refusé, sur une erreur `422`","uniqueKey":"error.errors","typeLabel":"object"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"type":"rate_limit_error","code":"rate_limited","message":"Trop de requêtes.","param":null,"doc_url":"https://docs.mercy-pay.com/developers/errors#rate_limited","request_id":"req_01jc8x4m2v7t9qk3n5w6y8z0ab"}},"examples":{"Example":{"title":"Example","value":{"error":{"type":"rate_limit_error","code":"rate_limited","message":"Trop de requêtes.","param":null,"doc_url":"https://docs.mercy-pay.com/developers/errors#rate_limited","request_id":"req_01jc8x4m2v7t9qk3n5w6y8z0ab"}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"9b9d2556-aa0c-405e-9134-3a7261b24bce":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Votre clé API. Utilisez une clé sandbox (`mp_sandbox_…`) pour essayer : aucun argent réel ne bouge.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"f7be4ff8-7197-43fa-8ad0-8aaccd4a6a44":{"url":"https://mercy-pay.com","description":"Production. La clé choisit l'environnement : `mp_sandbox_…` ou `mp_live_…`."}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Votre clé API. Utilisez une clé sandbox (`mp_sandbox_…`) pour essayer : aucun argent réel ne bouge.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Votre clé API. Utilisez une clé sandbox (`mp_sandbox_…`) pour essayer : aucun argent réel ne bouge.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"mercy-pay-docs","siteName":"Mercy Pay","title":"Lister les sessions - Mercy Pay","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-07T15:27:59.171Z","originalFileLocation":"api/checkout-sessions/list.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Vos sessions, de la plus récente à la plus ancienne.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Mercy Pay\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/mercy-pay-docs/FIGo4BWVKJadbUOG/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/mercy-pay-docs/FIGo4BWVKJadbUOG/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/mercy-pay-docs/FIGo4BWVKJadbUOG/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/mercy-pay-docs/FIGo4BWVKJadbUOG/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/mercy-pay-docs/FIGo4BWVKJadbUOG/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/mercy-pay-docs/FIGo4BWVKJadbUOG/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/mercy-pay-docs/FIGo4BWVKJadbUOG/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/mercy-pay-docs/FIGo4BWVKJadbUOG/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/mercy-pay-docs/FIGo4BWVKJadbUOG/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Lister les sessions - Mercy Pay\">\u003cmeta data-mint-head property=\"og:description\" content=\"Vos sessions, de la plus récente à la plus ancienne.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Mercy Pay\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.mercy-pay.com/api/checkout-sessions/list\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://mercy-pay-docs.mintlify.site/_mintlify/api/og/v2?division=Sessions+de+paiement\u0026amp;title=Lister+les+sessions\u0026amp;description=Vos+sessions%2C+de+la+plus+r%C3%A9cente+%C3%A0+la+plus+ancienne.\u0026amp;theme=29103f8f5341b6104078e85b\u0026amp;signature=6aebdc68d99c6e5c291ad2e87fa54c63da4b30116bf5671bd8c23038d221a3fa\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Lister les sessions - Mercy Pay\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Vos sessions, de la plus récente à la plus ancienne.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://mercy-pay-docs.mintlify.site/_mintlify/api/og/v2?division=Sessions+de+paiement\u0026amp;title=Lister+les+sessions\u0026amp;description=Vos+sessions%2C+de+la+plus+r%C3%A9cente+%C3%A0+la+plus+ancienne.\u0026amp;theme=29103f8f5341b6104078e85b\u0026amp;signature=6aebdc68d99c6e5c291ad2e87fa54c63da4b30116bf5671bd8c23038d221a3fa\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/mercy-pay-docs/FIGo4BWVKJadbUOG/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Mercy Pay\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#FF9D00\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.mercy-pay.com/api/checkout-sessions/list\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api/checkout-sessions/list.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.mercy-pay.com/#organization\",\"name\":\"Mercy Pay\",\"url\":\"https://docs.mercy-pay.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/mercy-pay-docs/C4bFF0BtqkbS1HgA/logo/light.svg?fit=max\u0026auto=format\u0026n=C4bFF0BtqkbS1HgA\u0026q=85\u0026s=fdfdcf01b6c0787ec76fcfbe7ce24162\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.mercy-pay.com#website\",\"name\":\"Mercy Pay\",\"url\":\"https://docs.mercy-pay.com\",\"publisher\":{\"@id\":\"https://docs.mercy-pay.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.mercy-pay.com/api/checkout-sessions/list#webpage\",\"url\":\"https://docs.mercy-pay.com/api/checkout-sessions/list\",\"name\":\"Lister les sessions\",\"description\":\"Vos sessions, de la plus récente à la plus ancienne.\",\"dateModified\":\"2026-11-07T15:27:59.171Z\",\"isPartOf\":{\"@id\":\"https://docs.mercy-pay.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.mercy-pay.com/api/checkout-sessions/list#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.mercy-pay.com/api/checkout-sessions/list#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Paiements\",\"item\":\"https://docs.mercy-pay.com/api/checkout-sessions/create\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Sessions de paiement\",\"item\":\"https://docs.mercy-pay.com/api/checkout-sessions/create\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Lister les sessions\",\"item\":\"https://docs.mercy-pay.com/api/checkout-sessions/list\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.mercy-pay.com/api/checkout-sessions/list#apireference\",\"headline\":\"Lister les sessions\",\"name\":\"Lister les sessions\",\"description\":\"Vos sessions, de la plus récente à la plus ancienne.\",\"url\":\"https://docs.mercy-pay.com/api/checkout-sessions/list\",\"mainEntityOfPage\":{\"@id\":\"https://docs.mercy-pay.com/api/checkout-sessions/list#webpage\"},\"dateModified\":\"2026-11-07T15:27:59.171Z\",\"publisher\":{\"@id\":\"https://docs.mercy-pay.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.mercy-pay.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Mercy Pay\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Mercy Pay\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api/checkout-sessions/list.md","siteName":"Mercy Pay","nav":{"global":{"anchors":[{"anchor":"Tableau de bord","icon":"layout-dashboard","href":"https://mercy-pay.com/dashboard"},{"anchor":"État des services","icon":"activity","href":"https://mercy-pay.com/statut"},{"anchor":"Support","icon":"life-buoy","href":"mailto:support@mercy-pay.com"}]},"tabs":[{"tab":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":""}]},{"tab":"Référence API","icon":"braces","groups":[{"group":"Introduction","icon":"book-open","pages":[{"title":"Authentification","href":"/developers/authentication"},{"title":"Erreurs","href":"/developers/errors"},{"title":"Idempotence","href":"/developers/idempotency"},{"title":"Limites de débit","href":"/developers/rate-limits"},{"title":"Pagination","href":"/developers/pagination"},{"title":"Metadata","href":"/developers/metadata"},{"title":"Objets liés","href":"/developers/expand"}]},{"group":"Compte","icon":"user","pages":[{"openapi":"GET /api/v1/account","title":"Lire le compte","href":"/api/account/get"},{"openapi":"GET /api/v1/provider_status","title":"État des opérateurs","href":"/api/provider-status/get"},{"openapi":"POST /api/v1/fees/quote","title":"Calculer les frais d'un paiement","href":"/api/fees/quote"}]},{"group":"Paiements","icon":"credit-card","pages":[{"group":"Sessions de paiement","icon":"panel-top","expanded":true,"pages":[{"openapi":"POST /api/v1/checkout_sessions","title":"Créer une session","description":"Crée une page de paiement hébergée et renvoie son adresse dans `checkout_url`. Redirigez-y votre client.","href":"/api/checkout-sessions/create"},{"openapi":"GET /api/v1/checkout_sessions","title":"Lister les sessions","href":"/api/checkout-sessions/list"},{"openapi":"GET /api/v1/checkout_sessions/{id}","title":"Lire une session","description":"Une session, avec `payment` : la dernière tentative du payeur, ou `null` tant qu'il n'a rien lancé.","href":"/api/checkout-sessions/get"},{"openapi":"POST /api/v1/checkout_sessions/{id}/expire","title":"Expirer une session","href":"/api/checkout-sessions/expire"}]},{"group":"Paiements","icon":"banknote","expanded":true,"pages":[{"openapi":"POST /api/v1/payments","title":"Encaisser un paiement","href":"/api/payments/create"},{"openapi":"GET /api/v1/payments","title":"Lister les paiements","href":"/api/payments/list"},{"openapi":"GET /api/v1/payments/{id}","title":"Lire un paiement","href":"/api/payments/get"}]},{"group":"Remboursements","pages":[{"title":"Rembourser un paiement","openapi":"POST /api/v1/payments/{id}/refunds","href":"/api/refunds/create"},{"title":"Lister les remboursements","openapi":"GET /api/v1/refunds","href":"/api/refunds/list"},{"title":"Lire un remboursement","openapi":"GET /api/v1/refunds/{id}","href":"/api/refunds/get"},{"title":"Annuler un remboursement retardé","openapi":"POST /api/v1/refunds/{id}/cancel","href":"/api/refunds/cancel"}]}]},{"group":"Liens de paiement","icon":"link","pages":[{"openapi":"POST /api/v1/payment_links","title":"Créer un lien","href":"/api/payment-links/create"},{"openapi":"GET /api/v1/payment_links","title":"Lister les liens","href":"/api/payment-links/list"},{"openapi":"GET /api/v1/payment_links/{id}","title":"Lire un lien","href":"/api/payment-links/get"},{"openapi":"PATCH /api/v1/payment_links/{id}","title":"Modifier un lien","href":"/api/payment-links/update"},{"openapi":"POST /api/v1/payment_links/{id}/archive","title":"Archiver un lien","href":"/api/payment-links/archive"},{"openapi":"DELETE /api/v1/payment_links/{id}","title":"Supprimer un lien","href":"/api/payment-links/delete"},{"openapi":"GET /api/v1/payment_links/{id}/payments","title":"Paiements d'un lien","href":"/api/payment-links/payments"}]},{"group":"Abonnements","icon":"repeat","pages":[{"group":"Plans","icon":"layers","pages":[{"openapi":"POST /api/v1/plans","title":"Créer un plan","href":"/api/plans/create"},{"openapi":"GET /api/v1/plans","title":"Lister les plans","href":"/api/plans/list"},{"openapi":"GET /api/v1/plans/{id}","title":"Lire un plan","href":"/api/plans/get"},{"openapi":"PATCH /api/v1/plans/{id}","title":"Modifier un plan","href":"/api/plans/update"},{"openapi":"POST /api/v1/plans/{id}/archive","title":"Archiver un plan","href":"/api/plans/archive"},{"openapi":"POST /api/v1/plans/{id}/restore","title":"Réactiver un plan","href":"/api/plans/restore"},{"openapi":"DELETE /api/v1/plans/{id}","title":"Supprimer un plan","href":"/api/plans/delete"}]},{"group":"Abonnements","icon":"repeat","pages":[{"openapi":"POST /api/v1/subscriptions","title":"Créer un abonnement","href":"/api/subscriptions/create"},{"openapi":"GET /api/v1/subscriptions","title":"Lister les abonnements","href":"/api/subscriptions/list"},{"openapi":"GET /api/v1/subscriptions/{id}","title":"Lire un abonnement","href":"/api/subscriptions/get"},{"openapi":"PATCH /api/v1/subscriptions/{id}","title":"Modifier un abonnement","href":"/api/subscriptions/update"},{"openapi":"POST /api/v1/subscriptions/{id}/cancel","title":"Annuler un abonnement","href":"/api/subscriptions/cancel"},{"openapi":"POST /api/v1/subscriptions/{id}/reactivate","title":"Retirer une annulation prévue","href":"/api/subscriptions/reactivate"},{"openapi":"POST /api/v1/subscriptions/{id}/advance","title":"Passer à l'échéance (sandbox)","href":"/api/subscriptions/advance"},{"openapi":"POST /api/v1/subscriptions/{id}/pause","title":"Mettre en pause","href":"/api/subscriptions/pause"},{"openapi":"POST /api/v1/subscriptions/{id}/resume","title":"Reprendre","href":"/api/subscriptions/resume"},{"openapi":"GET /api/v1/subscriptions/{id}/invoices","title":"Factures d'un abonnement","href":"/api/subscriptions/invoices"}]},{"group":"Clients","icon":"users","pages":[{"openapi":"POST /api/v1/customers","title":"Créer un client","href":"/api/customers/create"},{"openapi":"GET /api/v1/customers","title":"Lister les clients","href":"/api/customers/list"},{"openapi":"GET /api/v1/customers/{id}","title":"Lire un client","href":"/api/customers/get"},{"openapi":"GET /api/v1/customers/{customer}/payment_methods","title":"Moyens de paiement d'un client","href":"/api/customers/payment-methods"},{"openapi":"PATCH /api/v1/customers/{id}","title":"Modifier un client","href":"/api/customers/update"},{"openapi":"DELETE /api/v1/customers/{id}","title":"Supprimer un client","href":"/api/customers/delete"},{"openapi":"POST /api/v1/customers/{customer}/payment_methods/{payment_method}/default","title":"Choisir le moyen par défaut","href":"/api/customers/set-default"},{"openapi":"DELETE /api/v1/customers/{customer}/payment_methods/{payment_method}","title":"Retirer un moyen de paiement","href":"/api/customers/remove-payment-method"}]},{"group":"Factures","icon":"receipt","pages":[{"openapi":"GET /api/v1/invoices","title":"Lister les factures","href":"/api/invoices/list"},{"openapi":"GET /api/v1/invoices/{id}","title":"Lire une facture","href":"/api/invoices/get"},{"openapi":"POST /api/v1/invoices/{id}/pay","title":"Encaisser une facture","href":"/api/invoices/pay"},{"openapi":"POST /api/v1/invoices/{id}/send","title":"Envoyer la facture au client","href":"/api/invoices/send"}]},{"group":"Espace client","icon":"user-round-cog","pages":[{"openapi":"POST /api/v1/billing_portal/sessions","title":"Ouvrir l'espace client","href":"/api/billing-portal/create-session"}]}]},{"group":"Soldes et retraits","icon":"wallet","pages":[{"group":"Soldes","icon":"wallet","expanded":true,"pages":[{"openapi":"GET /api/v1/wallets","title":"Lire les soldes","href":"/api/wallets/list"},{"openapi":"POST /api/v1/wallet_transfers","title":"Virer entre deux soldes","href":"/api/wallet-transfers/create"},{"openapi":"GET /api/v1/wallet_transfers","title":"Lister les virements entre soldes","href":"/api/wallet-transfers/list"}]},{"group":"Retraits","icon":"arrow-up-right","expanded":true,"pages":[{"openapi":"POST /api/v1/payouts","title":"Demander un retrait","href":"/api/payouts/create"},{"openapi":"GET /api/v1/payouts","title":"Lister les retraits","href":"/api/payouts/list"},{"openapi":"GET /api/v1/payouts/{id}","title":"Lire un retrait","href":"/api/payouts/get"}]}]},{"group":"Webhooks","icon":"webhook","pages":[{"group":"Événements","icon":"activity","expanded":true,"pages":[{"openapi":"GET /api/v1/events","title":"Lister les événements","href":"/api/events/list"},{"openapi":"GET /api/v1/events/{id}","title":"Lire un événement","href":"/api/events/get"},{"openapi":"GET /api/v1/events/{id}/deliveries","title":"Lister les envois d'un événement","href":"/api/events/deliveries"},{"openapi":"POST /api/v1/events/{id}/resend","title":"Renvoyer un événement","href":"/api/events/resend"}]},{"group":"Endpoints","icon":"plug","expanded":true,"pages":[{"openapi":"POST /api/v1/webhook_endpoints","title":"Créer un endpoint","href":"/api/webhook-endpoints/create"},{"openapi":"GET /api/v1/webhook_endpoints","title":"Lister les endpoints","href":"/api/webhook-endpoints/list"},{"openapi":"GET /api/v1/webhook_endpoints/{id}","title":"Lire un endpoint","href":"/api/webhook-endpoints/get"},{"openapi":"PATCH /api/v1/webhook_endpoints/{id}","title":"Modifier un endpoint","href":"/api/webhook-endpoints/update"},{"openapi":"DELETE /api/v1/webhook_endpoints/{id}","title":"Supprimer un endpoint","href":"/api/webhook-endpoints/delete"},{"openapi":"POST /api/v1/webhook_endpoints/{id}/rotate_secret","title":"Changer le secret","href":"/api/webhook-endpoints/rotate-secret"},{"openapi":"POST /api/v1/webhook_endpoints/{id}/test","title":"Envoyer un test","href":"/api/webhook-endpoints/test"}]}]}]}]},"basePath":"","title":"Lister les sessions - Mercy Pay","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DdEMm2kG.js","utils-BMo572L7.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C-4m9KAx.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DPLK2Oq9.js","snippetPresets-BKjfJMC9.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-DTsgtCEj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C8vmhyQM.js","shallow-r9w8LQGS.js","getApiPlaygroundDisplay-DjPI64HQ.js","CodeSnippet-C8Bvhl16.js","CodeSnippets-BtWUwcMy.js","Page-BIYvYBgk.js","getPastedJson-Dcm_3Pgl.js","icon-BXwrTpjc.js","MethodPill-CcjfVmmy.js","DuplicateIcon-BuKIbXAQ.js","createIcon-DaL9yXsO.js","DynamicMarkdown-Co5nikxh.js","SectionHeading-P4UNTsMZ.js","axios-vUo_bRtp.js","Markdown-CEfymfIH.js","clsx-Dq9TQuNi.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-D2J8knkn.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BgZ2ThuU.js"]}