The fields in a payment’s answer, and how to handle each result.
Every sale, authorization, refund and void answers with the card processor’s result. These are the fields to act on
(names as in JSON; XML uses the same names with a capital first letter).
The processor’s words for it, such as Approval or Insufficient funds. Fine to show staff; for customers, use your own wording.
respProc
Which processor answered. Codes mean different things on different processors, so read respCode with it. PPS means the gateway itself answered, before the processor.
authCode
The issuer’s approval code, for the receipt.
retRef
The processor’s reference: keep it. It ties the payment to its capture, void, refund and deposit.
Only with respStatE: why the gateway couldn’t complete the request.
The card brands’ advice on a decline
On a decline, some processors (Rapid Connect and North) also pass on what the card brand advises. Each field is left out
when there’s nothing to say.
Field
What it is
declineCategory, declineCategoryText
Visa’s advice on retrying: 1 the issuer will never approve this card (don’t retry), 2 it can’t approve now (retry later), 3 something in the details was wrong (fix it, then retry).
merchAdviceCode, merchAdviceText
Mastercard’s advice, mostly for recurring payments. For example: 01 new account information available, 02 retry after 3 days, 03 account closed, 21 stop recurring payments for this merchant, 24–30 retry after 1 hour to 10 days.
assocRespCode, assocRespText
The card brand’s own response code and words, behind the processor’s respCode.
The result: respStat
respStat
Means
What to do
A
Approved
Complete the sale; print authCode on the receipt.
B
Try again
A temporary problem (a network or issuer timeout). Retry once after a few seconds. If you aren’t sure the first attempt failed, look the order up with Inquire first.
C
Declined
The issuer or the processor said no. respCode and respText say why: see Decline and response codes. Usually, ask for another payment method.
E
Not completed
The POS Gateway stopped before or after the processor, for example a key or setup problem, or a partial approval it voided. respMessage says why: see Errors.
Never retry an unclear result blindly. If the answer was lost or the result isn’t A or C, look the payment up with
Inquire by its order id: the payment may have gone through, and sending it again would charge the customer twice.
After the sale: setlStat
Capture and Inquire also say where the payment is on its way to the merchant’s bank, in setlStat.
setlStat
Means
Authorized
Approved, not yet captured.
Queued for Capture
Captured; it goes in the next settlement batch.
Accepted
Settled and accepted for funding.
Voided
Voided: nothing will be charged.
Declined
The authorization was declined.
Zero Amount
A $0 card check: nothing to capture.
Amount under review
Settled, held for review because of its amount; usually decided the next day.
Rejected, Format error, Token Decrypt
Not funded. Contact Mojo Payments with the order id.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Mojo Payments Knowledge Base","description":"How to use Mojo Payments: the portal for merchants and reseller partners, the POS Gateway for point-of-sale integrators, and the Mojo Payments API for developers.","colors":{"primary":"#141433","light":"#22D37A","dark":"#141433"},"logo":{"light":"https://mintcdn.com/mojo-payments/MckcyI-A5Z9ir26p/logo/light.svg?fit=max\u0026auto=format\u0026n=MckcyI-A5Z9ir26p\u0026q=85\u0026s=dacd7e76c31d01886cda0e6a371b62f4","dark":"https://mintcdn.com/mojo-payments/MckcyI-A5Z9ir26p/logo/dark.svg?fit=max\u0026auto=format\u0026n=MckcyI-A5Z9ir26p\u0026q=85\u0026s=b8f3993a050f21351f8efdf998d8ac5f","href":"https://paymentsmojo.com"},"favicon":"https://mintcdn.com/mojo-payments/MckcyI-A5Z9ir26p/favicon.svg?fit=max\u0026auto=format\u0026n=MckcyI-A5Z9ir26p\u0026q=85\u0026s=a8939d42fea4ec6dc902a5e377e30286","navbar":{"links":[{"href":"mailto:hello@paymentsmojo.com","label":"Contact us"}],"primary":{"type":"button","label":"Sign in","href":"https://portal.paymentsmojo.com"}},"footer":{"socials":{"website":"https://paymentsmojo.com"}},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"mojo-payments","hasAudioNarration":false,"actualSubdomain":"mojo-payments","customDomains":["kb.paymentsmojo.com"],"gitSource":{"type":"github","owner":"mojo-payments","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6aceea0317a934a8f2101fb0","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"Developers","count":59},{"language":"default","tag":"API reference","count":43},{"language":"default","tag":"POS integrators","count":19},{"language":"default","tag":"Merchants","count":12},{"language":"default","tag":"POS Gateway API","count":11},{"language":"default","tag":"Webhooks","count":11},{"language":"default","tag":"Guides","count":8},{"language":"default","tag":"Your business","count":8},{"language":"default","tag":"Recurring plans","count":7},{"language":"default","tag":"Invoices","count":6}]},"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":false},"customCss":[],"page":{"pagePath":"api/responses","slug":"/api/responses","pageMetadata":{"title":"Reading a payment response","description":"The fields in a payment's answer, and how to handle each result.","href":"/api/responses"},"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: \"The fields in a payment’s answer, and how to handle each result.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Heading,Table,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Every sale, authorization, refund and void answers with the card processor’s result. These are the fields to act on\n(names as in `,_jsx(_components.a,{href:`/api/formats`,children:`JSON`}),`; XML uses the same names with a capital first letter).`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`What it is`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`respStat`})}),_jsx(_components.td,{children:`The result: see below. Always check it first.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`respCode`})}),_jsxs(_components.td,{children:[`The processor’s code for the result: see `,_jsx(_components.a,{href:`/api/decline-codes`,children:`Decline and response codes`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`respText`})}),_jsxs(_components.td,{children:[`The processor’s words for it, such as `,_jsx(_components.code,{children:`Approval`}),` or `,_jsx(_components.code,{children:`Insufficient funds`}),`. Fine to show staff; for customers, use your own wording.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`respProc`})}),_jsxs(_components.td,{children:[`Which processor answered. Codes mean different things on different processors, so read `,_jsx(_components.code,{children:`respCode`}),` with it. `,_jsx(_components.code,{children:`PPS`}),` means the gateway itself answered, before the processor.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`authCode`})}),_jsx(_components.td,{children:`The issuer’s approval code, for the receipt.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`retRef`})}),_jsx(_components.td,{children:`The processor’s reference: keep it. It ties the payment to its capture, void, refund and deposit.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`amount`})}),_jsx(_components.td,{children:`The amount authorized.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`avsResp`})}),_jsxs(_components.td,{children:[`The address (ZIP) check: see `,_jsx(_components.a,{href:`/api/avs-cvv`,children:`Address and CVV checks`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`cvvResp`})}),_jsxs(_components.td,{children:[`The security code check: see `,_jsx(_components.a,{href:`/api/avs-cvv`,children:`Address and CVV checks`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`respMessage`})}),_jsxs(_components.td,{children:[`Only with `,_jsx(_components.code,{children:`respStat`}),` `,_jsx(_components.code,{children:`E`}),`: why the gateway couldn’t complete the request.`]})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`the-card-brands’-advice-on-a-decline`,children:`The card brands’ advice on a decline`}),`\n`,_jsx(_components.p,{children:`On a decline, some processors (Rapid Connect and North) also pass on what the card brand advises. Each field is left out\nwhen there’s nothing to say.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`What it is`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`declineCategory`}),`, `,_jsx(_components.code,{children:`declineCategoryText`})]}),_jsxs(_components.td,{children:[`Visa’s advice on retrying: `,_jsx(_components.code,{children:`1`}),` the issuer will never approve this card (don’t retry), `,_jsx(_components.code,{children:`2`}),` it can’t approve now (retry later), `,_jsx(_components.code,{children:`3`}),` something in the details was wrong (fix it, then retry).`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`merchAdviceCode`}),`, `,_jsx(_components.code,{children:`merchAdviceText`})]}),_jsxs(_components.td,{children:[`Mastercard’s advice, mostly for recurring payments. For example: `,_jsx(_components.code,{children:`01`}),` new account information available, `,_jsx(_components.code,{children:`02`}),` retry after 3 days, `,_jsx(_components.code,{children:`03`}),` account closed, `,_jsx(_components.code,{children:`21`}),` stop recurring payments for this merchant, `,_jsx(_components.code,{children:`24`}),`–`,_jsx(_components.code,{children:`30`}),` retry after 1 hour to 10 days.`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`assocRespCode`}),`, `,_jsx(_components.code,{children:`assocRespText`})]}),_jsxs(_components.td,{children:[`The card brand’s own response code and words, behind the processor’s `,_jsx(_components.code,{children:`respCode`}),`.`]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`the-result-respstat`,children:`The result: respStat`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:_jsx(_components.code,{children:`respStat`})}),_jsx(_components.th,{children:`Means`}),_jsx(_components.th,{children:`What to do`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`A`})}),_jsx(_components.td,{children:`Approved`}),_jsxs(_components.td,{children:[`Complete the sale; print `,_jsx(_components.code,{children:`authCode`}),` on the receipt.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`B`})}),_jsx(_components.td,{children:`Try again`}),_jsxs(_components.td,{children:[`A temporary problem (a network or issuer timeout). Retry once after a few seconds. If you aren’t sure the first attempt failed, look the order up with `,_jsx(_components.code,{children:`Inquire`}),` first.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`C`})}),_jsx(_components.td,{children:`Declined`}),_jsxs(_components.td,{children:[`The issuer or the processor said no. `,_jsx(_components.code,{children:`respCode`}),` and `,_jsx(_components.code,{children:`respText`}),` say why: see `,_jsx(_components.a,{href:`/api/decline-codes`,children:`Decline and response codes`}),`. Usually, ask for another payment method.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`E`})}),_jsx(_components.td,{children:`Not completed`}),_jsxs(_components.td,{children:[`The POS Gateway stopped before or after the processor, for example a key or setup problem, or a partial approval it voided. `,_jsx(_components.code,{children:`respMessage`}),` says why: see `,_jsx(_components.a,{href:`/api/errors`,children:`Errors`}),`.`]})]})]})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Never retry an unclear result blindly. If the answer was lost or the result isn’t `,_jsx(_components.code,{children:`A`}),` or `,_jsx(_components.code,{children:`C`}),`, look the payment up with\n`,_jsx(_components.code,{children:`Inquire`}),` by its order id: the payment may have gone through, and sending it again would charge the customer twice.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`after-the-sale-setlstat`,children:`After the sale: setlStat`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`Capture`}),` and `,_jsx(_components.code,{children:`Inquire`}),` also say where the payment is on its way to the merchant’s bank, in `,_jsx(_components.code,{children:`setlStat`}),`.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:_jsx(_components.code,{children:`setlStat`})}),_jsx(_components.th,{children:`Means`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Authorized`})}),_jsx(_components.td,{children:`Approved, not yet captured.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Queued for Capture`})}),_jsx(_components.td,{children:`Captured; it goes in the next settlement batch.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Accepted`})}),_jsx(_components.td,{children:`Settled and accepted for funding.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Voided`})}),_jsx(_components.td,{children:`Voided: nothing will be charged.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Declined`})}),_jsx(_components.td,{children:`The authorization was declined.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Zero Amount`})}),_jsx(_components.td,{children:`A $0 card check: nothing to capture.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Amount under review`})}),_jsx(_components.td,{children:`Settled, held for review because of its amount; usually decided the next day.`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`Rejected`}),`, `,_jsx(_components.code,{children:`Format error`}),`, `,_jsx(_components.code,{children:`Token Decrypt`})]}),_jsx(_components.td,{children:`Not funded. Contact Mojo Payments with the order id.`})]})]})]})]})}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":"Reading a payment response","description":"The fields in a payment's answer, and how to handle each result.","href":"/api/responses"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"The card brands’ advice on a decline","slug":"the-card-brands’-advice-on-a-decline","depth":3,"children":[]},{"title":"The result: respStat","slug":"the-result-respstat","depth":2,"children":[]},{"title":"After the sale: setlStat","slug":"after-the-sale-setlstat","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"mojo-payments","siteName":"Mojo Payments Knowledge Base","title":"Reading a payment response - Mojo Payments Knowledge Base","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-10T20:46:01.056Z","originalFileLocation":"api/responses.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=\"The fields in a payment\u0026#x27;s answer, and how to handle each result.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Mojo Payments Knowledge Base\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/mojo-payments/zehbxsTWHxF9hFEd/_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/mojo-payments/zehbxsTWHxF9hFEd/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/mojo-payments/zehbxsTWHxF9hFEd/_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/mojo-payments/zehbxsTWHxF9hFEd/_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/mojo-payments/zehbxsTWHxF9hFEd/_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/mojo-payments/zehbxsTWHxF9hFEd/_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/mojo-payments/zehbxsTWHxF9hFEd/_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/mojo-payments/zehbxsTWHxF9hFEd/_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/mojo-payments/zehbxsTWHxF9hFEd/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Reading a payment response - Mojo Payments Knowledge Base\">\u003cmeta data-mint-head property=\"og:description\" content=\"The fields in a payment\u0026#x27;s answer, and how to handle each result.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Mojo Payments Knowledge Base\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://kb.paymentsmojo.com/api/responses\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://mojo-payments.mintlify.site/_mintlify/api/og/v2?division=POS+Gateway+API\u0026amp;title=Reading+a+payment+response\u0026amp;description=The+fields+in+a+payment%27s+answer%2C+and+how+to+handle+each+result.\u0026amp;theme=bb9d2683b7c7ab8ad5384de5\u0026amp;signature=b579be51729ea7353d53b8bad179a2f87c428c723a4278a51719b0318202b60d\">\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=\"Reading a payment response - Mojo Payments Knowledge Base\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"The fields in a payment\u0026#x27;s answer, and how to handle each result.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://mojo-payments.mintlify.site/_mintlify/api/og/v2?division=POS+Gateway+API\u0026amp;title=Reading+a+payment+response\u0026amp;description=The+fields+in+a+payment%27s+answer%2C+and+how+to+handle+each+result.\u0026amp;theme=bb9d2683b7c7ab8ad5384de5\u0026amp;signature=b579be51729ea7353d53b8bad179a2f87c428c723a4278a51719b0318202b60d\">\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/mojo-payments/zehbxsTWHxF9hFEd/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Mojo Payments Knowledge Base\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#141433\">\u003clink data-mint-head rel=\"canonical\" href=\"https://kb.paymentsmojo.com/api/responses\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api/responses.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://kb.paymentsmojo.com/#organization\",\"name\":\"Mojo Payments Knowledge Base\",\"url\":\"https://kb.paymentsmojo.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/mojo-payments/MckcyI-A5Z9ir26p/logo/light.svg?fit=max\u0026auto=format\u0026n=MckcyI-A5Z9ir26p\u0026q=85\u0026s=dacd7e76c31d01886cda0e6a371b62f4\"}},{\"@type\":\"WebSite\",\"@id\":\"https://kb.paymentsmojo.com#website\",\"name\":\"Mojo Payments Knowledge Base\",\"url\":\"https://kb.paymentsmojo.com\",\"publisher\":{\"@id\":\"https://kb.paymentsmojo.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://kb.paymentsmojo.com/api/responses#webpage\",\"url\":\"https://kb.paymentsmojo.com/api/responses\",\"name\":\"Reading a payment response\",\"description\":\"The fields in a payment's answer, and how to handle each result.\",\"dateModified\":\"2026-10-10T20:46:01.056Z\",\"isPartOf\":{\"@id\":\"https://kb.paymentsmojo.com#website\"},\"breadcrumb\":{\"@id\":\"https://kb.paymentsmojo.com/api/responses#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://kb.paymentsmojo.com/api/responses#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"POS Gateway API\",\"item\":\"https://kb.paymentsmojo.com/api/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Reading a payment response\",\"item\":\"https://kb.paymentsmojo.com/api/responses\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://kb.paymentsmojo.com/api/responses#article\",\"headline\":\"Reading a payment response\",\"name\":\"Reading a payment response\",\"description\":\"The fields in a payment's answer, and how to handle each result.\",\"url\":\"https://kb.paymentsmojo.com/api/responses\",\"mainEntityOfPage\":{\"@id\":\"https://kb.paymentsmojo.com/api/responses#webpage\"},\"dateModified\":\"2026-10-10T20:46:01.056Z\",\"publisher\":{\"@id\":\"https://kb.paymentsmojo.com/#organization\"},\"isPartOf\":{\"@id\":\"https://kb.paymentsmojo.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Mojo Payments Knowledge Base\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Mojo Payments Knowledge Base\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api/responses.md","siteName":"Mojo Payments Knowledge Base","nav":{"global":null,"tabs":[{"tab":"Merchants","pages":[{"title":"Merchants","href":""}]},{"tab":"Resellers","pages":[{"title":"Resellers","href":"/resellers/getting-started"}]},{"tab":"Service partners","pages":[{"title":"Service partners","href":"/service-partners/getting-started"}]},{"tab":"POS integrators","groups":[{"group":"Get started","pages":[{"title":"Connecting a point of sale","sidebarTitle":"Overview","href":"/integrators/overview"}]},{"group":"POS Gateway API","pages":[{"title":"POS Gateway API","sidebarTitle":"API overview","href":"/api/overview"},{"title":"Keys","href":"/api/keys"},{"title":"Actions","href":"/api/actions"},{"title":"Earlier action names","href":"/api/earlier-names"},{"title":"Level 3 data","href":"/api/level-3"},{"title":"Formats","href":"/api/formats"},{"title":"Terminal settings","description":"How each location's terminals behave, set in the portal rather than in requests.","href":"/api/terminal-settings"},{"title":"Reading a payment response","href":"/api/responses"},{"title":"Decline and response codes","description":"What each answer from the card processor means, and what to do, whichever processor the MID is on.","href":"/api/decline-codes"},{"title":"Address and CVV checks","href":"/api/avs-cvv"},{"title":"Errors","href":"/api/errors"}]},{"group":"Mojo Payments CLI","pages":[{"title":"Mojo Payments CLI","sidebarTitle":"Overview","href":"/cli/overview"},{"title":"Installing the CLI","sidebarTitle":"Install","href":"/cli/install"},{"title":"Settings","href":"/cli/settings"},{"title":"Commands and results","href":"/cli/commands"},{"title":"Troubleshooting","href":"/cli/troubleshooting"}]},{"group":"POS guides","pages":[{"title":"POS guides","href":"/pos/overview"},{"title":"Passport","href":"/pos/passport"}]}]},{"tab":"Developers","pages":[{"title":"Developers","href":"/developers/overview"}]}]},"basePath":"","title":"Reading a payment response - Mojo Payments Knowledge Base","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":[],"chunks":[]}