Le marchand de la clé, l’environnement de cette clé, vos frais (taux par canal, frais fixe carte, qui les paie), les pays mobile money ouverts, vos limites et vos soldes. Lisez-le plutôt que de recopier ces valeurs dans votre configuration.
Essayez avec une clé sandbox (mp_sandbox_…) : aucun argent réel ne bouge. Voir Test et production.
key_prefix ne permet jamais de reconstituer la clé. Il sert seulement à la reconnaître dans votre tableau de bord.Le bloc fees donne vos taux réels, négociés ou non, et qui paie les frais. mobile_money liste les pays et opérateurs ouverts. Lisez ces valeurs plutôt que de les recopier dans votre configuration : elles changent quand votre contrat ou notre couverture évoluent.
Authorizations
Authorization
string
header
required
Votre clé API. Utilisez une clé sandbox (mp_sandbox_…) pour essayer : aucun argent réel ne bouge.
Response
Le compte
data
object
Hide child attributes
data.merchant
object
Hide child attributes
data.merchant.uuid
string<uuid>
Identifiant du marchand
data.merchant.name
string
Nom de la boutique
data.merchant.status
enum<string>
Statut du compte
Available options:
pending,
active,
suspended
data.merchant.kyc_status
enum<string>
Statut de la vérification d'identité, approved pour encaisser en live
Available options:
not_submitted,
pending,
approved,
rejected
data.merchant.default_currency
string
Devise par défaut
data.api_key
object
Hide child attributes
data.api_key.environment
enum<string>
Environnement de la clé
Available options:
sandbox,
live
data.api_key.key_prefix
string
Début de la clé, pour la reconnaître. Ne permet jamais de la reconstituer.
data.fees
object
Hide child attributes
data.fees.paid_by
enum<string>
Qui paie les frais de vos paiements
Available options:
merchant,
customer
data.fees.exempt
boolean
true si vous ne payez que le coût du prestataire, sans marge
data.fees.mobile_money
object
Hide child attributes
data.fees.mobile_money.rate_bps
integer
Taux en points de base (350 = 3,5 %)
data.fees.mobile_money.negotiated
boolean
true si ce taux a été négocié pour vous
data.fees.card
object
Hide child attributes
data.fees.card.rate_bps
integer
Taux en points de base (350 = 3,5 %)
data.fees.card.negotiated
boolean
true si ce taux a été négocié pour vous
data.fees.card.fixed_fee
object
Frais fixe ajouté à chaque paiement carte, en unités mineures, par devise
Hide child attributes
data.fees.card.fixed_fee.{key}
integer
data.fees.payout
object
Hide child attributes
data.fees.payout.rate_bps
integer
data.fees.refund
object
Hide child attributes
data.fees.refund.rate_bps
integer
data.fees.refund.minimum
object
Frais minimum par devise, en unités majeures
Hide child attributes
data.fees.refund.minimum.{key}
number
data.fees.refund.window_days
integer
Délai pour rembourser après le paiement
data.mobile_money
object[]
Pays mobile money ouverts
Hide child attributes
data.mobile_money.country
string
Code pays ISO à 3 lettres
data.mobile_money.currency
string
data.mobile_money.providers
string[]
data.limits
object
Hide child attributes
data.limits.monthly_volume
object | null
Plafond mensuel d'encaissement d'un compte particulier, null pour une entreprise
Hide child attributes
data.limits.monthly_volume.amount
integer
data.limits.monthly_volume.currency
string
data.limits.payout_max_amount
object
Montant maximum d'un retrait, en unités mineures, par devise
Hide child attributes
data.limits.payout_max_amount.{key}
integer
data.limits.payout_requests_per_hour
integer
data.wallets
object[]
Hide child attributes
data.wallets.id
string
Identifiant du solde (wal_…)
data.wallets.object
string
Allowed value: "wallet"
data.wallets.livemode
boolean
true pour de l'argent réel (clé live), false en sandbox
data.wallets.created
string<date-time> | null
Date de création, ISO 8601
data.wallets.channel
enum<string>
Canal
Available options:
mobile_money,
card
data.wallets.country
string | null
Pays, null pour la carte.
data.wallets.provider
string | null
Opérateur, null pour la carte.
data.wallets.currency
string
Devise du solde
data.wallets.available_balance
integer
Disponible pour un retrait, en unités mineures.
data.wallets.pending_balance
integer
Comptabilisé mais pas encore disponible (carte : jusqu'à ce que les fonds nous soient versés, en général sous 5 jours), en unités mineures.
{"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/account/get","slug":"/api/account/get","pageMetadata":{"openapi":"GET /api/v1/account","title":"Lire le compte","description":"Le marchand de la clé, l'environnement de cette clé, vos frais (taux par canal, frais fixe carte, qui les paie), les pays mobile money ouverts, vos limites et vos soldes. Lisez-le plutôt que de recopier ces valeurs dans votre configuration.","href":"/api/account/get"},"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: \"Le marchand de la clé, l’environnement de cette clé, vos frais (taux par canal, frais fixe carte, qui les paie), les pays mobile money ouverts, vos limites et vos soldes. Lisez-le plutôt que de recopier ces valeurs dans votre configuration.\"\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`,strong:`strong`,..._provideComponents(),...props.components},{Tip}=_components;if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(Tip,{children:_jsxs(_components.p,{children:[`Essayez avec une clé `,_jsx(_components.strong,{children:`sandbox`}),` (`,_jsx(_components.code,{children:`mp_sandbox_…`}),`) : aucun argent réel ne bouge. Voir `,_jsx(_components.a,{href:`/start/environments`,children:`Test et production`}),`.`]})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`key_prefix`}),` ne permet jamais de reconstituer la clé. Il sert seulement à la reconnaître dans votre tableau de bord.`]}),`\n`,_jsxs(_components.p,{children:[`Le bloc `,_jsx(_components.code,{children:`fees`}),` donne vos taux réels, négociés ou non, et qui paie les frais. `,_jsx(_components.code,{children:`mobile_money`}),` liste les pays et opérateurs ouverts. Lisez ces valeurs plutôt que de les recopier dans votre configuration : elles changent quand votre contrat ou notre couverture évoluent.`]})]})}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/account","title":"Lire le compte","description":"Le marchand de la clé, l'environnement de cette clé, vos frais (taux par canal, frais fixe carte, qui les paie), les pays mobile money ouverts, vos limites et vos soldes. Lisez-le plutôt que de recopier ces valeurs dans votre configuration.","href":"/api/account/get"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/mercy-pay-docs/bf93ee4a8fbaf22f/kenn-hosting-footer.js"],"openApiReferenceData":{"operation":{"tags":["Compte"],"operationId":"getAccount","summary":"Lire le compte","description":"Le marchand de la clé, l'environnement de cette clé, vos frais (taux par canal, frais fixe carte, qui les paie), les pays mobile money ouverts, vos limites et vos soldes. Lisez-le plutôt que de recopier ces valeurs dans votre configuration.","responses":{"200":"c8cbe1a6-e7ea-4ad0-ada2-780a37a74c4b","401":"6940c0db-d628-4490-9616-221bebcae935","403":"3ba6af4b-ed9b-493f-97a4-cf651d94a159","429":"336f6cc0-eb8c-4581-9445-a655479a4c7f"},"method":"get","type":"path","servers":["f7be4ff8-7197-43fa-8ad0-8aaccd4a6a44"],"security":["9b9d2556-aa0c-405e-9134-3a7261b24bce"],"path":"/api/v1/account","baseUrlOptions":["https://mercy-pay.com"],"title":"Lire le compte","codeSamples":[],"requestExampleLanguages":["bash","php","javascript","python"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"responses":{"c8cbe1a6-e7ea-4ad0-ada2-780a37a74c4b":{"description":"Le compte","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"merchant":{"type":"object","properties":{"uuid":{"type":"string","format":"uuid","description":"Identifiant du marchand","uniqueKey":"data.merchant.uuid","typeLabel":"string\u003cuuid>"},"name":{"type":"string","description":"Nom de la boutique","uniqueKey":"data.merchant.name","typeLabel":"string"},"status":{"type":"string","description":"Statut du compte","enum":["pending","active","suspended"],"uniqueKey":"data.merchant.status","typeLabel":"enum\u003cstring>"},"kyc_status":{"type":"string","description":"Statut de la vérification d'identité, `approved` pour encaisser en live","enum":["not_submitted","pending","approved","rejected"],"uniqueKey":"data.merchant.kyc_status","typeLabel":"enum\u003cstring>"},"default_currency":{"type":"string","description":"Devise par défaut","uniqueKey":"data.merchant.default_currency","typeLabel":"string"}},"uniqueKey":"data.merchant","typeLabel":"object"},"api_key":{"type":"object","properties":{"environment":{"type":"string","description":"Environnement de la clé","enum":["sandbox","live"],"uniqueKey":"data.api_key.environment","typeLabel":"enum\u003cstring>"},"key_prefix":{"type":"string","description":"Début de la clé, pour la reconnaître. Ne permet jamais de la reconstituer.","uniqueKey":"data.api_key.key_prefix","typeLabel":"string"}},"uniqueKey":"data.api_key","typeLabel":"object"},"fees":{"type":"object","properties":{"paid_by":{"type":"string","enum":["merchant","customer"],"description":"Qui paie les frais de vos paiements","uniqueKey":"data.fees.paid_by","typeLabel":"enum\u003cstring>"},"exempt":{"type":"boolean","description":"`true` si vous ne payez que le coût du prestataire, sans marge","uniqueKey":"data.fees.exempt","typeLabel":"boolean"},"mobile_money":{"type":"object","properties":{"rate_bps":{"type":"integer","description":"Taux en points de base (350 = 3,5 %)","uniqueKey":"data.fees.mobile_money.rate_bps","typeLabel":"integer"},"negotiated":{"type":"boolean","description":"`true` si ce taux a été négocié pour vous","uniqueKey":"data.fees.mobile_money.negotiated","typeLabel":"boolean"}},"uniqueKey":"data.fees.mobile_money","typeLabel":"object"},"card":{"type":"object","properties":{"rate_bps":{"type":"integer","description":"Taux en points de base (350 = 3,5 %)","uniqueKey":"data.fees.card.rate_bps","typeLabel":"integer"},"negotiated":{"type":"boolean","description":"`true` si ce taux a été négocié pour vous","uniqueKey":"data.fees.card.negotiated","typeLabel":"boolean"},"fixed_fee":{"type":"object","additionalProperties":{"type":"integer","uniqueKey":"data.fees.card.fixed_fee.additionalProperties","typeLabel":"integer"},"description":"Frais fixe ajouté à chaque paiement carte, en unités mineures, par devise","uniqueKey":"data.fees.card.fixed_fee","typeLabel":"object"}},"uniqueKey":"data.fees.card","typeLabel":"object"},"payout":{"type":"object","properties":{"rate_bps":{"type":"integer","uniqueKey":"data.fees.payout.rate_bps","typeLabel":"integer"}},"uniqueKey":"data.fees.payout","typeLabel":"object"},"refund":{"type":"object","properties":{"rate_bps":{"type":"integer","uniqueKey":"data.fees.refund.rate_bps","typeLabel":"integer"},"minimum":{"type":"object","additionalProperties":{"type":"number","uniqueKey":"data.fees.refund.minimum.additionalProperties","typeLabel":"number"},"description":"Frais minimum par devise, en unités majeures","uniqueKey":"data.fees.refund.minimum","typeLabel":"object"},"window_days":{"type":"integer","description":"Délai pour rembourser après le paiement","uniqueKey":"data.fees.refund.window_days","typeLabel":"integer"}},"uniqueKey":"data.fees.refund","typeLabel":"object"}},"uniqueKey":"data.fees","typeLabel":"object"},"mobile_money":{"type":"array","description":"Pays mobile money ouverts","items":{"type":"object","properties":{"country":{"type":"string","description":"Code pays ISO à 3 lettres","uniqueKey":"data.mobile_money.items.[INDEX].country","typeLabel":"string"},"currency":{"type":"string","uniqueKey":"data.mobile_money.items.[INDEX].currency","typeLabel":"string"},"providers":{"type":"array","items":{"type":"string","uniqueKey":"data.mobile_money.items.[INDEX].providers.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.mobile_money.items.[INDEX].providers","typeLabel":"string[]"}},"uniqueKey":"data.mobile_money.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.mobile_money","typeLabel":"object[]"},"limits":{"type":"object","properties":{"monthly_volume":{"oneOf":[{"type":"object","description":"Plafond mensuel d'encaissement d'un compte particulier, `null` pour une entreprise","properties":{"amount":{"type":"integer","uniqueKey":"data.limits.monthly_volume.oneOf.0.amount","typeLabel":"integer"},"currency":{"type":"string","uniqueKey":"data.limits.monthly_volume.oneOf.0.currency","typeLabel":"string"}},"uniqueKey":"data.limits.monthly_volume.oneOf.0","typeLabel":"object"},{"type":"null","description":"Plafond mensuel d'encaissement d'un compte particulier, `null` pour une entreprise","properties":{"amount":{"type":"integer"},"currency":{"type":"string"}},"uniqueKey":"data.limits.monthly_volume.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.limits.monthly_volume","typeLabel":"object | null"},"payout_max_amount":{"type":"object","additionalProperties":{"type":"integer","uniqueKey":"data.limits.payout_max_amount.additionalProperties","typeLabel":"integer"},"description":"Montant maximum d'un retrait, en unités mineures, par devise","uniqueKey":"data.limits.payout_max_amount","typeLabel":"object"},"payout_requests_per_hour":{"type":"integer","uniqueKey":"data.limits.payout_requests_per_hour","typeLabel":"integer"}},"uniqueKey":"data.limits","typeLabel":"object"},"wallets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identifiant du solde (`wal_…`)","uniqueKey":"data.wallets.items.[INDEX].id","typeLabel":"string"},"object":{"type":"string","const":"wallet","uniqueKey":"data.wallets.items.[INDEX].object","typeLabel":"string"},"livemode":{"type":"boolean","description":"`true` pour de l'argent réel (clé live), `false` en sandbox","uniqueKey":"data.wallets.items.[INDEX].livemode","typeLabel":"boolean"},"created":{"oneOf":[{"type":"string","format":"date-time","description":"Date de création, ISO 8601","uniqueKey":"data.wallets.items.[INDEX].created.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Date de création, ISO 8601","uniqueKey":"data.wallets.items.[INDEX].created.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.wallets.items.[INDEX].created","typeLabel":"string\u003cdate-time> | null"},"channel":{"type":"string","description":"Canal","enum":["mobile_money","card"],"uniqueKey":"data.wallets.items.[INDEX].channel","typeLabel":"enum\u003cstring>"},"country":{"oneOf":[{"type":"string","description":"Pays, `null` pour la carte.","uniqueKey":"data.wallets.items.[INDEX].country.oneOf.0","typeLabel":"string"},{"type":"null","description":"Pays, `null` pour la carte.","uniqueKey":"data.wallets.items.[INDEX].country.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.wallets.items.[INDEX].country","typeLabel":"string | null"},"provider":{"oneOf":[{"type":"string","description":"Opérateur, `null` pour la carte.","uniqueKey":"data.wallets.items.[INDEX].provider.oneOf.0","typeLabel":"string"},{"type":"null","description":"Opérateur, `null` pour la carte.","uniqueKey":"data.wallets.items.[INDEX].provider.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.wallets.items.[INDEX].provider","typeLabel":"string | null"},"currency":{"type":"string","description":"Devise du solde","uniqueKey":"data.wallets.items.[INDEX].currency","typeLabel":"string"},"available_balance":{"type":"integer","description":"Disponible pour un retrait, en unités mineures.","uniqueKey":"data.wallets.items.[INDEX].available_balance","typeLabel":"integer"},"pending_balance":{"type":"integer","description":"Comptabilisé mais pas encore disponible (carte : jusqu'à ce que les fonds nous soient versés, en général sous 5 jours), en unités mineures.","uniqueKey":"data.wallets.items.[INDEX].pending_balance","typeLabel":"integer"}},"uniqueKey":"data.wallets.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.wallets","typeLabel":"object[]"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"data":{"merchant":{"uuid":"0b6c2f1e-6d1a-4a3e-9d0a-2f3c1b7e8a41","name":"Boutique Ada","status":"active","kyc_status":"approved","default_currency":"XAF"},"api_key":{"environment":"sandbox","key_prefix":"mp_sandbox_9Kd2mQ7Z"},"wallets":[{"id":"wal_3f1a8c2e5b7d4e9a8c610d2f4b9a7e15","object":"wallet","livemode":false,"created":"2026-09-12T08:30:00+00:00","channel":"mobile_money","country":"CMR","provider":"MTN_MOMO_CMR","currency":"XAF","available_balance":9500,"pending_balance":0}]}},"examples":{"Example":{"title":"Example","value":{"data":{"merchant":{"uuid":"0b6c2f1e-6d1a-4a3e-9d0a-2f3c1b7e8a41","name":"Boutique Ada","status":"active","kyc_status":"approved","default_currency":"XAF"},"api_key":{"environment":"sandbox","key_prefix":"mp_sandbox_9Kd2mQ7Z"},"wallets":[{"id":"wal_3f1a8c2e5b7d4e9a8c610d2f4b9a7e15","object":"wallet","livemode":false,"created":"2026-09-12T08:30:00+00:00","channel":"mobile_money","country":"CMR","provider":"MTN_MOMO_CMR","currency":"XAF","available_balance":9500,"pending_balance":0}]}}}},"exampleType":"examples"}},"exampleType":"examples"},"6940c0db-d628-4490-9616-221bebcae935":{"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"},"3ba6af4b-ed9b-493f-97a4-cf651d94a159":{"description":"Compte suspendu, ou clé live avant l'approbation du KYC","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":"live_mode_requires_kyc","message":"Le mode live demande un KYC approuvé.","param":null,"doc_url":"https://docs.mercy-pay.com/developers/errors#live_mode_requires_kyc","request_id":"req_01jc8x4m2v7t9qk3n5w6y8z0ab"}},"examples":{"Example":{"title":"Example","value":{"error":{"type":"authentication_error","code":"live_mode_requires_kyc","message":"Le mode live demande un KYC approuvé.","param":null,"doc_url":"https://docs.mercy-pay.com/developers/errors#live_mode_requires_kyc","request_id":"req_01jc8x4m2v7t9qk3n5w6y8z0ab"}}}},"exampleType":"examples"}},"exampleType":"examples"},"336f6cc0-eb8c-4581-9445-a655479a4c7f":{"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 le compte - Mercy Pay","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-14T23:29:11.641Z","originalFileLocation":"api/account/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=\"Le marchand de la clé, l\u0026#x27;environnement de cette clé, vos frais (taux par canal, frais fixe carte, qui les paie), les pays mobile money ouverts, vos limites et vos soldes. Lisez-le plutôt que de recopier ces valeurs dans votre configuration.\">\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 le compte - Mercy Pay\">\u003cmeta data-mint-head property=\"og:description\" content=\"Le marchand de la clé, l\u0026#x27;environnement de cette clé, vos frais (taux par canal, frais fixe carte, qui les paie), les pays mobile money ouverts, vos limites et vos soldes. Lisez-le plutôt que de recopier ces valeurs dans votre configuration.\">\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/account/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=Compte\u0026amp;title=Lire+le+compte\u0026amp;description=Le+marchand+de+la+cl%C3%A9%2C+l%27environnement+de+cette+cl%C3%A9%2C+vos+frais+%28taux+par+canal%2C+frais+fixe+carte%2C+qui+les+paie%29%2C+les+pays+mobile+money+ouverts%2C+vos+limites+et+v\u0026amp;theme=29103f8f5341b6104078e85b\u0026amp;signature=2443610c3cd527000247b95ac885aa9fa881777584f24a206490c6ee59e1a9e3\">\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 le compte - Mercy Pay\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Le marchand de la clé, l\u0026#x27;environnement de cette clé, vos frais (taux par canal, frais fixe carte, qui les paie), les pays mobile money ouverts, vos limites et vos soldes. Lisez-le plutôt que de recopier ces valeurs dans votre configuration.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://mercy-pay-docs.mintlify.site/_mintlify/api/og/v2?division=Compte\u0026amp;title=Lire+le+compte\u0026amp;description=Le+marchand+de+la+cl%C3%A9%2C+l%27environnement+de+cette+cl%C3%A9%2C+vos+frais+%28taux+par+canal%2C+frais+fixe+carte%2C+qui+les+paie%29%2C+les+pays+mobile+money+ouverts%2C+vos+limites+et+v\u0026amp;theme=29103f8f5341b6104078e85b\u0026amp;signature=2443610c3cd527000247b95ac885aa9fa881777584f24a206490c6ee59e1a9e3\">\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/account/get\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api/account/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/account/get#webpage\",\"url\":\"https://docs.mercy-pay.com/api/account/get\",\"name\":\"Lire le compte\",\"description\":\"Le marchand de la clé, l'environnement de cette clé, vos frais (taux par canal, frais fixe carte, qui les paie), les pays mobile money ouverts, vos limites et vos soldes. Lisez-le plutôt que de recopier ces valeurs dans votre configuration.\",\"dateModified\":\"2026-11-14T23:29:11.641Z\",\"isPartOf\":{\"@id\":\"https://docs.mercy-pay.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.mercy-pay.com/api/account/get#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.mercy-pay.com/api/account/get#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Mercy Pay\",\"item\":\"https://docs.mercy-pay.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Lire le compte\",\"item\":\"https://docs.mercy-pay.com/api/account/get\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.mercy-pay.com/api/account/get#apireference\",\"headline\":\"Lire le compte\",\"name\":\"Lire le compte\",\"description\":\"Le marchand de la clé, l'environnement de cette clé, vos frais (taux par canal, frais fixe carte, qui les paie), les pays mobile money ouverts, vos limites et vos soldes. Lisez-le plutôt que de recopier ces valeurs dans votre configuration.\",\"url\":\"https://docs.mercy-pay.com/api/account/get\",\"mainEntityOfPage\":{\"@id\":\"https://docs.mercy-pay.com/api/account/get#webpage\"},\"dateModified\":\"2026-11-14T23:29:11.641Z\",\"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/account/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","description":"Recevez un objet lié en entier plutôt que son id, en une seule requête.","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","description":"Public, sans clé : appelez-le depuis le navigateur de votre client pour griser un opérateur en panne avant même de tenter un paiement.","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","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","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 le compte - 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"]}