When creating a payout payment, you can use the global markup configuration that has been set up for your merchant. With global markup, you do not need to send the markup object in the request payload.
Global markup is applied automatically: If the merchant has the markup feature enabled (enable_markup = true), the system will automatically search for and apply the submerchant’s own markup or, if there is none, the global markup configuration.
Validation: The system checks if the enable_markup flag is active for the submerchant.
Markup Search: If enabled, the system automatically searches for a markup configuration, first for the submerchant and then for the merchant, based on:
account_id (submerchant ID)
product (payout)
payment_method (markup for payout is currently available for PIX only)
Application: If the submerchant has its own markup for the payment method, it is applied to the payment. Otherwise, the global markup is applied.
Priority: If you send an inline markup object, it takes precedence over the submerchant and global markups.
Markup Required: If enable_markup = true for the submerchant and there is neither a submerchant markup nor a global markup configuration for the payment method, you must send an inline markup object. Otherwise, the request will fail with a 422 error.
Automatic Application: When enable_markup = true and a submerchant or global markup exists, it is automatically applied without requiring the markup object in the request.
If there is an error while searching for or verifying the global markup configuration.Result: Returns 422 error with message “Error verifying markup configuration. Please try again or contact support.”
Complete documentation for creating payout payments
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"WEpayments API","colors":{"primary":"#0070F3","light":"#3B82F6","dark":"#1E40AF"},"logo":{"light":"https://mintcdn.com/wepayments/GK7WnsFFvtF-KM57/logo/light.png?fit=max\u0026auto=format\u0026n=GK7WnsFFvtF-KM57\u0026q=85\u0026s=7fc96daf3fce22b28043ddd60dc04dab","dark":"https://mintcdn.com/wepayments/GK7WnsFFvtF-KM57/logo/dark.png?fit=max\u0026auto=format\u0026n=GK7WnsFFvtF-KM57\u0026q=85\u0026s=7646399133c566139392d17a9aa3a598"},"favicon":"https://mintcdn.com/wepayments/GK7WnsFFvtF-KM57/favicon.png?fit=max\u0026auto=format\u0026n=GK7WnsFFvtF-KM57\u0026q=85\u0026s=9acc6fa7d8d2cb32974438376b9d611b","api":{"mdx":{"auth":{"method":"bearer"},"server":"https://api.sandbox.wepayout.com.br"}},"navbar":{"links":[{"href":"https://app.wepayout.co/#/dashboard","label":"Dashboard"},{"href":"https://wepayments.instatus.com/","label":"Status Page"}],"primary":{"type":"button","label":"Get API Key","href":"https://support.wepayments.com.br/support/legal/api-authentication"}},"footer":{"socials":{"linkedin":"https://linkedin.com/company/wepayments"}},"seo":{"metatags":{"canonical":"https://docs.wepayout.co"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"wepayments","hasAudioNarration":false,"actualSubdomain":"wepayments","customDomains":["docs.wepayout.co"],"gitSource":{"type":"gitlab","owner":"wepayout","repo":"docs","projectId":75684596,"deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6ad665ec88e502fb0aeb6d58","clientVersion":"0.0.4087","searchFilterCounts":[{"language":"default","tag":"API Reference","count":71},{"language":"default","tag":"Payin","count":42},{"language":"default","tag":"Documentation","count":35},{"language":"default","tag":"Pix","count":28},{"language":"default","tag":"Payout","count":26},{"language":"default","tag":"Account","count":22},{"language":"default","tag":"Automatic Pix","count":16},{"language":"default","tag":"Markup","count":14},{"language":"default","tag":"Onboarding","count":11},{"language":"default","tag":"Webhooks","count":8}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":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":"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":"llms-txt-v2","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":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/markup/payout/create-payout-with-global-markup","slug":"/api-reference/markup/payout/create-payout-with-global-markup","pageMetadata":{"title":"Create Payout with Global Markup","api":"POST https://api.sandbox.wepayout.com.br/v2/payout/payments","description":"Create a payout payment using global markup configuration.","href":"/api-reference/markup/payout/create-payout-with-global-markup"},"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: \"Create a payout payment using global markup 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={code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Card,CardGroup,CodeBlock,CodeGroup,Expandable,Heading,Info,Note,ResponseField,Warning}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`1`,id:`create-payout-with-global-markup`,children:`Create Payout with Global Markup`}),`\n`,_jsxs(_components.p,{children:[`When creating a payout payment, you can use the `,_jsx(_components.strong,{children:`global markup`}),` configuration that has been set up for your merchant. With global markup, you `,_jsx(_components.strong,{children:`do not need to send`}),` the `,_jsx(_components.code,{children:`markup`}),` object in the request payload.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Global markup is applied automatically`}),`: If the merchant has the markup feature enabled (`,_jsx(_components.code,{children:`enable_markup = true`}),`), the system will automatically search for and apply the submerchant’s own markup or, if there is none, the global markup configuration.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`how-it-works`,children:`How It Works`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Validation`}),`: The system checks if the `,_jsx(_components.code,{children:`enable_markup`}),` flag is active for the submerchant.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Markup Search`}),`: If enabled, the system automatically searches for a markup configuration, first for the submerchant and then for the merchant, based on:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`account_id`}),` (submerchant ID)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`product`}),` (payout)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`payment_method`}),` (markup for payout is currently available for PIX only)`]}),`\n`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Application`}),`: If the submerchant has its own markup for the payment method, it is applied to the payment. Otherwise, the global markup is applied.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Priority`}),`: If you send an inline `,_jsx(_components.code,{children:`markup`}),` object, it takes precedence over the submerchant and global markups.`]}),`\n`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`request-examples`,children:`Request Examples`}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`PIX with Global Markup`,numberOfLines:`17`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`17`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"payment_method\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"PIX\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"invoice\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"e3317882-f821-455b-b082-dc3ba36e8a57\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"currency\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"BRL\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"amount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`100.50`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"country\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"BR\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"beneficiary\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"John Doe\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"document\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"CPF\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"number\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"12345678901\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"pix\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"key\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"12345678901\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`cURL - PIX with Global Markup`,numberOfLines:`20`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`20`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.sandbox.wepayout.com.br/v2/payout/payments\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer YOUR_TOKEN_HERE\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"payment_method\": \"PIX\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"invoice\": \"e3317882-f821-455b-b082-dc3ba36e8a57\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"currency\": \"BRL\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"amount\": 100.50,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"country\": \"BR\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"beneficiary\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"name\": \"John Doe\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"document\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"type\": \"CPF\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"number\": \"12345678901\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"pix\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"key\": \"12345678901\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(ResponseField,{name:`id`,type:`integer`,id:`param-id`,children:_jsx(_components.p,{children:`WEpayment’s auto generated id, use this id to perform conciliation or perform queries via API / Dashboard.`})}),`\n`,_jsxs(ResponseField,{name:`merchant`,type:`object`,id:`param-merchant`,children:[_jsx(_components.p,{children:`Merchant object.`}),_jsxs(Expandable,{title:`Merchant`,children:[_jsx(ResponseField,{name:`id`,type:`integer`,id:`param-id-1`,children:_jsx(_components.p,{children:`Id of the WE account that created the payout.`})}),_jsx(ResponseField,{name:`name`,type:`string`,id:`param-name`,children:_jsx(_components.p,{children:`Name of the WE account that created the payout.`})})]})]}),`\n`,_jsxs(ResponseField,{name:`payment_method`,type:`string`,id:`param-payment-method`,children:[_jsx(_components.p,{children:`Payment method used for the payout.`}),_jsxs(_components.p,{children:[`Values: `,_jsx(_components.code,{children:`PIX`})]})]}),`\n`,_jsx(ResponseField,{name:`amount`,type:`string`,id:`param-amount`,children:_jsx(_components.p,{children:`The payout amount formatted with currency symbol.`})}),`\n`,_jsx(ResponseField,{name:`currency`,type:`string`,id:`param-currency`,children:_jsx(_components.p,{children:`Currency code (ISO 4217).`})}),`\n`,_jsx(ResponseField,{name:`invoice`,type:`string`,id:`param-invoice`,children:_jsx(_components.p,{children:`Invoice identifier.`})}),`\n`,_jsxs(ResponseField,{name:`status`,type:`object`,id:`param-status`,children:[_jsx(_components.p,{children:`Payout status.`}),_jsxs(Expandable,{title:`Status`,children:[_jsx(ResponseField,{name:`id`,type:`integer`,id:`param-id-2`,children:_jsx(_components.p,{children:`Status ID.`})}),_jsx(ResponseField,{name:`name`,type:`string`,id:`param-name-1`,children:_jsx(_components.p,{children:`Status name (e.g., “Awaiting”).`})})]})]}),`\n`,_jsxs(ResponseField,{name:`beneficiary`,type:`object`,id:`param-beneficiary`,children:[_jsx(_components.p,{children:`Beneficiary information.`}),_jsxs(Expandable,{title:`Beneficiary`,children:[_jsx(ResponseField,{name:`name`,type:`string`,id:`param-name-2`,children:_jsx(_components.p,{children:`Beneficiary name.`})}),_jsx(ResponseField,{name:`document`,type:`object`,id:`param-document`,children:_jsx(_components.p,{children:`Document information.`})})]})]}),`\n`,_jsxs(ResponseField,{name:`markup`,type:`object or null`,id:`param-markup`,children:[_jsx(_components.p,{children:`Markup configuration applied to this payment (submerchant or global).`}),_jsxs(Expandable,{title:`Markup Object`,children:[_jsxs(ResponseField,{name:`mode`,type:`string`,id:`param-mode`,children:[_jsx(_components.p,{children:`Markup mode applied.`}),_jsxs(_components.p,{children:[`Values: `,_jsx(_components.code,{children:`fixed`}),`, `,_jsx(_components.code,{children:`percent`})]})]}),_jsx(ResponseField,{name:`amount`,type:`number`,id:`param-amount-1`,children:_jsx(_components.p,{children:`Markup value configured for this payment.`})}),_jsx(ResponseField,{name:`min_charge_value`,type:`number or null`,id:`param-min-charge-value`,children:_jsxs(_components.p,{children:[`Minimum markup value when `,_jsx(_components.code,{children:`mode`}),` is `,_jsx(_components.code,{children:`percent`}),`. Will be `,_jsx(_components.code,{children:`null`}),` when `,_jsx(_components.code,{children:`mode`}),` is `,_jsx(_components.code,{children:`fixed`}),`.`]})}),_jsx(ResponseField,{name:`max_charge_value`,type:`number or null`,id:`param-max-charge-value`,children:_jsxs(_components.p,{children:[`Maximum markup value when `,_jsx(_components.code,{children:`mode`}),` is `,_jsx(_components.code,{children:`percent`}),`. Will be `,_jsx(_components.code,{children:`null`}),` when `,_jsx(_components.code,{children:`mode`}),` is `,_jsx(_components.code,{children:`fixed`}),` or when not specified.`]})}),_jsxs(ResponseField,{name:`origin`,type:`string or null`,id:`param-origin`,children:[_jsx(_components.p,{children:`Level of the markup that was applied.`}),_jsxs(_components.p,{children:[`Values: `,_jsx(_components.code,{children:`sub_merchant`}),`, `,_jsx(_components.code,{children:`global`})]})]})]})]}),`\n`,`\n`,_jsx(Heading,{level:`2`,id:`business-rules`,children:`Business Rules`}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Markup Required`}),`: If `,_jsx(_components.code,{children:`enable_markup = true`}),` for the submerchant and there is neither a submerchant markup nor a global markup configuration for the payment method, you must send an inline `,_jsx(_components.code,{children:`markup`}),` object. Otherwise, the request will fail with a 422 error.`]})}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Automatic Application`}),`: When `,_jsx(_components.code,{children:`enable_markup = true`}),` and a submerchant or global markup exists, it is automatically applied without requiring the `,_jsx(_components.code,{children:`markup`}),` object in the request.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`error-scenarios`,children:`Error Scenarios`}),`\n`,_jsx(Heading,{level:`3`,id:`scenario-1-enable_markup-=-true-no-submerchant-or-global-markup-no-inline-markup`,children:`Scenario 1: enable_markup = true, No Submerchant or Global Markup, No Inline Markup`}),`\n`,_jsxs(_components.p,{children:[`If the submerchant has `,_jsx(_components.code,{children:`enable_markup = true`}),` but:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`No submerchant markup configuration exists for the payment method`}),`\n`,_jsx(_components.li,{children:`No global markup configuration exists for the payment method`}),`\n`,_jsx(_components.li,{children:`No inline markup object is sent in the request`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Result`}),`: Returns 422 error with message “O campo markup é obrigatório.”`]}),`\n`,_jsx(Heading,{level:`3`,id:`scenario-2-error-verifying-global-markup`,children:`Scenario 2: Error Verifying Global Markup`}),`\n`,_jsx(_components.p,{children:`If there is an error while searching for or verifying the global markup configuration.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Result`}),`: Returns 422 error with message “Error verifying markup configuration. Please try again or contact support.”`]}),`\n`,_jsx(Heading,{level:`2`,id:`related-resources`,children:`Related Resources`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Create Payout with Inline Markup`,icon:`code`,href:`/api-reference/markup/payout/create-payout-with-inline-markup`,children:_jsx(_components.p,{children:`Learn how to create payout with inline markup`})}),_jsx(Card,{title:`Create Merchant Markup`,icon:`plus`,href:`/api-reference/markup/account/create-merchant-markup`,children:_jsx(_components.p,{children:`Configure global markup for merchants`})}),_jsx(Card,{title:`About Markup`,icon:`circle-info`,href:`/markup/about-markup`,children:_jsx(_components.p,{children:`Understand markup types and configuration levels`})}),_jsx(Card,{title:`Create Payment`,icon:`file`,href:`/api-reference/cash-out/payout/create-payment`,children:_jsx(_components.p,{children:`Complete documentation for creating payout payments`})})]})]})}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":{"config":{},"pageMetadata":{"title":"Create Payout with Global Markup","api":"POST https://api.sandbox.wepayout.com.br/v2/payout/payments","description":"Create a payout payment using global markup configuration.","href":"/api-reference/markup/payout/create-payout-with-global-markup"}}},"mdxSourceWithNoJs":null,"noJsSplices":[[379,383,"Example,ResponseFiel"],[810,825,"Example)_missingMdxReference(`ResponseExample`,true);if(!ResponseField)_missingM"],[17710,21257,"_jsxs(ResponseExample,{children:[_jsx(CodeBlock,{filename:`201 Created - PIX Payment with Global Markup`,numberOfLines:`23`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`23`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`12345`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"merchant\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`477`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Merchant Name\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"payment_method\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"PIX\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"amount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"R$ 100,50\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"currency\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"BRL\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"invoice\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"e3317882-f821-455b-b082-dc3ba36e8a57\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Awaiting\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"beneficiary\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"John Doe\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"document\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"CPF\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"number\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"12345678901\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"markup\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Markup returns null`}),`: It is normal for the `,_jsx(_components.code,{children:`markup`}),` field to return `,_jsx(_components.code,{children:`null`}),` when using global markup.`]})}),_jsx(CodeBlock,{filename:`422 Unprocessable Entity - Markup Required`,numberOfLines:`8`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"The given data was invalid\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"errors\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"markup\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Inline markup is required when no global markup is configured\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`500 Internal Server Error`,numberOfLines:`3`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Internal server error\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`business-rules`,children:`Business Rules`}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Markup Required`}),`: If `,_jsx(_components.code,{children:`enable_markup = true`}),` for the submerchant and there is neither a submerchant markup nor a global markup configuration for the payment method, you must send an inline `,_jsx(_components.code,{children:`markup`}),` object. Otherwise, the request will fail with a 422 error.`]})}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Automatic Application`}),`: When `,_jsx(_components.code,{children:`enable_markup = true`}),` and a submerchant or global markup exists, it is automatically applied without requiring the `,_jsx(_components.code,{children:`markup`}),` object in the request.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`error-scenarios`,children:`Error Scenarios`}),`\n`,_jsx(Heading,{level:`3`,id:`scenario-1-enable_markup-=-true-no-submerchant-or-global-markup-no-inline-markup`,children:`Scenario 1: enable_markup = true, No Submerchant or Global Markup, No Inline Markup`}),`\n`,_jsxs(_components.p,{children:[`If the submerchant has `,_jsx(_components.code,{children:`enable_markup = true`}),` but:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`No submerchant markup configuration exists for the payment method`}),`\n`,_jsx(_components.li,{children:`No global markup configuration exists for the payment method`}),`\n`,_jsx(_components.li,{children:`No inline markup object is sent in the request`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Result`}),`: Returns 422 error with message “O campo markup é obrigatório.”`]}),`\n`,_jsx(Heading,{level:`3`,id:`scenario-2-error-verifying-global-markup`,children:`Scenario 2: Error Verifying Global Markup`}),`\n`,_jsx(_components.p,{children:`If there is an error while searching for or verifying the global markup configuration.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Result`}),`: Returns 422 error with message “Error verifying markup configuration. Please try again or contact support.”`]}),`\n`,_jsx(Heading,{level:`2`,id:`related-resources`,children:`Related Resources`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Create Payout with Inline Markup`,icon:`code`,href:`/api-reference/markup/payout/create-payout-with-inline-markup`,children:_jsx(_components.p,{children:`Learn how to create payout with inline markup`})}),_jsx(Card,{title:`Create Merchant Markup`,icon:`plus`,href:`/api-reference/markup/account/create-merchant-markup`,children:_jsx(_components.p,{children:`Configure global markup for merchants`})}),_jsx(Card,{title:`About Markup`,icon:`circle-info`,href:`/markup/about-markup`,children:_jsx(_components.p,{children:`Understand markup types and configuration levels`})}),_jsx(Card,{title:`Create Payment`,icon:`file`,href:`/api-reference/cash-out/payout/create-payment`,children:_jsx(_components.p,{children:`Complete documentation for creating payout payments`})})]})]})}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.\")}"]]},"mdxExtracts":{"tableOfContents":[{"title":"Create Payout with Global Markup","slug":"create-payout-with-global-markup","depth":1,"children":[]},{"title":"How It Works","slug":"how-it-works","depth":2,"children":[]},{"title":"Request Examples","slug":"request-examples","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[]},{"title":"Business Rules","slug":"business-rules","depth":2,"children":[]},{"title":"Error Scenarios","slug":"error-scenarios","depth":2,"children":[{"title":"Scenario 1: enable_markup = true, No Submerchant or Global Markup, No Inline Markup","slug":"scenario-1-enable_markup-=-true-no-submerchant-or-global-markup-no-inline-markup","depth":3,"children":[]},{"title":"Scenario 2: Error Verifying Global Markup","slug":"scenario-2-error-verifying-global-markup","depth":3,"children":[]}]},{"title":"Related Resources","slug":"related-resources","depth":2,"children":[]}],"codeExamples":{"response":{"type":"ResponseExample","children":[{"filename":"201 Created - PIX Payment with Global Markup","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"23\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">12345\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"merchant\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">477\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Merchant Name\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"payment_method\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"PIX\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"amount\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"R$ 100,50\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"currency\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"BRL\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"invoice\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"e3317882-f821-455b-b082-dc3ba36e8a57\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">1\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Awaiting\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"beneficiary\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"John Doe\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"document\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"type\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"CPF\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"number\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"12345678901\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"markup\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">null\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"","html":"\u003cp>\u003cstrong>Markup returns null\u003c/strong>: It is normal for the \u003ccode>markup\u003c/code> field to return \u003ccode>null\u003c/code> when using global markup.\u003c/p>"},{"filename":"422 Unprocessable Entity - Markup Required","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"8\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"The given data was invalid\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"errors\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"markup\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Inline markup is required when no global markup is configured\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> ]\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"500 Internal Server Error","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"3\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"error\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Internal server error\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"Create Payout with Global Markup","path":"/v2/payout/payments","servers":[{"url":"https://api.sandbox.wepayout.com.br"}],"method":"post","request":{"security":[{"title":"Bearer Auth","parameters":{"header":{"Authorization":{"type":"http","scheme":"bearer","description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token."}},"query":{},"cookie":{}}}],"parameters":{"query":{},"header":{},"cookie":{},"path":{}},"body":{}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"id":[{"type":"integer","description":"WEpayment’s auto generated id, use this id to perform conciliation or perform queries via API / Dashboard."}],"merchant":[{"type":"object","properties":{"id":[{"type":"integer","description":"Id of the WE account that created the payout."}],"name":[{"type":"string","description":"Name of the WE account that created the payout."}]},"description":"Merchant object."}],"payment_method":[{"type":"string","description":"Payment method used for the payout. Values: `PIX`"}],"amount":[{"type":"string","description":"The payout amount formatted with currency symbol."}],"currency":[{"type":"string","description":"Currency code (ISO 4217)."}],"invoice":[{"type":"string","description":"Invoice identifier."}],"status":[{"type":"object","properties":{"id":[{"type":"integer","description":"Status ID."}],"name":[{"type":"string","description":"Status name (e.g., “Awaiting”)."}]},"description":"Payout status."}],"beneficiary":[{"type":"object","properties":{"name":[{"type":"string","description":"Beneficiary name."}],"document":[{"type":"object","properties":{},"description":"Document information."}]},"description":"Beneficiary information."}],"markup":[{"type":"object","properties":{"mode":[{"type":"string","description":"Markup mode applied. Values: `fixed` , `percent`"}],"amount":[{"type":"number","description":"Markup value configured for this payment."}],"min_charge_value":[{"type":"object","properties":{},"description":"Minimum markup value when `mode` is `percent` . Will be `null` when `mode` is `fixed` ."}],"max_charge_value":[{"type":"object","properties":{},"description":"Maximum markup value when `mode` is `percent` . Will be `null` when `mode` is `fixed` or when not specified."}],"origin":[{"type":"object","properties":{},"description":"Level of the markup that was applied. Values: `sub_merchant` , `global`"}]},"description":"Markup configuration applied to this payment (submerchant or global)."}]}}],"examples":{"example":{"value":{"id":123,"merchant":{"id":123,"name":"\u003cstring>"},"payment_method":"\u003cstring>","amount":"\u003cstring>","currency":"\u003cstring>","invoice":"\u003cstring>","status":{"id":123,"name":"\u003cstring>"},"beneficiary":{"name":"\u003cstring>","document":{}},"markup":{"mode":"\u003cstring>","amount":123,"min_charge_value":{},"max_charge_value":{},"origin":{}}}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"wepayments","siteName":"WEpayments API","title":"Create Payout with Global Markup - WEpayments API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-29T13:28:05.341Z","originalFileLocation":"api-reference/markup/payout/create-payout-with-global-markup.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=\"Create a payout payment using global markup configuration.\">\u003cmeta data-mint-head name=\"application-name\" content=\"WEpayments API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/wepayments/qGQxngX3buQQZYlT/_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/wepayments/qGQxngX3buQQZYlT/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/wepayments/qGQxngX3buQQZYlT/_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/wepayments/qGQxngX3buQQZYlT/_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/wepayments/qGQxngX3buQQZYlT/_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/wepayments/qGQxngX3buQQZYlT/_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/wepayments/qGQxngX3buQQZYlT/_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/wepayments/qGQxngX3buQQZYlT/_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/wepayments/qGQxngX3buQQZYlT/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create Payout with Global Markup - WEpayments API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a payout payment using global markup configuration.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"WEpayments API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.wepayout.co/api-reference/markup/payout/create-payout-with-global-markup\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://wepayments.mintlify.site/_mintlify/api/og/v2?division=Payout\u0026amp;title=Create+Payout+with+Global+Markup\u0026amp;description=Create+a+payout+payment+using+global+markup+configuration.\u0026amp;theme=cacbf319b9db3ade4bd16632\u0026amp;signature=815071c59c6e19981b7f89271061ef17cf743edca9e177408abbeaf4a3fbc3fe\">\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=\"Create Payout with Global Markup - WEpayments API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a payout payment using global markup configuration.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://wepayments.mintlify.site/_mintlify/api/og/v2?division=Payout\u0026amp;title=Create+Payout+with+Global+Markup\u0026amp;description=Create+a+payout+payment+using+global+markup+configuration.\u0026amp;theme=cacbf319b9db3ade4bd16632\u0026amp;signature=815071c59c6e19981b7f89271061ef17cf743edca9e177408abbeaf4a3fbc3fe\">\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/wepayments/qGQxngX3buQQZYlT/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"WEpayments API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0070F3\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.wepayout.co/api-reference/markup/payout/create-payout-with-global-markup\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/markup/payout/create-payout-with-global-markup.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.wepayout.co/#organization\",\"name\":\"WEpayments API\",\"url\":\"https://docs.wepayout.co\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/wepayments/GK7WnsFFvtF-KM57/logo/light.png?fit=max\u0026auto=format\u0026n=GK7WnsFFvtF-KM57\u0026q=85\u0026s=7fc96daf3fce22b28043ddd60dc04dab\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.wepayout.co#website\",\"name\":\"WEpayments API\",\"url\":\"https://docs.wepayout.co\",\"publisher\":{\"@id\":\"https://docs.wepayout.co/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.wepayout.co/api-reference/markup/payout/create-payout-with-global-markup#webpage\",\"url\":\"https://docs.wepayout.co/api-reference/markup/payout/create-payout-with-global-markup\",\"name\":\"Create Payout with Global Markup\",\"description\":\"Create a payout payment using global markup configuration.\",\"dateModified\":\"2026-09-29T13:28:05.341Z\",\"isPartOf\":{\"@id\":\"https://docs.wepayout.co#website\"},\"breadcrumb\":{\"@id\":\"https://docs.wepayout.co/api-reference/markup/payout/create-payout-with-global-markup#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.wepayout.co/api-reference/markup/payout/create-payout-with-global-markup#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Markup\",\"item\":\"https://docs.wepayout.co/api-reference/markup/account/create-merchant-markup\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Payout\",\"item\":\"https://docs.wepayout.co/api-reference/markup/payout/create-payout-with-inline-markup\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create Payout with Global Markup\",\"item\":\"https://docs.wepayout.co/api-reference/markup/payout/create-payout-with-global-markup\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.wepayout.co/api-reference/markup/payout/create-payout-with-global-markup#apireference\",\"headline\":\"Create Payout with Global Markup\",\"name\":\"Create Payout with Global Markup\",\"description\":\"Create a payout payment using global markup configuration.\",\"url\":\"https://docs.wepayout.co/api-reference/markup/payout/create-payout-with-global-markup\",\"mainEntityOfPage\":{\"@id\":\"https://docs.wepayout.co/api-reference/markup/payout/create-payout-with-global-markup#webpage\"},\"dateModified\":\"2026-09-29T13:28:05.341Z\",\"publisher\":{\"@id\":\"https://docs.wepayout.co/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.wepayout.co#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"WEpayments API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"WEpayments API","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/model-context-protocol"}]},{"tab":"API Reference","groups":[{"group":"Account","pages":[{"group":"Onboarding","pages":[{"title":"Account Opening Request","api":"POST https://api.sandbox.wepayout.com.br/v2/register/companies","href":"/api-reference/account/create"},{"title":"List Account Opening Requests","api":"GET /v2/register/companies","href":"/api-reference/account/list-accounts"},{"title":"Get Account Opening Request By ID","api":"GET /v2/register/companies/{id}","href":"/api-reference/account/get-account-by-id"},{"group":"Segments","pages":[{"title":"List Segments","api":"GET /v2/register/segments","href":"/api-reference/account/segments/list-segments"}]},{"group":"Webhook","pages":[{"title":"Setup","api":"POST /v2/register/companies/webhooks","href":"/api-reference/account/webhook/webhook-setup"},{"title":"Query","api":"GET /v2/register/companies/webhooks","href":"/api-reference/account/webhook/webhook-query"},{"title":"Update","api":"PUT /v2/register/companies/webhooks","href":"/api-reference/account/webhook/webhook-update"},{"title":"Remove","api":"DELETE /v2/register/companies/webhooks","href":"/api-reference/account/webhook/webhook-remove"}]},{"group":"Documents","pages":[{"title":"Upload Document","api":"POST /v2/register/companies/{uuid}/documents","href":"/api-reference/account/documents/upload-document"},{"title":"List Documents","api":"GET /v2/register/companies/{uuid}/documents","href":"/api-reference/account/documents/list-documents"}]},{"group":"Signature","pages":[{"title":"Get Signature Link","api":"GET /v2/register/companies/{uuid}/signature/link","href":"/api-reference/account/signature/signature-link"}]}]},{"group":"Pix Keys","pages":[{"title":"List Merchant Pix Keys","api":"GET /v2/register/pix-keys","href":"/api-reference/account/pix-keys/list-pix-keys"}]},{"title":"Get Balance","api":"GET /v2/account/{merchantId}/balance","href":"/api-reference/account/get-balance"},{"title":"Get Balance Specific Day","api":"GET /v2/account/{merchantId}/balance/history","href":"/api-reference/account/get-balance-specific-day"},{"title":"Get Statement","api":"GET /v2/account/{merchantId}/statement","href":"/api-reference/account/get-statement"},{"title":"Change Fee Target Account","api":"POST /v2/account/{merchantId}/fee-target","href":"/api-reference/account/change-fee-target"}]},{"group":"Banks","pages":[{"title":"List Institutions","api":"GET /v2/banks","href":"/api-reference/banks/list-institutions"}]},{"group":"Payin","pages":[{"group":"Pix","pages":[{"group":"Charge","pages":[{"title":"Create Charge (Pix)","api":"POST /v2/payin/payments","href":"/api-reference/cash-in/payin/create-charge-pix"},{"title":"List Charge","api":"GET /v2/payin/payments","href":"/api-reference/cash-in/payin/list-charge"},{"title":"Get Unique Charge","api":"GET /v2/payin/payments/{id}","href":"/api-reference/cash-in/payin/get-unique-charge"},{"title":"Cancel Charges","api":"DELETE /v2/payin/payments/request-multiple-cancel","href":"/api-reference/cash-in/payin/request-multiple-cancel"},{"title":"Cancel Charges by Period","api":"DELETE /v2/payin/payments/request-cancel-by-period","href":"/api-reference/cash-in/payin/cancel-by-period"}]},{"group":"Refund","pages":[{"title":"Create Refund","api":"POST /v2/payin/payments/payin-refund/{id}","href":"/api-reference/cash-in/refund/create-refund"},{"title":"Get Unique Refund","api":"GET /v1/payin/payments/payin-refund/{refundId}","href":"/api-reference/cash-in/refund/get-unique-refund"}]},{"group":"Webhooks","pages":[{"title":"Resend Payin Webhooks (Bulk)","api":"POST /v2/payin/notifications/resend","href":"/api-reference/cash-in/webhooks/resend-bulk"},{"title":"Resend Job Status","api":"GET /v2/payin/notifications/resend/{jobId}","href":"/api-reference/cash-in/webhooks/resend-bulk-status"}]},{"group":"Automatic Pix","pages":[{"group":"Authorizations","pages":[{"title":"Create Authorization","api":"POST /v2/payin/payments","href":"/api-reference/automatic-pix/authorizations/create"},{"title":"List Authorizations","api":"GET /v2/automatic-pix/authorizations","href":"/api-reference/automatic-pix/authorizations/list"},{"title":"Get Authorization","api":"GET /v2/automatic-pix/authorizations/{id}","href":"/api-reference/automatic-pix/authorizations/get"},{"title":"Update Authorization","api":"PATCH /v2/automatic-pix/authorizations/{id}","href":"/api-reference/automatic-pix/authorizations/update"},{"title":"Cancel Authorization","api":"DELETE /v2/automatic-pix/authorizations/{id}","href":"/api-reference/automatic-pix/authorizations/cancel"}]},{"group":"Schedules","pages":[{"title":"List Schedules","api":"GET /v2/automatic-pix/schedules","href":"/api-reference/automatic-pix/schedules/list"},{"title":"Get Schedule","api":"GET /v2/automatic-pix/schedules/{id}","href":"/api-reference/automatic-pix/schedules/get"},{"title":"Update Schedule","api":"PATCH /v2/automatic-pix/schedules/{id}","href":"/api-reference/automatic-pix/schedules/update"},{"title":"Cancel Schedule","api":"DELETE /v2/automatic-pix/schedules/{id}","href":"/api-reference/automatic-pix/schedules/cancel"}]},{"group":"Webhooks","pages":[{"title":"List Authorization History Webhooks","api":"GET /v2/automatic-pix/webhooks/authorization-history/{id}","href":"/api-reference/automatic-pix/webhooks/list-authorization-history"},{"title":"Resend Authorization Webhook","api":"POST /v2/automatic-pix/webhooks/authorization-history/{id}/resend","href":"/api-reference/automatic-pix/webhooks/resend-authorization-history"},{"title":"List Schedule Webhooks","api":"GET /v2/automatic-pix/webhooks/schedule/{id}","href":"/api-reference/automatic-pix/webhooks/list-schedule"},{"title":"Resend Schedule Webhook","api":"POST /v2/automatic-pix/webhooks/schedule/resend/{historyId}","href":"/api-reference/automatic-pix/webhooks/resend-schedule"}]}]}]},{"group":"Bank Slip","pages":[{"title":"Create Charge (Bank Slip)","api":"POST /v2/payin/payments","href":"/api-reference/cash-in/payin/create-charge-bank-slip"}]},{"group":"CreditCard","pages":[{"title":"Create Charge","api":"POST /v1/payin/payments/credit-card","href":"/api-reference/credit-card/create-charge"}]}]},{"group":"Payout","pages":[{"group":"Payout","pages":[{"title":"Create Payment","api":"POST /v2/payout/payments","href":"/api-reference/cash-out/payout/create-payment"},{"title":"List Payment","api":"GET /v2/payout/payments","href":"/api-reference/cash-out/payout/list-payment"},{"title":"Get Unique Payment","api":"GET /v2/payout/payments/{id}","href":"/api-reference/cash-out/payout/get-unique-payment"},{"title":"Create Transfer","api":"POST /v2/payout/transfers","href":"/api-reference/cash-out/payout/create-transfer"},{"title":"Decode QR Code","api":"POST /v2/payout/qrcode-decode","href":"/api-reference/cash-out/payout/decode-qr-code"}]},{"group":"Webhooks","pages":[{"title":"Resend Payout Webhooks (Bulk)","api":"POST /v2/payout/notifications/resend","href":"/api-reference/cash-out/webhooks/resend-bulk"},{"title":"Resend Job Status","api":"GET /v2/payout/notifications/resend/{jobId}","href":"/api-reference/cash-out/webhooks/resend-bulk-status"}]},{"group":"Data Qualification","pages":[{"title":"Get Data Qualification Services","api":"GET /v1/payout/data-qualification/services","href":"/api-reference/data-qualification/get-services"},{"title":"Create Data Qualification","api":"POST /v1/payout/data-qualification","href":"/api-reference/data-qualification/create-data-qualification"},{"title":"List Data Qualifications","api":"GET /v1/payout/data-qualification","href":"/api-reference/data-qualification/list-data-qualification"},{"title":"Get Data Qualification By ID","api":"GET /v1/payout/data-qualification/{id}","href":"/api-reference/data-qualification/get-by-id"},{"title":"Get Data Qualification Statuses","api":"GET /v1/payout/data-qualification/status","href":"/api-reference/data-qualification/get-status"},{"title":"Get Data Qualification By Custom Code","api":"GET /v1/payout/data-qualification/custom-code/{customCode}","href":"/api-reference/data-qualification/get-by-custom-code"}]}]},{"group":"KYC","pages":[{"title":"KYC Webhook","icon":"webhook","href":"/api-reference/kyc/webhook"},{"title":"List KYC","api":"GET /v1/kyc","href":"/api-reference/kyc/list-kyc"},{"title":"Get KYC By ID","api":"GET /v1/kyc/{id}","href":"/api-reference/kyc/get"},{"title":"Get KYC By Document","api":"POST /v1/kyc/document/{cpf_or_cnpj}","href":"/api-reference/kyc/get-by-document"},{"title":"Submit Document For KYC","api":"POST /v1/kyc/documents/{documentId}/update","href":"/api-reference/kyc/submit-document"}]},{"group":"Markup","pages":[{"group":"Account","pages":[{"title":"Create Merchant Markup Configuration","api":"POST https://api.sandbox.wepayout.com.br/v2/account/markup","href":"/api-reference/markup/account/create-merchant-markup"},{"title":"Update Merchant Markup Configuration","api":"PATCH https://api.sandbox.wepayout.com.br/v2/account/markup/{markupId}","href":"/api-reference/markup/account/update-merchant-markup"},{"title":"List Merchant Markups Configuration","api":"GET https://api.sandbox.wepayout.com.br/v2/account/markups","href":"/api-reference/markup/account/list-merchant-markups"}]},{"group":"Submerchant","pages":[{"title":"List Submerchant Markups","api":"GET https://api.sandbox.wepayout.com.br/v2/account/{merchantId}/submerchants/markups","href":"/api-reference/markup/submerchant/list-submerchant-markups"},{"title":"Get Submerchant Markup","api":"GET https://api.sandbox.wepayout.com.br/v2/account/{merchantId}/submerchants/{subMerchantId}/markups","href":"/api-reference/markup/submerchant/get-submerchant-markup"},{"title":"Configure Submerchant Markup","api":"PUT https://api.sandbox.wepayout.com.br/v2/account/{merchantId}/submerchants/{subMerchantId}/markups","href":"/api-reference/markup/submerchant/upsert-submerchant-markup"},{"title":"Remove Submerchant Markup","api":"DELETE https://api.sandbox.wepayout.com.br/v2/account/{merchantId}/submerchants/{subMerchantId}/markups","href":"/api-reference/markup/submerchant/delete-submerchant-markup"},{"title":"Batch Apply Submerchant Markup","api":"POST https://api.sandbox.wepayout.com.br/v2/account/{merchantId}/submerchants/markups/batch","href":"/api-reference/markup/submerchant/batch-apply-submerchant-markup"}]},{"group":"Payin","pages":[{"title":"Create Payin with Inline Markup","api":"POST https://api.sandbox.wepayout.com.br/v2/payin/payments","href":"/api-reference/markup/payin/create-payin-with-inline-markup"},{"title":"Create Payin with Global Markup","api":"POST https://api.sandbox.wepayout.com.br/v2/payin/payments","href":"/api-reference/markup/payin/create-payin-with-global-markup"}]},{"group":"Payout","pages":[{"title":"Create Payout with Inline Markup","api":"POST https://api.sandbox.wepayout.com.br/v2/payout/payments","description":"Create a payout payment with inline markup configuration.","href":"/api-reference/markup/payout/create-payout-with-inline-markup"},{"title":"Create Payout with Global Markup","api":"POST https://api.sandbox.wepayout.com.br/v2/payout/payments","href":"/api-reference/markup/payout/create-payout-with-global-markup"}]}]}]}]},"basePath":"","title":"Create Payout with Global Markup - WEpayments API","buildId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","deploymentId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-CBsVopKK.js","utils-DZAk68jJ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D32AYZrP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D_A5_cny.js","snippetPresets-xNRfS9th.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BIB25-tq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CydJ4w4j.js","shallow-CYPBeQSG.js","getApiPlaygroundDisplay-A5xJVBOu.js","CodeSnippet-BVRTgi3m.js","CodeSnippets-DjD6BSlt.js","Page-Dr40SSJq.js","getPastedJson-D4V4JyrR.js","icon-uhcnG22T.js","MethodPill-CM-ZQdGH.js","DuplicateIcon-B_WnOiNf.js","createIcon-CJsb8utt.js","DynamicMarkdown-D-2HDKEp.js","SectionHeading-KP5xmMgQ.js","axios-vUo_bRtp.js"]}