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/get","slug":"/api/checkout-sessions/get","pageMetadata":{"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"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Une session, avec \", _jsx(_components.code, {\n children: \"payment\"\n }), \" : la dernière tentative du payeur, ou \", _jsx(_components.code, {\n children: \"null\"\n }), \" tant qu’il n’a rien lancé.\"]\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{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Heading,Table}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Le paiement porte la même référence dans son champ `,_jsx(_components.code,{children:`checkout_session`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`session-ouverte-par-un-lien-de-paiement`,children:`Session ouverte par un lien de paiement`}),`\n`,_jsxs(_components.p,{children:[`Une session ouverte par un `,_jsx(_components.a,{href:`/payment-links/overview`,children:`lien de paiement`}),` porte aussi, dans l’événement `,_jsx(_components.code,{children:`checkout_session.completed`}),` :`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Champ`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`payment_link`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`uuid`}),` du lien d’origine`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`payer_phone`})}),_jsx(_components.td,{children:`Téléphone saisi par le payeur, si le lien le demande`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`payer_address`})}),_jsxs(_components.td,{children:[`Objet `,_jsx(_components.code,{children:`line1`}),`, `,_jsx(_components.code,{children:`city`}),`, `,_jsx(_components.code,{children:`country`}),`, si le lien demande l’adresse`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`custom_fields`})}),_jsxs(_components.td,{children:[`Réponses aux champs personnalisés, par `,_jsx(_components.code,{children:`id`}),` de champ. Pour un fichier, son nom`]})]})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":{"theme":{"light":"github-light","dark":"github-dark"}},"config":{},"pageMetadata":{"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"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Session ouverte par un lien de paiement","slug":"session-ouverte-par-un-lien-de-paiement","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/mercy-pay-docs/bf93ee4a8fbaf22f/kenn-hosting-footer.js"],"openApiReferenceData":{"operation":{"tags":["Sessions de paiement"],"operationId":"getCheckoutSession","summary":"Lire une session","description":"Une session, avec `payment` : la dernière tentative du payeur, ou `null` tant qu'il n'a rien lancé.","parameters":["2dc697b6-861c-4629-9e05-25f2fbd61b6c"],"responses":{"200":"e30620f6-9b73-4c01-9f0d-f59c026d60cd","401":"df6cb33a-8c94-4719-a09a-30c2ef5f6c72","404":"26286137-be53-4874-9474-2911ac93db8c","429":"ddaa2ae2-3541-4399-a00d-b8c3f7610b02"},"method":"get","type":"path","servers":["f7be4ff8-7197-43fa-8ad0-8aaccd4a6a44"],"security":["9b9d2556-aa0c-405e-9134-3a7261b24bce"],"path":"/api/v1/checkout_sessions/{id}","baseUrlOptions":["https://mercy-pay.com"],"title":"Lire une session","codeSamples":[],"requestExampleLanguages":["bash","php","javascript","python"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"2dc697b6-861c-4629-9e05-25f2fbd61b6c":{"name":"id","in":"path","required":true,"schema":{"type":"string","isRequired":true,"description":"Identifiant de la session (`cs_…`)","uniqueKey":"","typeLabel":"string"},"description":"Identifiant de la session (`cs_…`)"}},"responses":{"e30620f6-9b73-4c01-9f0d-f59c026d60cd":{"description":"La session","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Identifiant de la session (`cs_…`)","uniqueKey":"data.id","typeLabel":"string"},"object":{"type":"string","const":"checkout_session","uniqueKey":"data.object","typeLabel":"string"},"livemode":{"type":"boolean","description":"`true` pour de l'argent réel (clé live), `false` en sandbox","uniqueKey":"data.livemode","typeLabel":"boolean"},"created":{"oneOf":[{"type":"string","format":"date-time","description":"Date de création, ISO 8601","uniqueKey":"data.created.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Date de création, ISO 8601","uniqueKey":"data.created.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.created","typeLabel":"string\u003cdate-time> | null"},"amount":{"type":"integer","description":"Montant demandé, en unités mineures.","uniqueKey":"data.amount","typeLabel":"integer"},"currency":{"type":"string","description":"Devise du montant","uniqueKey":"data.currency","typeLabel":"string"},"description":{"oneOf":[{"type":"string","description":"Affichée au client","uniqueKey":"data.description.oneOf.0","typeLabel":"string"},{"type":"null","description":"Affichée au client","uniqueKey":"data.description.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.description","typeLabel":"string | null"},"payer_name":{"oneOf":[{"type":"string","description":"Nom du payeur","uniqueKey":"data.payer_name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Nom du payeur","uniqueKey":"data.payer_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.payer_name","typeLabel":"string | null"},"payer_email":{"oneOf":[{"type":"string","description":"E-mail du payeur","uniqueKey":"data.payer_email.oneOf.0","typeLabel":"string"},{"type":"null","description":"E-mail du payeur","uniqueKey":"data.payer_email.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.payer_email","typeLabel":"string | null"},"payer_phone":{"oneOf":[{"type":"string","description":"Téléphone du payeur","uniqueKey":"data.payer_phone.oneOf.0","typeLabel":"string"},{"type":"null","description":"Téléphone du payeur","uniqueKey":"data.payer_phone.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.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.payer_address.oneOf.0","typeLabel":"object"},{"type":"null","description":"Adresse saisie, si un lien de paiement la demande : `line1`, `city`, `country`.","uniqueKey":"data.payer_address.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.payer_address","typeLabel":"object | null"},"payment_link":{"oneOf":[{"type":"string","description":"Lien de paiement d'origine (`plink_…`), `null` sinon","uniqueKey":"data.payment_link.oneOf.0","typeLabel":"string"},{"type":"null","description":"Lien de paiement d'origine (`plink_…`), `null` sinon","uniqueKey":"data.payment_link.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.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.custom_fields","typeLabel":"object"},"success_url":{"oneOf":[{"type":"string","description":"Retour après paiement réussi","uniqueKey":"data.success_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"Retour après paiement réussi","uniqueKey":"data.success_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.success_url","typeLabel":"string | null"},"cancel_url":{"oneOf":[{"type":"string","description":"Retour si le client abandonne","uniqueKey":"data.cancel_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"Retour si le client abandonne","uniqueKey":"data.cancel_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.cancel_url","typeLabel":"string | null"},"payment_method_types":{"oneOf":[{"type":"array","items":{"type":"string","enum":["mobile_money","card"],"uniqueKey":"data.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.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.payment_method_types.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.payment_method_types","typeLabel":"enum\u003cstring>[] | null"},"allowed_countries":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"data.allowed_countries.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"Pays mobile money proposés. `null` : tous les pays ouverts.","uniqueKey":"data.allowed_countries.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"description":"Pays mobile money proposés. `null` : tous les pays ouverts.","uniqueKey":"data.allowed_countries.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.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.status","typeLabel":"enum\u003cstring>"},"metadata":{"oneOf":[{"type":"object","additionalProperties":true,"description":"Vos données libres. Voir [Metadata](/developers/metadata).","uniqueKey":"data.metadata.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":true,"description":"Vos données libres. Voir [Metadata](/developers/metadata).","uniqueKey":"data.metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.metadata","typeLabel":"object | null"},"checkout_url":{"type":"string","description":"Page de paiement hébergée où rediriger votre client.","format":"uri","uniqueKey":"data.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.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.expires_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.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.payment.oneOf.0.id","typeLabel":"string"},"object":{"type":"string","const":"payment","uniqueKey":"data.payment.oneOf.0.object","typeLabel":"string"},"livemode":{"type":"boolean","description":"`true` pour de l'argent réel (clé live), `false` en sandbox","uniqueKey":"data.payment.oneOf.0.livemode","typeLabel":"boolean"},"created":{"oneOf":[{"type":"string","format":"date-time","description":"Date de création, ISO 8601","uniqueKey":"data.payment.oneOf.0.created.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Date de création, ISO 8601","uniqueKey":"data.payment.oneOf.0.created.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.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.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.payment.oneOf.0.checkout_session.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.payment.oneOf.0.checkout_session","typeLabel":"string | null"},"amount":{"type":"integer","description":"Montant payé par le payeur, en unités mineures","uniqueKey":"data.payment.oneOf.0.amount","typeLabel":"integer"},"fee_amount":{"type":"integer","description":"Frais retenus","uniqueKey":"data.payment.oneOf.0.fee_amount","typeLabel":"integer"},"net_amount":{"type":"integer","description":"Montant versé sur votre solde","uniqueKey":"data.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.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.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.payment.oneOf.0.currency","typeLabel":"string"},"payment_method":{"type":"string","description":"Canal de paiement","enum":["mobile_money","card"],"uniqueKey":"data.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.payment.oneOf.0.mobile_money_country.oneOf.0","typeLabel":"string"},{"type":"null","description":"Pays de l'opérateur, `null` pour une carte.","uniqueKey":"data.payment.oneOf.0.mobile_money_country.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.payment.oneOf.0.mobile_money_country","typeLabel":"string | null"},"mobile_money_provider":{"oneOf":[{"type":"string","description":"Opérateur, `null` pour une carte.","uniqueKey":"data.payment.oneOf.0.mobile_money_provider.oneOf.0","typeLabel":"string"},{"type":"null","description":"Opérateur, `null` pour une carte.","uniqueKey":"data.payment.oneOf.0.mobile_money_provider.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.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.payment.oneOf.0.payer.name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.payment.oneOf.0.payer.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.payment.oneOf.0.payer.name","typeLabel":"string | null"},"email":{"oneOf":[{"type":"string","uniqueKey":"data.payment.oneOf.0.payer.email.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.payment.oneOf.0.payer.email.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.payment.oneOf.0.payer.email","typeLabel":"string | null"},"phone":{"oneOf":[{"type":"string","description":"Indicatif compris, sans `+`, par exemple `237677123456`.","uniqueKey":"data.payment.oneOf.0.payer.phone.oneOf.0","typeLabel":"string"},{"type":"null","description":"Indicatif compris, sans `+`, par exemple `237677123456`.","uniqueKey":"data.payment.oneOf.0.payer.phone.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.payment.oneOf.0.payer.phone","typeLabel":"string | null"}},"uniqueKey":"data.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.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.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.payment.oneOf.0.failure_code.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.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.payment.oneOf.0.failure_reason.oneOf.0","typeLabel":"string"},{"type":"null","description":"Raison de l'échec en français, à afficher telle quelle.","uniqueKey":"data.payment.oneOf.0.failure_reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.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.payment.oneOf.0.metadata.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":true,"description":"Vos données libres. Voir [Metadata](/developers/metadata).","uniqueKey":"data.payment.oneOf.0.metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.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.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.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.payment.oneOf.0.next_action.oneOf.0.redirect_url","typeLabel":"string\u003curi>"}},"uniqueKey":"data.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.payment.oneOf.0.next_action.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.payment.oneOf.0.next_action","typeLabel":"object | null"}},"uniqueKey":"data.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.payment.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.payment","typeLabel":"object | null"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"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":"completed","metadata":{"order_id":"4821"},"checkout_url":"https://mercy-pay.com/paiement/01J9Z3V8QK4M2XW7R6TB5N0HYD","expires_at":"2026-10-03T10:50:00+00:00","payment":{"id":"pay_5e0c8a7b3d1f4a2e9c648b7f0d2e1a93","object":"payment","livemode":false,"created":"2026-10-04T10:20:00+00:00","checkout_session":"cs_01J9Z3V8QK4M2XW7R6TB5N0HYD","amount":15000,"fee_amount":750,"net_amount":14250,"currency":"XAF","payment_method":"mobile_money","mobile_money_country":"CMR","mobile_money_provider":"MTN_MOMO_CMR","status":"succeeded","failure_code":null,"failure_reason":null,"metadata":null,"next_action":null}}},"examples":{"Example":{"title":"Example","value":{"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":"completed","metadata":{"order_id":"4821"},"checkout_url":"https://mercy-pay.com/paiement/01J9Z3V8QK4M2XW7R6TB5N0HYD","expires_at":"2026-10-03T10:50:00+00:00","payment":{"id":"pay_5e0c8a7b3d1f4a2e9c648b7f0d2e1a93","object":"payment","livemode":false,"created":"2026-10-04T10:20:00+00:00","checkout_session":"cs_01J9Z3V8QK4M2XW7R6TB5N0HYD","amount":15000,"fee_amount":750,"net_amount":14250,"currency":"XAF","payment_method":"mobile_money","mobile_money_country":"CMR","mobile_money_provider":"MTN_MOMO_CMR","status":"succeeded","failure_code":null,"failure_reason":null,"metadata":null,"next_action":null}}}}},"exampleType":"examples"}},"exampleType":"examples"},"df6cb33a-8c94-4719-a09a-30c2ef5f6c72":{"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"},"26286137-be53-4874-9474-2911ac93db8c":{"description":"Ressource inconnue, ou d'un autre marchand ou environnement","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":"resource_not_found","message":"Ressource introuvable.","param":null,"doc_url":"https://docs.mercy-pay.com/developers/errors#resource_not_found","request_id":"req_01jc8x4m2v7t9qk3n5w6y8z0ab"}},"examples":{"Example":{"title":"Example","value":{"error":{"type":"invalid_request_error","code":"resource_not_found","message":"Ressource introuvable.","param":null,"doc_url":"https://docs.mercy-pay.com/developers/errors#resource_not_found","request_id":"req_01jc8x4m2v7t9qk3n5w6y8z0ab"}}}},"exampleType":"examples"}},"exampleType":"examples"},"ddaa2ae2-3541-4399-a00d-b8c3f7610b02":{"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":"Lire une session - Mercy Pay","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-13T12:49:08.733Z","originalFileLocation":"api/checkout-sessions/get.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=\"Une session, avec payment : la dernière tentative du payeur, ou null tant qu\u0026#x27;il n\u0026#x27;a rien lancé.\">\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=\"Lire une session - Mercy Pay\">\u003cmeta data-mint-head property=\"og:description\" content=\"Une session, avec payment : la dernière tentative du payeur, ou null tant qu\u0026#x27;il n\u0026#x27;a rien lancé.\">\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/get\">\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=Lire+une+session\u0026amp;description=Une+session%2C+avec+%60payment%60+%3A+la+derni%C3%A8re+tentative+du+payeur%2C+ou+%60null%60+tant+qu%27il+n%27a+rien+lanc%C3%A9.\u0026amp;theme=29103f8f5341b6104078e85b\u0026amp;signature=2902e1b43449a0d70f012d40aec7a937a3d6b568bf76300b1da45610f4023fcd\">\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=\"Lire une session - Mercy Pay\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Une session, avec payment : la dernière tentative du payeur, ou null tant qu\u0026#x27;il n\u0026#x27;a rien lancé.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://mercy-pay-docs.mintlify.site/_mintlify/api/og/v2?division=Sessions+de+paiement\u0026amp;title=Lire+une+session\u0026amp;description=Une+session%2C+avec+%60payment%60+%3A+la+derni%C3%A8re+tentative+du+payeur%2C+ou+%60null%60+tant+qu%27il+n%27a+rien+lanc%C3%A9.\u0026amp;theme=29103f8f5341b6104078e85b\u0026amp;signature=2902e1b43449a0d70f012d40aec7a937a3d6b568bf76300b1da45610f4023fcd\">\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/get\">\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/get.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/get#webpage\",\"url\":\"https://docs.mercy-pay.com/api/checkout-sessions/get\",\"name\":\"Lire une session\",\"description\":\"Une session, avec payment : la dernière tentative du payeur, ou null tant qu'il n'a rien lancé.\",\"dateModified\":\"2026-11-13T12:49:08.733Z\",\"isPartOf\":{\"@id\":\"https://docs.mercy-pay.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.mercy-pay.com/api/checkout-sessions/get#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.mercy-pay.com/api/checkout-sessions/get#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\":\"Lire une session\",\"item\":\"https://docs.mercy-pay.com/api/checkout-sessions/get\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.mercy-pay.com/api/checkout-sessions/get#apireference\",\"headline\":\"Lire une session\",\"name\":\"Lire une session\",\"description\":\"Une session, avec payment : la dernière tentative du payeur, ou null tant qu'il n'a rien lancé.\",\"url\":\"https://docs.mercy-pay.com/api/checkout-sessions/get\",\"mainEntityOfPage\":{\"@id\":\"https://docs.mercy-pay.com/api/checkout-sessions/get#webpage\"},\"dateModified\":\"2026-11-13T12:49:08.733Z\",\"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/get.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","href":"/api/checkout-sessions/create"},{"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"},{"openapi":"GET /api/v1/checkout_sessions/{id}","title":"Lire une session","href":"/api/checkout-sessions/get"},{"openapi":"POST /api/v1/checkout_sessions/{id}/expire","title":"Expirer une session","description":"Ferme une session que plus personne ne doit payer. Une session déjà payée, ou avec un paiement en cours, renvoie `409`.","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":"Lire une session - 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"]}