{"items":[{"type":"link","label":"Gateway API","link":"/apis/openapi","routeSlug":"/apis/openapi","content":{"contentType":"overview","meta":{"name":"Gateway API"},"children":[{"nodeType":"container","panels":[{"title":"Download OpenAPI description","titleTranslationKey":"download.description.title","children":[{"kind":"download","label":"openapi.json","url":"/_bundle/apis/openapi.json?download"},{"kind":"download","label":"openapi.yaml","url":"/_bundle/apis/openapi.yaml?download"}]},{"title":"Overview","titleTranslationKey":"info.title","children":[{"kind":"email","title":"E-mail","titleTranslationKey":"info.contact.name","email":"info@gateway.net","label":"info@gateway.net","withCopyButton":true,"copyContent":"info@gateway.net"},{"kind":"attribute","title":"License","titleTranslationKey":"info.license","label":"Gateway API","value":"Gateway API"}]},{"title":"Languages","titleTranslationKey":"languages.title","children":[{"kind":"languages","options":[{"key":"payload","title":"Payload","lang":"Payload"},{"key":"curl","title":"cURL","lang":"curl"},{"key":"js","title":"JS","lang":"JavaScript"},{"key":"csharp","title":"C#","lang":"C#"},{"key":"python","title":"Python","lang":"Python"},{"key":"go","title":"Go","lang":"Go"},{"key":"ruby","title":"Ruby","lang":"Ruby"},{"key":"java","title":"Java","lang":"Java"},{"key":"node","title":"Node.js","lang":"Node.js"},{"key":"php","title":"PHP","lang":"PHP"},{"key":"r","title":"R","lang":"R"}]}]},{"title":"Servers","titleTranslationKey":"servers.title","children":[{"kind":"servers","servers":[{"url":"/_mock/apis/openapi","description":"Mock server (simulated responses)","isMockServer":true}],"mode":"default"}]}],"children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"header","level":1,"label":"Gateway API (1.0.0-beta.27)","showPageActions":true},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Our public APIs enable clients to integrate with the Gateway API server. Our APIs use RESTful architecture, conform with OpenAPI specifications, and are PCI-DSS compliant."},"children":[]}]}]}]}],"sectionId":"/apis/openapi"}],"sectionId":"/apis/openapi"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"section/request-ids"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request IDs"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Every response — successful or not — includes an "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"x-request-id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header containing a GUID that uniquely identifies the request."},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"x-request-id: 73039bd9-c380-4186-bffe-259125144a56\n","language":"http"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"x-request-id: 73039bd9-c380-4186-bffe-259125144a56\n"},"children":[]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Log this value with your request and supply it when contacting support so that a specific request can be traced."},"children":[]}]}]}]}],"sectionId":"/apis/openapi/section/request-ids"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"section/mock-responses-in-this-reference"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Mock responses in this reference"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Requests sent from this reference go to a mock server, not the live gateway. Responses are generated from the examples in this description, so the values in them are illustrative and must not be used in a real integration. See the production server in the Servers list for live testing."},"children":[]}]}]}]}],"sectionId":"/apis/openapi/section/mock-responses-in-this-reference"}]}]}},{"type":"link","label":"Request IDs","link":"/apis/openapi/section/request-ids","routeSlug":"/apis/openapi/section/request-ids","content":null},{"type":"link","label":"Mock responses in this reference","link":"/apis/openapi/section/mock-responses-in-this-reference","routeSlug":"/apis/openapi/section/mock-responses-in-this-reference","content":null},{"type":"separator","label":"Transactions","content":null},{"type":"group","label":"Send transactions","link":"/apis/openapi/send-transactions","routeSlug":"/apis/openapi/send-transactions","items":[{"label":"Create a Transaction","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/openapi/send-transactions/createtransaction","routeSlug":"/apis/openapi/send-transactions/createtransaction","metadata":{"seo":{"title":"Create a Transaction","description":"Create a payment transaction via a payment card (credit or debit)."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createTransaction","name":"Create a Transaction","isWebhook":false,"pointer":"/paths/~1v1~1transactions/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a Transaction","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create a payment transaction via a payment card (credit or debit)."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"SALE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" transaction authorizes and captures the payment simultaneously."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"AUTH"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" transaction authorizes the payment and requires a subsequent  capture."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"ApiKeyAuth","scopes":[],"type":"apiKey","in":"header","paramName":"Api-Key","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key authentication. Include the API key in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Api-Key"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"WARNING"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": API key-based authentication offers no cryptographic security; always use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.mozilla.org/en-US/docs/Glossary/HTTPS"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"HTTPS"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":":"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"  Api-Key: AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe\n","language":"http"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"  Api-Key: AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe\n"},"children":[]}]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Client-Id","in":"header","schemaId":"schema_26","required":true},{"name":"X-Acting-As-Client-Id","in":"header","schemaId":"schema_26","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The child client this request acts on behalf of. A reseller still authenticates as itself — "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Api-Key"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Client-Id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" stay the reseller's — and names the child here."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This works only from a parent to its own children. Merchants have no children, so a merchant calling as itself omits the header. Sending your own client ULID here is not the same as omitting it, and is rejected on some operations."},"children":[]}]}]}]}],"pointer":"/paths/~1v1~1transactions/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/TransactionCreateRequest","exampleIds":["paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/saleWithCard","paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/saleWithToken","paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/authWithCard","paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/authWithToken","paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/saleWithBankAccount","paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/payout","paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/saleDeclined","paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/saleRecurringSubsequent"]}},"schemaId":"components/schemas/TransactionCreateRequest","exampleIds":["paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/saleWithCard","paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/saleWithToken","paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/authWithCard","paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/authWithToken","paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/saleWithBankAccount","paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/payout","paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/saleDeclined","paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/saleRecurringSubsequent"],"pointer":"/paths/~1v1~1transactions/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v1/transactions","servers":[{"url":"/_mock/apis/openapi","description":"Mock server (simulated responses)","isMockServer":true}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Client-Id","in":"header","required":true,"schemaId":"schema_26"},{"name":"X-Acting-As-Client-Id","in":"header","required":false,"schemaId":"schema_26"}],"cookie":[]},"security":[{"schemes":[{"id":"ApiKeyAuth","type":"apiKey","name":"Api-Key","in":"header"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/TransactionCreateRequest","exampleIds":["paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/saleWithCard","paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/saleWithToken","paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/authWithCard","paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/authWithToken","paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/saleWithBankAccount","paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/payout","paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/saleDeclined","paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/saleRecurringSubsequent"]}},"responseCodes":["200","400","401","403","409","500","502"],"pointer":"/v1/transactions","href":"send-transactions/createtransaction","openApiOperationId":"createTransaction","summary":"Create a Transaction"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/apis/openapi","description":"Mock server (simulated responses)","isMockServer":true}],"schemaId":"components/schemas/TransactionCreateRequest","exampleIds":["paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/saleWithCard","paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/saleWithToken","paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/authWithCard","paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/authWithToken","paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/saleWithBankAccount","paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/payout","paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/saleDeclined","paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/saleRecurringSubsequent"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/TransactionCreateRequest","exampleIds":["paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/saleWithCard","paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/saleWithToken","paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/authWithCard","paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/authWithToken","paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/saleWithBankAccount","paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/payout","paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/saleDeclined","paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/saleRecurringSubsequent"]}},"examples":[{},{},{},{},{},{},{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Transaction created successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TransactionResponse","exampleIds":["paths/~1v1~1transactions/post/responses/200/content/application~1json/examples/saleWithCard","paths/~1v1~1transactions/post/responses/200/content/application~1json/examples/saleWithToken","paths/~1v1~1transactions/post/responses/200/content/application~1json/examples/authWithCard","paths/~1v1~1transactions/post/responses/200/content/application~1json/examples/authWithToken","paths/~1v1~1transactions/post/responses/200/content/application~1json/examples/payout","paths/~1v1~1transactions/post/responses/200/content/application~1json/examples/saleDeclined","paths/~1v1~1transactions/post/responses/200/content/application~1json/examples/saleRecurringSubsequent"]}},"schemaId":"components/schemas/TransactionResponse","exampleIds":["paths/~1v1~1transactions/post/responses/200/content/application~1json/examples/saleWithCard","paths/~1v1~1transactions/post/responses/200/content/application~1json/examples/saleWithToken","paths/~1v1~1transactions/post/responses/200/content/application~1json/examples/authWithCard","paths/~1v1~1transactions/post/responses/200/content/application~1json/examples/authWithToken","paths/~1v1~1transactions/post/responses/200/content/application~1json/examples/payout","paths/~1v1~1transactions/post/responses/200/content/application~1json/examples/saleDeclined","paths/~1v1~1transactions/post/responses/200/content/application~1json/examples/saleRecurringSubsequent"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"400","description":"Bad request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_28","exampleIds":["paths/~1v1~1transactions/post/responses/400/content/application~1json/examples/invalidRequestData"]}},"schemaId":"schema_28","exampleIds":["paths/~1v1~1transactions/post/responses/400/content/application~1json/examples/invalidRequestData"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"401","description":"Not authenticated","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_29","exampleIds":["paths/~1v1~1transactions/post/responses/401/content/application~1json/examples/notAuthenticated"]}},"schemaId":"schema_29","exampleIds":["paths/~1v1~1transactions/post/responses/401/content/application~1json/examples/notAuthenticated"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_30","exampleIds":["paths/~1v1~1transactions/post/responses/403/content/application~1json/examples/unauthorizedAction"]}},"schemaId":"schema_30","exampleIds":["paths/~1v1~1transactions/post/responses/403/content/application~1json/examples/unauthorizedAction"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"409","description":"Conflict","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_31","exampleIds":["paths/~1v1~1transactions/post/responses/409/content/application~1json/examples/duplicateAction"]}},"schemaId":"schema_31","exampleIds":["paths/~1v1~1transactions/post/responses/409/content/application~1json/examples/duplicateAction"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_32","exampleIds":["paths/~1v1~1transactions/post/responses/500/content/application~1json/examples/systemError"]}},"schemaId":"schema_32","exampleIds":["paths/~1v1~1transactions/post/responses/500/content/application~1json/examples/systemError"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"502","description":"The gateway reached the downstream processor and could not use its response. Distinct from a 500, which is a fault inside the gateway.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_33","exampleIds":["paths/~1v1~1transactions/post/responses/502/content/application~1json/examples/downstreamError"]}},"schemaId":"schema_33","exampleIds":["paths/~1v1~1transactions/post/responses/502/content/application~1json/examples/downstreamError"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"}],"pointer":"/paths/~1v1~1transactions/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/TransactionResponse","exampleIds":["paths/~1v1~1transactions/post/responses/200/content/application~1json/examples/saleWithCard","paths/~1v1~1transactions/post/responses/200/content/application~1json/examples/saleWithToken","paths/~1v1~1transactions/post/responses/200/content/application~1json/examples/authWithCard","paths/~1v1~1transactions/post/responses/200/content/application~1json/examples/authWithToken","paths/~1v1~1transactions/post/responses/200/content/application~1json/examples/payout","paths/~1v1~1transactions/post/responses/200/content/application~1json/examples/saleDeclined","paths/~1v1~1transactions/post/responses/200/content/application~1json/examples/saleRecurringSubsequent"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TransactionResponse","exampleIds":["paths/~1v1~1transactions/post/responses/200/content/application~1json/examples/saleWithCard","paths/~1v1~1transactions/post/responses/200/content/application~1json/examples/saleWithToken","paths/~1v1~1transactions/post/responses/200/content/application~1json/examples/authWithCard","paths/~1v1~1transactions/post/responses/200/content/application~1json/examples/authWithToken","paths/~1v1~1transactions/post/responses/200/content/application~1json/examples/payout","paths/~1v1~1transactions/post/responses/200/content/application~1json/examples/saleDeclined","paths/~1v1~1transactions/post/responses/200/content/application~1json/examples/saleRecurringSubsequent"]}}},{"code":"400","schemaId":"schema_28","exampleIds":["paths/~1v1~1transactions/post/responses/400/content/application~1json/examples/invalidRequestData"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_28","exampleIds":["paths/~1v1~1transactions/post/responses/400/content/application~1json/examples/invalidRequestData"]}}},{"code":"401","schemaId":"schema_29","exampleIds":["paths/~1v1~1transactions/post/responses/401/content/application~1json/examples/notAuthenticated"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_29","exampleIds":["paths/~1v1~1transactions/post/responses/401/content/application~1json/examples/notAuthenticated"]}}},{"code":"403","schemaId":"schema_30","exampleIds":["paths/~1v1~1transactions/post/responses/403/content/application~1json/examples/unauthorizedAction"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_30","exampleIds":["paths/~1v1~1transactions/post/responses/403/content/application~1json/examples/unauthorizedAction"]}}},{"code":"409","schemaId":"schema_31","exampleIds":["paths/~1v1~1transactions/post/responses/409/content/application~1json/examples/duplicateAction"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_31","exampleIds":["paths/~1v1~1transactions/post/responses/409/content/application~1json/examples/duplicateAction"]}}},{"code":"500","schemaId":"schema_32","exampleIds":["paths/~1v1~1transactions/post/responses/500/content/application~1json/examples/systemError"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_32","exampleIds":["paths/~1v1~1transactions/post/responses/500/content/application~1json/examples/systemError"]}}},{"code":"502","schemaId":"schema_33","exampleIds":["paths/~1v1~1transactions/post/responses/502/content/application~1json/examples/downstreamError"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_33","exampleIds":["paths/~1v1~1transactions/post/responses/502/content/application~1json/examples/downstreamError"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/send-transactions/createtransaction"}],"panels":[]}]},"httpPath":"/v1/transactions"},{"label":"Capture a Transaction","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/openapi/send-transactions/capturetransaction","routeSlug":"/apis/openapi/send-transactions/capturetransaction","metadata":{"seo":{"title":"Capture a Transaction","description":"Capture an authorized transaction. A captured transaction will be settled during the next scheduled batch closure and funds will be transferred from the cardholder's account to the merchant's account. This operation is only available for approved authorization requests."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"captureTransaction","name":"Capture a Transaction","isWebhook":false,"pointer":"/paths/~1v1~1transactions~1{id}~1capture/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Capture a Transaction","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Capture an authorized transaction. A captured transaction will be  settled during the next scheduled batch closure and funds will be  transferred from the cardholder's account to the merchant's account. This operation is only available for approved authorization requests."},{"nodeType":"security","requirements":[{"schemes":[{"name":"ApiKeyAuth","scopes":[],"type":"apiKey","in":"header","paramName":"Api-Key","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key authentication. Include the API key in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Api-Key"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"WARNING"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": API key-based authentication offers no cryptographic security; always use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.mozilla.org/en-US/docs/Glossary/HTTPS"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"HTTPS"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":":"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"  Api-Key: AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe\n","language":"http"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"  Api-Key: AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe\n"},"children":[]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_34","description":"The ID of the transaction to capture. You can find the transaction  ID in the response of the original authorization transaction.","required":true,"examples":{"captureCard":{"summary":"The card authorization returned by authWithCard","value":"TRANSACTION-01KEW32V6YNV11T336VEDKL123"},"captureToken":{"summary":"The token authorization returned by authWithToken","value":"TRANSACTION-01KEW34J7RS3N9P5WQDEX8ZTB2"}}}],"pointer":"/paths/~1v1~1transactions~1{id}~1capture/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Client-Id","in":"header","schemaId":"schema_26","required":true},{"name":"X-Acting-As-Client-Id","in":"header","schemaId":"schema_26","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The child client this request acts on behalf of. A reseller still authenticates as itself — "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Api-Key"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Client-Id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" stay the reseller's — and names the child here."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This works only from a parent to its own children. Merchants have no children, so a merchant calling as itself omits the header. Sending your own client ULID here is not the same as omitting it, and is rejected on some operations."},"children":[]}]}]}]}],"pointer":"/paths/~1v1~1transactions~1{id}~1capture/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/TransactionCaptureRequest","exampleIds":["paths/~1v1~1transactions~1{id}~1capture/post/requestBody/content/application~1json/examples/captureCard","paths/~1v1~1transactions~1{id}~1capture/post/requestBody/content/application~1json/examples/captureToken"]}},"schemaId":"components/schemas/TransactionCaptureRequest","exampleIds":["paths/~1v1~1transactions~1{id}~1capture/post/requestBody/content/application~1json/examples/captureCard","paths/~1v1~1transactions~1{id}~1capture/post/requestBody/content/application~1json/examples/captureToken"],"pointer":"/paths/~1v1~1transactions~1{id}~1capture/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v1/transactions/{id}/capture","servers":[{"url":"/_mock/apis/openapi","description":"Mock server (simulated responses)","isMockServer":true}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"TRANSACTION-01KEW32V6YNV11T336VEDKL123","schemaId":"schema_34"}],"query":[],"querystring":[],"header":[{"name":"Client-Id","in":"header","required":true,"schemaId":"schema_26"},{"name":"X-Acting-As-Client-Id","in":"header","required":false,"schemaId":"schema_26"}],"cookie":[]},"security":[{"schemes":[{"id":"ApiKeyAuth","type":"apiKey","name":"Api-Key","in":"header"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/TransactionCaptureRequest","exampleIds":["paths/~1v1~1transactions~1{id}~1capture/post/requestBody/content/application~1json/examples/captureCard","paths/~1v1~1transactions~1{id}~1capture/post/requestBody/content/application~1json/examples/captureToken"]}},"responseCodes":["200","400","401","403","404","409","500","502"],"pointer":"/v1/transactions/{id}/capture","href":"send-transactions/capturetransaction","openApiOperationId":"captureTransaction","summary":"Capture a Transaction"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/apis/openapi","description":"Mock server (simulated responses)","isMockServer":true}],"schemaId":"components/schemas/TransactionCaptureRequest","exampleIds":["paths/~1v1~1transactions~1{id}~1capture/post/requestBody/content/application~1json/examples/captureCard","paths/~1v1~1transactions~1{id}~1capture/post/requestBody/content/application~1json/examples/captureToken"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/TransactionCaptureRequest","exampleIds":["paths/~1v1~1transactions~1{id}~1capture/post/requestBody/content/application~1json/examples/captureCard","paths/~1v1~1transactions~1{id}~1capture/post/requestBody/content/application~1json/examples/captureToken"]}},"examples":[{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Transaction captured successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TransactionResponse","exampleIds":["paths/~1v1~1transactions~1{id}~1capture/post/responses/200/content/application~1json/examples/captureCard","paths/~1v1~1transactions~1{id}~1capture/post/responses/200/content/application~1json/examples/captureToken"]}},"schemaId":"components/schemas/TransactionResponse","exampleIds":["paths/~1v1~1transactions~1{id}~1capture/post/responses/200/content/application~1json/examples/captureCard","paths/~1v1~1transactions~1{id}~1capture/post/responses/200/content/application~1json/examples/captureToken"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"400","description":"Bad request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_28","exampleIds":["paths/~1v1~1transactions~1{id}~1capture/post/responses/400/content/application~1json/examples/invalidRequestData"]}},"schemaId":"schema_28","exampleIds":["paths/~1v1~1transactions~1{id}~1capture/post/responses/400/content/application~1json/examples/invalidRequestData"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"401","description":"Not authenticated","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_29","exampleIds":["paths/~1v1~1transactions~1{id}~1capture/post/responses/401/content/application~1json/examples/notAuthenticated"]}},"schemaId":"schema_29","exampleIds":["paths/~1v1~1transactions~1{id}~1capture/post/responses/401/content/application~1json/examples/notAuthenticated"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_30","exampleIds":["paths/~1v1~1transactions~1{id}~1capture/post/responses/403/content/application~1json/examples/unauthorizedAction"]}},"schemaId":"schema_30","exampleIds":["paths/~1v1~1transactions~1{id}~1capture/post/responses/403/content/application~1json/examples/unauthorizedAction"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_35","exampleIds":["paths/~1v1~1transactions~1{id}~1capture/post/responses/404/content/application~1json/examples/resourceNotFound"]}},"schemaId":"schema_35","exampleIds":["paths/~1v1~1transactions~1{id}~1capture/post/responses/404/content/application~1json/examples/resourceNotFound"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"409","description":"Conflict","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_31","exampleIds":["paths/~1v1~1transactions~1{id}~1capture/post/responses/409/content/application~1json/examples/duplicateAction"]}},"schemaId":"schema_31","exampleIds":["paths/~1v1~1transactions~1{id}~1capture/post/responses/409/content/application~1json/examples/duplicateAction"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_32","exampleIds":["paths/~1v1~1transactions~1{id}~1capture/post/responses/500/content/application~1json/examples/systemError"]}},"schemaId":"schema_32","exampleIds":["paths/~1v1~1transactions~1{id}~1capture/post/responses/500/content/application~1json/examples/systemError"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"502","description":"The gateway reached the downstream processor and could not use its response. Distinct from a 500, which is a fault inside the gateway.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_33","exampleIds":["paths/~1v1~1transactions~1{id}~1capture/post/responses/502/content/application~1json/examples/downstreamError"]}},"schemaId":"schema_33","exampleIds":["paths/~1v1~1transactions~1{id}~1capture/post/responses/502/content/application~1json/examples/downstreamError"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"}],"pointer":"/paths/~1v1~1transactions~1{id}~1capture/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/TransactionResponse","exampleIds":["paths/~1v1~1transactions~1{id}~1capture/post/responses/200/content/application~1json/examples/captureCard","paths/~1v1~1transactions~1{id}~1capture/post/responses/200/content/application~1json/examples/captureToken"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TransactionResponse","exampleIds":["paths/~1v1~1transactions~1{id}~1capture/post/responses/200/content/application~1json/examples/captureCard","paths/~1v1~1transactions~1{id}~1capture/post/responses/200/content/application~1json/examples/captureToken"]}}},{"code":"400","schemaId":"schema_28","exampleIds":["paths/~1v1~1transactions~1{id}~1capture/post/responses/400/content/application~1json/examples/invalidRequestData"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_28","exampleIds":["paths/~1v1~1transactions~1{id}~1capture/post/responses/400/content/application~1json/examples/invalidRequestData"]}}},{"code":"401","schemaId":"schema_29","exampleIds":["paths/~1v1~1transactions~1{id}~1capture/post/responses/401/content/application~1json/examples/notAuthenticated"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_29","exampleIds":["paths/~1v1~1transactions~1{id}~1capture/post/responses/401/content/application~1json/examples/notAuthenticated"]}}},{"code":"403","schemaId":"schema_30","exampleIds":["paths/~1v1~1transactions~1{id}~1capture/post/responses/403/content/application~1json/examples/unauthorizedAction"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_30","exampleIds":["paths/~1v1~1transactions~1{id}~1capture/post/responses/403/content/application~1json/examples/unauthorizedAction"]}}},{"code":"404","schemaId":"schema_35","exampleIds":["paths/~1v1~1transactions~1{id}~1capture/post/responses/404/content/application~1json/examples/resourceNotFound"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_35","exampleIds":["paths/~1v1~1transactions~1{id}~1capture/post/responses/404/content/application~1json/examples/resourceNotFound"]}}},{"code":"409","schemaId":"schema_31","exampleIds":["paths/~1v1~1transactions~1{id}~1capture/post/responses/409/content/application~1json/examples/duplicateAction"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_31","exampleIds":["paths/~1v1~1transactions~1{id}~1capture/post/responses/409/content/application~1json/examples/duplicateAction"]}}},{"code":"500","schemaId":"schema_32","exampleIds":["paths/~1v1~1transactions~1{id}~1capture/post/responses/500/content/application~1json/examples/systemError"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_32","exampleIds":["paths/~1v1~1transactions~1{id}~1capture/post/responses/500/content/application~1json/examples/systemError"]}}},{"code":"502","schemaId":"schema_33","exampleIds":["paths/~1v1~1transactions~1{id}~1capture/post/responses/502/content/application~1json/examples/downstreamError"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_33","exampleIds":["paths/~1v1~1transactions~1{id}~1capture/post/responses/502/content/application~1json/examples/downstreamError"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/send-transactions/capturetransaction"}],"panels":[]}]},"httpPath":"/v1/transactions/{id}/capture"},{"label":"Cancel (void) or refund a transaction","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/openapi/send-transactions/canceltransaction","routeSlug":"/apis/openapi/send-transactions/canceltransaction","metadata":{"seo":{"title":"Cancel (void) or refund a transaction","description":"Cancel (void) a transaction or refund a transaction."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"cancelTransaction","name":"Cancel (void) or refund a transaction","isWebhook":false,"pointer":"/paths/~1v1~1transactions~1{id}~1cancel/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Cancel (void) or refund a transaction","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Cancel (void) a transaction or refund a transaction."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Select type "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"VOID"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to void a transaction before settlement."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Select type "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"REFUND"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to refund a transaction after settlement."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"ApiKeyAuth","scopes":[],"type":"apiKey","in":"header","paramName":"Api-Key","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key authentication. Include the API key in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Api-Key"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"WARNING"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": API key-based authentication offers no cryptographic security; always use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.mozilla.org/en-US/docs/Glossary/HTTPS"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"HTTPS"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":":"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"  Api-Key: AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe\n","language":"http"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"  Api-Key: AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe\n"},"children":[]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_34","description":"The ID of the transaction to cancel or refund.","required":true,"examples":{"voidTransaction":{"summary":"The sale returned by saleWithCard, voided before settlement","value":"TRANSACTION-01KEW32V6YNV11T33XGDR7TGWC"},"refundTransaction":{"summary":"The same sale, partially refunded after settlement","value":"TRANSACTION-01KEW32V6YNV11T33XGDR7TGWC"}}}],"pointer":"/paths/~1v1~1transactions~1{id}~1cancel/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Client-Id","in":"header","schemaId":"schema_26","required":true},{"name":"X-Acting-As-Client-Id","in":"header","schemaId":"schema_26","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The child client this request acts on behalf of. A reseller still authenticates as itself — "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Api-Key"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Client-Id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" stay the reseller's — and names the child here."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This works only from a parent to its own children. Merchants have no children, so a merchant calling as itself omits the header. Sending your own client ULID here is not the same as omitting it, and is rejected on some operations."},"children":[]}]}]}]}],"pointer":"/paths/~1v1~1transactions~1{id}~1cancel/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_36","exampleIds":["paths/~1v1~1transactions~1{id}~1cancel/post/requestBody/content/application~1json/examples/voidTransaction","paths/~1v1~1transactions~1{id}~1cancel/post/requestBody/content/application~1json/examples/refundTransaction"]}},"schemaId":"schema_36","exampleIds":["paths/~1v1~1transactions~1{id}~1cancel/post/requestBody/content/application~1json/examples/voidTransaction","paths/~1v1~1transactions~1{id}~1cancel/post/requestBody/content/application~1json/examples/refundTransaction"],"pointer":"/paths/~1v1~1transactions~1{id}~1cancel/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v1/transactions/{id}/cancel","servers":[{"url":"/_mock/apis/openapi","description":"Mock server (simulated responses)","isMockServer":true}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"TRANSACTION-01KEW32V6YNV11T33XGDR7TGWC","schemaId":"schema_34"}],"query":[],"querystring":[],"header":[{"name":"Client-Id","in":"header","required":true,"schemaId":"schema_26"},{"name":"X-Acting-As-Client-Id","in":"header","required":false,"schemaId":"schema_26"}],"cookie":[]},"security":[{"schemes":[{"id":"ApiKeyAuth","type":"apiKey","name":"Api-Key","in":"header"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_36","exampleIds":["paths/~1v1~1transactions~1{id}~1cancel/post/requestBody/content/application~1json/examples/voidTransaction","paths/~1v1~1transactions~1{id}~1cancel/post/requestBody/content/application~1json/examples/refundTransaction"]}},"responseCodes":["200","400","401","403","404","409","500","502"],"pointer":"/v1/transactions/{id}/cancel","href":"send-transactions/canceltransaction","openApiOperationId":"cancelTransaction","summary":"Cancel (void) or refund a transaction"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/apis/openapi","description":"Mock server (simulated responses)","isMockServer":true}],"schemaId":"schema_36","exampleIds":["paths/~1v1~1transactions~1{id}~1cancel/post/requestBody/content/application~1json/examples/voidTransaction","paths/~1v1~1transactions~1{id}~1cancel/post/requestBody/content/application~1json/examples/refundTransaction"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_36","exampleIds":["paths/~1v1~1transactions~1{id}~1cancel/post/requestBody/content/application~1json/examples/voidTransaction","paths/~1v1~1transactions~1{id}~1cancel/post/requestBody/content/application~1json/examples/refundTransaction"]}},"examples":[{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Transaction canceled or refunded successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TransactionResponse","exampleIds":["paths/~1v1~1transactions~1{id}~1cancel/post/responses/200/content/application~1json/examples/voidTransaction","paths/~1v1~1transactions~1{id}~1cancel/post/responses/200/content/application~1json/examples/refundTransaction"]}},"schemaId":"components/schemas/TransactionResponse","exampleIds":["paths/~1v1~1transactions~1{id}~1cancel/post/responses/200/content/application~1json/examples/voidTransaction","paths/~1v1~1transactions~1{id}~1cancel/post/responses/200/content/application~1json/examples/refundTransaction"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"400","description":"Bad request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_28","exampleIds":["paths/~1v1~1transactions~1{id}~1cancel/post/responses/400/content/application~1json/examples/invalidRequestData"]}},"schemaId":"schema_28","exampleIds":["paths/~1v1~1transactions~1{id}~1cancel/post/responses/400/content/application~1json/examples/invalidRequestData"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"401","description":"Not authenticated","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_29","exampleIds":["paths/~1v1~1transactions~1{id}~1cancel/post/responses/401/content/application~1json/examples/notAuthenticated"]}},"schemaId":"schema_29","exampleIds":["paths/~1v1~1transactions~1{id}~1cancel/post/responses/401/content/application~1json/examples/notAuthenticated"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_30","exampleIds":["paths/~1v1~1transactions~1{id}~1cancel/post/responses/403/content/application~1json/examples/unauthorizedAction"]}},"schemaId":"schema_30","exampleIds":["paths/~1v1~1transactions~1{id}~1cancel/post/responses/403/content/application~1json/examples/unauthorizedAction"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_35","exampleIds":["paths/~1v1~1transactions~1{id}~1cancel/post/responses/404/content/application~1json/examples/resourceNotFound"]}},"schemaId":"schema_35","exampleIds":["paths/~1v1~1transactions~1{id}~1cancel/post/responses/404/content/application~1json/examples/resourceNotFound"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"409","description":"Conflict","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_31","exampleIds":["paths/~1v1~1transactions~1{id}~1cancel/post/responses/409/content/application~1json/examples/duplicateAction"]}},"schemaId":"schema_31","exampleIds":["paths/~1v1~1transactions~1{id}~1cancel/post/responses/409/content/application~1json/examples/duplicateAction"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_32","exampleIds":["paths/~1v1~1transactions~1{id}~1cancel/post/responses/500/content/application~1json/examples/systemError"]}},"schemaId":"schema_32","exampleIds":["paths/~1v1~1transactions~1{id}~1cancel/post/responses/500/content/application~1json/examples/systemError"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"502","description":"The gateway reached the downstream processor and could not use its response. Distinct from a 500, which is a fault inside the gateway.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_33","exampleIds":["paths/~1v1~1transactions~1{id}~1cancel/post/responses/502/content/application~1json/examples/downstreamError"]}},"schemaId":"schema_33","exampleIds":["paths/~1v1~1transactions~1{id}~1cancel/post/responses/502/content/application~1json/examples/downstreamError"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"}],"pointer":"/paths/~1v1~1transactions~1{id}~1cancel/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/TransactionResponse","exampleIds":["paths/~1v1~1transactions~1{id}~1cancel/post/responses/200/content/application~1json/examples/voidTransaction","paths/~1v1~1transactions~1{id}~1cancel/post/responses/200/content/application~1json/examples/refundTransaction"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TransactionResponse","exampleIds":["paths/~1v1~1transactions~1{id}~1cancel/post/responses/200/content/application~1json/examples/voidTransaction","paths/~1v1~1transactions~1{id}~1cancel/post/responses/200/content/application~1json/examples/refundTransaction"]}}},{"code":"400","schemaId":"schema_28","exampleIds":["paths/~1v1~1transactions~1{id}~1cancel/post/responses/400/content/application~1json/examples/invalidRequestData"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_28","exampleIds":["paths/~1v1~1transactions~1{id}~1cancel/post/responses/400/content/application~1json/examples/invalidRequestData"]}}},{"code":"401","schemaId":"schema_29","exampleIds":["paths/~1v1~1transactions~1{id}~1cancel/post/responses/401/content/application~1json/examples/notAuthenticated"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_29","exampleIds":["paths/~1v1~1transactions~1{id}~1cancel/post/responses/401/content/application~1json/examples/notAuthenticated"]}}},{"code":"403","schemaId":"schema_30","exampleIds":["paths/~1v1~1transactions~1{id}~1cancel/post/responses/403/content/application~1json/examples/unauthorizedAction"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_30","exampleIds":["paths/~1v1~1transactions~1{id}~1cancel/post/responses/403/content/application~1json/examples/unauthorizedAction"]}}},{"code":"404","schemaId":"schema_35","exampleIds":["paths/~1v1~1transactions~1{id}~1cancel/post/responses/404/content/application~1json/examples/resourceNotFound"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_35","exampleIds":["paths/~1v1~1transactions~1{id}~1cancel/post/responses/404/content/application~1json/examples/resourceNotFound"]}}},{"code":"409","schemaId":"schema_31","exampleIds":["paths/~1v1~1transactions~1{id}~1cancel/post/responses/409/content/application~1json/examples/duplicateAction"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_31","exampleIds":["paths/~1v1~1transactions~1{id}~1cancel/post/responses/409/content/application~1json/examples/duplicateAction"]}}},{"code":"500","schemaId":"schema_32","exampleIds":["paths/~1v1~1transactions~1{id}~1cancel/post/responses/500/content/application~1json/examples/systemError"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_32","exampleIds":["paths/~1v1~1transactions~1{id}~1cancel/post/responses/500/content/application~1json/examples/systemError"]}}},{"code":"502","schemaId":"schema_33","exampleIds":["paths/~1v1~1transactions~1{id}~1cancel/post/responses/502/content/application~1json/examples/downstreamError"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_33","exampleIds":["paths/~1v1~1transactions~1{id}~1cancel/post/responses/502/content/application~1json/examples/downstreamError"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/send-transactions/canceltransaction"}],"panels":[]}]},"httpPath":"/v1/transactions/{id}/cancel"}],"content":{"contentType":"group","meta":{"name":"Send transactions"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Send transactions","showPageActions":true},{"nodeType":"markdoc","content":"The Send Transactions operations includes APIs for sending payment  transactions via credit card or payment token. Transaction types  include sales, authorizations, captures, and refund/cancels."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/v1/transactions","summary":"Create a Transaction","prefix":{"name":"post","color":"post"},"badges":[],"link":"/send-transactions/createtransaction","deprecated":false},{"title":"/v1/transactions/{id}/capture","summary":"Capture a Transaction","prefix":{"name":"post","color":"post"},"badges":[],"link":"/send-transactions/capturetransaction","deprecated":false},{"title":"/v1/transactions/{id}/cancel","summary":"Cancel (void) or refund a transaction","prefix":{"name":"post","color":"post"},"badges":[],"link":"/send-transactions/canceltransaction","deprecated":false}]}]}]}]}},{"type":"group","label":"Transaction reports","link":"/apis/openapi/transaction-reports","routeSlug":"/apis/openapi/transaction-reports","items":[{"label":"List Transactions","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/openapi/transaction-reports/listtransactions","routeSlug":"/apis/openapi/transaction-reports/listtransactions","metadata":{"seo":{"title":"List Transactions","description":"Return a list of payment transactions for a merchant account. Use the  query parameters to filter and sort the results."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listTransactions","name":"List Transactions","isWebhook":false,"pointer":"/paths/~1v1~1transactions/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List Transactions","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return a list of payment transactions for a merchant account. Use the  query parameters to filter and sort the results."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"transaction-reports/listtransactions/request/examples","deepLinkHash":"/transaction-reports/listtransactions#transaction-reports/listtransactions/request/examples"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Examples"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"50 approved Sale transactions:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"GET /v1/transactions?type=sale&result=approved&limit=50\n","language":"http"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"GET /v1/transactions?type=sale&result=approved&limit=50\n"},"children":[]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Declined transactions in January 2026:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"GET /v1/transactions?result=declined&created.gte=2026-01-01T00:00:00Z&created.lte=2026-01-31T23:59:59Z\n","language":"http"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"GET /v1/transactions?result=declined&created.gte=2026-01-01T00:00:00Z&created.lte=2026-01-31T23:59:59Z\n"},"children":[]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A child merchant's transactions (reseller viewing merchant):"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"GET /v1/transactions?client_id=CLIENT-01KFDKXMQ637EKEAY410MSQSXB\n","language":"http"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"GET /v1/transactions?client_id=CLIENT-01KFDKXMQ637EKEAY410MSQSXB\n"},"children":[]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Page through results — skip first 100, return next 25, sorted by amount descending:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"GET /v1/transactions?offset=100&limit=25&sort_by=amount&sort_order=desc\n","language":"http"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"GET /v1/transactions?offset=100&limit=25&sort_by=amount&sort_order=desc\n"},"children":[]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"All Sales and Authorizations for a merchant in a date range:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"GET /v1/transactions?type=sale,auth&client_id=CLIENT-01KFDKXMQ637EKEAY410MSQSXB&created.gte=2026-03-01T00:00:00Z&created.lte=2026-03-31T23:59:59Z\n","language":"http"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"GET /v1/transactions?type=sale,auth&client_id=CLIENT-01KFDKXMQ637EKEAY410MSQSXB&created.gte=2026-03-01T00:00:00Z&created.lte=2026-03-31T23:59:59Z\n"},"children":[]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"ApiKeyAuth","scopes":[],"type":"apiKey","in":"header","paramName":"Api-Key","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key authentication. Include the API key in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Api-Key"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"WARNING"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": API key-based authentication offers no cryptographic security; always use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.mozilla.org/en-US/docs/Glossary/HTTPS"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"HTTPS"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":":"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"  Api-Key: AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe\n","language":"http"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"  Api-Key: AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe\n"},"children":[]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"limit","in":"query","schemaId":"schema_37","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Maximum number of transactions to return. Range: 1–1000."},"children":[]}]}]}]},{"name":"offset","in":"query","schemaId":"schema_38","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Number of transactions to skip before returning results. Use with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"limit"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to select a specific window. For example, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"offset=20&limit=20"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" returns records 21–40."},"children":[]}]}]}]},{"name":"batch_id","in":"query","schemaId":"schema_34","description":"Filter results to transactions belonging to a specific batch."},{"name":"is_settled","in":"query","schemaId":"schema_39","description":"Whether the transaction is settled.","example":true},{"name":"card_type","in":"query","schemaId":"schema_40","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filters transactions by card type. Send one value, or a comma-separated list to match any of several types — "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"card_type=CREDIT,DEBIT"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Values are matched case-insensitively."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Accepts every value a transaction response can carry, including "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"UNKNOWN"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for transactions whose card type the processor could not determine. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"UNKNOWN"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is the common case on most merchants, so a filter of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"CREDIT"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"DEBIT"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" alone returns very few rows."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The open-batch filter on "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v1/batches/transactions"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is a different parameter and does not behave the same way. See "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"OpenBatchCardType"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"name":"integration","in":"query","schemaId":"schema_41","description":"Filter results to transactions belonging to a specific integration  (e.g., payment processor such as TSYS or Vericheck)."},{"name":"client_id","in":"query","schemaId":"schema_34","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter results to transactions belonging to a specific client. Resellers use this to view transactions for a child merchant under their account. The authenticated caller must have permission to access the specified client's data. More than one  client_id can be included by using a comma-separated list."},"children":[]}]}]}],"examples":{"merchant":{"value":"CLIENT-01KFDKXMQ637EKEAY410MSQSXB"}}},{"name":"type","in":"query","schemaId":"schema_42","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by transaction type. Send one value, or a comma-separated list to match any of several types — "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"type=SALE,AUTH"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Values are matched case-insensitively."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Two current limitations are worth knowing before you rely on this filter. Filtering by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"PAYOUT"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is accepted but ignored, and returns unfiltered results rather than an error. Sending "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"VOID"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" returns a server error; a cancelled payment is reported as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"CANCEL"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", so filter on that instead."},"children":[]}]}]}]},{"name":"result","in":"query","schemaId":"schema_43","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by transaction result. Use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"approved"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to return only approved transactions or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"declined"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to return only declined transactions. When omitted, transactions with any result are returned."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Possible values:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"APPROVED"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"DECLINED"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ERROR"},"children":[]}]}]}]}]},{"name":"created.gte","in":"query","schemaId":"schema_44","description":"Return transactions created at or after this timestamp (inclusive). ISO 8601 format (UTC).","example":"2026-01-01T00:00:00Z"},{"name":"created.lte","in":"query","schemaId":"schema_44","description":"Return transactions created at or before this timestamp (inclusive). ISO 8601 format (UTC)."},{"name":"sort_by","in":"query","schemaId":"schema_45","description":"Field to sort results by."},{"name":"sort_order","in":"query","schemaId":"schema_46","description":"Sort direction."}],"pointer":"/paths/~1v1~1transactions/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Client-Id","in":"header","schemaId":"schema_26","required":true},{"name":"X-Acting-As-Client-Id","in":"header","schemaId":"schema_26","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The child client this request acts on behalf of. A reseller still authenticates as itself — "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Api-Key"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Client-Id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" stay the reseller's — and names the child here."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This works only from a parent to its own children. Merchants have no children, so a merchant calling as itself omits the header. Sending your own client ULID here is not the same as omitting it, and is rejected on some operations."},"children":[]}]}]}]}],"pointer":"/paths/~1v1~1transactions/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v1/transactions","servers":[{"url":"/_mock/apis/openapi","description":"Mock server (simulated responses)","isMockServer":true}],"parameters":{"path":[],"query":[{"name":"limit","in":"query","required":false,"schemaId":"schema_37"},{"name":"offset","in":"query","required":false,"schemaId":"schema_38"},{"name":"batch_id","in":"query","required":false,"schemaId":"schema_34","style":"form"},{"name":"is_settled","in":"query","required":false,"example":true,"schemaId":"schema_39"},{"name":"card_type","in":"query","required":false,"schemaId":"schema_40","style":"form","explode":false},{"name":"integration","in":"query","required":false,"schemaId":"schema_41"},{"name":"client_id","in":"query","required":false,"example":"CLIENT-01KFDKXMQ637EKEAY410MSQSXB","schemaId":"schema_34","style":"form","explode":true},{"name":"type","in":"query","required":false,"schemaId":"schema_42","style":"form","explode":false},{"name":"result","in":"query","required":false,"schemaId":"schema_43"},{"name":"created.gte","in":"query","required":false,"example":"2026-01-01T00:00:00Z","schemaId":"schema_44"},{"name":"created.lte","in":"query","required":false,"schemaId":"schema_44"},{"name":"sort_by","in":"query","required":false,"schemaId":"schema_45"},{"name":"sort_order","in":"query","required":false,"schemaId":"schema_46"}],"querystring":[],"header":[{"name":"Client-Id","in":"header","required":true,"schemaId":"schema_26"},{"name":"X-Acting-As-Client-Id","in":"header","required":false,"schemaId":"schema_26"}],"cookie":[]},"security":[{"schemes":[{"id":"ApiKeyAuth","type":"apiKey","name":"Api-Key","in":"header"}],"scopes":[]}],"responseCodes":["200","400","401","403","500"],"pointer":"/v1/transactions","href":"transaction-reports/listtransactions","openApiOperationId":"listTransactions","summary":"List Transactions"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/apis/openapi","description":"Mock server (simulated responses)","isMockServer":true}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Payment transaction list returned successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TransactionsListResponse","exampleIds":["paths/~1v1~1transactions/get/responses/200/content/application~1json/examples/transactionList"]}},"schemaId":"components/schemas/TransactionsListResponse","exampleIds":["paths/~1v1~1transactions/get/responses/200/content/application~1json/examples/transactionList"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"400","description":"Bad request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_28","exampleIds":["paths/~1v1~1transactions/get/responses/400/content/application~1json/examples/invalidRequestData"]}},"schemaId":"schema_28","exampleIds":["paths/~1v1~1transactions/get/responses/400/content/application~1json/examples/invalidRequestData"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"401","description":"Not authenticated","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_29","exampleIds":["paths/~1v1~1transactions/get/responses/401/content/application~1json/examples/notAuthenticated"]}},"schemaId":"schema_29","exampleIds":["paths/~1v1~1transactions/get/responses/401/content/application~1json/examples/notAuthenticated"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_30","exampleIds":["paths/~1v1~1transactions/get/responses/403/content/application~1json/examples/unauthorizedAction"]}},"schemaId":"schema_30","exampleIds":["paths/~1v1~1transactions/get/responses/403/content/application~1json/examples/unauthorizedAction"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_32","exampleIds":["paths/~1v1~1transactions/get/responses/500/content/application~1json/examples/systemError"]}},"schemaId":"schema_32","exampleIds":["paths/~1v1~1transactions/get/responses/500/content/application~1json/examples/systemError"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"}],"pointer":"/paths/~1v1~1transactions/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/TransactionsListResponse","exampleIds":["paths/~1v1~1transactions/get/responses/200/content/application~1json/examples/transactionList"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TransactionsListResponse","exampleIds":["paths/~1v1~1transactions/get/responses/200/content/application~1json/examples/transactionList"]}}},{"code":"400","schemaId":"schema_28","exampleIds":["paths/~1v1~1transactions/get/responses/400/content/application~1json/examples/invalidRequestData"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_28","exampleIds":["paths/~1v1~1transactions/get/responses/400/content/application~1json/examples/invalidRequestData"]}}},{"code":"401","schemaId":"schema_29","exampleIds":["paths/~1v1~1transactions/get/responses/401/content/application~1json/examples/notAuthenticated"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_29","exampleIds":["paths/~1v1~1transactions/get/responses/401/content/application~1json/examples/notAuthenticated"]}}},{"code":"403","schemaId":"schema_30","exampleIds":["paths/~1v1~1transactions/get/responses/403/content/application~1json/examples/unauthorizedAction"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_30","exampleIds":["paths/~1v1~1transactions/get/responses/403/content/application~1json/examples/unauthorizedAction"]}}},{"code":"500","schemaId":"schema_32","exampleIds":["paths/~1v1~1transactions/get/responses/500/content/application~1json/examples/systemError"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_32","exampleIds":["paths/~1v1~1transactions/get/responses/500/content/application~1json/examples/systemError"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/transaction-reports/listtransactions"}],"panels":[]}]},"httpPath":"/v1/transactions"},{"label":"Retrieve a Transaction","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/openapi/transaction-reports/retrievetransaction","routeSlug":"/apis/openapi/transaction-reports/retrievetransaction","metadata":{"seo":{"title":"Retrieve a Transaction","description":"Retrieve the details of a specific transaction."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"retrieveTransaction","name":"Retrieve a Transaction","isWebhook":false,"pointer":"/paths/~1v1~1transactions~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve a Transaction","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieve the details of a specific transaction."},{"nodeType":"security","requirements":[{"schemes":[{"name":"ApiKeyAuth","scopes":[],"type":"apiKey","in":"header","paramName":"Api-Key","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key authentication. Include the API key in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Api-Key"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"WARNING"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": API key-based authentication offers no cryptographic security; always use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.mozilla.org/en-US/docs/Glossary/HTTPS"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"HTTPS"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":":"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"  Api-Key: AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe\n","language":"http"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"  Api-Key: AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe\n"},"children":[]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_34","required":true}],"pointer":"/paths/~1v1~1transactions~1{id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Client-Id","in":"header","schemaId":"schema_26","required":true},{"name":"X-Acting-As-Client-Id","in":"header","schemaId":"schema_26","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The child client this request acts on behalf of. A reseller still authenticates as itself — "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Api-Key"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Client-Id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" stay the reseller's — and names the child here."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This works only from a parent to its own children. Merchants have no children, so a merchant calling as itself omits the header. Sending your own client ULID here is not the same as omitting it, and is rejected on some operations."},"children":[]}]}]}]}],"pointer":"/paths/~1v1~1transactions~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v1/transactions/{id}","servers":[{"url":"/_mock/apis/openapi","description":"Mock server (simulated responses)","isMockServer":true}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_34"}],"query":[],"querystring":[],"header":[{"name":"Client-Id","in":"header","required":true,"schemaId":"schema_26"},{"name":"X-Acting-As-Client-Id","in":"header","required":false,"schemaId":"schema_26"}],"cookie":[]},"security":[{"schemes":[{"id":"ApiKeyAuth","type":"apiKey","name":"Api-Key","in":"header"}],"scopes":[]}],"responseCodes":["200","400","401","403","404","500"],"pointer":"/v1/transactions/{id}","href":"transaction-reports/retrievetransaction","openApiOperationId":"retrieveTransaction","summary":"Retrieve a Transaction"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/apis/openapi","description":"Mock server (simulated responses)","isMockServer":true}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Transaction details retrieved successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TransactionResponse","exampleIds":["paths/~1v1~1transactions~1{id}/get/responses/200/content/application~1json/examples/saleWithCard"]}},"schemaId":"components/schemas/TransactionResponse","exampleIds":["paths/~1v1~1transactions~1{id}/get/responses/200/content/application~1json/examples/saleWithCard"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"400","description":"Bad request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_28","exampleIds":["paths/~1v1~1transactions~1{id}/get/responses/400/content/application~1json/examples/invalidRequestData"]}},"schemaId":"schema_28","exampleIds":["paths/~1v1~1transactions~1{id}/get/responses/400/content/application~1json/examples/invalidRequestData"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"401","description":"Not authenticated","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_29","exampleIds":["paths/~1v1~1transactions~1{id}/get/responses/401/content/application~1json/examples/notAuthenticated"]}},"schemaId":"schema_29","exampleIds":["paths/~1v1~1transactions~1{id}/get/responses/401/content/application~1json/examples/notAuthenticated"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_30","exampleIds":["paths/~1v1~1transactions~1{id}/get/responses/403/content/application~1json/examples/unauthorizedAction"]}},"schemaId":"schema_30","exampleIds":["paths/~1v1~1transactions~1{id}/get/responses/403/content/application~1json/examples/unauthorizedAction"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_35","exampleIds":["paths/~1v1~1transactions~1{id}/get/responses/404/content/application~1json/examples/resourceNotFound"]}},"schemaId":"schema_35","exampleIds":["paths/~1v1~1transactions~1{id}/get/responses/404/content/application~1json/examples/resourceNotFound"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_32","exampleIds":["paths/~1v1~1transactions~1{id}/get/responses/500/content/application~1json/examples/systemError"]}},"schemaId":"schema_32","exampleIds":["paths/~1v1~1transactions~1{id}/get/responses/500/content/application~1json/examples/systemError"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"}],"pointer":"/paths/~1v1~1transactions~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/TransactionResponse","exampleIds":["paths/~1v1~1transactions~1{id}/get/responses/200/content/application~1json/examples/saleWithCard"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TransactionResponse","exampleIds":["paths/~1v1~1transactions~1{id}/get/responses/200/content/application~1json/examples/saleWithCard"]}}},{"code":"400","schemaId":"schema_28","exampleIds":["paths/~1v1~1transactions~1{id}/get/responses/400/content/application~1json/examples/invalidRequestData"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_28","exampleIds":["paths/~1v1~1transactions~1{id}/get/responses/400/content/application~1json/examples/invalidRequestData"]}}},{"code":"401","schemaId":"schema_29","exampleIds":["paths/~1v1~1transactions~1{id}/get/responses/401/content/application~1json/examples/notAuthenticated"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_29","exampleIds":["paths/~1v1~1transactions~1{id}/get/responses/401/content/application~1json/examples/notAuthenticated"]}}},{"code":"403","schemaId":"schema_30","exampleIds":["paths/~1v1~1transactions~1{id}/get/responses/403/content/application~1json/examples/unauthorizedAction"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_30","exampleIds":["paths/~1v1~1transactions~1{id}/get/responses/403/content/application~1json/examples/unauthorizedAction"]}}},{"code":"404","schemaId":"schema_35","exampleIds":["paths/~1v1~1transactions~1{id}/get/responses/404/content/application~1json/examples/resourceNotFound"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_35","exampleIds":["paths/~1v1~1transactions~1{id}/get/responses/404/content/application~1json/examples/resourceNotFound"]}}},{"code":"500","schemaId":"schema_32","exampleIds":["paths/~1v1~1transactions~1{id}/get/responses/500/content/application~1json/examples/systemError"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_32","exampleIds":["paths/~1v1~1transactions~1{id}/get/responses/500/content/application~1json/examples/systemError"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/transaction-reports/retrievetransaction"}],"panels":[]}]},"httpPath":"/v1/transactions/{id}"}],"content":{"contentType":"group","meta":{"name":"Transaction reports"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Transaction reports","showPageActions":true},{"nodeType":"markdoc","content":"The Transaction reports operations includes APIs for generating  transaction reports."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/v1/transactions","summary":"List Transactions","prefix":{"name":"get","color":"get"},"badges":[],"link":"/transaction-reports/listtransactions","deprecated":false},{"title":"/v1/transactions/{id}","summary":"Retrieve a Transaction","prefix":{"name":"get","color":"get"},"badges":[],"link":"/transaction-reports/retrievetransaction","deprecated":false}]}]}]}]}},{"type":"separator","label":"Batches","content":null},{"type":"group","label":"Close batches","link":"/apis/openapi/close-batches","routeSlug":"/apis/openapi/close-batches","items":[{"label":"Close a Batch","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/openapi/close-batches/closebatch","routeSlug":"/apis/openapi/close-batches/closebatch","metadata":{"seo":{"title":"Close a Batch","description":"Manually close a batch of transactions. Closing a batch initiates the settlement process for all captured transactions in the batch."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"closeBatch","name":"Close a Batch","isWebhook":false,"pointer":"/paths/~1v1~1batches~1close/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Close a Batch","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Manually close a batch of transactions. Closing a batch initiates the  settlement process for all captured transactions in the batch."},{"nodeType":"security","requirements":[{"schemes":[{"name":"ApiKeyAuth","scopes":[],"type":"apiKey","in":"header","paramName":"Api-Key","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key authentication. Include the API key in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Api-Key"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"WARNING"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": API key-based authentication offers no cryptographic security; always use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.mozilla.org/en-US/docs/Glossary/HTTPS"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"HTTPS"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":":"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"  Api-Key: AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe\n","language":"http"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"  Api-Key: AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe\n"},"children":[]}]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Client-Id","in":"header","schemaId":"schema_26","required":true},{"name":"X-Acting-As-Client-Id","in":"header","schemaId":"schema_26","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The child client this request acts on behalf of. A reseller still authenticates as itself — "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Api-Key"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Client-Id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" stay the reseller's — and names the child here."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This works only from a parent to its own children. Merchants have no children, so a merchant calling as itself omits the header. Sending your own client ULID here is not the same as omitting it, and is rejected on some operations."},"children":[]}]}]}]}],"pointer":"/paths/~1v1~1batches~1close/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/BatchClose"}},"schemaId":"components/schemas/BatchClose","pointer":"/paths/~1v1~1batches~1close/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v1/batches/close","servers":[{"url":"/_mock/apis/openapi","description":"Mock server (simulated responses)","isMockServer":true}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Client-Id","in":"header","required":true,"schemaId":"schema_26"},{"name":"X-Acting-As-Client-Id","in":"header","required":false,"schemaId":"schema_26"}],"cookie":[]},"security":[{"schemes":[{"id":"ApiKeyAuth","type":"apiKey","name":"Api-Key","in":"header"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/BatchClose"}},"responseCodes":["200","400","401","403","404","409","500","502"],"pointer":"/v1/batches/close","href":"close-batches/closebatch","openApiOperationId":"closeBatch","summary":"Close a Batch"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/apis/openapi","description":"Mock server (simulated responses)","isMockServer":true}],"schemaId":"components/schemas/BatchClose","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/BatchClose"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Batch closed successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchCloseResponse"}},"schemaId":"components/schemas/BatchCloseResponse","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"400","description":"Bad request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_28","exampleIds":["paths/~1v1~1batches~1close/post/responses/400/content/application~1json/examples/invalidRequestData"]}},"schemaId":"schema_28","exampleIds":["paths/~1v1~1batches~1close/post/responses/400/content/application~1json/examples/invalidRequestData"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"401","description":"Not authenticated","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_29","exampleIds":["paths/~1v1~1batches~1close/post/responses/401/content/application~1json/examples/notAuthenticated"]}},"schemaId":"schema_29","exampleIds":["paths/~1v1~1batches~1close/post/responses/401/content/application~1json/examples/notAuthenticated"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_30","exampleIds":["paths/~1v1~1batches~1close/post/responses/403/content/application~1json/examples/unauthorizedAction"]}},"schemaId":"schema_30","exampleIds":["paths/~1v1~1batches~1close/post/responses/403/content/application~1json/examples/unauthorizedAction"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_35","exampleIds":["paths/~1v1~1batches~1close/post/responses/404/content/application~1json/examples/resourceNotFound"]}},"schemaId":"schema_35","exampleIds":["paths/~1v1~1batches~1close/post/responses/404/content/application~1json/examples/resourceNotFound"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"409","description":"Conflict","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_31","exampleIds":["paths/~1v1~1batches~1close/post/responses/409/content/application~1json/examples/duplicateAction"]}},"schemaId":"schema_31","exampleIds":["paths/~1v1~1batches~1close/post/responses/409/content/application~1json/examples/duplicateAction"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_32","exampleIds":["paths/~1v1~1batches~1close/post/responses/500/content/application~1json/examples/systemError"]}},"schemaId":"schema_32","exampleIds":["paths/~1v1~1batches~1close/post/responses/500/content/application~1json/examples/systemError"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"502","description":"The gateway reached the downstream processor and could not use its response. Distinct from a 500, which is a fault inside the gateway.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_33","exampleIds":["paths/~1v1~1batches~1close/post/responses/502/content/application~1json/examples/downstreamError"]}},"schemaId":"schema_33","exampleIds":["paths/~1v1~1batches~1close/post/responses/502/content/application~1json/examples/downstreamError"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"}],"pointer":"/paths/~1v1~1batches~1close/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/BatchCloseResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchCloseResponse"}}},{"code":"400","schemaId":"schema_28","exampleIds":["paths/~1v1~1batches~1close/post/responses/400/content/application~1json/examples/invalidRequestData"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_28","exampleIds":["paths/~1v1~1batches~1close/post/responses/400/content/application~1json/examples/invalidRequestData"]}}},{"code":"401","schemaId":"schema_29","exampleIds":["paths/~1v1~1batches~1close/post/responses/401/content/application~1json/examples/notAuthenticated"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_29","exampleIds":["paths/~1v1~1batches~1close/post/responses/401/content/application~1json/examples/notAuthenticated"]}}},{"code":"403","schemaId":"schema_30","exampleIds":["paths/~1v1~1batches~1close/post/responses/403/content/application~1json/examples/unauthorizedAction"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_30","exampleIds":["paths/~1v1~1batches~1close/post/responses/403/content/application~1json/examples/unauthorizedAction"]}}},{"code":"404","schemaId":"schema_35","exampleIds":["paths/~1v1~1batches~1close/post/responses/404/content/application~1json/examples/resourceNotFound"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_35","exampleIds":["paths/~1v1~1batches~1close/post/responses/404/content/application~1json/examples/resourceNotFound"]}}},{"code":"409","schemaId":"schema_31","exampleIds":["paths/~1v1~1batches~1close/post/responses/409/content/application~1json/examples/duplicateAction"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_31","exampleIds":["paths/~1v1~1batches~1close/post/responses/409/content/application~1json/examples/duplicateAction"]}}},{"code":"500","schemaId":"schema_32","exampleIds":["paths/~1v1~1batches~1close/post/responses/500/content/application~1json/examples/systemError"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_32","exampleIds":["paths/~1v1~1batches~1close/post/responses/500/content/application~1json/examples/systemError"]}}},{"code":"502","schemaId":"schema_33","exampleIds":["paths/~1v1~1batches~1close/post/responses/502/content/application~1json/examples/downstreamError"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_33","exampleIds":["paths/~1v1~1batches~1close/post/responses/502/content/application~1json/examples/downstreamError"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/close-batches/closebatch"}],"panels":[]}]},"httpPath":"/v1/batches/close"}],"content":{"contentType":"group","meta":{"name":"Close batches"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Close batches","showPageActions":true},{"nodeType":"markdoc","content":"The Close batches operations includes APIs for closing batches of  transactions."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/v1/batches/close","summary":"Close a Batch","prefix":{"name":"post","color":"post"},"badges":[],"link":"/close-batches/closebatch","deprecated":false}]}]}]}]}},{"type":"group","label":"Batch reports","link":"/apis/openapi/batch-reports","routeSlug":"/apis/openapi/batch-reports","items":[{"label":"List Batches","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/openapi/batch-reports/listbatches","routeSlug":"/apis/openapi/batch-reports/listbatches","metadata":{"seo":{"title":"List Batches","description":"Return a list of batches. Use the query parameters to filter and sort the results."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listBatches","name":"List Batches","isWebhook":false,"pointer":"/paths/~1v1~1batches/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List Batches","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Return a list of batches. Use the query parameters to filter and sort  the results."},{"nodeType":"security","requirements":[{"schemes":[{"name":"ApiKeyAuth","scopes":[],"type":"apiKey","in":"header","paramName":"Api-Key","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key authentication. Include the API key in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Api-Key"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"WARNING"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": API key-based authentication offers no cryptographic security; always use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.mozilla.org/en-US/docs/Glossary/HTTPS"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"HTTPS"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":":"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"  Api-Key: AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe\n","language":"http"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"  Api-Key: AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe\n"},"children":[]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"skip","in":"query","schemaId":"schema_34"},{"name":"take","in":"query","schemaId":"schema_34"},{"name":"sort_column","in":"query","schemaId":"schema_34"},{"name":"sort_order","in":"query","schemaId":"schema_47"},{"name":"search_text","in":"query","schemaId":"schema_34"},{"name":"term","in":"query","schemaId":"schema_34"}],"pointer":"/paths/~1v1~1batches/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Client-Id","in":"header","schemaId":"schema_26","required":true},{"name":"X-Acting-As-Client-Id","in":"header","schemaId":"schema_26","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The child client this request acts on behalf of. A reseller still authenticates as itself — "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Api-Key"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Client-Id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" stay the reseller's — and names the child here."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This works only from a parent to its own children. Merchants have no children, so a merchant calling as itself omits the header. Sending your own client ULID here is not the same as omitting it, and is rejected on some operations."},"children":[]}]}]}]}],"pointer":"/paths/~1v1~1batches/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v1/batches","servers":[{"url":"/_mock/apis/openapi","description":"Mock server (simulated responses)","isMockServer":true}],"parameters":{"path":[],"query":[{"name":"skip","in":"query","schemaId":"schema_34"},{"name":"take","in":"query","schemaId":"schema_34"},{"name":"sort_column","in":"query","schemaId":"schema_34"},{"name":"sort_order","in":"query","schemaId":"components/schemas/SortOrder"},{"name":"search_text","in":"query","schemaId":"schema_34"},{"name":"term","in":"query","schemaId":"schema_34"}],"querystring":[],"header":[{"name":"Client-Id","in":"header","required":true,"schemaId":"schema_26"},{"name":"X-Acting-As-Client-Id","in":"header","required":false,"schemaId":"schema_26"}],"cookie":[]},"security":[{"schemes":[{"id":"ApiKeyAuth","type":"apiKey","name":"Api-Key","in":"header"}],"scopes":[]}],"responseCodes":["200","400","401","403","500"],"pointer":"/v1/batches","href":"batch-reports/listbatches","openApiOperationId":"listBatches","summary":"List Batches"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/apis/openapi","description":"Mock server (simulated responses)","isMockServer":true}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Batch list returned successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchElasticModelTransResponse"}},"schemaId":"components/schemas/BatchElasticModelTransResponse","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"400","description":"Bad request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_28","exampleIds":["paths/~1v1~1batches/get/responses/400/content/application~1json/examples/invalidRequestData"]}},"schemaId":"schema_28","exampleIds":["paths/~1v1~1batches/get/responses/400/content/application~1json/examples/invalidRequestData"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"401","description":"Not authenticated","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_29","exampleIds":["paths/~1v1~1batches/get/responses/401/content/application~1json/examples/notAuthenticated"]}},"schemaId":"schema_29","exampleIds":["paths/~1v1~1batches/get/responses/401/content/application~1json/examples/notAuthenticated"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_30","exampleIds":["paths/~1v1~1batches/get/responses/403/content/application~1json/examples/unauthorizedAction"]}},"schemaId":"schema_30","exampleIds":["paths/~1v1~1batches/get/responses/403/content/application~1json/examples/unauthorizedAction"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_32","exampleIds":["paths/~1v1~1batches/get/responses/500/content/application~1json/examples/systemError"]}},"schemaId":"schema_32","exampleIds":["paths/~1v1~1batches/get/responses/500/content/application~1json/examples/systemError"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"}],"pointer":"/paths/~1v1~1batches/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/BatchElasticModelTransResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchElasticModelTransResponse"}}},{"code":"400","schemaId":"schema_28","exampleIds":["paths/~1v1~1batches/get/responses/400/content/application~1json/examples/invalidRequestData"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_28","exampleIds":["paths/~1v1~1batches/get/responses/400/content/application~1json/examples/invalidRequestData"]}}},{"code":"401","schemaId":"schema_29","exampleIds":["paths/~1v1~1batches/get/responses/401/content/application~1json/examples/notAuthenticated"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_29","exampleIds":["paths/~1v1~1batches/get/responses/401/content/application~1json/examples/notAuthenticated"]}}},{"code":"403","schemaId":"schema_30","exampleIds":["paths/~1v1~1batches/get/responses/403/content/application~1json/examples/unauthorizedAction"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_30","exampleIds":["paths/~1v1~1batches/get/responses/403/content/application~1json/examples/unauthorizedAction"]}}},{"code":"500","schemaId":"schema_32","exampleIds":["paths/~1v1~1batches/get/responses/500/content/application~1json/examples/systemError"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_32","exampleIds":["paths/~1v1~1batches/get/responses/500/content/application~1json/examples/systemError"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/batch-reports/listbatches"}],"panels":[]}]},"httpPath":"/v1/batches"},{"label":"List Batch Status","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/openapi/batch-reports/listbatchstatus","routeSlug":"/apis/openapi/batch-reports/listbatchstatus","metadata":{"seo":{"title":"List Batch Status","description":"Return the status of batches for a client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listBatchStatus","name":"List Batch Status","isWebhook":false,"pointer":"/paths/~1v1~1batches~1status/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List Batch Status","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Return the status of batches for a client."},{"nodeType":"security","requirements":[{"schemes":[{"name":"ApiKeyAuth","scopes":[],"type":"apiKey","in":"header","paramName":"Api-Key","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key authentication. Include the API key in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Api-Key"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"WARNING"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": API key-based authentication offers no cryptographic security; always use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.mozilla.org/en-US/docs/Glossary/HTTPS"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"HTTPS"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":":"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"  Api-Key: AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe\n","language":"http"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"  Api-Key: AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe\n"},"children":[]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"client_id","in":"query","schemaId":"schema_34"},{"name":"last_checked_at","in":"query","schemaId":"schema_44"}],"pointer":"/paths/~1v1~1batches~1status/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Client-Id","in":"header","schemaId":"schema_26","required":true},{"name":"X-Acting-As-Client-Id","in":"header","schemaId":"schema_26","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The child client this request acts on behalf of. A reseller still authenticates as itself — "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Api-Key"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Client-Id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" stay the reseller's — and names the child here."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This works only from a parent to its own children. Merchants have no children, so a merchant calling as itself omits the header. Sending your own client ULID here is not the same as omitting it, and is rejected on some operations."},"children":[]}]}]}]}],"pointer":"/paths/~1v1~1batches~1status/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v1/batches/status","servers":[{"url":"/_mock/apis/openapi","description":"Mock server (simulated responses)","isMockServer":true}],"parameters":{"path":[],"query":[{"name":"client_id","in":"query","schemaId":"schema_34"},{"name":"last_checked_at","in":"query","schemaId":"schema_44"}],"querystring":[],"header":[{"name":"Client-Id","in":"header","required":true,"schemaId":"schema_26"},{"name":"X-Acting-As-Client-Id","in":"header","required":false,"schemaId":"schema_26"}],"cookie":[]},"security":[{"schemes":[{"id":"ApiKeyAuth","type":"apiKey","name":"Api-Key","in":"header"}],"scopes":[]}],"responseCodes":["200","400","401","403","404","500"],"pointer":"/v1/batches/status","href":"batch-reports/listbatchstatus","openApiOperationId":"listBatchStatus","summary":"List Batch Status"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/apis/openapi","description":"Mock server (simulated responses)","isMockServer":true}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Batch status returned successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchStatusResponse"}},"schemaId":"components/schemas/BatchStatusResponse","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"400","description":"Bad request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_28","exampleIds":["paths/~1v1~1batches~1status/get/responses/400/content/application~1json/examples/invalidRequestData"]}},"schemaId":"schema_28","exampleIds":["paths/~1v1~1batches~1status/get/responses/400/content/application~1json/examples/invalidRequestData"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"401","description":"Not authenticated","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_29","exampleIds":["paths/~1v1~1batches~1status/get/responses/401/content/application~1json/examples/notAuthenticated"]}},"schemaId":"schema_29","exampleIds":["paths/~1v1~1batches~1status/get/responses/401/content/application~1json/examples/notAuthenticated"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_30","exampleIds":["paths/~1v1~1batches~1status/get/responses/403/content/application~1json/examples/unauthorizedAction"]}},"schemaId":"schema_30","exampleIds":["paths/~1v1~1batches~1status/get/responses/403/content/application~1json/examples/unauthorizedAction"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_35","exampleIds":["paths/~1v1~1batches~1status/get/responses/404/content/application~1json/examples/resourceNotFound"]}},"schemaId":"schema_35","exampleIds":["paths/~1v1~1batches~1status/get/responses/404/content/application~1json/examples/resourceNotFound"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_32","exampleIds":["paths/~1v1~1batches~1status/get/responses/500/content/application~1json/examples/systemError"]}},"schemaId":"schema_32","exampleIds":["paths/~1v1~1batches~1status/get/responses/500/content/application~1json/examples/systemError"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"}],"pointer":"/paths/~1v1~1batches~1status/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/BatchStatusResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BatchStatusResponse"}}},{"code":"400","schemaId":"schema_28","exampleIds":["paths/~1v1~1batches~1status/get/responses/400/content/application~1json/examples/invalidRequestData"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_28","exampleIds":["paths/~1v1~1batches~1status/get/responses/400/content/application~1json/examples/invalidRequestData"]}}},{"code":"401","schemaId":"schema_29","exampleIds":["paths/~1v1~1batches~1status/get/responses/401/content/application~1json/examples/notAuthenticated"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_29","exampleIds":["paths/~1v1~1batches~1status/get/responses/401/content/application~1json/examples/notAuthenticated"]}}},{"code":"403","schemaId":"schema_30","exampleIds":["paths/~1v1~1batches~1status/get/responses/403/content/application~1json/examples/unauthorizedAction"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_30","exampleIds":["paths/~1v1~1batches~1status/get/responses/403/content/application~1json/examples/unauthorizedAction"]}}},{"code":"404","schemaId":"schema_35","exampleIds":["paths/~1v1~1batches~1status/get/responses/404/content/application~1json/examples/resourceNotFound"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_35","exampleIds":["paths/~1v1~1batches~1status/get/responses/404/content/application~1json/examples/resourceNotFound"]}}},{"code":"500","schemaId":"schema_32","exampleIds":["paths/~1v1~1batches~1status/get/responses/500/content/application~1json/examples/systemError"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_32","exampleIds":["paths/~1v1~1batches~1status/get/responses/500/content/application~1json/examples/systemError"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/batch-reports/listbatchstatus"}],"panels":[]}]},"httpPath":"/v1/batches/status"},{"label":"List Transactions in a Batch without Batch ID","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/openapi/batch-reports/listbatchtransactionsunknownbatchid","routeSlug":"/apis/openapi/batch-reports/listbatchtransactionsunknownbatchid","metadata":{"seo":{"title":"List Transactions in a Batch without Batch ID","description":"Return a list of transactions in a batch without a batch ID. Use this endpoint to return a list of transactions in an open batch. Open batches do not have a batch ID. (Batch ID assigned when settlement request sent to host processor.)"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listBatchTransactionsUnknownBatchId","name":"List Transactions in a Batch without Batch ID","isWebhook":false,"pointer":"/paths/~1v1~1batches~1transactions/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List Transactions in a Batch without Batch ID","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Return a list of transactions in a batch without a batch ID. Use this endpoint to return a list of transactions in an open batch. Open batches do not have a batch ID. (Batch ID assigned when settlement request  sent to host processor.)"},{"nodeType":"security","requirements":[{"schemes":[{"name":"ApiKeyAuth","scopes":[],"type":"apiKey","in":"header","paramName":"Api-Key","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key authentication. Include the API key in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Api-Key"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"WARNING"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": API key-based authentication offers no cryptographic security; always use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.mozilla.org/en-US/docs/Glossary/HTTPS"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"HTTPS"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":":"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"  Api-Key: AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe\n","language":"http"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"  Api-Key: AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe\n"},"children":[]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"limit","in":"query","schemaId":"schema_37","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Maximum number of transactions to return. Range: 1–1000."},"children":[]}]}]}]},{"name":"offset","in":"query","schemaId":"schema_38","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Number of transactions to skip before returning results. Use with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"limit"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to select a specific window. For example, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"offset=20&limit=20"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" returns records 21–40."},"children":[]}]}]}]},{"name":"client_id","in":"query","schemaId":"schema_34","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter results to transactions belonging to a specific client. Resellers use this to view transactions for a child merchant under their account. The authenticated caller must have permission to access the specified client's data. More than one  client_id can be included by using a comma-separated list."},"children":[]}]}]}],"examples":{"merchant":{"value":"CLIENT-01KFDKXMQ637EKEAY410MSQSXB"}}},{"name":"integration","in":"query","schemaId":"schema_41","description":"Filter results to transactions belonging to a specific integration  (e.g., payment processor such as TSYS or Vericheck)."},{"name":"card_type","in":"query","schemaId":"schema_48","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filters open-batch transactions by card type. Send a single value; this filter does not accept a list. Values are matched case-insensitively."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Two differences from the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"card_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" filter on "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v1/transactions"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are worth knowing before you rely on this one. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"UNKNOWN"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is rejected with a 400, because open-batch eligibility has no bucket for an undetermined card type. And "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"CREDIT"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" returns transactions whose card type is credit "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"or"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" undetermined, since the two are grouped together here. So the same value selects a wider set of rows on this operation than on "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v1/transactions"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"name":"created_at","in":"query","schemaId":"schema_49","description":"Filter by time created."},{"name":"timezone","in":"query","schemaId":"schema_50","description":"The time zone of the account."}],"pointer":"/paths/~1v1~1batches~1transactions/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Client-Id","in":"header","schemaId":"schema_26","required":true},{"name":"X-Acting-As-Client-Id","in":"header","schemaId":"schema_26","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The child client this request acts on behalf of. A reseller still authenticates as itself — "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Api-Key"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Client-Id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" stay the reseller's — and names the child here."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This works only from a parent to its own children. Merchants have no children, so a merchant calling as itself omits the header. Sending your own client ULID here is not the same as omitting it, and is rejected on some operations."},"children":[]}]}]}]}],"pointer":"/paths/~1v1~1batches~1transactions/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v1/batches/transactions","servers":[{"url":"/_mock/apis/openapi","description":"Mock server (simulated responses)","isMockServer":true}],"parameters":{"path":[],"query":[{"name":"limit","in":"query","required":false,"schemaId":"schema_37"},{"name":"offset","in":"query","required":false,"schemaId":"schema_38"},{"name":"client_id","in":"query","required":false,"example":"CLIENT-01KFDKXMQ637EKEAY410MSQSXB","schemaId":"schema_34","style":"form","explode":true},{"name":"integration","in":"query","required":false,"schemaId":"schema_41"},{"name":"card_type","in":"query","required":false,"schemaId":"components/schemas/OpenBatchCardType"},{"name":"created_at","in":"query","required":false,"schemaId":"schema_49"},{"name":"timezone","in":"query","required":false,"schemaId":"schema_50"}],"querystring":[],"header":[{"name":"Client-Id","in":"header","required":true,"schemaId":"schema_26"},{"name":"X-Acting-As-Client-Id","in":"header","required":false,"schemaId":"schema_26"}],"cookie":[]},"security":[{"schemes":[{"id":"ApiKeyAuth","type":"apiKey","name":"Api-Key","in":"header"}],"scopes":[]}],"responseCodes":["200","400","401","403","500"],"pointer":"/v1/batches/transactions","href":"batch-reports/listbatchtransactionsunknownbatchid","openApiOperationId":"listBatchTransactionsUnknownBatchId","summary":"List Transactions in a Batch without Batch ID"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/apis/openapi","description":"Mock server (simulated responses)","isMockServer":true}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Transaction list returned successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TransactionsListResponse"}},"schemaId":"components/schemas/TransactionsListResponse","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"400","description":"Bad request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_28","exampleIds":["paths/~1v1~1batches~1transactions/get/responses/400/content/application~1json/examples/invalidRequestData"]}},"schemaId":"schema_28","exampleIds":["paths/~1v1~1batches~1transactions/get/responses/400/content/application~1json/examples/invalidRequestData"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"401","description":"Not authenticated","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_29","exampleIds":["paths/~1v1~1batches~1transactions/get/responses/401/content/application~1json/examples/notAuthenticated"]}},"schemaId":"schema_29","exampleIds":["paths/~1v1~1batches~1transactions/get/responses/401/content/application~1json/examples/notAuthenticated"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_30","exampleIds":["paths/~1v1~1batches~1transactions/get/responses/403/content/application~1json/examples/unauthorizedAction"]}},"schemaId":"schema_30","exampleIds":["paths/~1v1~1batches~1transactions/get/responses/403/content/application~1json/examples/unauthorizedAction"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_32","exampleIds":["paths/~1v1~1batches~1transactions/get/responses/500/content/application~1json/examples/systemError"]}},"schemaId":"schema_32","exampleIds":["paths/~1v1~1batches~1transactions/get/responses/500/content/application~1json/examples/systemError"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"}],"pointer":"/paths/~1v1~1batches~1transactions/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/TransactionsListResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TransactionsListResponse"}}},{"code":"400","schemaId":"schema_28","exampleIds":["paths/~1v1~1batches~1transactions/get/responses/400/content/application~1json/examples/invalidRequestData"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_28","exampleIds":["paths/~1v1~1batches~1transactions/get/responses/400/content/application~1json/examples/invalidRequestData"]}}},{"code":"401","schemaId":"schema_29","exampleIds":["paths/~1v1~1batches~1transactions/get/responses/401/content/application~1json/examples/notAuthenticated"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_29","exampleIds":["paths/~1v1~1batches~1transactions/get/responses/401/content/application~1json/examples/notAuthenticated"]}}},{"code":"403","schemaId":"schema_30","exampleIds":["paths/~1v1~1batches~1transactions/get/responses/403/content/application~1json/examples/unauthorizedAction"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_30","exampleIds":["paths/~1v1~1batches~1transactions/get/responses/403/content/application~1json/examples/unauthorizedAction"]}}},{"code":"500","schemaId":"schema_32","exampleIds":["paths/~1v1~1batches~1transactions/get/responses/500/content/application~1json/examples/systemError"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_32","exampleIds":["paths/~1v1~1batches~1transactions/get/responses/500/content/application~1json/examples/systemError"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/batch-reports/listbatchtransactionsunknownbatchid"}],"panels":[]}]},"httpPath":"/v1/batches/transactions"},{"label":"List Transactions in a Batch with Batch ID","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/openapi/batch-reports/listbatchtransactions","routeSlug":"/apis/openapi/batch-reports/listbatchtransactions","metadata":{"seo":{"title":"List Transactions in a Batch with Batch ID","description":"Return a list of transactions in a batch."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listBatchTransactions","name":"List Transactions in a Batch with Batch ID","isWebhook":false,"pointer":"/paths/~1v1~1batches~1{id}~1transactions/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List Transactions in a Batch with Batch ID","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Return a list of transactions in a batch."},{"nodeType":"security","requirements":[{"schemes":[{"name":"ApiKeyAuth","scopes":[],"type":"apiKey","in":"header","paramName":"Api-Key","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key authentication. Include the API key in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Api-Key"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"WARNING"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": API key-based authentication offers no cryptographic security; always use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.mozilla.org/en-US/docs/Glossary/HTTPS"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"HTTPS"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":":"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"  Api-Key: AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe\n","language":"http"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"  Api-Key: AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe\n"},"children":[]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_34","required":true}],"pointer":"/paths/~1v1~1batches~1{id}~1transactions/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"limit","in":"query","schemaId":"schema_37","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Maximum number of transactions to return. Range: 1–1000."},"children":[]}]}]}]},{"name":"offset","in":"query","schemaId":"schema_38","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Number of transactions to skip before returning results. Use with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"limit"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to select a specific window. For example, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"offset=20&limit=20"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" returns records 21–40."},"children":[]}]}]}]},{"name":"include_bad_transactions","in":"query","schemaId":"schema_51","description":"Include bad transactions in the response. Bad transactions are  transactions that failed to process due to errors or other issues."}],"pointer":"/paths/~1v1~1batches~1{id}~1transactions/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Client-Id","in":"header","schemaId":"schema_26","required":true},{"name":"X-Acting-As-Client-Id","in":"header","schemaId":"schema_26","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The child client this request acts on behalf of. A reseller still authenticates as itself — "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Api-Key"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Client-Id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" stay the reseller's — and names the child here."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This works only from a parent to its own children. Merchants have no children, so a merchant calling as itself omits the header. Sending your own client ULID here is not the same as omitting it, and is rejected on some operations."},"children":[]}]}]}]}],"pointer":"/paths/~1v1~1batches~1{id}~1transactions/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v1/batches/{id}/transactions","servers":[{"url":"/_mock/apis/openapi","description":"Mock server (simulated responses)","isMockServer":true}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_34"}],"query":[{"name":"limit","in":"query","required":false,"schemaId":"schema_37"},{"name":"offset","in":"query","required":false,"schemaId":"schema_38"},{"name":"include_bad_transactions","in":"query","required":false,"schemaId":"schema_51"}],"querystring":[],"header":[{"name":"Client-Id","in":"header","required":true,"schemaId":"schema_26"},{"name":"X-Acting-As-Client-Id","in":"header","required":false,"schemaId":"schema_26"}],"cookie":[]},"security":[{"schemes":[{"id":"ApiKeyAuth","type":"apiKey","name":"Api-Key","in":"header"}],"scopes":[]}],"responseCodes":["200","400","401","403","404","500"],"pointer":"/v1/batches/{id}/transactions","href":"batch-reports/listbatchtransactions","openApiOperationId":"listBatchTransactions","summary":"List Transactions in a Batch with Batch ID"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/apis/openapi","description":"Mock server (simulated responses)","isMockServer":true}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Transaction list returned successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TransactionsListResponse"}},"schemaId":"components/schemas/TransactionsListResponse","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"400","description":"Bad request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_28","exampleIds":["paths/~1v1~1batches~1{id}~1transactions/get/responses/400/content/application~1json/examples/invalidRequestData"]}},"schemaId":"schema_28","exampleIds":["paths/~1v1~1batches~1{id}~1transactions/get/responses/400/content/application~1json/examples/invalidRequestData"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"401","description":"Not authenticated","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_29","exampleIds":["paths/~1v1~1batches~1{id}~1transactions/get/responses/401/content/application~1json/examples/notAuthenticated"]}},"schemaId":"schema_29","exampleIds":["paths/~1v1~1batches~1{id}~1transactions/get/responses/401/content/application~1json/examples/notAuthenticated"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_30","exampleIds":["paths/~1v1~1batches~1{id}~1transactions/get/responses/403/content/application~1json/examples/unauthorizedAction"]}},"schemaId":"schema_30","exampleIds":["paths/~1v1~1batches~1{id}~1transactions/get/responses/403/content/application~1json/examples/unauthorizedAction"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_35","exampleIds":["paths/~1v1~1batches~1{id}~1transactions/get/responses/404/content/application~1json/examples/resourceNotFound"]}},"schemaId":"schema_35","exampleIds":["paths/~1v1~1batches~1{id}~1transactions/get/responses/404/content/application~1json/examples/resourceNotFound"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_32","exampleIds":["paths/~1v1~1batches~1{id}~1transactions/get/responses/500/content/application~1json/examples/systemError"]}},"schemaId":"schema_32","exampleIds":["paths/~1v1~1batches~1{id}~1transactions/get/responses/500/content/application~1json/examples/systemError"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"}],"pointer":"/paths/~1v1~1batches~1{id}~1transactions/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/TransactionsListResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TransactionsListResponse"}}},{"code":"400","schemaId":"schema_28","exampleIds":["paths/~1v1~1batches~1{id}~1transactions/get/responses/400/content/application~1json/examples/invalidRequestData"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_28","exampleIds":["paths/~1v1~1batches~1{id}~1transactions/get/responses/400/content/application~1json/examples/invalidRequestData"]}}},{"code":"401","schemaId":"schema_29","exampleIds":["paths/~1v1~1batches~1{id}~1transactions/get/responses/401/content/application~1json/examples/notAuthenticated"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_29","exampleIds":["paths/~1v1~1batches~1{id}~1transactions/get/responses/401/content/application~1json/examples/notAuthenticated"]}}},{"code":"403","schemaId":"schema_30","exampleIds":["paths/~1v1~1batches~1{id}~1transactions/get/responses/403/content/application~1json/examples/unauthorizedAction"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_30","exampleIds":["paths/~1v1~1batches~1{id}~1transactions/get/responses/403/content/application~1json/examples/unauthorizedAction"]}}},{"code":"404","schemaId":"schema_35","exampleIds":["paths/~1v1~1batches~1{id}~1transactions/get/responses/404/content/application~1json/examples/resourceNotFound"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_35","exampleIds":["paths/~1v1~1batches~1{id}~1transactions/get/responses/404/content/application~1json/examples/resourceNotFound"]}}},{"code":"500","schemaId":"schema_32","exampleIds":["paths/~1v1~1batches~1{id}~1transactions/get/responses/500/content/application~1json/examples/systemError"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_32","exampleIds":["paths/~1v1~1batches~1{id}~1transactions/get/responses/500/content/application~1json/examples/systemError"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/batch-reports/listbatchtransactions"}],"panels":[]}]},"httpPath":"/v1/batches/{id}/transactions"}],"content":{"contentType":"group","meta":{"name":"Batch reports"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Batch reports","showPageActions":true},{"nodeType":"markdoc","content":"The Batch reports operations includes APIs for generating reports on  batches."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/v1/batches","summary":"List Batches","prefix":{"name":"get","color":"get"},"badges":[],"link":"/batch-reports/listbatches","deprecated":false},{"title":"/v1/batches/status","summary":"List Batch Status","prefix":{"name":"get","color":"get"},"badges":[],"link":"/batch-reports/listbatchstatus","deprecated":false},{"title":"/v1/batches/transactions","summary":"List Transactions in a Batch without Batch ID","prefix":{"name":"get","color":"get"},"badges":[],"link":"/batch-reports/listbatchtransactionsunknownbatchid","deprecated":false},{"title":"/v1/batches/{id}/transactions","summary":"List Transactions in a Batch with Batch ID","prefix":{"name":"get","color":"get"},"badges":[],"link":"/batch-reports/listbatchtransactions","deprecated":false}]}]}]}]}},{"type":"separator","label":"Client Accounts","content":null},{"type":"group","label":"Client management","link":"/apis/openapi/client-management","routeSlug":"/apis/openapi/client-management","items":[{"label":"Create a Client","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/openapi/client-management/createclient","routeSlug":"/apis/openapi/client-management/createclient","metadata":{"seo":{"title":"Create a Client","description":"Create a new client account. Client types include reseller and merchant."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createClient","name":"Create a Client","isWebhook":false,"pointer":"/paths/~1v1~1clients/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a Client","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create a new client account. Client types include "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"reseller"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"merchant"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"ApiKeyAuth","scopes":[],"type":"apiKey","in":"header","paramName":"Api-Key","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key authentication. Include the API key in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Api-Key"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"WARNING"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": API key-based authentication offers no cryptographic security; always use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.mozilla.org/en-US/docs/Glossary/HTTPS"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"HTTPS"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":":"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"  Api-Key: AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe\n","language":"http"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"  Api-Key: AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe\n"},"children":[]}]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Client-Id","in":"header","schemaId":"schema_26","required":true},{"name":"X-Acting-As-Client-Id","in":"header","schemaId":"schema_26","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The child client this request acts on behalf of. A reseller still authenticates as itself — "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Api-Key"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Client-Id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" stay the reseller's — and names the child here."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This works only from a parent to its own children. Merchants have no children, so a merchant calling as itself omits the header. Sending your own client ULID here is not the same as omitting it, and is rejected on some operations."},"children":[]}]}]}]}],"pointer":"/paths/~1v1~1clients/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateClientRequest"}},"schemaId":"components/schemas/CreateClientRequest","pointer":"/paths/~1v1~1clients/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v1/clients","servers":[{"url":"/_mock/apis/openapi","description":"Mock server (simulated responses)","isMockServer":true}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Client-Id","in":"header","required":true,"schemaId":"schema_26"},{"name":"X-Acting-As-Client-Id","in":"header","required":false,"schemaId":"schema_26"}],"cookie":[]},"security":[{"schemes":[{"id":"ApiKeyAuth","type":"apiKey","name":"Api-Key","in":"header"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateClientRequest"}},"responseCodes":["200","400","401","403","409","500"],"pointer":"/v1/clients","href":"client-management/createclient","openApiOperationId":"createClient","summary":"Create a Client"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/apis/openapi","description":"Mock server (simulated responses)","isMockServer":true}],"schemaId":"components/schemas/CreateClientRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateClientRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Client account created successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CreateClientResponse"}},"schemaId":"components/schemas/CreateClientResponse","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"400","description":"Bad request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_28","exampleIds":["paths/~1v1~1clients/post/responses/400/content/application~1json/examples/invalidRequestData"]}},"schemaId":"schema_28","exampleIds":["paths/~1v1~1clients/post/responses/400/content/application~1json/examples/invalidRequestData"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"401","description":"Not authenticated","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_29","exampleIds":["paths/~1v1~1clients/post/responses/401/content/application~1json/examples/notAuthenticated"]}},"schemaId":"schema_29","exampleIds":["paths/~1v1~1clients/post/responses/401/content/application~1json/examples/notAuthenticated"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_30","exampleIds":["paths/~1v1~1clients/post/responses/403/content/application~1json/examples/unauthorizedAction"]}},"schemaId":"schema_30","exampleIds":["paths/~1v1~1clients/post/responses/403/content/application~1json/examples/unauthorizedAction"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"409","description":"Conflict","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_31","exampleIds":["paths/~1v1~1clients/post/responses/409/content/application~1json/examples/duplicateAction"]}},"schemaId":"schema_31","exampleIds":["paths/~1v1~1clients/post/responses/409/content/application~1json/examples/duplicateAction"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_32","exampleIds":["paths/~1v1~1clients/post/responses/500/content/application~1json/examples/systemError"]}},"schemaId":"schema_32","exampleIds":["paths/~1v1~1clients/post/responses/500/content/application~1json/examples/systemError"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"}],"pointer":"/paths/~1v1~1clients/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/CreateClientResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CreateClientResponse"}}},{"code":"400","schemaId":"schema_28","exampleIds":["paths/~1v1~1clients/post/responses/400/content/application~1json/examples/invalidRequestData"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_28","exampleIds":["paths/~1v1~1clients/post/responses/400/content/application~1json/examples/invalidRequestData"]}}},{"code":"401","schemaId":"schema_29","exampleIds":["paths/~1v1~1clients/post/responses/401/content/application~1json/examples/notAuthenticated"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_29","exampleIds":["paths/~1v1~1clients/post/responses/401/content/application~1json/examples/notAuthenticated"]}}},{"code":"403","schemaId":"schema_30","exampleIds":["paths/~1v1~1clients/post/responses/403/content/application~1json/examples/unauthorizedAction"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_30","exampleIds":["paths/~1v1~1clients/post/responses/403/content/application~1json/examples/unauthorizedAction"]}}},{"code":"409","schemaId":"schema_31","exampleIds":["paths/~1v1~1clients/post/responses/409/content/application~1json/examples/duplicateAction"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_31","exampleIds":["paths/~1v1~1clients/post/responses/409/content/application~1json/examples/duplicateAction"]}}},{"code":"500","schemaId":"schema_32","exampleIds":["paths/~1v1~1clients/post/responses/500/content/application~1json/examples/systemError"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_32","exampleIds":["paths/~1v1~1clients/post/responses/500/content/application~1json/examples/systemError"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/client-management/createclient"}],"panels":[]}]},"httpPath":"/v1/clients"},{"label":"Update a Client","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/openapi/client-management/updateclient","routeSlug":"/apis/openapi/client-management/updateclient","metadata":{"seo":{"title":"Update a Client","description":"Update an existing client account."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateClient","name":"Update a Client","isWebhook":false,"pointer":"/paths/~1v1~1clients~1{clientId}/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a Client","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Update an existing client account."},{"nodeType":"security","requirements":[{"schemes":[{"name":"ApiKeyAuth","scopes":[],"type":"apiKey","in":"header","paramName":"Api-Key","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key authentication. Include the API key in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Api-Key"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"WARNING"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": API key-based authentication offers no cryptographic security; always use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.mozilla.org/en-US/docs/Glossary/HTTPS"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"HTTPS"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":":"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"  Api-Key: AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe\n","language":"http"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"  Api-Key: AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe\n"},"children":[]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"clientId","in":"path","schemaId":"schema_34","required":true}],"pointer":"/paths/~1v1~1clients~1{clientId}/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Client-Id","in":"header","schemaId":"schema_26","required":true},{"name":"X-Acting-As-Client-Id","in":"header","schemaId":"schema_26","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The child client this request acts on behalf of. A reseller still authenticates as itself — "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Api-Key"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Client-Id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" stay the reseller's — and names the child here."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This works only from a parent to its own children. Merchants have no children, so a merchant calling as itself omits the header. Sending your own client ULID here is not the same as omitting it, and is rejected on some operations."},"children":[]}]}]}]}],"pointer":"/paths/~1v1~1clients~1{clientId}/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateClientsRequest"}},"schemaId":"components/schemas/UpdateClientsRequest","pointer":"/paths/~1v1~1clients~1{clientId}/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v1/clients/{clientId}","servers":[{"url":"/_mock/apis/openapi","description":"Mock server (simulated responses)","isMockServer":true}],"parameters":{"path":[{"name":"clientId","in":"path","required":true,"schemaId":"schema_34"}],"query":[],"querystring":[],"header":[{"name":"Client-Id","in":"header","required":true,"schemaId":"schema_26"},{"name":"X-Acting-As-Client-Id","in":"header","required":false,"schemaId":"schema_26"}],"cookie":[]},"security":[{"schemes":[{"id":"ApiKeyAuth","type":"apiKey","name":"Api-Key","in":"header"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UpdateClientsRequest"}},"responseCodes":["200","400","401","403","404","409","500"],"pointer":"/v1/clients/{clientId}","href":"client-management/updateclient","openApiOperationId":"updateClient","summary":"Update a Client"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/apis/openapi","description":"Mock server (simulated responses)","isMockServer":true}],"schemaId":"components/schemas/UpdateClientsRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateClientsRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Client updated successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/UpdateClientsResponse"}},"schemaId":"components/schemas/UpdateClientsResponse","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"400","description":"Bad request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_28","exampleIds":["paths/~1v1~1clients~1{clientId}/post/responses/400/content/application~1json/examples/invalidRequestData"]}},"schemaId":"schema_28","exampleIds":["paths/~1v1~1clients~1{clientId}/post/responses/400/content/application~1json/examples/invalidRequestData"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"401","description":"Not authenticated","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_29","exampleIds":["paths/~1v1~1clients~1{clientId}/post/responses/401/content/application~1json/examples/notAuthenticated"]}},"schemaId":"schema_29","exampleIds":["paths/~1v1~1clients~1{clientId}/post/responses/401/content/application~1json/examples/notAuthenticated"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_30","exampleIds":["paths/~1v1~1clients~1{clientId}/post/responses/403/content/application~1json/examples/unauthorizedAction"]}},"schemaId":"schema_30","exampleIds":["paths/~1v1~1clients~1{clientId}/post/responses/403/content/application~1json/examples/unauthorizedAction"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_35","exampleIds":["paths/~1v1~1clients~1{clientId}/post/responses/404/content/application~1json/examples/resourceNotFound"]}},"schemaId":"schema_35","exampleIds":["paths/~1v1~1clients~1{clientId}/post/responses/404/content/application~1json/examples/resourceNotFound"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"409","description":"Conflict","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_31","exampleIds":["paths/~1v1~1clients~1{clientId}/post/responses/409/content/application~1json/examples/duplicateAction"]}},"schemaId":"schema_31","exampleIds":["paths/~1v1~1clients~1{clientId}/post/responses/409/content/application~1json/examples/duplicateAction"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_32","exampleIds":["paths/~1v1~1clients~1{clientId}/post/responses/500/content/application~1json/examples/systemError"]}},"schemaId":"schema_32","exampleIds":["paths/~1v1~1clients~1{clientId}/post/responses/500/content/application~1json/examples/systemError"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"}],"pointer":"/paths/~1v1~1clients~1{clientId}/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/UpdateClientsResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/UpdateClientsResponse"}}},{"code":"400","schemaId":"schema_28","exampleIds":["paths/~1v1~1clients~1{clientId}/post/responses/400/content/application~1json/examples/invalidRequestData"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_28","exampleIds":["paths/~1v1~1clients~1{clientId}/post/responses/400/content/application~1json/examples/invalidRequestData"]}}},{"code":"401","schemaId":"schema_29","exampleIds":["paths/~1v1~1clients~1{clientId}/post/responses/401/content/application~1json/examples/notAuthenticated"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_29","exampleIds":["paths/~1v1~1clients~1{clientId}/post/responses/401/content/application~1json/examples/notAuthenticated"]}}},{"code":"403","schemaId":"schema_30","exampleIds":["paths/~1v1~1clients~1{clientId}/post/responses/403/content/application~1json/examples/unauthorizedAction"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_30","exampleIds":["paths/~1v1~1clients~1{clientId}/post/responses/403/content/application~1json/examples/unauthorizedAction"]}}},{"code":"404","schemaId":"schema_35","exampleIds":["paths/~1v1~1clients~1{clientId}/post/responses/404/content/application~1json/examples/resourceNotFound"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_35","exampleIds":["paths/~1v1~1clients~1{clientId}/post/responses/404/content/application~1json/examples/resourceNotFound"]}}},{"code":"409","schemaId":"schema_31","exampleIds":["paths/~1v1~1clients~1{clientId}/post/responses/409/content/application~1json/examples/duplicateAction"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_31","exampleIds":["paths/~1v1~1clients~1{clientId}/post/responses/409/content/application~1json/examples/duplicateAction"]}}},{"code":"500","schemaId":"schema_32","exampleIds":["paths/~1v1~1clients~1{clientId}/post/responses/500/content/application~1json/examples/systemError"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_32","exampleIds":["paths/~1v1~1clients~1{clientId}/post/responses/500/content/application~1json/examples/systemError"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/client-management/updateclient"}],"panels":[]}]},"httpPath":"/v1/clients/{clientId}"}],"content":{"contentType":"group","meta":{"name":"Client management"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Client management","showPageActions":true},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Client Management operations includes APIs for managing client  accounts. Client types include "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"RESELLER"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"MERCHANT"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/v1/clients","summary":"Create a Client","prefix":{"name":"post","color":"post"},"badges":[],"link":"/client-management/createclient","deprecated":false},{"title":"/v1/clients/{clientId}","summary":"Update a Client","prefix":{"name":"post","color":"post"},"badges":[],"link":"/client-management/updateclient","deprecated":false}]}]}]}]}},{"type":"group","label":"Client reports","link":"/apis/openapi/client-reports","routeSlug":"/apis/openapi/client-reports","items":[{"label":"List all Clients","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/openapi/client-reports/listclients","routeSlug":"/apis/openapi/client-reports/listclients","metadata":{"seo":{"title":"List all Clients","description":"Return a list of all client accounts."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listClients","name":"List all Clients","isWebhook":false,"pointer":"/paths/~1v1~1clients/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List all Clients","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Return a list of all client accounts."},{"nodeType":"security","requirements":[{"schemes":[{"name":"ApiKeyAuth","scopes":[],"type":"apiKey","in":"header","paramName":"Api-Key","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key authentication. Include the API key in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Api-Key"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"WARNING"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": API key-based authentication offers no cryptographic security; always use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.mozilla.org/en-US/docs/Glossary/HTTPS"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"HTTPS"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":":"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"  Api-Key: AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe\n","language":"http"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"  Api-Key: AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe\n"},"children":[]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"Take","in":"query","schemaId":"schema_34"},{"name":"Skip","in":"query","schemaId":"schema_34"},{"name":"SortColumn","in":"query","schemaId":"schema_34"},{"name":"SortOrder","in":"query","schemaId":"schema_47"},{"name":"SearchText","in":"query","schemaId":"schema_34"},{"name":"Term","in":"query","schemaId":"schema_34"}],"pointer":"/paths/~1v1~1clients/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Client-Id","in":"header","schemaId":"schema_26","required":true},{"name":"X-Acting-As-Client-Id","in":"header","schemaId":"schema_26","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The child client this request acts on behalf of. A reseller still authenticates as itself — "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Api-Key"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Client-Id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" stay the reseller's — and names the child here."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This works only from a parent to its own children. Merchants have no children, so a merchant calling as itself omits the header. Sending your own client ULID here is not the same as omitting it, and is rejected on some operations."},"children":[]}]}]}]}],"pointer":"/paths/~1v1~1clients/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v1/clients","servers":[{"url":"/_mock/apis/openapi","description":"Mock server (simulated responses)","isMockServer":true}],"parameters":{"path":[],"query":[{"name":"Take","in":"query","schemaId":"schema_34"},{"name":"Skip","in":"query","schemaId":"schema_34"},{"name":"SortColumn","in":"query","schemaId":"schema_34"},{"name":"SortOrder","in":"query","schemaId":"components/schemas/SortOrder"},{"name":"SearchText","in":"query","schemaId":"schema_34"},{"name":"Term","in":"query","schemaId":"schema_34"}],"querystring":[],"header":[{"name":"Client-Id","in":"header","required":true,"schemaId":"schema_26"},{"name":"X-Acting-As-Client-Id","in":"header","required":false,"schemaId":"schema_26"}],"cookie":[]},"security":[{"schemes":[{"id":"ApiKeyAuth","type":"apiKey","name":"Api-Key","in":"header"}],"scopes":[]}],"responseCodes":["200","400","401","403","500"],"pointer":"/v1/clients","href":"client-reports/listclients","openApiOperationId":"listClients","summary":"List all Clients"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/apis/openapi","description":"Mock server (simulated responses)","isMockServer":true}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Client list returned successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/GetAllClientsResponse"}},"schemaId":"components/schemas/GetAllClientsResponse","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"400","description":"Bad request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_28","exampleIds":["paths/~1v1~1clients/get/responses/400/content/application~1json/examples/invalidRequestData"]}},"schemaId":"schema_28","exampleIds":["paths/~1v1~1clients/get/responses/400/content/application~1json/examples/invalidRequestData"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"401","description":"Not authenticated","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_29","exampleIds":["paths/~1v1~1clients/get/responses/401/content/application~1json/examples/notAuthenticated"]}},"schemaId":"schema_29","exampleIds":["paths/~1v1~1clients/get/responses/401/content/application~1json/examples/notAuthenticated"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_30","exampleIds":["paths/~1v1~1clients/get/responses/403/content/application~1json/examples/unauthorizedAction"]}},"schemaId":"schema_30","exampleIds":["paths/~1v1~1clients/get/responses/403/content/application~1json/examples/unauthorizedAction"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_32","exampleIds":["paths/~1v1~1clients/get/responses/500/content/application~1json/examples/systemError"]}},"schemaId":"schema_32","exampleIds":["paths/~1v1~1clients/get/responses/500/content/application~1json/examples/systemError"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"}],"pointer":"/paths/~1v1~1clients/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/GetAllClientsResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/GetAllClientsResponse"}}},{"code":"400","schemaId":"schema_28","exampleIds":["paths/~1v1~1clients/get/responses/400/content/application~1json/examples/invalidRequestData"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_28","exampleIds":["paths/~1v1~1clients/get/responses/400/content/application~1json/examples/invalidRequestData"]}}},{"code":"401","schemaId":"schema_29","exampleIds":["paths/~1v1~1clients/get/responses/401/content/application~1json/examples/notAuthenticated"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_29","exampleIds":["paths/~1v1~1clients/get/responses/401/content/application~1json/examples/notAuthenticated"]}}},{"code":"403","schemaId":"schema_30","exampleIds":["paths/~1v1~1clients/get/responses/403/content/application~1json/examples/unauthorizedAction"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_30","exampleIds":["paths/~1v1~1clients/get/responses/403/content/application~1json/examples/unauthorizedAction"]}}},{"code":"500","schemaId":"schema_32","exampleIds":["paths/~1v1~1clients/get/responses/500/content/application~1json/examples/systemError"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_32","exampleIds":["paths/~1v1~1clients/get/responses/500/content/application~1json/examples/systemError"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/client-reports/listclients"}],"panels":[]}]},"httpPath":"/v1/clients"},{"label":"Retrieve a Client","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/openapi/client-reports/getclient","routeSlug":"/apis/openapi/client-reports/getclient","metadata":{"seo":{"title":"Retrieve a Client","description":"Retrieve details of a specific client account."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getClient","name":"Retrieve a Client","isWebhook":false,"pointer":"/paths/~1v1~1clients~1{clientId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve a Client","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieve details of a specific client account."},{"nodeType":"security","requirements":[{"schemes":[{"name":"ApiKeyAuth","scopes":[],"type":"apiKey","in":"header","paramName":"Api-Key","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key authentication. Include the API key in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Api-Key"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"WARNING"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": API key-based authentication offers no cryptographic security; always use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.mozilla.org/en-US/docs/Glossary/HTTPS"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"HTTPS"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":":"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"  Api-Key: AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe\n","language":"http"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"  Api-Key: AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe\n"},"children":[]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"clientId","in":"path","schemaId":"schema_34","required":true}],"pointer":"/paths/~1v1~1clients~1{clientId}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Client-Id","in":"header","schemaId":"schema_26","required":true},{"name":"X-Acting-As-Client-Id","in":"header","schemaId":"schema_26","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The child client this request acts on behalf of. A reseller still authenticates as itself — "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Api-Key"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Client-Id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" stay the reseller's — and names the child here."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This works only from a parent to its own children. Merchants have no children, so a merchant calling as itself omits the header. Sending your own client ULID here is not the same as omitting it, and is rejected on some operations."},"children":[]}]}]}]}],"pointer":"/paths/~1v1~1clients~1{clientId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v1/clients/{clientId}","servers":[{"url":"/_mock/apis/openapi","description":"Mock server (simulated responses)","isMockServer":true}],"parameters":{"path":[{"name":"clientId","in":"path","required":true,"schemaId":"schema_34"}],"query":[],"querystring":[],"header":[{"name":"Client-Id","in":"header","required":true,"schemaId":"schema_26"},{"name":"X-Acting-As-Client-Id","in":"header","required":false,"schemaId":"schema_26"}],"cookie":[]},"security":[{"schemes":[{"id":"ApiKeyAuth","type":"apiKey","name":"Api-Key","in":"header"}],"scopes":[]}],"responseCodes":["200","400","401","403","404","500"],"pointer":"/v1/clients/{clientId}","href":"client-reports/getclient","openApiOperationId":"getClient","summary":"Retrieve a Client"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/apis/openapi","description":"Mock server (simulated responses)","isMockServer":true}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Client details retrieved successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/GetClientResponse"}},"schemaId":"components/schemas/GetClientResponse","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"400","description":"Bad request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_28","exampleIds":["paths/~1v1~1clients~1{clientId}/get/responses/400/content/application~1json/examples/invalidRequestData"]}},"schemaId":"schema_28","exampleIds":["paths/~1v1~1clients~1{clientId}/get/responses/400/content/application~1json/examples/invalidRequestData"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"401","description":"Not authenticated","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_29","exampleIds":["paths/~1v1~1clients~1{clientId}/get/responses/401/content/application~1json/examples/notAuthenticated"]}},"schemaId":"schema_29","exampleIds":["paths/~1v1~1clients~1{clientId}/get/responses/401/content/application~1json/examples/notAuthenticated"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_30","exampleIds":["paths/~1v1~1clients~1{clientId}/get/responses/403/content/application~1json/examples/unauthorizedAction"]}},"schemaId":"schema_30","exampleIds":["paths/~1v1~1clients~1{clientId}/get/responses/403/content/application~1json/examples/unauthorizedAction"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_35","exampleIds":["paths/~1v1~1clients~1{clientId}/get/responses/404/content/application~1json/examples/resourceNotFound"]}},"schemaId":"schema_35","exampleIds":["paths/~1v1~1clients~1{clientId}/get/responses/404/content/application~1json/examples/resourceNotFound"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_32","exampleIds":["paths/~1v1~1clients~1{clientId}/get/responses/500/content/application~1json/examples/systemError"]}},"schemaId":"schema_32","exampleIds":["paths/~1v1~1clients~1{clientId}/get/responses/500/content/application~1json/examples/systemError"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"}],"pointer":"/paths/~1v1~1clients~1{clientId}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/GetClientResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/GetClientResponse"}}},{"code":"400","schemaId":"schema_28","exampleIds":["paths/~1v1~1clients~1{clientId}/get/responses/400/content/application~1json/examples/invalidRequestData"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_28","exampleIds":["paths/~1v1~1clients~1{clientId}/get/responses/400/content/application~1json/examples/invalidRequestData"]}}},{"code":"401","schemaId":"schema_29","exampleIds":["paths/~1v1~1clients~1{clientId}/get/responses/401/content/application~1json/examples/notAuthenticated"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_29","exampleIds":["paths/~1v1~1clients~1{clientId}/get/responses/401/content/application~1json/examples/notAuthenticated"]}}},{"code":"403","schemaId":"schema_30","exampleIds":["paths/~1v1~1clients~1{clientId}/get/responses/403/content/application~1json/examples/unauthorizedAction"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_30","exampleIds":["paths/~1v1~1clients~1{clientId}/get/responses/403/content/application~1json/examples/unauthorizedAction"]}}},{"code":"404","schemaId":"schema_35","exampleIds":["paths/~1v1~1clients~1{clientId}/get/responses/404/content/application~1json/examples/resourceNotFound"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_35","exampleIds":["paths/~1v1~1clients~1{clientId}/get/responses/404/content/application~1json/examples/resourceNotFound"]}}},{"code":"500","schemaId":"schema_32","exampleIds":["paths/~1v1~1clients~1{clientId}/get/responses/500/content/application~1json/examples/systemError"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_32","exampleIds":["paths/~1v1~1clients~1{clientId}/get/responses/500/content/application~1json/examples/systemError"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/client-reports/getclient"}],"panels":[]}]},"httpPath":"/v1/clients/{clientId}"}],"content":{"contentType":"group","meta":{"name":"Client reports"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Client reports","showPageActions":true},{"nodeType":"markdoc","content":"The Client Reports operations includes APIs for managing client  accounts."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/v1/clients","summary":"List all Clients","prefix":{"name":"get","color":"get"},"badges":[],"link":"/client-reports/listclients","deprecated":false},{"title":"/v1/clients/{clientId}","summary":"Retrieve a Client","prefix":{"name":"get","color":"get"},"badges":[],"link":"/client-reports/getclient","deprecated":false}]}]}]}]}},{"type":"separator","label":"Integrations","content":null},{"type":"group","label":"Integration management","link":"/apis/openapi/integration-management","routeSlug":"/apis/openapi/integration-management","items":[{"label":"Create an Integration","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/openapi/integration-management/createintegration","routeSlug":"/apis/openapi/integration-management/createintegration","metadata":{"seo":{"title":"Create an Integration","description":"Create an integration with a third-party service provider, including payment processors, tokenization services, and other payment services."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createIntegration","name":"Create an Integration","isWebhook":false,"pointer":"/paths/~1v1~1integrations/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create an Integration","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Create an integration with a third-party service provider, including  payment processors, tokenization services, and other payment services."},{"nodeType":"security","requirements":[{"schemes":[{"name":"ApiKeyAuth","scopes":[],"type":"apiKey","in":"header","paramName":"Api-Key","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key authentication. Include the API key in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Api-Key"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"WARNING"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": API key-based authentication offers no cryptographic security; always use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.mozilla.org/en-US/docs/Glossary/HTTPS"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"HTTPS"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":":"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"  Api-Key: AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe\n","language":"http"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"  Api-Key: AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe\n"},"children":[]}]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Client-Id","in":"header","schemaId":"schema_26","required":true},{"name":"X-Acting-As-Client-Id","in":"header","schemaId":"schema_26","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The child client this request acts on behalf of. A reseller still authenticates as itself — "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Api-Key"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Client-Id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" stay the reseller's — and names the child here."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This works only from a parent to its own children. Merchants have no children, so a merchant calling as itself omits the header. Sending your own client ULID here is not the same as omitting it, and is rejected on some operations."},"children":[]}]}]}]}],"pointer":"/paths/~1v1~1integrations/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/IntegrationCreateRequest","exampleIds":["paths/~1v1~1integrations/post/requestBody/content/application~1json/examples/tsysIntegration"]}},"schemaId":"components/schemas/IntegrationCreateRequest","exampleIds":["paths/~1v1~1integrations/post/requestBody/content/application~1json/examples/tsysIntegration"],"pointer":"/paths/~1v1~1integrations/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v1/integrations","servers":[{"url":"/_mock/apis/openapi","description":"Mock server (simulated responses)","isMockServer":true}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Client-Id","in":"header","required":true,"schemaId":"schema_26"},{"name":"X-Acting-As-Client-Id","in":"header","required":false,"schemaId":"schema_26"}],"cookie":[]},"security":[{"schemes":[{"id":"ApiKeyAuth","type":"apiKey","name":"Api-Key","in":"header"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/IntegrationCreateRequest","exampleIds":["paths/~1v1~1integrations/post/requestBody/content/application~1json/examples/tsysIntegration"]}},"responseCodes":["200","400","401","403","409","500"],"pointer":"/v1/integrations","href":"integration-management/createintegration","openApiOperationId":"createIntegration","summary":"Create an Integration"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/apis/openapi","description":"Mock server (simulated responses)","isMockServer":true}],"schemaId":"components/schemas/IntegrationCreateRequest","exampleIds":["paths/~1v1~1integrations/post/requestBody/content/application~1json/examples/tsysIntegration"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/IntegrationCreateRequest","exampleIds":["paths/~1v1~1integrations/post/requestBody/content/application~1json/examples/tsysIntegration"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Integration created successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/IntegrationGetResponse","exampleIds":["paths/~1v1~1integrations/post/responses/200/content/application~1json/examples/tsysIntegration"]}},"schemaId":"components/schemas/IntegrationGetResponse","exampleIds":["paths/~1v1~1integrations/post/responses/200/content/application~1json/examples/tsysIntegration"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"400","description":"Bad request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_28","exampleIds":["paths/~1v1~1integrations/post/responses/400/content/application~1json/examples/invalidRequestData"]}},"schemaId":"schema_28","exampleIds":["paths/~1v1~1integrations/post/responses/400/content/application~1json/examples/invalidRequestData"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"401","description":"Not authenticated","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_29","exampleIds":["paths/~1v1~1integrations/post/responses/401/content/application~1json/examples/notAuthenticated"]}},"schemaId":"schema_29","exampleIds":["paths/~1v1~1integrations/post/responses/401/content/application~1json/examples/notAuthenticated"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_30","exampleIds":["paths/~1v1~1integrations/post/responses/403/content/application~1json/examples/unauthorizedAction"]}},"schemaId":"schema_30","exampleIds":["paths/~1v1~1integrations/post/responses/403/content/application~1json/examples/unauthorizedAction"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"409","description":"Conflict","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_31","exampleIds":["paths/~1v1~1integrations/post/responses/409/content/application~1json/examples/duplicateAction"]}},"schemaId":"schema_31","exampleIds":["paths/~1v1~1integrations/post/responses/409/content/application~1json/examples/duplicateAction"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_32","exampleIds":["paths/~1v1~1integrations/post/responses/500/content/application~1json/examples/systemError"]}},"schemaId":"schema_32","exampleIds":["paths/~1v1~1integrations/post/responses/500/content/application~1json/examples/systemError"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"}],"pointer":"/paths/~1v1~1integrations/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/IntegrationGetResponse","exampleIds":["paths/~1v1~1integrations/post/responses/200/content/application~1json/examples/tsysIntegration"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/IntegrationGetResponse","exampleIds":["paths/~1v1~1integrations/post/responses/200/content/application~1json/examples/tsysIntegration"]}}},{"code":"400","schemaId":"schema_28","exampleIds":["paths/~1v1~1integrations/post/responses/400/content/application~1json/examples/invalidRequestData"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_28","exampleIds":["paths/~1v1~1integrations/post/responses/400/content/application~1json/examples/invalidRequestData"]}}},{"code":"401","schemaId":"schema_29","exampleIds":["paths/~1v1~1integrations/post/responses/401/content/application~1json/examples/notAuthenticated"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_29","exampleIds":["paths/~1v1~1integrations/post/responses/401/content/application~1json/examples/notAuthenticated"]}}},{"code":"403","schemaId":"schema_30","exampleIds":["paths/~1v1~1integrations/post/responses/403/content/application~1json/examples/unauthorizedAction"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_30","exampleIds":["paths/~1v1~1integrations/post/responses/403/content/application~1json/examples/unauthorizedAction"]}}},{"code":"409","schemaId":"schema_31","exampleIds":["paths/~1v1~1integrations/post/responses/409/content/application~1json/examples/duplicateAction"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_31","exampleIds":["paths/~1v1~1integrations/post/responses/409/content/application~1json/examples/duplicateAction"]}}},{"code":"500","schemaId":"schema_32","exampleIds":["paths/~1v1~1integrations/post/responses/500/content/application~1json/examples/systemError"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_32","exampleIds":["paths/~1v1~1integrations/post/responses/500/content/application~1json/examples/systemError"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/integration-management/createintegration"}],"panels":[]}]},"httpPath":"/v1/integrations"},{"label":"Update an Integration","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/openapi/integration-management/updateintegration","routeSlug":"/apis/openapi/integration-management/updateintegration","metadata":{"seo":{"title":"Update an Integration","description":"Update an existing integration with a third-party service provider."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateIntegration","name":"Update an Integration","isWebhook":false,"pointer":"/paths/~1v1~1integrations~1{id}/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update an Integration","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Update an existing integration with a third-party service provider."},{"nodeType":"security","requirements":[{"schemes":[{"name":"ApiKeyAuth","scopes":[],"type":"apiKey","in":"header","paramName":"Api-Key","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key authentication. Include the API key in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Api-Key"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"WARNING"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": API key-based authentication offers no cryptographic security; always use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.mozilla.org/en-US/docs/Glossary/HTTPS"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"HTTPS"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":":"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"  Api-Key: AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe\n","language":"http"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"  Api-Key: AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe\n"},"children":[]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_34","required":true}],"pointer":"/paths/~1v1~1integrations~1{id}/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Client-Id","in":"header","schemaId":"schema_26","required":true},{"name":"X-Acting-As-Client-Id","in":"header","schemaId":"schema_26","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The child client this request acts on behalf of. A reseller still authenticates as itself — "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Api-Key"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Client-Id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" stay the reseller's — and names the child here."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This works only from a parent to its own children. Merchants have no children, so a merchant calling as itself omits the header. Sending your own client ULID here is not the same as omitting it, and is rejected on some operations."},"children":[]}]}]}]}],"pointer":"/paths/~1v1~1integrations~1{id}/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/IntegrationUpdateRequest"}},"schemaId":"components/schemas/IntegrationUpdateRequest","pointer":"/paths/~1v1~1integrations~1{id}/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v1/integrations/{id}","servers":[{"url":"/_mock/apis/openapi","description":"Mock server (simulated responses)","isMockServer":true}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_34"}],"query":[],"querystring":[],"header":[{"name":"Client-Id","in":"header","required":true,"schemaId":"schema_26"},{"name":"X-Acting-As-Client-Id","in":"header","required":false,"schemaId":"schema_26"}],"cookie":[]},"security":[{"schemes":[{"id":"ApiKeyAuth","type":"apiKey","name":"Api-Key","in":"header"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/IntegrationUpdateRequest"}},"responseCodes":["200","400","401","403","404","500"],"pointer":"/v1/integrations/{id}","href":"integration-management/updateintegration","openApiOperationId":"updateIntegration","summary":"Update an Integration"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/apis/openapi","description":"Mock server (simulated responses)","isMockServer":true}],"schemaId":"components/schemas/IntegrationUpdateRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/IntegrationUpdateRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Integration updated successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/IntegrationGetResponse"}},"schemaId":"components/schemas/IntegrationGetResponse","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"400","description":"Bad request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_28","exampleIds":["paths/~1v1~1integrations~1{id}/post/responses/400/content/application~1json/examples/invalidRequestData"]}},"schemaId":"schema_28","exampleIds":["paths/~1v1~1integrations~1{id}/post/responses/400/content/application~1json/examples/invalidRequestData"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"401","description":"Not authenticated","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_29","exampleIds":["paths/~1v1~1integrations~1{id}/post/responses/401/content/application~1json/examples/notAuthenticated"]}},"schemaId":"schema_29","exampleIds":["paths/~1v1~1integrations~1{id}/post/responses/401/content/application~1json/examples/notAuthenticated"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_30","exampleIds":["paths/~1v1~1integrations~1{id}/post/responses/403/content/application~1json/examples/unauthorizedAction"]}},"schemaId":"schema_30","exampleIds":["paths/~1v1~1integrations~1{id}/post/responses/403/content/application~1json/examples/unauthorizedAction"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_35","exampleIds":["paths/~1v1~1integrations~1{id}/post/responses/404/content/application~1json/examples/resourceNotFound"]}},"schemaId":"schema_35","exampleIds":["paths/~1v1~1integrations~1{id}/post/responses/404/content/application~1json/examples/resourceNotFound"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_32","exampleIds":["paths/~1v1~1integrations~1{id}/post/responses/500/content/application~1json/examples/systemError"]}},"schemaId":"schema_32","exampleIds":["paths/~1v1~1integrations~1{id}/post/responses/500/content/application~1json/examples/systemError"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"}],"pointer":"/paths/~1v1~1integrations~1{id}/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/IntegrationGetResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/IntegrationGetResponse"}}},{"code":"400","schemaId":"schema_28","exampleIds":["paths/~1v1~1integrations~1{id}/post/responses/400/content/application~1json/examples/invalidRequestData"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_28","exampleIds":["paths/~1v1~1integrations~1{id}/post/responses/400/content/application~1json/examples/invalidRequestData"]}}},{"code":"401","schemaId":"schema_29","exampleIds":["paths/~1v1~1integrations~1{id}/post/responses/401/content/application~1json/examples/notAuthenticated"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_29","exampleIds":["paths/~1v1~1integrations~1{id}/post/responses/401/content/application~1json/examples/notAuthenticated"]}}},{"code":"403","schemaId":"schema_30","exampleIds":["paths/~1v1~1integrations~1{id}/post/responses/403/content/application~1json/examples/unauthorizedAction"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_30","exampleIds":["paths/~1v1~1integrations~1{id}/post/responses/403/content/application~1json/examples/unauthorizedAction"]}}},{"code":"404","schemaId":"schema_35","exampleIds":["paths/~1v1~1integrations~1{id}/post/responses/404/content/application~1json/examples/resourceNotFound"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_35","exampleIds":["paths/~1v1~1integrations~1{id}/post/responses/404/content/application~1json/examples/resourceNotFound"]}}},{"code":"500","schemaId":"schema_32","exampleIds":["paths/~1v1~1integrations~1{id}/post/responses/500/content/application~1json/examples/systemError"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_32","exampleIds":["paths/~1v1~1integrations~1{id}/post/responses/500/content/application~1json/examples/systemError"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/integration-management/updateintegration"}],"panels":[]}]},"httpPath":"/v1/integrations/{id}"}],"content":{"contentType":"group","meta":{"name":"Integration management"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Integration management","showPageActions":true},{"nodeType":"markdoc","content":"The Integration management operations includes APIs for managing integrations with  third-party service providers."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/v1/integrations","summary":"Create an Integration","prefix":{"name":"post","color":"post"},"badges":[],"link":"/integration-management/createintegration","deprecated":false},{"title":"/v1/integrations/{id}","summary":"Update an Integration","prefix":{"name":"post","color":"post"},"badges":[],"link":"/integration-management/updateintegration","deprecated":false}]}]}]}]}},{"type":"group","label":"Integration reports","link":"/apis/openapi/integration-reports","routeSlug":"/apis/openapi/integration-reports","items":[{"label":"List Integrations","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/openapi/integration-reports/listintegrations","routeSlug":"/apis/openapi/integration-reports/listintegrations","metadata":{"seo":{"title":"List Integrations","description":"Return a list of all integrations that the client account has onboarded with."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listIntegrations","name":"List Integrations","isWebhook":false,"pointer":"/paths/~1v1~1integrations/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List Integrations","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Return a list of all integrations that the client account  has onboarded with."},{"nodeType":"security","requirements":[{"schemes":[{"name":"ApiKeyAuth","scopes":[],"type":"apiKey","in":"header","paramName":"Api-Key","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key authentication. Include the API key in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Api-Key"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"WARNING"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": API key-based authentication offers no cryptographic security; always use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.mozilla.org/en-US/docs/Glossary/HTTPS"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"HTTPS"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":":"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"  Api-Key: AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe\n","language":"http"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"  Api-Key: AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe\n"},"children":[]}]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Client-Id","in":"header","schemaId":"schema_26","required":true},{"name":"X-Acting-As-Client-Id","in":"header","schemaId":"schema_26","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The child client this request acts on behalf of. A reseller still authenticates as itself — "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Api-Key"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Client-Id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" stay the reseller's — and names the child here."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This works only from a parent to its own children. Merchants have no children, so a merchant calling as itself omits the header. Sending your own client ULID here is not the same as omitting it, and is rejected on some operations."},"children":[]}]}]}]}],"pointer":"/paths/~1v1~1integrations/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v1/integrations","servers":[{"url":"/_mock/apis/openapi","description":"Mock server (simulated responses)","isMockServer":true}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Client-Id","in":"header","required":true,"schemaId":"schema_26"},{"name":"X-Acting-As-Client-Id","in":"header","required":false,"schemaId":"schema_26"}],"cookie":[]},"security":[{"schemes":[{"id":"ApiKeyAuth","type":"apiKey","name":"Api-Key","in":"header"}],"scopes":[]}],"responseCodes":["200","400","401","403","500"],"pointer":"/v1/integrations","href":"integration-reports/listintegrations","openApiOperationId":"listIntegrations","summary":"List Integrations"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/apis/openapi","description":"Mock server (simulated responses)","isMockServer":true}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Integration list returned successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/IntegrationSummaryResponse"}},"schemaId":"components/schemas/IntegrationSummaryResponse","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"400","description":"Bad request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_28","exampleIds":["paths/~1v1~1integrations/get/responses/400/content/application~1json/examples/invalidRequestData"]}},"schemaId":"schema_28","exampleIds":["paths/~1v1~1integrations/get/responses/400/content/application~1json/examples/invalidRequestData"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"401","description":"Not authenticated","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_29","exampleIds":["paths/~1v1~1integrations/get/responses/401/content/application~1json/examples/notAuthenticated"]}},"schemaId":"schema_29","exampleIds":["paths/~1v1~1integrations/get/responses/401/content/application~1json/examples/notAuthenticated"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_30","exampleIds":["paths/~1v1~1integrations/get/responses/403/content/application~1json/examples/unauthorizedAction"]}},"schemaId":"schema_30","exampleIds":["paths/~1v1~1integrations/get/responses/403/content/application~1json/examples/unauthorizedAction"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_32","exampleIds":["paths/~1v1~1integrations/get/responses/500/content/application~1json/examples/systemError"]}},"schemaId":"schema_32","exampleIds":["paths/~1v1~1integrations/get/responses/500/content/application~1json/examples/systemError"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"}],"pointer":"/paths/~1v1~1integrations/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/IntegrationSummaryResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/IntegrationSummaryResponse"}}},{"code":"400","schemaId":"schema_28","exampleIds":["paths/~1v1~1integrations/get/responses/400/content/application~1json/examples/invalidRequestData"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_28","exampleIds":["paths/~1v1~1integrations/get/responses/400/content/application~1json/examples/invalidRequestData"]}}},{"code":"401","schemaId":"schema_29","exampleIds":["paths/~1v1~1integrations/get/responses/401/content/application~1json/examples/notAuthenticated"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_29","exampleIds":["paths/~1v1~1integrations/get/responses/401/content/application~1json/examples/notAuthenticated"]}}},{"code":"403","schemaId":"schema_30","exampleIds":["paths/~1v1~1integrations/get/responses/403/content/application~1json/examples/unauthorizedAction"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_30","exampleIds":["paths/~1v1~1integrations/get/responses/403/content/application~1json/examples/unauthorizedAction"]}}},{"code":"500","schemaId":"schema_32","exampleIds":["paths/~1v1~1integrations/get/responses/500/content/application~1json/examples/systemError"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_32","exampleIds":["paths/~1v1~1integrations/get/responses/500/content/application~1json/examples/systemError"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/integration-reports/listintegrations"}],"panels":[]}]},"httpPath":"/v1/integrations"},{"label":"Retrieve an Integration","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/openapi/integration-reports/getintegration","routeSlug":"/apis/openapi/integration-reports/getintegration","metadata":{"seo":{"title":"Retrieve an Integration","description":"Retrieve details of a specific integration."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getIntegration","name":"Retrieve an Integration","isWebhook":false,"pointer":"/paths/~1v1~1integrations~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve an Integration","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieve details of a specific integration."},{"nodeType":"security","requirements":[{"schemes":[{"name":"ApiKeyAuth","scopes":[],"type":"apiKey","in":"header","paramName":"Api-Key","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key authentication. Include the API key in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Api-Key"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"WARNING"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": API key-based authentication offers no cryptographic security; always use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.mozilla.org/en-US/docs/Glossary/HTTPS"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"HTTPS"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":":"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"  Api-Key: AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe\n","language":"http"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"  Api-Key: AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe\n"},"children":[]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_34","required":true}],"pointer":"/paths/~1v1~1integrations~1{id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Client-Id","in":"header","schemaId":"schema_26","required":true},{"name":"X-Acting-As-Client-Id","in":"header","schemaId":"schema_26","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The child client this request acts on behalf of. A reseller still authenticates as itself — "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Api-Key"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Client-Id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" stay the reseller's — and names the child here."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This works only from a parent to its own children. Merchants have no children, so a merchant calling as itself omits the header. Sending your own client ULID here is not the same as omitting it, and is rejected on some operations."},"children":[]}]}]}]}],"pointer":"/paths/~1v1~1integrations~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v1/integrations/{id}","servers":[{"url":"/_mock/apis/openapi","description":"Mock server (simulated responses)","isMockServer":true}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_34"}],"query":[],"querystring":[],"header":[{"name":"Client-Id","in":"header","required":true,"schemaId":"schema_26"},{"name":"X-Acting-As-Client-Id","in":"header","required":false,"schemaId":"schema_26"}],"cookie":[]},"security":[{"schemes":[{"id":"ApiKeyAuth","type":"apiKey","name":"Api-Key","in":"header"}],"scopes":[]}],"responseCodes":["200","400","401","403","404","500"],"pointer":"/v1/integrations/{id}","href":"integration-reports/getintegration","openApiOperationId":"getIntegration","summary":"Retrieve an Integration"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/apis/openapi","description":"Mock server (simulated responses)","isMockServer":true}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Integration retrieved successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/IntegrationGetResponse"}},"schemaId":"components/schemas/IntegrationGetResponse","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"400","description":"Bad request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_28","exampleIds":["paths/~1v1~1integrations~1{id}/get/responses/400/content/application~1json/examples/invalidRequestData"]}},"schemaId":"schema_28","exampleIds":["paths/~1v1~1integrations~1{id}/get/responses/400/content/application~1json/examples/invalidRequestData"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"401","description":"Not authenticated","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_29","exampleIds":["paths/~1v1~1integrations~1{id}/get/responses/401/content/application~1json/examples/notAuthenticated"]}},"schemaId":"schema_29","exampleIds":["paths/~1v1~1integrations~1{id}/get/responses/401/content/application~1json/examples/notAuthenticated"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_30","exampleIds":["paths/~1v1~1integrations~1{id}/get/responses/403/content/application~1json/examples/unauthorizedAction"]}},"schemaId":"schema_30","exampleIds":["paths/~1v1~1integrations~1{id}/get/responses/403/content/application~1json/examples/unauthorizedAction"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_35","exampleIds":["paths/~1v1~1integrations~1{id}/get/responses/404/content/application~1json/examples/resourceNotFound"]}},"schemaId":"schema_35","exampleIds":["paths/~1v1~1integrations~1{id}/get/responses/404/content/application~1json/examples/resourceNotFound"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_32","exampleIds":["paths/~1v1~1integrations~1{id}/get/responses/500/content/application~1json/examples/systemError"]}},"schemaId":"schema_32","exampleIds":["paths/~1v1~1integrations~1{id}/get/responses/500/content/application~1json/examples/systemError"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"}],"pointer":"/paths/~1v1~1integrations~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/IntegrationGetResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/IntegrationGetResponse"}}},{"code":"400","schemaId":"schema_28","exampleIds":["paths/~1v1~1integrations~1{id}/get/responses/400/content/application~1json/examples/invalidRequestData"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_28","exampleIds":["paths/~1v1~1integrations~1{id}/get/responses/400/content/application~1json/examples/invalidRequestData"]}}},{"code":"401","schemaId":"schema_29","exampleIds":["paths/~1v1~1integrations~1{id}/get/responses/401/content/application~1json/examples/notAuthenticated"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_29","exampleIds":["paths/~1v1~1integrations~1{id}/get/responses/401/content/application~1json/examples/notAuthenticated"]}}},{"code":"403","schemaId":"schema_30","exampleIds":["paths/~1v1~1integrations~1{id}/get/responses/403/content/application~1json/examples/unauthorizedAction"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_30","exampleIds":["paths/~1v1~1integrations~1{id}/get/responses/403/content/application~1json/examples/unauthorizedAction"]}}},{"code":"404","schemaId":"schema_35","exampleIds":["paths/~1v1~1integrations~1{id}/get/responses/404/content/application~1json/examples/resourceNotFound"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_35","exampleIds":["paths/~1v1~1integrations~1{id}/get/responses/404/content/application~1json/examples/resourceNotFound"]}}},{"code":"500","schemaId":"schema_32","exampleIds":["paths/~1v1~1integrations~1{id}/get/responses/500/content/application~1json/examples/systemError"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_32","exampleIds":["paths/~1v1~1integrations~1{id}/get/responses/500/content/application~1json/examples/systemError"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/integration-reports/getintegration"}],"panels":[]}]},"httpPath":"/v1/integrations/{id}"},{"label":"List Integration Summary","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/openapi/integration-reports/listintegrationsummary","routeSlug":"/apis/openapi/integration-reports/listintegrationsummary","metadata":{"seo":{"title":"List Integration Summary","description":"Return a summary list of integrations for a specific client."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listIntegrationSummary","name":"List Integration Summary","isWebhook":false,"pointer":"/paths/~1v1~1integrations~1summary~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List Integration Summary","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Return a summary list of integrations for a specific client."},{"nodeType":"security","requirements":[{"schemes":[{"name":"ApiKeyAuth","scopes":[],"type":"apiKey","in":"header","paramName":"Api-Key","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key authentication. Include the API key in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Api-Key"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"WARNING"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": API key-based authentication offers no cryptographic security; always use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.mozilla.org/en-US/docs/Glossary/HTTPS"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"HTTPS"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":":"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"  Api-Key: AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe\n","language":"http"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"  Api-Key: AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe\n"},"children":[]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_34","required":true}],"pointer":"/paths/~1v1~1integrations~1summary~1{id}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Client-Id","in":"header","schemaId":"schema_26","required":true},{"name":"X-Acting-As-Client-Id","in":"header","schemaId":"schema_26","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The child client this request acts on behalf of. A reseller still authenticates as itself — "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Api-Key"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Client-Id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" stay the reseller's — and names the child here."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This works only from a parent to its own children. Merchants have no children, so a merchant calling as itself omits the header. Sending your own client ULID here is not the same as omitting it, and is rejected on some operations."},"children":[]}]}]}]}],"pointer":"/paths/~1v1~1integrations~1summary~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v1/integrations/summary/{id}","servers":[{"url":"/_mock/apis/openapi","description":"Mock server (simulated responses)","isMockServer":true}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_34"}],"query":[],"querystring":[],"header":[{"name":"Client-Id","in":"header","required":true,"schemaId":"schema_26"},{"name":"X-Acting-As-Client-Id","in":"header","required":false,"schemaId":"schema_26"}],"cookie":[]},"security":[{"schemes":[{"id":"ApiKeyAuth","type":"apiKey","name":"Api-Key","in":"header"}],"scopes":[]}],"responseCodes":["200","400","401","403","404","500"],"pointer":"/v1/integrations/summary/{id}","href":"integration-reports/listintegrationsummary","openApiOperationId":"listIntegrationSummary","summary":"List Integration Summary"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/apis/openapi","description":"Mock server (simulated responses)","isMockServer":true}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Integration summary returned successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/IntegrationSummaryResponse"}},"schemaId":"components/schemas/IntegrationSummaryResponse","headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"400","description":"Bad request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_28","exampleIds":["paths/~1v1~1integrations~1summary~1{id}/get/responses/400/content/application~1json/examples/invalidRequestData"]}},"schemaId":"schema_28","exampleIds":["paths/~1v1~1integrations~1summary~1{id}/get/responses/400/content/application~1json/examples/invalidRequestData"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"401","description":"Not authenticated","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_29","exampleIds":["paths/~1v1~1integrations~1summary~1{id}/get/responses/401/content/application~1json/examples/notAuthenticated"]}},"schemaId":"schema_29","exampleIds":["paths/~1v1~1integrations~1summary~1{id}/get/responses/401/content/application~1json/examples/notAuthenticated"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_30","exampleIds":["paths/~1v1~1integrations~1summary~1{id}/get/responses/403/content/application~1json/examples/unauthorizedAction"]}},"schemaId":"schema_30","exampleIds":["paths/~1v1~1integrations~1summary~1{id}/get/responses/403/content/application~1json/examples/unauthorizedAction"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_35","exampleIds":["paths/~1v1~1integrations~1summary~1{id}/get/responses/404/content/application~1json/examples/resourceNotFound"]}},"schemaId":"schema_35","exampleIds":["paths/~1v1~1integrations~1summary~1{id}/get/responses/404/content/application~1json/examples/resourceNotFound"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_32","exampleIds":["paths/~1v1~1integrations~1summary~1{id}/get/responses/500/content/application~1json/examples/systemError"]}},"schemaId":"schema_32","exampleIds":["paths/~1v1~1integrations~1summary~1{id}/get/responses/500/content/application~1json/examples/systemError"],"headers":{"x-request-id":{"$ref":"#/components/headers/RequestId"}},"headerSchemaId":"schema_27"}],"pointer":"/paths/~1v1~1integrations~1summary~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/IntegrationSummaryResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/IntegrationSummaryResponse"}}},{"code":"400","schemaId":"schema_28","exampleIds":["paths/~1v1~1integrations~1summary~1{id}/get/responses/400/content/application~1json/examples/invalidRequestData"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_28","exampleIds":["paths/~1v1~1integrations~1summary~1{id}/get/responses/400/content/application~1json/examples/invalidRequestData"]}}},{"code":"401","schemaId":"schema_29","exampleIds":["paths/~1v1~1integrations~1summary~1{id}/get/responses/401/content/application~1json/examples/notAuthenticated"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_29","exampleIds":["paths/~1v1~1integrations~1summary~1{id}/get/responses/401/content/application~1json/examples/notAuthenticated"]}}},{"code":"403","schemaId":"schema_30","exampleIds":["paths/~1v1~1integrations~1summary~1{id}/get/responses/403/content/application~1json/examples/unauthorizedAction"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_30","exampleIds":["paths/~1v1~1integrations~1summary~1{id}/get/responses/403/content/application~1json/examples/unauthorizedAction"]}}},{"code":"404","schemaId":"schema_35","exampleIds":["paths/~1v1~1integrations~1summary~1{id}/get/responses/404/content/application~1json/examples/resourceNotFound"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_35","exampleIds":["paths/~1v1~1integrations~1summary~1{id}/get/responses/404/content/application~1json/examples/resourceNotFound"]}}},{"code":"500","schemaId":"schema_32","exampleIds":["paths/~1v1~1integrations~1summary~1{id}/get/responses/500/content/application~1json/examples/systemError"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_32","exampleIds":["paths/~1v1~1integrations~1summary~1{id}/get/responses/500/content/application~1json/examples/systemError"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/integration-reports/listintegrationsummary"}],"panels":[]}]},"httpPath":"/v1/integrations/summary/{id}"}],"content":{"contentType":"group","meta":{"name":"Integration reports"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Integration reports","showPageActions":true},{"nodeType":"markdoc","content":"The Integration reports operations includes APIs for generating reports on  integrations."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/v1/integrations","summary":"List Integrations","prefix":{"name":"get","color":"get"},"badges":[],"link":"/integration-reports/listintegrations","deprecated":false},{"title":"/v1/integrations/{id}","summary":"Retrieve an Integration","prefix":{"name":"get","color":"get"},"badges":[],"link":"/integration-reports/getintegration","deprecated":false},{"title":"/v1/integrations/summary/{id}","summary":"List Integration Summary","prefix":{"name":"get","color":"get"},"badges":[],"link":"/integration-reports/listintegrationsummary","deprecated":false}]}]}]}]}}],"store":{"schemaStore":{"components/schemas/Address":{"id":"components/schemas/Address","kind":"json-schema","title":"Address","data":{"title":"Address","description":"Address object.","properties":{"line1":{"maxLength":50,"type":"string","description":"Primary street address line.","examples":["123 Main St"]},"line2":{"maxLength":50,"type":"string","description":"Secondary address line (suite, apt, floor, etc.).","examples":["Suite 100"]},"city":{"maxLength":50,"type":"string","description":"City name.","examples":["Springfield"]},"state":{"maxLength":2,"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Two-letter US state code (e.g. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"VA"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"examples":["VA"]},"postal_code":{"maxLength":10,"pattern":"^[a-zA-Z0-9]+(-|\\s?)[a-zA-Z0-9]+$","type":"string","description":"ZIP or postal code.","examples":["22150"]},"country":{"maxLength":2,"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Two-letter ISO 3166-1 alpha-2 country code (e.g. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"US"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"examples":["US"]}},"additionalProperties":false}},"components/schemas/BankAccountType":{"id":"components/schemas/BankAccountType","kind":"json-schema","title":"BankAccountType","data":{"type":"string","description":"The type of bank account.","enum":["CHECKING","SAVINGS"],"x-enumDescriptions":{"CHECKING":"Checking account.","SAVINGS":"Savings account."},"examples":["CHECKING","SAVINGS"]}},"components/schemas/BankAccountInput":{"id":"components/schemas/BankAccountInput","kind":"json-schema","title":"BankAccountInput","data":{"description":"Request object for Bank Account (ACH) payment method.","type":"object","required":["type","account_number","account_type","first_name","last_name","routing_number"],"properties":{"type":{"$ref":"#/components/schemas/PaymentMethodTypeInput","const":"ACH","description":"The type of payment method."},"standard_entry_class":{"$ref":"#/components/schemas/StandardEntryClass","default":"WEB"},"account_type":{"$ref":"#/components/schemas/BankAccountType"},"routing_number":{"minLength":9,"maxLength":9,"pattern":"^\\d{9}$","type":"string","description":"Nine-digit ABA routing number.","examples":["021000021"]},"account_number":{"minLength":4,"maxLength":20,"pattern":"^\\d{4,20}$","type":"string","description":"Bank account number.","examples":["123456789012"]},"first_name":{"type":"string","description":"Account holder's first name.","examples":["John"]},"last_name":{"type":"string","description":"Account holder's last name.","examples":["Doe"]},"description":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Optional information to include on customer's bank  statement. This is a short description that, e.g., identifies the goods or services purchased or the merchant's name. If left blank, the merchant's name will be used as a default description. Only the  first 10 characters will appear on the bank statement. Defaults to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ACH Transaction"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when omitted."},"children":[]}]}]}],"default":"ACH Transaction","maxLength":30,"examples":["Frank's Garage","Acme LLC","Blue jeans","Bob's Burgers"]}},"additionalProperties":false}},"components/schemas/BankAccountOutput":{"id":"components/schemas/BankAccountOutput","kind":"json-schema","title":"BankAccountOutput","data":{"type":"object","description":"New bank account (ACH) payment method details for tokenization or direct use.","readOnly":true,"required":["type"],"properties":{"type":{"$ref":"#/components/schemas/PaymentMethodTypeOutput","const":"ACH"},"standard_entry_class":{"$ref":"#/components/schemas/StandardEntryClass"},"account_type":{"$ref":"#/components/schemas/BankAccountType"},"route_number_truncated":{"type":"string","description":"Nine-digit ABA routing number truncated to the last 4 digits.","examples":["0210"]},"account_number_truncated":{"type":"string","description":"Bank account number truncated to the last 4 digits.","examples":["1234"],"readOnly":true},"payment_token":{"$ref":"#/components/schemas/PaymentToken"},"first_name":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Account holder's first name. On a transaction response this is the name submitted with the request. On a reporting response it is derived by splitting the stored account holder name at the last space, so a single-word stored name returns an empty string here and puts the whole name in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"last_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":["John"]},"last_name":{"type":"string","description":"Account holder's last name.","examples":["Doe"]},"description":{"type":"string","description":"Optional information to include on customer's bank  statement. This is a short description that, e.g., identifies the goods or services purchased or the merchant's name. If left blank, the merchant's name will be used as a default description.","maxLength":30,"examples":["Frank's Pool Hall","Acme Jewelry","Blue jeans","Bob's Burgers"]}},"additionalProperties":false}},"components/schemas/ClientAddress":{"id":"components/schemas/ClientAddress","kind":"json-schema","title":"ClientAddress","data":{"title":"ClientAddress","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A client address, including a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" that identifies its purpose ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"LEGAL"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"BILLING"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"PHYSICAL"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"type":"object","properties":{"type":{"$ref":"#/components/schemas/ClientAddressType"},"line1":{"maxLength":50,"type":"string","description":"Primary street address line.","examples":["123 Main St"]},"line2":{"maxLength":50,"type":"string","description":"Secondary address line (suite, apt, floor, etc.).","examples":["Suite 100"]},"city":{"maxLength":50,"type":"string","description":"City name.","examples":["Springfield"]},"state":{"maxLength":2,"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Two-letter US state code (e.g. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"VA"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"examples":["VA"]},"postal_code":{"maxLength":10,"pattern":"^[a-zA-Z0-9]+(-|\\s?)[a-zA-Z0-9]+$","type":"string","description":"ZIP or postal code.","examples":["22150"]},"country":{"maxLength":2,"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Two-letter ISO 3166-1 alpha-2 country code (e.g. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"US"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"examples":["US"]}},"additionalProperties":false}},"components/schemas/ClientAddressType":{"id":"components/schemas/ClientAddressType","kind":"json-schema","title":"ClientAddressType","data":{"type":"string","description":"The purpose of this address.","enum":["LEGAL","BILLING","PHYSICAL"],"x-enumDescriptions":{"LEGAL":"The client's registered legal address.","BILLING":"The address used for billing the client.","PHYSICAL":"The client's physical location address."},"default":"LEGAL","examples":["LEGAL","BILLING","PHYSICAL"]}},"components/schemas/Amount":{"id":"components/schemas/Amount","kind":"json-schema","title":"Amount","data":{"type":"integer","format":"int32","title":"Amount","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Amount in cents (e.g. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"10000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" = $100.00). All transactions are in US  dollars (USD)."},"children":[]}]}]}],"minimum":50,"maximum":99999999,"examples":[10000,100000,1000000]}},"components/schemas/AvsResultCode":{"id":"components/schemas/AvsResultCode","kind":"json-schema","title":"AvsResultCode","data":{"oneOf":[{"type":"string","enum":["A","B","N","P","R","S","U","W","X","Y","Z"]},{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Numeric code returned when AVS was not performed or is inapplicable. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" indicates no AVS check was requested."},"children":[]}]}]}],"enum":[0]}],"x-enumDescriptions":{"0":"AVS not requested or not applicable.","A":"The street address matched, but the postal code did not.","B":"No address information was provided or transaction declined.","N":"Neither the street address nor postal code matched.","P":"AVS is not applicable for this transaction.","R":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Retry — AVS was unavailable or timed out."},"children":[]}]}]}],"S":"AVS is not supported by card issuer.","U":"Address information is unavailable.","W":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The US ZIP+4 code matches, but the street address does not."},"children":[]}]}]}],"X":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Both the street address and the US ZIP+4 code matched."},"children":[]}]}]}],"Y":"The street address and postal code matched.","Z":"The postal code matched, but the street address did not."},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The result of the Address Verification Service (AVS) check. May be a single-letter string code or integer "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when AVS was not performed."},"children":[]}]}]}],"examples":["A","Y",0]}},"components/schemas/BatchClose":{"id":"components/schemas/BatchClose","kind":"json-schema","title":"BatchClose","data":{"required":["batch_type","client_id","created_at","processor"],"type":"object","description":"Request body for manually closing a batch of transactions.","properties":{"client_id":{"type":"string","description":"The unique identifier of the client whose batch should be closed.","examples":["CLIENT-01KFDKXMQ637EKEAY410MSQSXB"]},"batch_id":{"type":["string","null"],"description":"The unique identifier of the specific batch to close. Omit to  close all open batches for the client.","examples":["BATCH-01KEW32V6YNV11T33XGDR7TGWC"]},"processor":{"$ref":"#/components/schemas/Processor"},"batch_type":{"$ref":"#/components/schemas/BatchType"},"created_at":{"type":"string","format":"date-time","description":"ISO 8601 timestamp of when the batch was created.","examples":["2026-07-15T08:00:00Z"]},"timezone":{"type":["string","null"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"IANA timezone identifier for the batch (e.g. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"America/New_York"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"examples":["America/New_York"]}},"additionalProperties":false}},"components/schemas/BatchCloseResponse":{"id":"components/schemas/BatchCloseResponse","kind":"json-schema","title":"BatchCloseResponse","data":{"required":["response_text"],"type":"object","description":"Response returned after a batch close operation.","properties":{"response_text":{"type":"string","description":"Human-readable message describing the outcome of the batch close.","examples":["Batch closed successfully. 1 batch submitted for settlement."]},"correlation_id":{"$ref":"#/components/schemas/CorrelationId"}},"additionalProperties":false}},"components/schemas/BatchElasticModel":{"id":"components/schemas/BatchElasticModel","kind":"json-schema","title":"BatchElasticModel","data":{"required":["approved_amount","batch_id","batch_number","batch_type","captured_amount","client_dba","client_id","closed_at_date_time","created_at","created_at_date_time","id","net_amount","processor","refund_amount","request","response","settled_at_date_time","status","void_amount"],"type":"object","description":"A batch record returned from the transaction search index.","properties":{"id":{"type":"string","description":"Unique identifier for the batch assigned by the API server.","examples":["BATCH-01KEW32V6YNV11T33XGDR7TGWC"]},"processor":{"type":["string","null"],"description":"The payment processor that processed this batch. Null when the processor is unknown or not assigned.","examples":["TSYS"]},"status":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Current status of the batch (e.g. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"open"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"closed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"settled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"examples":["closed"]},"client_id":{"type":"string","description":"Unique identifier of the client that owns this batch.","examples":["CLIENT-01KFDKXMQ637EKEAY410MSQSXB"]},"closed_at":{"type":["string","null"],"format":"date-time","description":"ISO 8601 timestamp of when the batch was closed. Null if still open.","examples":["2026-07-15T23:00:12Z"]},"settled_at":{"type":["string","null"],"format":"date-time","description":"ISO 8601 timestamp of when the batch was settled. Null if not yet settled.","examples":["2026-07-16T02:14:33Z"]},"created_at":{"type":"string","format":"date-time","description":"ISO 8601 timestamp of when the batch was created.","examples":["2026-07-15T08:00:00Z"]},"client_dba":{"type":"string","description":"Doing Business As (DBA) name of the client.","examples":["Acme Jewelry"]},"net_amount":{"type":"integer","format":"int64","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Net batch amount in dollars (approved minus refunds and voids).  Amount in cents (e.g. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"10000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" = $100.00). All transactions are in  US dollars (USD)."},"children":[]}]}]}],"examples":[4550000]},"approved_amount":{"type":"integer","format":"int64","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Total approved transaction amount in dollars. Amount in cents  (e.g. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"10000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" = $100.00). All transactions are in US dollars (USD)."},"children":[]}]}]}],"examples":[4800000]},"captured_amount":{"type":"integer","format":"int64","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Total captured transaction amount in dollars. Amount in cents  (e.g. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"10000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" = $100.00). All transactions are in US dollars (USD)."},"children":[]}]}]}],"examples":[4800000]},"void_amount":{"type":"integer","format":"int64","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Total voided transaction amount in dollars. Amount in cents  (e.g. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"10000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" = $100.00). All transactions are in US dollars (USD)."},"children":[]}]}]}],"examples":[150000]},"refund_amount":{"type":"integer","format":"int64","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Total refunded transaction amount in dollars. Amount in cents  (e.g. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"10000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" = $100.00). All transactions are in US dollars (USD)."},"children":[]}]}]}],"examples":[100000]},"request":{"type":["string","null"],"description":"Raw request payload sent to the processor for batch close. Null when not available.","examples":["{\"batch_number\":42,\"transaction_count\":17}"]},"response":{"type":["string","null"],"description":"Raw response payload received from the processor. Null when not available.","examples":["{\"response_code\":\"00\",\"batch_number\":42}"]},"batch_number":{"type":"integer","format":"int32","description":"Sequential batch number assigned by the processor.","examples":[42]},"batch_type":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The type of batch (e.g. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Credit"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Debit"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"examples":["Credit"]},"batch_id":{"type":"string","description":"Unique batch identifier assigned by the API server.","examples":["BATCH-01KEW32V6YNV11T33XGDR7TGWC"]},"closed_at_date_time":{"type":["string","null"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Human-readable form of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"closed_at"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", in the gateway's local time with no offset. Null while the batch is still open. Twelve-hour clock — prefer "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"closed_at"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", which is ISO 8601 and unambiguous."},"children":[]}]}]}],"examples":["06/05/2026 02:00:51 PM"]},"settled_at_date_time":{"type":["string","null"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Human-readable form of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"settled_at"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", in the gateway's local time with no offset. Null until the batch settles. Twelve-hour clock — prefer "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"settled_at"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", which is ISO 8601 and unambiguous."},"children":[]}]}]}],"examples":["06/05/2026 02:14:33 PM"]},"created_at_date_time":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Human-readable form of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"created_at"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", in the gateway's local time with no offset. Twelve-hour clock — prefer "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"created_at"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", which is ISO 8601 and unambiguous."},"children":[]}]}]}],"examples":["06/03/2026 03:08:14 PM"]},"batch_net_deposit":{"type":["integer","null"],"format":"int64","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Net amount deposited for the batch, in cents (e.g. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"10000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" = $100.00). Null until the processor reports it."},"children":[]}]}]}],"examples":[4550000]}},"additionalProperties":false}},"components/schemas/BatchElasticModelTransResponse":{"id":"components/schemas/BatchElasticModelTransResponse","kind":"json-schema","title":"BatchElasticModelTransResponse","data":{"required":["count","results"],"type":"object","description":"Paginated response containing a list of batch records.","properties":{"count":{"type":"integer","format":"int64","description":"Total number of batch records matching the query.","examples":[3]},"results":{"type":"array","description":"List of batch records.","items":{"$ref":"#/components/schemas/BatchElasticModel"}},"correlation_id":{"$ref":"#/components/schemas/CorrelationId"}},"additionalProperties":false}},"components/schemas/CardInput":{"id":"components/schemas/CardInput","kind":"json-schema","title":"CardInput","data":{"description":"Credit or debit card details for tokenization or direct use in a transaction.","type":"object","required":["type","pan","expiry"],"properties":{"type":{"$ref":"#/components/schemas/PaymentMethodTypeInput","const":"Card","description":"The type of payment method.","examples":["Card"]},"pan":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Primary account number (PAN) — the full card number."},"children":[]}]}]}],"pattern":"^\\d{14,19}$","examples":["4012000098765439","4012881888818888"]},"expiry":{"$ref":"#/components/schemas/ExpiryInput"},"cvv":{"pattern":"^\\d{3,4}$","type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Card verification value (CVV/CVC) — three digits for Visa, Mastercard,  Discover. Four digits for American Express."},"children":[]}]}]}],"examples":["999"]},"first_name":{"type":"string","description":"First name of the cardholder.","examples":["John"]},"last_name":{"type":"string","description":"Last name of the cardholder.","examples":["Doe"]},"contact":{"type":"object","properties":{"phone":{"$ref":"#/components/schemas/PhoneNullable"},"email":{"$ref":"#/components/schemas/Email"}}},"billing_address":{"$ref":"#/components/schemas/Address"},"entry_method":{"$ref":"#/components/schemas/EntryMethod"}},"additionalProperties":false}},"components/schemas/CardOutput":{"id":"components/schemas/CardOutput","kind":"json-schema","title":"CardOutput","data":{"description":"Credit or debit card details returned on a transaction response.","required":["type"],"type":"object","properties":{"type":{"$ref":"#/components/schemas/PaymentMethodTypeOutput","const":"CARD","description":"The type of payment method.","examples":["CARD"]},"truncated_pan":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Masked card number with only the last 4 digits visible  (e.g. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"****1111"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"examples":["****-****-****-5439"]},"payment_token":{"$ref":"#/components/schemas/PaymentToken"},"expiry":{"oneOf":[{"$ref":"#/components/schemas/Expiry"},{"type":"null"}],"description":"Card expiration date. Null on capture/void/refund responses where expiry is not echoed back.","examples":[{"month":"01","year":"2028"}]},"first_name":{"type":["string","null"],"description":"First name of the cardholder. Null if not provided.","examples":["John"]},"last_name":{"type":["string","null"],"description":"Last name of the cardholder. Null if not provided.","examples":["Doe"]},"entry_method":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"How the card payment method was entered (e.g. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"keyed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"swiped"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":",  "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"chip"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"contactless"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"magstripe"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"barcode"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"qr"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"other"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"examples":["keyed"]},"auth_code":{"type":"string","description":"Authorization code generated by the card provider when the card is successfully  authorized.","examples":["123456"]},"retrieval_reference_number":{"type":["string","null"],"description":"The retrieval reference number (RRN) is a 12-character alphanumeric  identifier assigned to a card transaction to allow the tracking  of a specific transaction record. ","examples":["000000603076"]},"card_type":{"$ref":"#/components/schemas/CardType","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The type of card. A transaction response always reports "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"UNKNOWN"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": the processor does not return the card type on the authorization, so the gateway has nothing to report yet. Read the transaction back from a reporting endpoint — "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v1/transactions"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v1/transactions/{id}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — for the determined value. Treat "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"UNKNOWN"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" as \"not yet known\" on a transaction response and as \"the processor could not determine it\" on a reporting response."},"children":[]}]}]}]},"card_brand":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Card network brand (e.g. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Visa"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Mastercard"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Amex"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Discover"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"examples":["Visa"]},"cvv_result_code":{"description":"The result returned from a card verification value check. Null on void/refund responses where CVV is not re-checked.","type":["string","null"],"maxLength":1,"examples":["M"]},"avs_result_code":{"$ref":"#/components/schemas/AvsResultCode"},"avs_response":{"type":"string","description":"Human-readable AVS response message.","examples":["Exact Match - Street address and postal code match"]}},"additionalProperties":false}},"components/schemas/CardType":{"id":"components/schemas/CardType","kind":"json-schema","title":"CardType","data":{"type":"string","enum":["DEBIT","CREDIT","UNKNOWN"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The type of card. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"UNKNOWN"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is returned when the processor cannot determine the card type."},"children":[]}]}]}],"examples":["DEBIT","CREDIT","UNKNOWN"]}},"components/schemas/OpenBatchCardType":{"id":"components/schemas/OpenBatchCardType","kind":"json-schema","title":"OpenBatchCardType","data":{"type":"string","enum":["DEBIT","CREDIT"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The card types the open-batch transaction filter accepts. This is a narrower set than "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"CardType"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", which is what a transaction response carries. Open-batch eligibility groups transactions the way batch close does, and that grouping has no separate bucket for an undetermined card type — so "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"UNKNOWN"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" cannot be selected there and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"CREDIT"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" covers it."},"children":[]}]}]}],"examples":["DEBIT","CREDIT"]}},"components/schemas/ExpiryInput":{"id":"components/schemas/ExpiryInput","kind":"json-schema","title":"ExpiryInput","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Card expiration date supplied on a request. Both fields are numbers, not strings, and the year is the full four-digit year. A response returns a different shape — see "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Expiry"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"additionalProperties":false,"properties":{"month":{"type":"integer","format":"int32","description":"Month of the card expiration date, as a number from 1 to 12.","minimum":1,"maximum":12,"examples":[1]},"year":{"type":"integer","format":"int32","description":"Four-digit year of the card expiration date.","minimum":2020,"maximum":2100,"examples":[2028]}},"required":["month","year"]}},"components/schemas/Expiry":{"id":"components/schemas/Expiry","kind":"json-schema","title":"Expiry","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Card expiration date returned on a response. Both fields are strings. A request uses a different shape — see "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ExpiryInput"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"additionalProperties":false,"properties":{"month":{"type":"string","description":"Month of the card expiration date as a two-digit number","minLength":2,"maxLength":2,"pattern":"^(0[1-9]|1[0-2])$","examples":["01"]},"year":{"type":"string","description":"Year of the card expiration date as a four-digit number.","minLength":4,"maxLength":4,"pattern":"^\\d{4}$","examples":["2028"]}},"required":["month","year"]}},"components/schemas/Email":{"id":"components/schemas/Email","kind":"json-schema","title":"Email","data":{"type":"string","description":"Email address.","format":"email","examples":["james.t.kirk@example.com"],"writeOnly":true}},"components/schemas/EntryMethod":{"id":"components/schemas/EntryMethod","kind":"json-schema","title":"EntryMethod","data":{"type":["string","null"],"enum":["MOTO","ECOMMERCE",null],"default":"ECOMMERCE","x-enumDescriptions":{"MOTO":"A Card Not Present entry method where the payment method information was obtained over the phone or via postal mail.","ECOMMERCE":"A Card Not Present entry method where the payment method information was obtained over the Internet via a web browser."},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"How the payment method information was captured. Both supported values are Card Not Present: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ECOMMERCE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for information taken over the internet through a web browser, and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"MOTO"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for information taken over the phone or by postal mail."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Optional. Defaults to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ECOMMERCE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when omitted or sent as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":["ECOMMERCE"]}},"components/schemas/PaymentMethodInput":{"id":"components/schemas/PaymentMethodInput","kind":"json-schema","title":"PaymentMethodInput","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Schema for payment methods supplied on a transaction create request. Concrete subtypes are discriminated by the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" property."},"children":[]}]}]}],"oneOf":[{"$ref":"#/components/schemas/BankAccountInput","title":"ACH"},{"$ref":"#/components/schemas/CardInput","title":"Card"},{"$ref":"#/components/schemas/PaymentTokenInput","title":"Token"}],"discriminator":{"propertyName":"type","mapping":{"ACH":"#/components/schemas/BankAccountInput","Card":"#/components/schemas/CardInput","Token":"#/components/schemas/PaymentTokenInput"}}}},"components/schemas/PaymentMethodOutput":{"id":"components/schemas/PaymentMethodOutput","kind":"json-schema","title":"PaymentMethodOutput","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Base schema for payment methods returned on a transaction response. Concrete subtypes are discriminated by the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" property."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A response reports the underlying instrument, so "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"CARD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ACH"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Paying with a token is not a third kind of response: send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payment_method.type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Token"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and the gateway resolves the token to the card or bank account behind it, then reports that. The token itself comes back in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payment_token"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on either subtype."},"children":[]}]}]}],"oneOf":[{"$ref":"#/components/schemas/CardOutput","title":"CARD"},{"$ref":"#/components/schemas/BankAccountOutput","title":"ACH"}],"discriminator":{"propertyName":"type","mapping":{"ACH":"#/components/schemas/BankAccountOutput","CARD":"#/components/schemas/CardOutput"}}}},"components/schemas/PaymentToken":{"id":"components/schemas/PaymentToken","kind":"json-schema","title":"PaymentToken","data":{"description":"Reference to a previously stored (tokenized) payment method. Null when tokenization was not performed or failed.","type":["string","null"],"examples":["PAYMENT_TOKEN-01KFDKXMQ637EKEAY410MSQSXB"]}},"components/schemas/PaymentTokenInput":{"id":"components/schemas/PaymentTokenInput","kind":"json-schema","title":"PaymentTokenInput","data":{"description":"Reference to a previously stored (tokenized) payment method supplied on a request.","type":"object","required":["type","payment_token"],"properties":{"type":{"$ref":"#/components/schemas/PaymentMethodTypeInput","const":"Token","description":"The type of payment method.","examples":["Token"]},"payment_token":{"$ref":"#/components/schemas/PaymentToken"}},"additionalProperties":false}},"components/schemas/BatchStatusDto":{"id":"components/schemas/BatchStatusDto","kind":"json-schema","title":"BatchStatusDto","data":{"type":"object","description":"Summary status for a single batch.","properties":{"batch_id":{"type":["string","null"],"description":"Unique identifier of the batch.","examples":["BATCH-01KEW32V6YNV11T33XGDR7TGWC"]},"status":{"type":["string","null"],"description":"Current processing status of the batch.","examples":["in_progress"]}},"additionalProperties":false}},"components/schemas/BatchStatusResponse":{"id":"components/schemas/BatchStatusResponse","kind":"json-schema","title":"BatchStatusResponse","data":{"type":"object","description":"Response containing the current status of batches for a client.","properties":{"has_in_progress":{"type":["boolean","null"],"description":"Whether the client has any batches currently being processed.","examples":[true]},"in_progress_batches":{"type":["array","null"],"description":"List of batches currently in progress.","items":{"$ref":"#/components/schemas/BatchStatusDto"}},"completed_batches":{"type":["array","null"],"description":"List of batches that have completed processing.","items":{"$ref":"#/components/schemas/BatchStatusDto"}},"max_closed_at":{"type":["string","null"],"format":"date-time","description":"ISO 8601 timestamp of the most recently closed batch.","examples":["2026-07-15T23:00:12Z"]},"correlation_id":{"$ref":"#/components/schemas/CorrelationId"}},"additionalProperties":false}},"components/schemas/BatchType":{"id":"components/schemas/BatchType","kind":"json-schema","title":"BatchType","data":{"type":"string","description":"The type of batch.","enum":["Credit","Debit"],"x-enumDescriptions":{"Credit":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Credit batch — contains credit/sale transactions."},"children":[]}]}]}],"Debit":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Debit batch — contains debit transactions."},"children":[]}]}]}]},"examples":["Credit","Debit"]}},"components/schemas/Phone":{"id":"components/schemas/Phone","kind":"json-schema","title":"Phone","data":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Phone number. The phone number must contain between 10 and 12 digits and can contain spaces, a leading "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"+"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" symbol (when used with a country  code), and the special characters "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"("},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":")"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"-"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Alphabetical  characters are not allowed."},"children":[]}]}]}],"format":"tel","pattern":"^(\\+\\d{1,2})?[\\s.-]?\\(?\\d{3}\\)?[\\s.-]?\\d{3}[\\s.-]?\\d{4}$","examples":["+18005551234","+1-800-555-1234","800.555.1245","800 555 1234"]}},"components/schemas/PhoneNullable":{"id":"components/schemas/PhoneNullable","kind":"json-schema","title":"PhoneNullable","data":{"oneOf":[{"$ref":"#/components/schemas/Phone"},{"type":"null"}],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Phone number. The phone number must contain between 10 and 12 digits and can contain spaces, a leading "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"+"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" symbol (when used with a country  code), and the special characters "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"("},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":")"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"-"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Alphabetical  characters are not allowed."},"children":[]}]}]}],"examples":["+17035550123",null]}},"components/schemas/TransactionCreateRequest":{"id":"components/schemas/TransactionCreateRequest","kind":"json-schema","title":"TransactionCreateRequest","data":{"required":["amount","payment_method","type"],"type":"object","description":"Request body for creating a new payment transaction.","properties":{"type":{"$ref":"#/components/schemas/TransactionCreateType","examples":["SALE"]},"amount":{"$ref":"#/components/schemas/Amount"},"tip":{"$ref":"#/components/schemas/Tip"},"currency":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Three-letter ISO 4217 currency code. Optional; defaults to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"USD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", which is the only value the gateway accepts."},"children":[]}]}]}],"const":"USD","default":"USD","examples":["USD"]},"payment_method":{"$ref":"#/components/schemas/PaymentMethodInput"},"initiator":{"$ref":"#/components/schemas/Initiator","description":"The initiator of the transaction."},"recurring":{"type":"boolean","default":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Marks the transaction as part of a recurring payment agreement. Supplying "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"recurring_details"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" has the same effect on most paths, but set this flag explicitly on a recurring charge."},"children":[]}]}]}],"examples":[true]},"recurring_details":{"$ref":"#/components/schemas/RecurringDetails"},"metadata":{"$ref":"#/components/schemas/Metadata"}},"additionalProperties":false}},"components/schemas/TransactionCaptureRequest":{"id":"components/schemas/TransactionCaptureRequest","kind":"json-schema","title":"TransactionCaptureRequest","data":{"required":["amount"],"type":"object","description":"Request body for capturing a previously authorized transaction.","properties":{"amount":{"$ref":"#/components/schemas/Amount"},"tip":{"$ref":"#/components/schemas/Tip"}}}},"components/schemas/TransactionCreateType":{"id":"components/schemas/TransactionCreateType","kind":"json-schema","title":"TransactionCreateType","data":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The type of transaction to create. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /v1/transactions"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" accepts these three. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"REFUND"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"VOID"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are served by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /v1/transactions/{id}/cancel"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"CAPTURE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /v1/transactions/{id}/capture"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Which of the three applies depends on the payment method: a card takes "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"SALE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"AUTH"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", a bank account takes "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"SALE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"PAYOUT"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A payment token resolves to whichever instrument it was issued for, so the applicable pair is not known until the gateway detokenizes it."},"children":[]}]}]}],"enum":["SALE","AUTH","PAYOUT"],"x-enumDescriptions":{"SALE":"Requests payment card or ACH authorization with an immediate, automatic capture of authorized funds. Includes payment cards and ACH debits. Funds transferred from customer to merchant.","AUTH":"Requests payment card authorization that is not automatically captured. Completed by a manual capture of the authorized funds.","PAYOUT":"An ACH credit. Funds transferred from merchant to customer."},"examples":["SALE"]}},"components/schemas/TransactionType":{"id":"components/schemas/TransactionType","kind":"json-schema","title":"TransactionType","data":{"type":"string","description":"The type of transaction.","enum":["SALE","AUTH","PAYOUT","REFUND","VOID","CAPTURE"],"x-enumDescriptions":{"SALE":"Requests payment card or ACH authorization with an immediate, automatic capture of authorized funds. Includes payment cards and ACH debits.  Funds transferred from customer to merchant.","AUTH":"Requests for payment card authorization that is not automatically captured.  Transaction is completed by manual capture of authorized funds.","PAYOUT":"An ACH credit. Funds tranferred from merchant to customer.","REFUND":"Refunds a settled payment. Funds tranferred from merchant to customer.","VOID":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Cancels a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"SALE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or captured "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"AUTH"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" before settlement."},"children":[]}]}]}],"CAPTURE":"Manually captures an authorized payment."},"examples":["SALE"]}},"components/schemas/TransactionResponseType":{"id":"components/schemas/TransactionResponseType","kind":"json-schema","title":"TransactionResponseType","data":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The type of transaction, as reported on a response. This is not the same set a request may ask for — see "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"TransactionCreateType"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A cancelled payment is reported as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"CANCEL"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", never as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"VOID"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"enum":["SALE","AUTH","INCREMENTAL_AUTH","PAYOUT","REFUND","CANCEL","CAPTURE"],"x-enumDescriptions":{"SALE":"Payment card or ACH authorization with an immediate, automatic capture of the authorized funds. Funds transferred from customer to merchant.","AUTH":"Payment card authorization that was not automatically captured, and is completed by a manual capture.","INCREMENTAL_AUTH":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An authorization that raised the amount held by an earlier "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"AUTH"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"PAYOUT":"An ACH credit. Funds transferred from merchant to customer.","REFUND":"A refund of a settled payment. Funds transferred from merchant to customer.","CANCEL":"A payment cancelled before settlement. Covers a void, a reversal, and a reversed transaction, which the gateway reports under this single value.","CAPTURE":"Manual capture of an authorized payment."},"examples":["SALE"]}},"components/schemas/PaymentMethodTypeInput":{"id":"components/schemas/PaymentMethodTypeInput","kind":"json-schema","title":"PaymentMethodTypeInput","data":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The type of payment method supplied on a request. A response returns a different set of values — see "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"PaymentMethodTypeOutput"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"enum":["ACH","Card","Token"],"x-enumDescriptions":{"ACH":"A bank account debited or credited over ACH.","Card":"A credit or debit card.","Token":"A stored payment method, referenced by its token."},"examples":["ACH","Card","Token"]}},"components/schemas/PaymentMethodTypeOutput":{"id":"components/schemas/PaymentMethodTypeOutput","kind":"json-schema","title":"PaymentMethodTypeOutput","data":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The type of payment method returned on a response. A request supplies a different set of values — see "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"PaymentMethodTypeInput"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A token-funded transaction reports the instrument the token resolves to, so there is no separate token value here. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"PaymentMethodTypeInput"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" still accepts "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Token"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on the way in."},"children":[]}]}]}],"enum":["ACH","CARD"],"x-enumDescriptions":{"ACH":"A bank account debited or credited over ACH.","CARD":"A credit or debit card."},"examples":["ACH","CARD"]}},"components/schemas/RecurringDetails":{"id":"components/schemas/RecurringDetails","kind":"json-schema","title":"RecurringDetails","data":{"type":"object","description":"Stored-credential details. Present only when the transaction is part of a recurring payment agreement; omit for one-off transactions. Identifies the transaction's position within the agreement.","required":["sequence"],"properties":{"sequence":{"$ref":"#/components/schemas/RecurringSequence"},"initial_transaction_id":{"type":["string","null"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The transaction ID of the initial customer-initiated (CIT) transaction that established the recurring payment agreement. Required when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sequence"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"SUBSEQUENT"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; omit (or send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") on the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INITIAL"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" transaction."},"children":[]}]}]}],"examples":["TRANSACTION-01KEW32V6YNV11T336VEDKL123"]},"initial_network_transaction_id":{"type":["string","null"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The network-assigned transaction identifier (Visa Transaction ID / Mastercard Trace ID) returned on the initial authorization that established the agreement. Supply this only when the initial transaction was processed outside this gateway (e.g. migration from another provider). When "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"initial_transaction_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" references a transaction processed by this gateway, the network ID is resolved automatically and this field may be omitted."},"children":[]}]}]}],"examples":["MCC1234567890"]}},"additionalProperties":false}},"components/schemas/RecurringSequence":{"id":"components/schemas/RecurringSequence","kind":"json-schema","title":"RecurringSequence","data":{"type":"string","description":"The position of this transaction within a recurring payment agreement.","enum":["INITIAL","SUBSEQUENT"],"x-enumDescriptions":{"INITIAL":"The first, customer-initiated (CIT) transaction in the agreement. Establishes the stored credential.","SUBSEQUENT":"A follow-on transaction billed against the agreement established by the INITIAL transaction. Usually merchant-initiated (MIT)."},"examples":["INITIAL"]}},"components/schemas/TransactionRefundRequest":{"id":"components/schemas/TransactionRefundRequest","kind":"json-schema","title":"TransactionRefundRequest","data":{"required":["type","amount"],"type":"object","description":"Request body for refunding a settled transaction.","properties":{"type":{"$ref":"#/components/schemas/TransactionType","const":"REFUND","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Discriminates this request from a void. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"TransactionRequestConverter"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" handles only "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"VOID"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"REFUND"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on this operation."},"children":[]}]}]}],"examples":["REFUND"]},"amount":{"$ref":"#/components/schemas/Amount","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Refund amount in cents (e.g. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"10000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" = $100.00). Amount must be  less than or equal to the transaction amount."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Maximum 99,999,999 cents ($999,999.99). All transactions are in US dollars (USD)."},"children":[]}]}]}],"examples":[2500]}},"additionalProperties":false}},"components/schemas/Result":{"id":"components/schemas/Result","kind":"json-schema","title":"Result","data":{"type":"string","enum":["APPROVED","DECLINED","ERROR"],"x-enumDescriptions":{"APPROVED":"The transaction was approved by the issuer.","DECLINED":"The transaction was declined by the issuer.","ERROR":"The transaction experienced an error after it was successfully created by the API server."},"examples":["APPROVED"]}},"components/schemas/SettlementIssue":{"id":"components/schemas/SettlementIssue","kind":"json-schema","title":"SettlementIssue","data":{"type":["string","null"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An issue preventing the transaction from settling. Null when there is no issue — because the transaction was canceled, has already settled, or is still in an open batch. Read "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"is_settled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to see whether it settled."},"children":[]}]}]}],"enum":["REMOVED_FROM_BATCH",null],"x-enumDescriptions":{"REMOVED_FROM_BATCH":"The transaction was removed from its batch before settlement."},"examples":["REMOVED_FROM_BATCH"]}},"components/schemas/Tip":{"id":"components/schemas/Tip","kind":"json-schema","title":"Tip","data":{"type":"integer","format":"int32","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Tip amount in cents (e.g. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" = $10.00). If no tip is included, use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or omit the field."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is the whole charge and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"tip"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" declares how much of it is gratuity. The two are not added together: a $100.00 bill with a $20.00 tip is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount: 12000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"tip: 2000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and the cardholder is charged $120.00. The tip is reported to the processor separately at settlement and never increases the settled amount."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Minimum 0 cents ($0.00). Maximum 99,999,999 cents ($999,999.99). All transactions are in US dollars (USD)."},"children":[]}]}]}],"minimum":0,"maximum":99999999,"examples":[0,1000]}},"components/schemas/TimeCreated":{"id":"components/schemas/TimeCreated","kind":"json-schema","title":"TimeCreated","data":{"type":"string","format":"date-time","description":"the API server generated time indicating when the object was created.  In ISO-8601 format (YYYY-MM-DDTHH:MM:SS.SSSZ).","examples":["2026-01-15T14:30:00Z"]}},"components/schemas/TransactionResponse":{"id":"components/schemas/TransactionResponse","kind":"json-schema","title":"TransactionResponse","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Response returned after processing a payment transaction."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The transaction endpoints and the reporting endpoints return this same object, and a transaction response is the earlier of the two. Some values are not known when the gateway answers the original request — they arrive from the processor seconds, minutes, or hours later. A field in that position carries a placeholder on the transaction response and its settled value on any reporting read of the same transaction, so read the field's own description before treating the first response as final. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payment_method.card_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is the current example."},"children":[]}]}]}],"properties":{"id":{"type":"string","description":"Unique identifier for the transaction assigned by the API server.","examples":["TRANSACTION-01KEW32V6YNV11T33XGDR7TGWC"]},"reference_transaction_id":{"type":["string","null"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"transaction_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of the transaction that this request  references, that is, the transaction that this request updated,  captured, canceled, or refunded. Null for original transactions."},"children":[]}]}]}],"examples":["TRANSACTION-01KEW32V6YNV11T336VEDKL123"]},"type":{"$ref":"#/components/schemas/TransactionResponseType","examples":["SALE"]},"result":{"$ref":"#/components/schemas/Result"},"client_id":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of the client account that requested this  transaction."},"children":[]}]}]}],"examples":["CLIENT-01JMRSPCK7XVNP3KS8F2W4T6Y"]},"client_dba":{"type":"string","description":"Doing Business As (DBA) name of the client account.","examples":["Acme Jewelry"]},"integrations":{"$ref":"#/components/schemas/Integrations"},"response_code":{"type":"string","description":"Response code generated by the payment processor. ","examples":["00"]},"response_description":{"type":"string","description":"Human-readable description of the transaction outcome.","examples":["Approved"]},"batch_id":{"type":["string","null"],"description":"Unique identifier of the batch containing this transaction. Null when the transaction has not yet been assigned to a batch.","examples":["BATCH-01KEW32V6YNV11T33XGDR7TGWC"]},"is_settled":{"type":"boolean","description":"Whether the transaction is settled.","examples":[false]},"settlement_issue":{"$ref":"#/components/schemas/SettlementIssue"},"is_returned":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Whether the transaction has been returned by the processor. A return is a transaction outcome rather than an API error, it arrives days after the transaction was approved, and it can follow a transaction that has already settled - so read this alongside "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"is_settled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" rather than instead of it. Always false on a card transaction."},"children":[]}]}]}],"examples":[false]},"returned_at":{"type":["string","null"],"format":"date-time","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The time the processor sent the return. In ISO-8601 format (YYYY-MM-DDTHH:MM:SS.SSSZ), UTC, matching "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"time_created"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Null when the transaction has not been returned."},"children":[]}]}]}],"examples":["2026-09-02T15:38:07.8304618Z"]},"return_code":{"type":["string","null"],"description":"The NACHA return code, three characters. Omitted entirely when the transaction has not been returned, and omitted on a returned transaction the processor sent no code for - not sent as null.","examples":["R03"]},"return_reason":{"type":["string","null"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Human-readable description of the reason the processor returned the transaction. Omitted entirely when the transaction has not been returned, the way "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"return_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is - not sent as null."},"children":[]}]}]}],"examples":["NO ACCOUNT/ UNABLE TO LOCATE ACCOUNT"]},"time_created":{"$ref":"#/components/schemas/TimeCreated"},"amount":{"$ref":"#/components/schemas/Amount"},"tip":{"$ref":"#/components/schemas/Tip"},"currency":{"type":"string","description":"Three-letter ISO 4217 currency code for the transaction.","const":"USD","examples":["USD"]},"payment_method":{"$ref":"#/components/schemas/PaymentMethodOutput"},"recurring":{"type":"boolean","description":"Whether the transaction is part of a recurring payment agreement.","examples":[false]},"initiator":{"oneOf":[{"$ref":"#/components/schemas/Initiator"},{"type":"null"}],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Who initiated the transaction. Null on a transaction read back through "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v1/transactions/{id}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", which does not currently return the value supplied on create. Tracked as a gateway defect — treat the value from the create response as authoritative."},"children":[]}]}]}]},"recurring_details":{"oneOf":[{"$ref":"#/components/schemas/RecurringDetails"},{"type":"null"}],"description":"Stored-credential details for the recurring agreement this transaction belongs to. Null on a one-off transaction."},"network_transaction_id":{"type":["string","null"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The network-assigned transaction identifier (Visa Transaction ID / Mastercard Trace ID) assigned by the card network. On the initial transaction of a recurring agreement, store this value and supply it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"recurring.initial_network_transaction_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on subsequent transactions billed against the agreement (required when those transactions are processed by a different gateway). Null when the network did not return an identifier."},"children":[]}]}]}],"examples":["MCC1234567890"]},"metadata":{"$ref":"#/components/schemas/Metadata"}},"additionalProperties":false}},"components/schemas/TransactionCancelRequest":{"id":"components/schemas/TransactionCancelRequest","kind":"json-schema","title":"TransactionCancelRequest","data":{"required":["type"],"type":"object","description":"Request body for canceling (voiding) an authorized but unsettled transaction.","properties":{"type":{"$ref":"#/components/schemas/TransactionType","const":"VOID","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Discriminates this request from a refund. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"TransactionRequestConverter"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" handles only "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"VOID"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"REFUND"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on this operation."},"children":[]}]}]}],"examples":["VOID"]}},"additionalProperties":false}},"components/schemas/TransactionsListResponse":{"id":"components/schemas/TransactionsListResponse","kind":"json-schema","title":"TransactionsListResponse","data":{"type":"object","description":"Paginated list of transactions.","properties":{"total_count":{"type":"integer","format":"int32","description":"Total number of transactions matching the query.","examples":[42]},"limit":{"type":"integer","format":"int32","description":"Maximum number of records returned in this response.","examples":[100]},"offset":{"type":"integer","format":"int32","description":"Number of records skipped.","examples":[20]},"has_more":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Whether additional records exist beyond this result set. If "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", increment "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"offset"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"limit"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to fetch the next page."},"children":[]}]}]}],"examples":[true]},"transactions":{"type":"array","description":"Array of transaction objects matching the query.","items":{"$ref":"#/components/schemas/TransactionResponse"}}},"additionalProperties":false}},"components/schemas/ClientAdminContactDetails":{"id":"components/schemas/ClientAdminContactDetails","kind":"json-schema","title":"ClientAdminContactDetails","data":{"required":["first_name","last_name","email","time_zone"],"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Contact information for the primary admin user of a client account, as returned on a response. The four required properties are always present and may be null, because a client created through an internal path is not held to the rules "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ClientAdminContactDetailsInput"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" applies. A request uses "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ClientAdminContactDetailsInput"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to create and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ClientAdminContactDetailsUpdate"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to amend."},"children":[]}]}]}],"properties":{"first_name":{"type":["string","null"],"description":"First name of the admin contact.","examples":["John"]},"last_name":{"type":["string","null"],"description":"Last name of the admin contact.","examples":["Doe"]},"email":{"type":["string","null"],"format":"email","description":"Email address of the admin contact. Used as the login username.","examples":["john.doe@example.com"]},"phone":{"$ref":"#/components/schemas/PhoneNullable"},"time_zone":{"$ref":"#/components/schemas/TimeZone"}},"additionalProperties":false}},"components/schemas/ClientAdminContactDetailsInput":{"id":"components/schemas/ClientAdminContactDetailsInput","kind":"json-schema","title":"ClientAdminContactDetailsInput","data":{"required":["first_name","last_name","email","time_zone"],"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Contact information for the primary admin user, supplied when creating a client. The four required properties must each carry a value — null is rejected, and so is an empty string."},"children":[]}]}]}],"properties":{"first_name":{"type":"string","minLength":1,"description":"First name of the admin contact.","examples":["John"]},"last_name":{"type":"string","minLength":1,"description":"Last name of the admin contact.","examples":["Doe"]},"email":{"type":"string","minLength":1,"format":"email","description":"Email address of the admin contact. Used as the login username.","examples":["john.doe@example.com"]},"phone":{"$ref":"#/components/schemas/PhoneNullable"},"time_zone":{"$ref":"#/components/schemas/TimeZone"}},"additionalProperties":false}},"components/schemas/ClientAdminContactDetailsUpdate":{"id":"components/schemas/ClientAdminContactDetailsUpdate","kind":"json-schema","title":"ClientAdminContactDetailsUpdate","data":{"type":"object","description":"Contact information supplied when updating a client. Every property is optional; send only the ones you are changing. Omitting a property leaves it as it was.","properties":{"first_name":{"type":"string","description":"First name of the admin contact.","examples":["John"]},"last_name":{"type":"string","description":"Last name of the admin contact.","examples":["Doe"]},"email":{"type":"string","format":"email","description":"Email address of the admin contact. Used as the login username.","examples":["john.doe@example.com"]},"phone":{"$ref":"#/components/schemas/PhoneNullable"},"time_zone":{"$ref":"#/components/schemas/TimeZone"}},"additionalProperties":false}},"components/schemas/ClientDTO":{"id":"components/schemas/ClientDTO","kind":"json-schema","title":"ClientDTO","data":{"required":["active","id"],"type":"object","description":"Summary representation of a client account.","properties":{"id":{"type":"string","description":"Unique identifier for the client assigned by the API server.","examples":["CLIENT-3MTWBWLKDIWHU7IX28A3TQPA"]},"dba":{"type":["string","null"],"description":"Doing Business As (DBA) name of the client.","examples":["Acme Jewelry"]},"first_name":{"type":["string","null"],"description":"First name of the primary admin contact.","examples":["John"]},"last_name":{"type":["string","null"],"description":"Last name of the primary admin contact.","examples":["Doe"]},"email_address":{"type":["string","null"],"format":"email","description":"Email address of the primary admin contact.","examples":["john.doe@example.com"]},"phone_number":{"$ref":"#/components/schemas/PhoneNullable"},"parent_id":{"type":["string","null"],"description":"Unique identifier of the parent client account.","examples":["CLIENT-01JMRSPCK7XVNP3KS8F2W4T6Y"]},"active":{"type":"boolean","description":"Whether the client account is active.","examples":[true]},"date_added":{"type":["string","null"],"format":"date-time","description":"ISO 8601 timestamp of when the client account was created.","examples":["2026-02-11T09:24:17Z"]},"metadata":{"type":["object","null"],"description":"Arbitrary key-value metadata attached to the client account.","examples":[{"crm_account_id":"CRM-88213","onboarding_rep":"jsmith"}]}},"additionalProperties":false}},"components/schemas/ClientDetailsDTO":{"id":"components/schemas/ClientDetailsDTO","kind":"json-schema","title":"ClientDetailsDTO","data":{"required":["active","dba","id"],"type":"object","description":"Detailed representation of a client account including audit metadata.","properties":{"id":{"type":"string","description":"Unique identifier for the client assigned by the API server.","examples":["CLIENT-3MTWBWLKDIWHU7IX28A3TQPA"]},"dba":{"type":"string","description":"Doing Business As (DBA) name of the client.","examples":["Acme Jewelry"]},"user_id":{"type":["string","null"],"description":"Identifier of the admin user associated with this client.","examples":["USER-3MTWBWLKDIWHU7IX28A3TQPA"]},"parent_id":{"type":["string","null"],"description":"Unique identifier of the parent client account.","examples":["CLIENT-01JMRSPCK7XVNP3KS8F2W4T6Y"]},"effective":{"type":["string","null"],"format":"date-time","description":"ISO 8601 timestamp of when the client account became effective.","examples":["2026-02-11T00:00:00Z"]},"expiry":{"type":["string","null"],"format":"date-time","description":"ISO 8601 timestamp of when the client account expires. Null if no expiry.","examples":[null]},"active":{"type":"boolean","description":"Whether the client account is active.","examples":[true]},"modified":{"type":["string","null"],"format":"date-time","description":"ISO 8601 timestamp of the last modification to this record.","examples":["2026-06-30T14:02:51Z"]},"modified_by":{"type":["integer","null"],"format":"int32","description":"Internal ID of the user who last modified this record.","examples":[1042]},"metadata":{"$ref":"#/components/schemas/Metadata"}},"additionalProperties":false}},"components/schemas/ClientType":{"id":"components/schemas/ClientType","kind":"json-schema","title":"ClientType","data":{"type":"string","description":"The type of client account.","enum":["reseller","merchant"],"x-enumDescriptions":{"reseller":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Reseller — a client that resells services to merchants."},"children":[]}]}]}],"merchant":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Merchant — a client that processes payments."},"children":[]}]}]}]},"examples":["reseller","merchant"]}},"components/schemas/CorrelationId":{"id":"components/schemas/CorrelationId","kind":"json-schema","title":"CorrelationId","data":{"type":"string","description":"Identifier the gateway assigns to the request and carries across the services that handled it. Quote it when reporting a problem.","examples":["01KFDKXMQ637EKEAY410MSQSXB"]}},"components/schemas/CreateClientRequest":{"id":"components/schemas/CreateClientRequest","kind":"json-schema","title":"CreateClientRequest","data":{"required":["admin_contact_details","dba","parent_id","type"],"type":"object","description":"Request body for creating a new client account.","properties":{"parent_id":{"minLength":1,"type":"string","description":"Unique identifier of the parent client account (reseller or ISO).","examples":["CLIENT-01JMRSPCK7XVNP3KS8F2W4T6Y"]},"type":{"$ref":"#/components/schemas/ClientType"},"dba":{"minLength":1,"type":"string","description":"Doing Business As (DBA) name for the new client.","examples":["Acme Jewelry"]},"address":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"One or more client addresses. Each address carries a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" identifying its purpose (legal, billing, or physical)."},"children":[]}]}]}],"items":{"$ref":"#/components/schemas/ClientAddress"}},"primary_phone":{"$ref":"#/components/schemas/PhoneNullable","description":"Client primary phone number","examples":["+18006555667"]},"support_phone":{"$ref":"#/components/schemas/PhoneNullable","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Client support or customer service phone number. If left blank, this number will default to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"primary_phone"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":["+18005255656"]},"website":{"type":"string","format":"url","description":"URL of client website","examples":["https://www.acme.com"]},"admin_contact_details":{"$ref":"#/components/schemas/ClientAdminContactDetailsInput"},"metadata":{"$ref":"#/components/schemas/Metadata"}},"additionalProperties":false}},"components/schemas/CreateClientResponse":{"id":"components/schemas/CreateClientResponse","kind":"json-schema","title":"CreateClientResponse","data":{"required":["admin_contact_details","api_key","dba","id","parent_id","type"],"type":"object","description":"Response returned after successfully creating a new client account.","properties":{"id":{"minLength":1,"type":"string","description":"Unique identifier for the newly created client assigned by the API server.","examples":["CLIENT-3MTWBWLKDIWHU7IX28A3TQPA"]},"parent_id":{"minLength":1,"type":"string","description":"Unique identifier of the parent client account.","examples":["CLIENT-01JMRSPCK7XVNP3KS8F2W4T6Y"]},"type":{"$ref":"#/components/schemas/ClientType"},"dba":{"minLength":1,"type":"string","description":"Doing Business As (DBA) name of the newly created client.","examples":["Acme Jewelry"]},"address":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"One or more client addresses. Each address carries a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" identifying its purpose (legal, billing, or physical)."},"children":[]}]}]}],"items":{"$ref":"#/components/schemas/ClientAddress"}},"primary_phone":{"$ref":"#/components/schemas/PhoneNullable","description":"Client primary phone number","examples":["+18006555667"]},"support_phone":{"$ref":"#/components/schemas/PhoneNullable","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Client support or customer service phone number. If left blank, this number will default to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"primary_phone"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":["+18005255656"]},"website":{"type":["string","null"],"format":"url","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"URL of client website. Null when the client was created without one — the gateway returns the field rather than omitting it."},"children":[]}]}]}],"examples":["https://www.acme.com"]},"admin_contact_details":{"$ref":"#/components/schemas/ClientAdminContactDetails"},"api_key":{"minLength":1,"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key issued for the new client. Returned once, on this response only — store it, because no later call returns it again."},"children":[]}]}]}],"examples":["pk_live_01KFDKXMQ637EKEAY410MSQSXB"]},"metadata":{"$ref":"#/components/schemas/Metadata"},"correlation_id":{"$ref":"#/components/schemas/CorrelationId"}},"additionalProperties":false}},"components/schemas/GetAllClientsResponse":{"id":"components/schemas/GetAllClientsResponse","kind":"json-schema","title":"GetAllClientsResponse","data":{"required":["all_clients"],"type":"object","description":"Response containing a list of all client accounts accessible to the caller.","properties":{"all_clients":{"type":"array","description":"List of client account summaries.","items":{"$ref":"#/components/schemas/ClientDTO"}},"correlation_id":{"$ref":"#/components/schemas/CorrelationId"}},"additionalProperties":false}},"components/schemas/GetClientResponse":{"id":"components/schemas/GetClientResponse","kind":"json-schema","title":"GetClientResponse","data":{"required":["client_details"],"type":"object","description":"Response containing details for a specific client account.","properties":{"client_details":{"$ref":"#/components/schemas/ClientDetailsDTO"},"correlation_id":{"$ref":"#/components/schemas/CorrelationId"}},"additionalProperties":false}},"components/schemas/Integrations":{"id":"components/schemas/Integrations","kind":"json-schema","title":"Integrations","data":{"type":"array","description":"Third-party integrations tied to the merchant account for this transaction. Includes the payment processor that processed the payment and may include additional services (e.g. network token providers) as offerings expand.","items":{"$ref":"#/components/schemas/IntegrationsEnum"},"examples":[["TSYS"]]}},"components/schemas/IntegrationsEnum":{"id":"components/schemas/IntegrationsEnum","kind":"json-schema","title":"IntegrationsEnum","data":{"type":"string","enum":["TSYS","VERICHECK"],"x-enumDescriptions":{"TSYS":"The TSYS card processor. Returned on card transactions.","VERICHECK":"The Vericheck ACH processor. Returned on bank account (ACH) transactions."},"examples":["TSYS"]}},"components/schemas/Initiator":{"id":"components/schemas/Initiator","kind":"json-schema","title":"Initiator","data":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Who initiated the transaction, per the card-network stored-credential framework. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"CUSTOMER"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" = customer-initiated (CIT); "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"MERCHANT"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" = merchant-initiated (MIT)."},"children":[]}]}]}],"enum":["MERCHANT","CUSTOMER","THIRD_PARTY"],"x-enumDescriptions":{"MERCHANT":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Merchant-initiated transaction (MIT) — billed without the cardholder present."},"children":[]}]}]}],"CUSTOMER":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Customer-initiated transaction (CIT) — the cardholder is actively present."},"children":[]}]}]}],"THIRD_PARTY":"Initiated by a third party on the merchant's behalf."},"examples":["CUSTOMER"]}},"components/schemas/IntegrationCreateRequest":{"id":"components/schemas/IntegrationCreateRequest","kind":"json-schema","title":"IntegrationCreateRequest","data":{"required":["integration_details","is_active","processor"],"type":"object","description":"Request body for creating a new processor integration for a client.","properties":{"client":{"type":["string","null"],"description":"The client ID to associate with this integration. Defaults to the caller's client if omitted.","examples":["CLIENT-01KFDKXMQ637EKEAY410MSQSXB"]},"is_active":{"type":"boolean","description":"Whether the integration should be active immediately upon creation.","default":false,"examples":[true]},"processor":{"$ref":"#/components/schemas/Processor"},"integration_details":{"$ref":"#/components/schemas/IntegrationDetailRequest"}},"additionalProperties":false}},"components/schemas/IntegrationDetailRequest":{"id":"components/schemas/IntegrationDetailRequest","kind":"json-schema","title":"IntegrationDetailRequest","data":{"oneOf":[{"$ref":"#/components/schemas/TSYSHostDetailsRequest","title":"TSYS"},{"$ref":"#/components/schemas/VericheckOnboardingRequest","title":"Vericheck"}]}},"components/schemas/IntegrationDetailResponse":{"id":"components/schemas/IntegrationDetailResponse","kind":"json-schema","title":"IntegrationDetailResponse","data":{"type":"object","description":"Processor-specific integration details returned in responses. Shape varies by processor.","oneOf":[{"$ref":"#/components/schemas/TSYSHostDetailsResponse"},{"$ref":"#/components/schemas/VericheckOnboardingResponse"}],"properties":{"created_by":{"type":["integer","null"],"format":"int32","description":"Internal ID of the user who created this integration.","examples":[1042]},"created_at":{"type":["string","null"],"format":"date-time","description":"ISO 8601 timestamp of when the integration was created.","examples":["2026-02-11T09:24:17Z"]},"modified_by":{"type":["integer","null"],"format":"int32","description":"Internal ID of the user who last modified this integration.","examples":[1042]},"modified_at":{"type":["string","null"],"format":"date-time","description":"ISO 8601 timestamp of the last modification to this integration.","examples":["2026-06-30T14:02:51Z"]}}}},"components/schemas/IntegrationGetResponse":{"id":"components/schemas/IntegrationGetResponse","kind":"json-schema","title":"IntegrationGetResponse","data":{"required":["integration_details","is_active","processor"],"type":"object","description":"Response containing details for a specific processor integration.","properties":{"id":{"type":["string","null"],"description":"Unique identifier for this integration configuration.","examples":["INTEGRATION-01KFDKXMQ637EKEAY410MSQSXB"]},"is_active":{"type":"boolean","description":"Whether the integration is currently active.","examples":[true]},"client":{"type":["string","null"],"description":"The client ID associated with this integration.","examples":["CLIENT-01KFDKXMQ637EKEAY410MSQSXB"]},"processor":{"$ref":"#/components/schemas/Processor"},"integration_details":{"$ref":"#/components/schemas/IntegrationDetailResponse"},"correlation_id":{"$ref":"#/components/schemas/CorrelationId"}},"additionalProperties":false}},"components/schemas/IntegrationSummary":{"id":"components/schemas/IntegrationSummary","kind":"json-schema","title":"IntegrationSummary","data":{"required":["is_active","processor"],"type":"object","description":"Summary of a processor integration returned in list responses.","properties":{"id":{"type":["string","null"],"description":"Unique identifier for this integration configuration.","examples":["INTEGRATION-01KFDKXMQ637EKEAY410MSQSXB"]},"processor":{"$ref":"#/components/schemas/Processor"},"is_active":{"type":"boolean","description":"Whether the integration is currently active.","examples":[true]}},"additionalProperties":false}},"components/schemas/IntegrationSummaryResponse":{"id":"components/schemas/IntegrationSummaryResponse","kind":"json-schema","title":"IntegrationSummaryResponse","data":{"required":["integrations"],"type":"object","description":"Response containing a list of processor integrations.","properties":{"integrations":{"type":"array","description":"The integrations the client account has onboarded with.","items":{"$ref":"#/components/schemas/IntegrationSummary"}},"correlation_id":{"$ref":"#/components/schemas/CorrelationId"}},"additionalProperties":false}},"components/schemas/IntegrationUpdateRequest":{"id":"components/schemas/IntegrationUpdateRequest","kind":"json-schema","title":"IntegrationUpdateRequest","data":{"required":["integration_details","is_active","processor"],"type":"object","description":"Request body for updating an existing processor integration.","properties":{"is_active":{"type":"boolean","description":"Whether the integration should be active after this update.","examples":[false]},"processor":{"$ref":"#/components/schemas/Processor"},"integration_details":{"$ref":"#/components/schemas/IntegrationDetailRequest"}},"additionalProperties":false}},"components/schemas/Metadata":{"id":"components/schemas/Metadata","kind":"json-schema","title":"Metadata","data":{"type":["object","null"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Key-value pairs for storing additional information on the transaction. Send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to clear all metadata."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"At most 50 keys. Keys may contain letters, digits, hyphens, and underscores, up to 40 characters. Values are strings up to 500 characters. Every limit below is enforced; a request that exceeds any of them is rejected."},"children":[]}]}]}],"maxProperties":50,"propertyNames":{"pattern":"^[a-zA-Z0-9_-]+$","maxLength":40},"additionalProperties":{"type":"string","maxLength":500},"examples":[{"order_id":"ORD-10432","sales_channel":"web","customer_reference":"cust-8891"}]}},"components/schemas/UpdateClientsRequest":{"id":"components/schemas/UpdateClientsRequest","kind":"json-schema","title":"UpdateClientsRequest","data":{"type":"object","description":"Request body for updating an existing client account. All fields are optional; omit to leave unchanged.","properties":{"dba":{"type":["string","null"],"description":"Updated Doing Business As (DBA) name for the client.","examples":["Acme Jewelry & Watches"]},"type":{"$ref":"#/components/schemas/ClientType"},"admin_contact_details":{"$ref":"#/components/schemas/ClientAdminContactDetailsUpdate"},"metadata":{"$ref":"#/components/schemas/Metadata"}},"additionalProperties":false}},"components/schemas/Processor":{"id":"components/schemas/Processor","kind":"json-schema","title":"Processor","data":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The payment processor or service provider for the integration. Send the value exactly as spelled here. On the integration operations the gateway parses this field case-sensitively, so "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"TSYS"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is rejected."},"children":[]}]}]}],"enum":["Tsys","Vericheck"],"x-enumDescriptions":{"Tsys":"TSYS payment processor","Vericheck":"Vericheck ACH processor"},"examples":["Tsys"]}},"components/schemas/SortOrder":{"id":"components/schemas/SortOrder","kind":"json-schema","title":"SortOrder","data":{"type":"string","description":"The sort order for list results.","enum":["ASC","DESC"],"x-enumDescriptions":{"ASC":"Ascending order (oldest first).","DESC":"Descending order (newest first)."},"examples":["DESC"]}},"components/schemas/StandardEntryClass":{"id":"components/schemas/StandardEntryClass","kind":"json-schema","title":"StandardEntryClass","data":{"type":"string","description":"ACH Standard Entry Class (SEC) code that defines the transaction type and authorization method.","enum":["PPD","CCD","WEB","TEL","POP","BOC"],"x-enumDescriptions":{"PPD":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Prearranged Payment and Deposit — consumer account transactions authorized in writing."},"children":[]}]}]}],"CCD":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Corporate Credit or Debit — business-to-business ACH transactions."},"children":[]}]}]}],"WEB":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Internet-initiated entries — consumer transactions authorized via the internet."},"children":[]}]}]}],"TEL":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Telephone-initiated entries — consumer transactions authorized by phone."},"children":[]}]}]}],"POP":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Point-of-Purchase — check conversion transactions at the point of sale."},"children":[]}]}]}],"BOC":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Back Office Conversion — check conversion after the sale."},"children":[]}]}]}]},"examples":["PPD","CCD"]}},"components/schemas/TimeZone":{"id":"components/schemas/TimeZone","kind":"json-schema","title":"TimeZone","data":{"type":"string","description":"The time zone of the account.","enum":["America/Los_Angeles","America/Phoenix","America/Denver","America/Chicago","America/New_York","Pacific/Honolulu","America/Anchorage"],"x-enumDescriptions":{"America/Los_Angeles":"Pacific Time Zone","America/Phoenix":"Mountain Standard Time (MST, no DST)","America/Denver":"Mountain Time Zone","America/Chicago":"Central Time Zone","America/New_York":"Eastern Time Zone","Pacific/Honolulu":"Hawaii-Aleutian Standard Time (HAST)","America/Anchorage":"Alaska Time Zone"},"examples":["America/New_York","America/Los_Angeles"]}},"components/schemas/TSYSHostDetailsRequest":{"id":"components/schemas/TSYSHostDetailsRequest","kind":"json-schema","title":"TSYSHostDetailsRequest","data":{"required":["address1","agent_bank_number","agent_chain_number","amex_number","amex_opt_blue","association","bank_number","bin","descriptor_city","descriptor_postal","descriptor_state","discover_number","industry","mcc","merchant_aba_number","merchant_area_code","merchant_settlement_agent_number","mid","mvv","name","phone_number","reimbursement_attribute","settlement_time","sharing_group","store_number","terminal_id","terminal_number","url","v_number"],"type":"object","description":"TSYS processor-specific configuration details for creating a merchant integration.","properties":{"name":{"type":"string","maxLength":25,"description":"Client legal name as registered with TSYS.","examples":["Acme Jewelry LLC"]},"dba":{"type":["string","null"],"description":"Doing Business As (DBA) name, if different from legal name.","examples":["Acme Jewelry"]},"url":{"type":"string","description":"URL of processor server.","examples":["https://example.apiserver.com"]},"phone_number":{"type":"integer","format":"int64","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Merchant contact phone number, as digits only. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"TsysHostDetailsRequest"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" binds this as a 64-bit integer, so punctuation and a leading "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"+"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are not accepted."},"children":[]}]}]}],"examples":[17035550123]},"fax_number":{"$ref":"#/components/schemas/PhoneNullable","examples":["+17035550199"]},"mid":{"type":"string","description":"Merchant ID (MID) assigned by the payment processor.","examples":["888000001234"]},"amex_number":{"type":"string","description":"American Express identification number for the merchant.","examples":["1234567890"]},"association":{"type":"string","description":"Association or network identifier for the merchant.","examples":["VISA"]},"bin":{"type":"string","description":"Bank Identification Number (BIN) for the acquiring bank.","examples":["431940"]},"discover_number":{"type":"string","description":"Discover network identifier for the merchant.","examples":["601100999999"]},"mcc":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Merchant Category Code (MCC) — four-digit ISO 18245 code classifying the business type."},"children":[]}]}]}],"examples":["5944"]},"bank_number":{"type":"string","maxLength":4,"description":"Acquiring bank number assigned by TSYS.","examples":["1234"]},"industry":{"description":"Industry type identifier for the merchant (processor-specific).","enum":["0","A","B","D","H","L","O","P","R"],"x-enumDescriptions":{"0":"Industry type not specified.","A":"Auto rental","B":"Bank/Financial Institution","D":"Direct Marketing","H":"Hotel","L":"Limited Amount Terminal","O":"Oil Company/Automated Fueling System","P":"Passenger Transport","R":"Retail/Restaurant/Grocery"},"type":"string","examples":["0","A","B","D","H","L","O","P","R"],"default":"R"},"amex_opt_blue":{"type":"boolean","description":"Whether the merchant participates in the American Express OptBlue program.","examples":[true]},"agent_chain":{"type":["string","null"],"description":"Agent chain identifier associated with the merchant account.","examples":["012345"]},"store_number":{"type":"string","description":"Store number for the merchant location, if applicable.","examples":["0001"]},"mvv":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Merchant Verification Value — unique identifier for the merchant's POS system."},"children":[]}]}]}],"examples":["123456"]},"terminal_number":{"type":"string","description":"Terminal number associated with the merchant account.","examples":["0001"]},"agent_bank_number":{"type":"string","description":"Agent bank number assigned by TSYS.","examples":["123456"]},"agent_chain_number":{"type":"string","description":"Agent chain number assigned by TSYS.","examples":["654321"]},"descriptor_postal":{"type":"string","maxLength":10,"description":"ZIP code shown on the cardholder's billing statement descriptor.","examples":["22150"]},"descriptor_city":{"type":"string","maxLength":32,"description":"City shown on the cardholder's billing statement descriptor.","examples":["Springfield"]},"descriptor_state":{"type":"string","maxLength":2,"description":"State shown on the cardholder's billing statement descriptor.","examples":["VA"]},"descriptor_country":{"type":["string","null"],"maxLength":3,"description":"Country shown on the cardholder's billing statement descriptor.","examples":["US"]},"descriptor_phone":{"type":["integer","null"],"format":"int64","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Phone number shown on the cardholder's billing statement descriptor, as digits only. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"TsysHostDetailsRequest"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" binds this as a nullable 64-bit integer, so punctuation and a leading "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"+"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are not accepted."},"children":[]}]}]}],"examples":[17035550123]},"descriptor_store_number":{"type":["string","null"],"maxLength":4,"description":"Store number shown on the cardholder's billing statement descriptor.","examples":["0001"]},"address1":{"type":"string","maxLength":32,"description":"Primary street address of the merchant.","examples":["123 Main St"]},"address2":{"type":["string","null"],"description":"Secondary address line of the merchant.","examples":["Suite 100"]},"descriptor_line3":{"type":["string","null"],"description":"Third line of the billing statement descriptor.","examples":["ACME JEWELRY 703-555-0123"]},"terminal_id":{"type":"string","maxLength":8,"description":"Terminal ID assigned by the processor for the merchant's POS device.","examples":["00000001"]},"v_number":{"type":"string","maxLength":8,"description":"Visa-assigned number for the merchant.","examples":["V1234567"]},"settlement_time":{"type":"string","description":"Daily batch settlement time in HH:MM format (24-hour, local to merchant).","examples":["23:00"]},"merchant_area_code":{"type":"integer","format":"int32","description":"Area code of the merchant's primary phone number.","examples":[703]},"descriptor_area_code":{"type":["integer","null"],"format":"int32","description":"Area code shown on the cardholder's billing statement descriptor.","examples":[703]},"sharing_group":{"type":"string","maxLength":30,"description":"Visa-assigned sharing group identifier specifying which direct debit and EBT networks the merchant's POS device can access.","examples":["AEFGKMQ"]},"merchant_aba_number":{"type":"string","maxLength":9,"description":"Merchant's ABA routing number for settlement.","examples":["123456789"]},"merchant_settlement_agent_number":{"type":"string","maxLength":4,"description":"Settlement agent number assigned to the merchant by TSYS.","examples":["1234"]},"reimbursement_attribute":{"type":"string","description":"Reimbursement attribute code for interchange qualification.","examples":["0"]},"fcsid":{"type":["string","null"],"maxLength":7,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"FCS ID — Fiserv/TSYS internal identifier for the merchant configuration."},"children":[]}]}]}],"examples":["12345"]},"metadata":{"$ref":"#/components/schemas/Metadata"}},"additionalProperties":false}},"components/schemas/TSYSHostDetailsResponse":{"id":"components/schemas/TSYSHostDetailsResponse","kind":"json-schema","title":"TSYSHostDetailsResponse","data":{"required":["merchant_area_code"],"type":"object","description":"TSYS processor-specific configuration details returned in integration responses.","properties":{"name":{"type":["string","null"],"description":"Merchant legal name as registered with TSYS.","examples":["Acme Jewelry LLC"]},"dba":{"type":["string","null"],"description":"Doing Business As (DBA) name.","examples":["Acme Jewelry"]},"url":{"type":["string","null"],"description":"Merchant website URL.","examples":["https://example.apiserver.com"]},"phone_number":{"type":"integer","format":"int64","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Merchant contact phone number, as digits only. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"TsysHostDetailsResponse"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" returns this as a 64-bit integer, so it carries no punctuation and no leading "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"+"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[17035550123]},"fax_number":{"type":["string","null"],"description":"Merchant fax number.","examples":["+17035550199"]},"mid":{"type":["string","null"],"description":"Merchant ID (MID) assigned by the payment processor.","examples":["888000001234"]},"amex_number":{"type":["string","null"],"description":"American Express identification number for the merchant.","examples":["1234567890"]},"association":{"type":["string","null"],"description":"Association or network identifier for the merchant.","examples":["VISA"]},"bin":{"type":["string","null"],"description":"Bank Identification Number (BIN) for the acquiring bank.","examples":["431940"]},"discover_number":{"type":["string","null"],"description":"Discover network identifier for the merchant.","examples":["601100999999"]},"mcc":{"type":["string","null"],"description":"Merchant Category Code (MCC) classifying the business type.","examples":["5944"]},"bank_number":{"type":["string","null"],"description":"Acquiring bank number assigned by TSYS.","examples":["1234"]},"industry":{"type":["string","null"],"description":"Industry type identifier for the merchant.","examples":["R"]},"amex_opt_blue":{"type":["boolean","null"],"description":"Whether the merchant participates in the American Express OptBlue program.","examples":[true]},"agent_chain":{"type":["string","null"],"description":"Agent chain identifier associated with the merchant.","examples":["012345"]},"store_number":{"type":["string","null"],"description":"Store number for the merchant location.","examples":["0001"]},"mvv":{"type":["string","null"],"description":"Merchant Verification Value for the merchant's POS system.","examples":["123456"]},"terminal_number":{"type":["string","null"],"description":"Terminal number associated with the merchant account.","examples":["0001"]},"agent_bank_number":{"type":["string","null"],"description":"Agent bank number assigned by TSYS.","examples":["123456"]},"agent_chain_number":{"type":["string","null"],"description":"Agent chain number assigned by TSYS.","examples":["654321"]},"descriptor_postal":{"type":["string","null"],"description":"ZIP code on the cardholder's billing statement descriptor.","examples":["22150"]},"descriptor_city":{"type":["string","null"],"description":"City on the cardholder's billing statement descriptor.","examples":["Springfield"]},"descriptor_state":{"type":["string","null"],"description":"State on the cardholder's billing statement descriptor.","examples":["VA"]},"descriptor_country":{"type":["string","null"],"description":"Country on the cardholder's billing statement descriptor.","examples":["US"]},"descriptor_phone":{"type":["integer","null"],"format":"int64","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Phone number shown on the cardholder's billing statement descriptor, as digits only. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"TsysHostDetailsResponse"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" returns this as a nullable 64-bit integer, so it carries no punctuation and no leading "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"+"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[17035550123]},"descriptor_store_number":{"type":["string","null"],"description":"Store number on the cardholder's billing statement descriptor.","examples":["0001"]},"address1":{"type":["string","null"],"description":"Primary street address of the merchant.","examples":["123 Main St"]},"address2":{"type":["string","null"],"description":"Secondary address line of the merchant.","examples":["Suite 100"]},"descriptor_line3":{"type":["string","null"],"description":"Third line of the billing statement descriptor.","examples":["ACME JEWELRY 703-555-0123"]},"terminal_id":{"type":["string","null"],"description":"Terminal ID for the merchant's POS device.","examples":["00000001"]},"v_number":{"type":["string","null"],"description":"Visa-assigned number for the merchant.","examples":["V1234567"]},"settlement_time":{"type":["string","null"],"description":"Daily batch settlement time in HH:MM format.","examples":["23:00"]},"merchant_area_code":{"type":"integer","format":"int32","description":"Area code of the merchant's primary phone number.","examples":[703]},"descriptor_area_code":{"type":["integer","null"],"format":"int32","description":"Area code on the cardholder's billing statement descriptor.","examples":[703]},"sharing_group":{"type":["string","null"],"description":"Visa-assigned sharing group identifier for direct debit and EBT network access.","examples":["AEFGKMQ"]},"merchant_aba_number":{"type":["string","null"],"description":"Merchant's ABA routing number for settlement.","examples":["123456789"]},"merchant_settlement_agent_number":{"type":["string","null"],"description":"Settlement agent number for the merchant.","examples":["1234"]},"reimbursement_attribute":{"type":["string","null"],"description":"Reimbursement attribute code for interchange qualification.","examples":["0"]},"fcsid":{"type":["string","null"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"FCS ID — internal identifier for the merchant configuration."},"children":[]}]}]}],"examples":["12345"]},"metadata":{"$ref":"#/components/schemas/Metadata"},"created_by":{"type":["integer","null"],"format":"integer","description":"Internal ID of the user who created this integration.","examples":[1042]},"created_at":{"type":["string","null"],"format":"date-time","description":"ISO 8601 timestamp of when the integration was created.","examples":["2026-02-11T09:24:17Z"]},"modified_by":{"type":["integer","null"],"format":"integer","description":"Internal ID of the user who last modified this integration.","examples":[1042]},"modified_at":{"type":["string","null"],"format":"date-time","description":"ISO 8601 timestamp of the last modification to this integration.","examples":["2026-06-30T14:02:51Z"]}},"additionalProperties":false}},"components/schemas/UpdateClientsResponse":{"id":"components/schemas/UpdateClientsResponse","kind":"json-schema","title":"UpdateClientsResponse","data":{"required":["admin_contact_details","dba","id","parent_id","type"],"type":"object","description":"Response returned after successfully updating a client account.","properties":{"id":{"minLength":1,"type":"string","description":"Unique identifier for the client.","examples":["CLIENT-3MTWBWLKDIWHU7IX28A3TQPA"]},"parent_id":{"minLength":1,"type":"string","description":"Unique identifier of the parent client account.","examples":["CLIENT-01JMRSPCK7XVNP3KS8F2W4T6Y"]},"dba":{"minLength":1,"type":"string","description":"Updated Doing Business As (DBA) name of the client.","examples":["Acme Jewelry"]},"type":{"$ref":"#/components/schemas/ClientType"},"admin_contact_details":{"$ref":"#/components/schemas/ClientAdminContactDetails"},"metadata":{"$ref":"#/components/schemas/Metadata"},"correlation_id":{"$ref":"#/components/schemas/CorrelationId"}},"additionalProperties":false}},"components/schemas/VericheckOnboardingRequest":{"id":"components/schemas/VericheckOnboardingRequest","kind":"json-schema","title":"VericheckOnboardingRequest","data":{"description":"Request object for onboarding merchant to Vericheck.","required":["client_id","client_secret"],"properties":{"client_id":{"description":"Merchant's Client Id provided by Vericheck for API authentication.","type":"string","maxLength":50,"examples":["fe121095-6b52-4fcd-a103-be814684800a"]},"client_secret":{"description":"Merchant's password provided by Vericheck for API authentication.","type":"string","maxLength":50,"examples":["ffc10d27d40241529d97af3gd021f5e7c3bb"]},"metadata":{"$ref":"#/components/schemas/Metadata"}}}},"components/schemas/VericheckOnboardingResponse":{"id":"components/schemas/VericheckOnboardingResponse","kind":"json-schema","title":"VericheckOnboardingResponse","data":{"description":"Response object for onboarding merchant to Vericheck.","required":["client_id"],"properties":{"client_id":{"description":"Merchant's Client Id provided by Vericheck for API authentication.","type":"string","maxLength":50,"examples":["fe121095-6b52-4fcd-a103-be814684800a"]},"client_secret":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Merchant's secret at Vericheck, returned masked. The real value is write-only — send it on the request and do not expect to read it back."},"children":[]}]}]}],"type":"string","readOnly":true,"examples":["******"]},"metadata":{"$ref":"#/components/schemas/Metadata"}}}},"components/schemas/BaseProblem":{"id":"components/schemas/BaseProblem","kind":"json-schema","title":"BaseProblem","data":{"type":"object","additionalProperties":true,"description":"Error response object.","properties":{"error_code":{"type":"string","description":"The Gateway generated error code."},"error_message":{"type":"string","description":"Human-readable explanation that is specific to this occurrence of the problem."},"details":{"type":["object","null"],"description":"The field in the request that caused the error. May be null  if not applicable.","additionalProperties":{"type":"string"}},"source":{"type":["object","null"],"description":"Object containing host-processor-specific error information.  May be null if not applicable.","properties":{"system":{"type":["string","null"],"description":"The host processor name.","examples":["TSYS"]},"code":{"type":["string","null"],"description":"The host processor code.","examples":["51"]},"message":{"type":["string","null"],"description":"The host processor message.","examples":["Insufficient funds"]}}}}}},"components/schemas/BadRequest":{"id":"components/schemas/BadRequest","kind":"json-schema","title":"BadRequest","data":{"type":"object","additionalProperties":true,"description":"Error response object.","properties":{"error_code":{"type":"string","description":"The Gateway generated error code."},"error_message":{"type":"string","description":"Human-readable explanation that is specific to this occurrence of the problem."},"details":{"type":["object","null"],"description":"The field in the request that caused the error. May be null  if not applicable.","additionalProperties":{"type":"string"}},"source":{"type":["object","null"],"description":"Object containing host-processor-specific error information.  May be null if not applicable.","properties":{"system":{"type":["string","null"],"description":"The host processor name.","examples":["TSYS"]},"code":{"type":["string","null"],"description":"The host processor code.","examples":["51"]},"message":{"type":["string","null"],"description":"The host processor message.","examples":["Insufficient funds"]}}}}}},"components/schemas/Conflict":{"id":"components/schemas/Conflict","kind":"json-schema","title":"Conflict","data":{"type":"object","additionalProperties":true,"description":"Error response object.","properties":{"error_code":{"type":"string","description":"The Gateway generated error code."},"error_message":{"type":"string","description":"Human-readable explanation that is specific to this occurrence of the problem."},"details":{"type":["object","null"],"description":"The field in the request that caused the error. May be null  if not applicable.","additionalProperties":{"type":"string"}},"source":{"type":["object","null"],"description":"Object containing host-processor-specific error information.  May be null if not applicable.","properties":{"system":{"type":["string","null"],"description":"The host processor name.","examples":["TSYS"]},"code":{"type":["string","null"],"description":"The host processor code.","examples":["51"]},"message":{"type":["string","null"],"description":"The host processor message.","examples":["Insufficient funds"]}}}}}},"components/schemas/Unauthorized":{"id":"components/schemas/Unauthorized","kind":"json-schema","title":"Unauthorized","data":{"type":"object","additionalProperties":true,"description":"Error response object.","properties":{"error_code":{"type":"string","description":"The Gateway generated error code."},"error_message":{"type":"string","description":"Human-readable explanation that is specific to this occurrence of the problem."},"details":{"type":["object","null"],"description":"The field in the request that caused the error. May be null  if not applicable.","additionalProperties":{"type":"string"}},"source":{"type":["object","null"],"description":"Object containing host-processor-specific error information.  May be null if not applicable.","properties":{"system":{"type":["string","null"],"description":"The host processor name.","examples":["TSYS"]},"code":{"type":["string","null"],"description":"The host processor code.","examples":["51"]},"message":{"type":["string","null"],"description":"The host processor message.","examples":["Insufficient funds"]}}}}}},"components/schemas/Forbidden":{"id":"components/schemas/Forbidden","kind":"json-schema","title":"Forbidden","data":{"type":"object","additionalProperties":true,"description":"Error response object.","properties":{"error_code":{"type":"string","description":"The Gateway generated error code."},"error_message":{"type":"string","description":"Human-readable explanation that is specific to this occurrence of the problem."},"details":{"type":["object","null"],"description":"The field in the request that caused the error. May be null  if not applicable.","additionalProperties":{"type":"string"}},"source":{"type":["object","null"],"description":"Object containing host-processor-specific error information.  May be null if not applicable.","properties":{"system":{"type":["string","null"],"description":"The host processor name.","examples":["TSYS"]},"code":{"type":["string","null"],"description":"The host processor code.","examples":["51"]},"message":{"type":["string","null"],"description":"The host processor message.","examples":["Insufficient funds"]}}}}}},"components/schemas/NotFound":{"id":"components/schemas/NotFound","kind":"json-schema","title":"NotFound","data":{"type":"object","additionalProperties":true,"description":"Error response object.","properties":{"error_code":{"type":"string","description":"The Gateway generated error code."},"error_message":{"type":"string","description":"Human-readable explanation that is specific to this occurrence of the problem."},"details":{"type":["object","null"],"description":"The field in the request that caused the error. May be null  if not applicable.","additionalProperties":{"type":"string"}},"source":{"type":["object","null"],"description":"Object containing host-processor-specific error information.  May be null if not applicable.","properties":{"system":{"type":["string","null"],"description":"The host processor name.","examples":["TSYS"]},"code":{"type":["string","null"],"description":"The host processor code.","examples":["51"]},"message":{"type":["string","null"],"description":"The host processor message.","examples":["Insufficient funds"]}}}}}},"components/schemas/InternalServerError":{"id":"components/schemas/InternalServerError","kind":"json-schema","title":"InternalServerError","data":{"type":"object","additionalProperties":true,"description":"Error response object.","properties":{"error_code":{"type":"string","description":"The Gateway generated error code."},"error_message":{"type":"string","description":"Human-readable explanation that is specific to this occurrence of the problem."},"details":{"type":["object","null"],"description":"The field in the request that caused the error. May be null  if not applicable.","additionalProperties":{"type":"string"}},"source":{"type":["object","null"],"description":"Object containing host-processor-specific error information.  May be null if not applicable.","properties":{"system":{"type":["string","null"],"description":"The host processor name.","examples":["TSYS"]},"code":{"type":["string","null"],"description":"The host processor code.","examples":["51"]},"message":{"type":["string","null"],"description":"The host processor message.","examples":["Insufficient funds"]}}}}}},"components/schemas/BadGateway":{"id":"components/schemas/BadGateway","kind":"json-schema","title":"BadGateway","data":{"type":"object","additionalProperties":true,"description":"Error response object.","properties":{"error_code":{"type":"string","description":"The Gateway generated error code."},"error_message":{"type":"string","description":"Human-readable explanation that is specific to this occurrence of the problem."},"details":{"type":["object","null"],"description":"The field in the request that caused the error. May be null  if not applicable.","additionalProperties":{"type":"string"}},"source":{"type":["object","null"],"description":"Object containing host-processor-specific error information.  May be null if not applicable.","properties":{"system":{"type":["string","null"],"description":"The host processor name.","examples":["TSYS"]},"code":{"type":["string","null"],"description":"The host processor code.","examples":["51"]},"message":{"type":["string","null"],"description":"The host processor message.","examples":["Insufficient funds"]}}}}}},"schema_26":{"kind":"json-schema","data":{"type":"string","format":"ulid","examples":["CLIENT-01KFDKXMQ637EKEAY410MSQSXB","CLIENT-01KFDKXMQ637ETEAY410MSQTUH"]},"id":"schema_26"},"schema_27":{"kind":"json-schema","data":{"type":"object","properties":{"x-request-id":{"type":"string","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","examples":["73039bd9-c380-4186-bffe-259125144a56"],"description":"Unique identifier assigned to the request by the API server. Returned on every response, including errors. Log this value and supply it when contacting support so that a specific request can be traced."}},"required":["x-request-id"]},"id":"schema_27"},"schema_28":{"kind":"json-schema","data":{"title":"BadRequest","$ref":"#/components/schemas/BaseProblem"},"id":"schema_28"},"schema_29":{"kind":"json-schema","data":{"title":"Unauthorized","$ref":"#/components/schemas/BaseProblem"},"id":"schema_29"},"schema_30":{"kind":"json-schema","data":{"title":"Forbidden","$ref":"#/components/schemas/BaseProblem"},"id":"schema_30"},"schema_31":{"kind":"json-schema","data":{"title":"Conflict","$ref":"#/components/schemas/BaseProblem"},"id":"schema_31"},"schema_32":{"kind":"json-schema","data":{"title":"Internal Server Error","$ref":"#/components/schemas/BaseProblem"},"id":"schema_32"},"schema_33":{"kind":"json-schema","data":{"title":"Bad Gateway","$ref":"#/components/schemas/BaseProblem"},"id":"schema_33"},"schema_34":{"kind":"json-schema","data":{"type":"string"},"id":"schema_34"},"schema_35":{"kind":"json-schema","data":{"title":"NotFound","$ref":"#/components/schemas/BaseProblem"},"id":"schema_35"},"schema_36":{"kind":"json-schema","data":{"oneOf":[{"$ref":"#/components/schemas/TransactionCancelRequest"},{"$ref":"#/components/schemas/TransactionRefundRequest"}]},"id":"schema_36"},"schema_37":{"kind":"json-schema","data":{"type":"integer","format":"int32","minimum":1,"maximum":1000,"default":100},"id":"schema_37"},"schema_38":{"kind":"json-schema","data":{"type":"integer","format":"int32","minimum":0,"default":0},"id":"schema_38"},"schema_39":{"kind":"json-schema","data":{"type":"boolean"},"id":"schema_39"},"schema_40":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/CardType"}},"id":"schema_40"},"schema_41":{"kind":"json-schema","data":{"type":"string","enum":["TSYS","VERICHECK"]},"id":"schema_41"},"schema_42":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/TransactionResponseType"}},"id":"schema_42"},"schema_43":{"kind":"json-schema","data":{"type":"string","enum":["APPROVED","DECLINED","ERROR"]},"id":"schema_43"},"schema_44":{"kind":"json-schema","data":{"type":"string","format":"date-time"},"id":"schema_44"},"schema_45":{"kind":"json-schema","data":{"type":"string","enum":["CREATED","TYPE","RESULT"],"x-enumDescriptions":{"CREATED":"Created timestamp.","TYPE":"Transaction type.","RESULT":"Transaction result."},"default":"CREATED"},"id":"schema_45"},"schema_46":{"kind":"json-schema","data":{"type":"string","enum":["ASC","DESC"],"default":"DESC","x-enumDescriptions":{"ASC":"Ascending sort order.","DESC":"Descending sort order."}},"id":"schema_46"},"schema_47":{"kind":"json-schema","data":{"$ref":"#/components/schemas/SortOrder"},"id":"schema_47"},"schema_48":{"kind":"json-schema","data":{"$ref":"#/components/schemas/OpenBatchCardType"},"id":"schema_48"},"schema_49":{"kind":"json-schema","data":{"type":"string","description":"Gateway API generated time indicating when the object was created. ","pattern":"^\\d{2}/\\d{2}/\\d{4} \\d{2}:\\d{2}:\\d{2}$","examples":["05/18/2026 16:49:29","10/28/2026 05:49:29"]},"id":"schema_49"},"schema_50":{"kind":"json-schema","data":{"type":"string","enum":["America/Los_Angeles","America/Phoenix","America/Denver","America/Chicago","America/New_York","Pacific/Honolulu","America/Anchorage"],"x-enumDescriptions":{"America/Los_Angeles":"Pacific Time Zone","America/Phoenix":"Mountain Standard Time (MST, no DST)","America/Denver":"Mountain Time Zone","America/Chicago":"Central Time Zone","America/New_York":"Eastern Time Zone","Pacific/Honolulu":"Hawaii-Aleutian Standard Time (HAST)","America/Anchorage":"Alaska Time Zone"},"examples":["America/New_York","America/Los_Angeles"]},"id":"schema_50"},"schema_51":{"kind":"json-schema","data":{"type":"boolean","default":false},"id":"schema_51"}},"exampleStore":{"components/examples/BadRequestExample":{"id":"components/examples/BadRequestExample","value":{"error_code":"INVALID_REQUEST_DATA","error_message":"The API request contains invalid data.","details":{"amount":"Invalid amount","payment_method.pan":"Malformed PAN"},"source":{"system":"TSYS","code":"13","message":"Invalid amount"}},"summary":"Invalid field value in the request body"},"components/examples/UnauthorizedExample":{"id":"components/examples/UnauthorizedExample","value":{"error_code":"NOT_AUTHENTICATED","error_message":"Access credentials missing or invalid.","details":null,"source":{"system":null,"code":null,"message":null}},"summary":"Missing or invalid API key"},"components/examples/ForbiddenExample":{"id":"components/examples/ForbiddenExample","value":{"error_code":"UNAUTHORIZED_ACTION","error_message":"Requested action is unavailable or forbidden.","details":null,"source":{"system":null,"code":null,"message":null}},"summary":"Authenticated but not authorized for this action"},"components/examples/NotFoundExample":{"id":"components/examples/NotFoundExample","value":{"error_code":"RESOURCE_NOT_FOUND","error_message":"Resource not found.","details":null,"source":{"system":null,"code":null,"message":null}},"summary":"Resource ID does not exist"},"components/examples/ConflictExample":{"id":"components/examples/ConflictExample","value":{"error_code":"DUPLICATE_ACTION","error_message":"Duplicate action requested.","details":null,"source":{"system":"TSYS","code":"12","message":"Invalid transaction"}},"summary":"Duplicate or state-conflicting action"},"components/examples/BadGatewayExample":{"id":"components/examples/BadGatewayExample","value":{"error_code":"DOWNSTREAM_ERROR","error_message":"Downstream service returned invalid or unexpected response.","details":null,"source":{"system":"VERICHECK","code":"502","message":"Bad Gateway"}},"summary":"The processor returned an invalid or unexpected response","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Distinct from a 500. A 500 is a fault inside the gateway; a 502 means the gateway reached the processor and could not use what came back. Both are safe to retry, but only a 502 says the transaction may have been seen by the processor — reconcile before retrying a payment."},"children":[]}]}]}]},"components/examples/InternalServerErrorExample":{"id":"components/examples/InternalServerErrorExample","value":{"error_code":"SYSTEM_ERROR","error_message":"Internal system error.","details":null,"source":{"system":"TSYS","code":"96","message":"System malfunction"}},"summary":"Unhandled server fault or downstream processor error"},"components/examples/SaleWithCardRequestExample":{"id":"components/examples/SaleWithCardRequestExample","value":{"type":"SALE","amount":10000,"tip":0,"payment_method":{"type":"Card","entry_method":"ECOMMERCE","pan":"4012000098765439","expiry":{"month":1,"year":2028},"cvv":"999","first_name":"John","last_name":"Doe","contact":{"phone":"+17035550123","email":"john.doe@example.com"},"billing_address":{"line1":"123 Main St","line2":"Suite 100","city":"Springfield","state":"VA","postal_code":"22150","country":"US"}},"initiator":"CUSTOMER","metadata":{"order_id":"ORD-10432","sales_channel":"web","customer_reference":"cust-8891"}},"summary":"Sale with a card","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A single-step sale that authorizes and captures $100.00 in one call, using full card details. This is the transaction the void, refund, and recurring examples all reference."},"children":[]}]}]}]},"components/examples/SaleWithCardResponseExample":{"id":"components/examples/SaleWithCardResponseExample","value":{"id":"TRANSACTION-01KEW32V6YNV11T33XGDR7TGWC","reference_transaction_id":null,"type":"SALE","result":"APPROVED","client_id":"CLIENT-01KFDKXMQ637EKEAY410MSQSXB","client_dba":"Acme Jewelry","integrations":["TSYS"],"response_code":"00","response_description":"Approved","batch_id":"BATCH-01KEW32V6YNV11T33XGDR7TGWC","is_settled":false,"time_created":"2026-07-15T14:22:05Z","amount":10000,"tip":0,"currency":"USD","payment_method":{"type":"CARD","truncated_pan":"****-****-****-5439","payment_token":"PAYMENT_TOKEN-01KFDKXMQ637EKEAY410MSQSXB","expiry":{"month":"01","year":"2028"},"first_name":"John","last_name":"Doe","entry_method":"keyed","auth_code":"123456","retrieval_reference_number":"000000603076","card_type":"UNKNOWN","card_brand":"Visa","cvv_result_code":"M","avs_result_code":"Y","avs_response":"Exact Match - Street address and postal code match"},"initiator":"CUSTOMER","network_transaction_id":"MCC1234567890","metadata":{"order_id":"ORD-10432","sales_channel":"web","customer_reference":"cust-8891"}},"summary":"Sale with a card — approved","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The approved sale. Because a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"SALE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" authorizes and captures in one step, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"batch_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is already assigned and the transaction settles at the next batch close. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"reference_transaction_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is null because this is an original transaction, not a capture, void, or refund of another one."},"children":[]}]}]}]},"components/examples/TransactionGetResponseExample":{"id":"components/examples/TransactionGetResponseExample","value":{"id":"TRANSACTION-01KEW32V6YNV11T33XGDR7TGWC","reference_transaction_id":null,"type":"SALE","result":"APPROVED","client_id":"CLIENT-01KFDKXMQ637EKEAY410MSQSXB","client_dba":"Acme Jewelry","integrations":["TSYS"],"response_code":"00","response_description":"Approved","batch_id":"BATCH-01KEW32V6YNV11T33XGDR7TGWC","is_settled":false,"time_created":"2026-07-15T14:22:05Z","amount":10000,"tip":0,"currency":"USD","payment_method":{"type":"CARD","truncated_pan":"****-****-****-5439","payment_token":"PAYMENT_TOKEN-01KFDKXMQ637EKEAY410MSQSXB","expiry":{"month":"01","year":"2028"},"first_name":"John","last_name":"Doe","entry_method":"keyed","auth_code":"123456","retrieval_reference_number":"000000603076","card_type":"CREDIT","card_brand":"Visa","cvv_result_code":"M","avs_result_code":"Y","avs_response":"Exact Match - Street address and postal code match"},"initiator":"CUSTOMER","network_transaction_id":"MCC1234567890","metadata":{"order_id":"ORD-10432","sales_channel":"web","customer_reference":"cust-8891"}},"summary":"The same sale, read back from reporting","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The sale from "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"SaleWithCardResponseExample"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", read back after the processor reported the card type. Everything else is unchanged; the one difference is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payment_method.card_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", which was "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"UNKNOWN"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on the transaction response and is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"CREDIT"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" here. See "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"TransactionResponse"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for why the two differ."},"children":[]}]}]}]},"components/examples/SaleWithTokenRequestExample":{"id":"components/examples/SaleWithTokenRequestExample","value":{"type":"SALE","amount":10000,"tip":0,"payment_method":{"type":"Token","payment_token":"PAYMENT_TOKEN-01KFDKXMQ637EKEAY410MSQSXB"},"initiator":"CUSTOMER","metadata":{"order_id":"ORD-10433","sales_channel":"web","customer_reference":"cust-8891"}},"summary":"Sale with a stored payment token","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The same $100.00 sale, charged against a previously stored payment token instead of raw card details. No PAN, expiry, or CVV is sent."},"children":[]}]}]}]},"components/examples/SaleWithTokenResponseExample":{"id":"components/examples/SaleWithTokenResponseExample","value":{"id":"TRANSACTION-01KEW33H5PQ2K8M4VNCDW7YRT9","reference_transaction_id":null,"type":"SALE","result":"APPROVED","client_id":"CLIENT-01KFDKXMQ637EKEAY410MSQSXB","client_dba":"Acme Jewelry","integrations":["TSYS"],"response_code":"00","response_description":"Approved","batch_id":"BATCH-01KEW32V6YNV11T33XGDR7TGWC","is_settled":false,"time_created":"2026-07-15T14:31:47Z","amount":10000,"tip":0,"currency":"USD","payment_method":{"type":"CARD","truncated_pan":"****-****-****-5439","payment_token":"PAYMENT_TOKEN-01KFDKXMQ637EKEAY410MSQSXB","expiry":{"month":"01","year":"2028"},"first_name":"John","last_name":"Doe","entry_method":"keyed","auth_code":"123456","retrieval_reference_number":"000000603076","card_type":"UNKNOWN","card_brand":"Visa","cvv_result_code":"M","avs_result_code":"Y","avs_response":"Exact Match - Street address and postal code match"},"initiator":"CUSTOMER","network_transaction_id":"MCC1234567890","metadata":{"order_id":"ORD-10433","sales_channel":"web","customer_reference":"cust-8891"}},"summary":"Sale with a stored payment token — approved","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The approved token sale. The response reports the card the token resolves to, so "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payment_method.type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"CARD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and the card attributes are present. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payment_token"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" carries the token that funded it."},"children":[]}]}]}]},"components/examples/AuthWithCardRequestExample":{"id":"components/examples/AuthWithCardRequestExample","value":{"type":"AUTH","amount":10000,"tip":0,"payment_method":{"type":"Card","entry_method":"ECOMMERCE","pan":"4012000098765439","expiry":{"month":1,"year":2028},"cvv":"999","first_name":"John","last_name":"Doe","contact":{"phone":"+17035550123","email":"john.doe@example.com"},"billing_address":{"line1":"123 Main St","line2":"Suite 100","city":"Springfield","state":"VA","postal_code":"22150","country":"US"}},"initiator":"CUSTOMER","metadata":{"order_id":"ORD-10434","sales_channel":"web","customer_reference":"cust-8891"}},"summary":"Authorization with a card","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A two-step authorization that reserves $100.00 without capturing it. Capture the resulting transaction with the Capture operation; the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"captureCard"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" example there captures exactly this transaction."},"children":[]}]}]}]},"components/examples/AuthWithCardResponseExample":{"id":"components/examples/AuthWithCardResponseExample","value":{"id":"TRANSACTION-01KEW32V6YNV11T336VEDKL123","reference_transaction_id":null,"type":"AUTH","result":"APPROVED","client_id":"CLIENT-01KFDKXMQ637EKEAY410MSQSXB","client_dba":"Acme Jewelry","integrations":["TSYS"],"response_code":"00","response_description":"Approved","batch_id":null,"is_settled":false,"time_created":"2026-07-15T15:02:11Z","amount":10000,"tip":0,"currency":"USD","payment_method":{"type":"CARD","truncated_pan":"****-****-****-5439","payment_token":"PAYMENT_TOKEN-01KFDKXMQ637EKEAY410MSQSXB","expiry":{"month":"01","year":"2028"},"first_name":"John","last_name":"Doe","entry_method":"keyed","auth_code":"123456","retrieval_reference_number":"000000603076","card_type":"UNKNOWN","card_brand":"Visa","cvv_result_code":"M","avs_result_code":"Y","avs_response":"Exact Match - Street address and postal code match"},"initiator":"CUSTOMER","network_transaction_id":"MCC1234567890","metadata":{"order_id":"ORD-10434","sales_channel":"web","customer_reference":"cust-8891"}},"summary":"Authorization with a card — approved","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The approved authorization. An "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"AUTH"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" does not capture, so "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"batch_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is null and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"is_settled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is false until the transaction is captured. Use this "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" as the path parameter on the Capture operation."},"children":[]}]}]}]},"components/examples/AuthWithTokenRequestExample":{"id":"components/examples/AuthWithTokenRequestExample","value":{"type":"AUTH","amount":10000,"tip":0,"payment_method":{"type":"Token","payment_token":"PAYMENT_TOKEN-01KFDKXMQ637EKEAY410MSQSXB"},"initiator":"CUSTOMER","metadata":{"order_id":"ORD-10435","sales_channel":"web","customer_reference":"cust-8891"}},"summary":"Authorization with a stored payment token","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A two-step authorization charged against a stored payment token. The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"captureToken"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" example on the Capture operation captures this one."},"children":[]}]}]}]},"components/examples/AuthWithTokenResponseExample":{"id":"components/examples/AuthWithTokenResponseExample","value":{"id":"TRANSACTION-01KEW34J7RS3N9P5WQDEX8ZTB2","reference_transaction_id":null,"type":"AUTH","result":"APPROVED","client_id":"CLIENT-01KFDKXMQ637EKEAY410MSQSXB","client_dba":"Acme Jewelry","integrations":["TSYS"],"response_code":"00","response_description":"Approved","batch_id":null,"is_settled":false,"time_created":"2026-07-15T15:14:39Z","amount":10000,"tip":0,"currency":"USD","payment_method":{"type":"CARD","truncated_pan":"****-****-****-5439","payment_token":"PAYMENT_TOKEN-01KFDKXMQ637EKEAY410MSQSXB","expiry":{"month":"01","year":"2028"},"first_name":"John","last_name":"Doe","entry_method":"keyed","auth_code":"123456","retrieval_reference_number":"000000603076","card_type":"UNKNOWN","card_brand":"Visa","cvv_result_code":"M","avs_result_code":"Y","avs_response":"Exact Match - Street address and postal code match"},"initiator":"CUSTOMER","network_transaction_id":"MCC1234567890","metadata":{"order_id":"ORD-10435","sales_channel":"web","customer_reference":"cust-8891"}},"summary":"Authorization with a stored payment token — approved","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The approved token authorization. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"batch_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is null until the transaction is captured."},"children":[]}]}]}]},"components/examples/AchSaleRequestExample":{"id":"components/examples/AchSaleRequestExample","value":{"type":"SALE","amount":10000,"tip":0,"payment_method":{"type":"ACH","account_type":"CHECKING","routing_number":"021000021","account_number":"123456789012","standard_entry_class":"WEB","first_name":"John","last_name":"Doe","description":"Blue jeans"},"metadata":{"order_id":"ORD-10438","sales_channel":"web","customer_reference":"cust-8891"}},"summary":"Sale charged to a bank account (ACH)","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A $100.00 ACH debit. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ACH"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the gateway matches this value case-insensitively against "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"card"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ach"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"token"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and rejects anything else before reading the rest of the payment method."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"routing_number"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is exactly nine digits and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"account_number"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is four to twenty. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"standard_entry_class"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"description"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are both optional; they default to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"WEB"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ACH Transaction"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"first_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"last_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are supplied because the ACH processor requires them."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A bank account accepts "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"SALE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"PAYOUT"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". It does not accept "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"AUTH"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},"components/examples/PayoutRequestExample":{"id":"components/examples/PayoutRequestExample","value":{"type":"PAYOUT","amount":25000,"tip":0,"payment_method":{"type":"ACH","account_type":"CHECKING","routing_number":"021000021","account_number":"123456789012","standard_entry_class":"CCD","first_name":"Dana","last_name":"Reyes","description":"Vendor payment"},"metadata":{"invoice_id":"INV-2291","sales_channel":"api"}},"summary":"Payout to a bank account (ACH credit)","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A $250.00 ACH credit. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"PAYOUT"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", which reverses the direction: funds move from the merchant to the bank account rather than into it."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The payment method is the same "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"BankAccountInput"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" an ACH debit uses, with the same required fields. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"standard_entry_class"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"CCD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" here because the recipient is a business; use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"PPD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when paying an individual."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A bank account accepts "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"SALE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"PAYOUT"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A card accepts neither "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"PAYOUT"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" nor anything but "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"SALE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"AUTH"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", so a payout with a card payment method is rejected with 400 "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INVALID_ACTION"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},"components/examples/PayoutResponseExample":{"id":"components/examples/PayoutResponseExample","value":{"id":"TRANSACTION-01KEW3J7NRW9T4M2QVBXK8HZD3","reference_transaction_id":null,"type":"PAYOUT","result":"APPROVED","client_id":"CLIENT-01KFDKXMQ637EKEAY410MSQSXB","client_dba":"Acme Jewelry","integrations":["VERICHECK"],"response_code":"00","response_description":"Approved","batch_id":"BATCH-01KEW32V6YNV11T33XGDR7TGWC","is_settled":false,"is_returned":false,"returned_at":null,"time_created":"2026-07-15T17:31:44Z","amount":25000,"tip":0,"currency":"USD","payment_method":{"type":"ACH","standard_entry_class":"CCD","account_type":"CHECKING","route_number_truncated":"****21","account_number_truncated":"****9012","payment_token":"PAYMENT_TOKEN-01KFDKXMQ637ETEAY410MSQTUH","first_name":"Dana","last_name":"Reyes","description":"Vendor payment"},"metadata":{"invoice_id":"INV-2291","sales_channel":"api"}},"summary":"Payout to a bank account — approved","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The approved payout. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payment_method.type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ACH"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and the account identifiers are truncated, the way they are on any ACH response."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"is_returned"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"false"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"returned_at"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is null because nothing has been returned yet. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"return_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"return_reason"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are absent rather than null — they appear only once a return arrives, which can be days after this response. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"batch_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is assigned, so the payout leaves at the next batch close."},"children":[]}]}]}]},"components/examples/SaleDeclinedRequestExample":{"id":"components/examples/SaleDeclinedRequestExample","value":{"type":"SALE","amount":10000,"tip":0,"payment_method":{"type":"Card","entry_method":"ECOMMERCE","pan":"4012000098765439","expiry":{"month":1,"year":2028},"cvv":"999","first_name":"John","last_name":"Doe","contact":{"phone":"+17035550123","email":"john.doe@example.com"},"billing_address":{"line1":"123 Main St","line2":"Suite 100","city":"Springfield","state":"VA","postal_code":"22150","country":"US"}},"initiator":"CUSTOMER","metadata":{"order_id":"ORD-10436","sales_channel":"web","customer_reference":"cust-8891"}},"summary":"Sale that returns a decline","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An ordinary card sale, identical in shape to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"saleWithCard"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Nothing in this request causes a decline: the card number and amount are the same ordinary values the approved example uses. Do not treat either as a decline trigger — against the live gateway they behave like any other sale. The declined body shown alongside is a fixed sample of what an issuer decline looks like."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Selecting this example and sending it returns the "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"approved"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" sample, because the mock server always answers with the first response example for the operation unless a specific one is named. To see the decline, add the header "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"x-redocly-response-body-example: saleDeclined"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},"components/examples/SaleDeclinedResponseExample":{"id":"components/examples/SaleDeclinedResponseExample","value":{"id":"TRANSACTION-01KEW36C9TQ5N1P7YRFGZ0BVW4","reference_transaction_id":null,"type":"SALE","result":"DECLINED","client_id":"CLIENT-01KFDKXMQ637EKEAY410MSQSXB","client_dba":"Acme Jewelry","integrations":["TSYS"],"response_code":"51","response_description":"Insufficient funds","batch_id":null,"is_settled":false,"time_created":"2026-07-15T15:47:52Z","amount":10000,"tip":0,"currency":"USD","payment_method":{"type":"CARD","truncated_pan":"****-****-****-5439","expiry":{"month":"01","year":"2028"},"first_name":"John","last_name":"Doe","entry_method":"keyed","retrieval_reference_number":"000000603077","card_type":"UNKNOWN","card_brand":"Visa","cvv_result_code":"M","avs_result_code":"Y","avs_response":"Exact Match - Street address and postal code match"},"initiator":"CUSTOMER","network_transaction_id":null,"metadata":{"order_id":"ORD-10436","sales_channel":"web","customer_reference":"cust-8891"}},"summary":"Sale — declined for insufficient funds","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A declined sale. Note this is an HTTP 200 with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"result: DECLINED"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", not an error response: the request was processed correctly and the issuer declined it. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"response_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"51"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is the insufficient-funds code. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"batch_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is null and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"is_settled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is false because a declined transaction is never captured or settled. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"auth_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is absent rather than null — the issuer never issued one."},"children":[]}]}]}]},"components/examples/SaleRecurringSubsequentRequestExample":{"id":"components/examples/SaleRecurringSubsequentRequestExample","value":{"type":"SALE","amount":10000,"tip":0,"payment_method":{"type":"Card","entry_method":"ECOMMERCE","pan":"4012000098765439","expiry":{"month":1,"year":2028},"first_name":"John","last_name":"Doe","billing_address":{"line1":"123 Main St","line2":"Suite 100","city":"Springfield","state":"VA","postal_code":"22150","country":"US"}},"initiator":"MERCHANT","recurring_details":{"sequence":"SUBSEQUENT","initial_transaction_id":"TRANSACTION-01KEW32V6YNV11T33XGDR7TGWC"},"metadata":{"order_id":"ORD-10437","sales_channel":"recurring","customer_reference":"cust-8891"}},"summary":"Subsequent recurring payment on a stored credential","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A merchant-initiated (MIT) payment billed against the stored-credential agreement that "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"saleWithCard"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" established."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Three rules apply together here. The gateway enforces all three and returns 400 "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INVALID_ACTION"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when one is broken; this schema does not describe them, so a generated client will not catch them first. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"recurring_details"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" requires "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"initiator"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sequence: SUBSEQUENT"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" requires either "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"initial_transaction_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"initial_network_transaction_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Only "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sequence: INITIAL"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" may use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"initiator: CUSTOMER"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"initial_transaction_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" points at the transaction returned by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"saleWithCard"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"initial_network_transaction_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" instead when the agreement began outside this gateway. No CVV is sent — the cardholder is not present."},"children":[]}]}]}]},"components/examples/SaleRecurringSubsequentResponseExample":{"id":"components/examples/SaleRecurringSubsequentResponseExample","value":{"id":"TRANSACTION-01KEW3D4YMV8Q7T3FNJZ2XPB56","reference_transaction_id":null,"type":"SALE","result":"APPROVED","client_id":"CLIENT-01KFDKXMQ637EKEAY410MSQSXB","client_dba":"Acme Jewelry","integrations":["TSYS"],"response_code":"00","response_description":"Approved","batch_id":"BATCH-01KEXA7M2QP5N8T3VDFGH1JKR9","is_settled":false,"time_created":"2026-08-15T09:00:00Z","amount":10000,"tip":0,"currency":"USD","payment_method":{"type":"CARD","truncated_pan":"****-****-****-5439","payment_token":"PAYMENT_TOKEN-01KFDKXMQ637EKEAY410MSQSXB","expiry":{"month":"01","year":"2028"},"first_name":"John","last_name":"Doe","entry_method":"keyed","auth_code":"123456","retrieval_reference_number":"000000603078","card_type":"UNKNOWN","card_brand":"Visa","cvv_result_code":null,"avs_result_code":"Y","avs_response":"Exact Match - Street address and postal code match"},"initiator":"MERCHANT","recurring_details":{"sequence":"SUBSEQUENT","initial_transaction_id":"TRANSACTION-01KEW32V6YNV11T33XGDR7TGWC"},"network_transaction_id":"MCC1234567890","metadata":{"order_id":"ORD-10437","sales_channel":"recurring","customer_reference":"cust-8891"}},"summary":"Subsequent recurring payment — approved","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The approved recurring payment. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"initiator"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"recurring_details"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" echo the request, and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"network_transaction_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" carries the network-assigned identifier that links this payment to the agreement. The payment falls in a later batch than the initial sale."},"children":[]}]}]}]},"components/examples/CaptureCardRequestExample":{"id":"components/examples/CaptureCardRequestExample","value":{"amount":10000,"tip":0},"summary":"Capture a card authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Captures the full $100.00 authorized by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"authWithCard"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Send this to the transaction ID returned by that authorization."},"children":[]}]}]}]},"components/examples/CaptureCardResponseExample":{"id":"components/examples/CaptureCardResponseExample","value":{"id":"TRANSACTION-01KEW35B8QP4M2X9YHFT0KDN47","reference_transaction_id":"TRANSACTION-01KEW32V6YNV11T336VEDKL123","type":"CAPTURE","result":"APPROVED","client_id":"CLIENT-01KFDKXMQ637EKEAY410MSQSXB","client_dba":"Acme Jewelry","integrations":["TSYS"],"response_code":"00","response_description":"Approved","batch_id":"BATCH-01KEW32V6YNV11T33XGDR7TGWC","is_settled":false,"time_created":"2026-07-15T16:08:23Z","amount":10000,"tip":0,"currency":"USD","payment_method":{"type":"CARD","truncated_pan":"****-****-****-5439","payment_token":"PAYMENT_TOKEN-01KFDKXMQ637EKEAY410MSQSXB","expiry":null,"first_name":"John","last_name":"Doe","entry_method":"keyed","auth_code":"123456","retrieval_reference_number":"000000603076","card_type":"UNKNOWN","card_brand":"Visa","cvv_result_code":"M"},"initiator":"CUSTOMER","network_transaction_id":"MCC1234567890","metadata":{"order_id":"ORD-10434","sales_channel":"web","customer_reference":"cust-8891"}},"summary":"Capture a card authorization — approved","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The capture record. It is a new transaction whose "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"reference_transaction_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" points at the authorization it captured. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expiry"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is null because expiry is not echoed back on capture responses. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"batch_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is now assigned, so the funds settle at the next batch close."},"children":[]}]}]}]},"components/examples/CaptureTokenRequestExample":{"id":"components/examples/CaptureTokenRequestExample","value":{"amount":10000,"tip":0},"summary":"Capture a stored-token authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Captures the full $100.00 authorized by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"authWithToken"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The capture request body is identical whichever payment method the authorization used — only the response differs."},"children":[]}]}]}]},"components/examples/CaptureTokenResponseExample":{"id":"components/examples/CaptureTokenResponseExample","value":{"id":"TRANSACTION-01KEW37D0SR6P2Q8ZTGHA1CWX5","reference_transaction_id":"TRANSACTION-01KEW34J7RS3N9P5WQDEX8ZTB2","type":"CAPTURE","result":"APPROVED","client_id":"CLIENT-01KFDKXMQ637EKEAY410MSQSXB","client_dba":"Acme Jewelry","integrations":["TSYS"],"response_code":"00","response_description":"Approved","batch_id":"BATCH-01KEW32V6YNV11T33XGDR7TGWC","is_settled":false,"time_created":"2026-07-15T16:19:05Z","amount":10000,"tip":0,"currency":"USD","payment_method":{"type":"CARD","truncated_pan":"****-****-****-5439","payment_token":"PAYMENT_TOKEN-01KFDKXMQ637EKEAY410MSQSXB","expiry":null,"first_name":"John","last_name":"Doe","entry_method":"keyed","auth_code":"123456","retrieval_reference_number":"000000603076","card_type":"UNKNOWN","card_brand":"Visa","cvv_result_code":"M"},"initiator":"CUSTOMER","network_transaction_id":"MCC1234567890","metadata":{"order_id":"ORD-10435","sales_channel":"web","customer_reference":"cust-8891"}},"summary":"Capture a stored-token authorization — approved","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The capture record for a token authorization. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payment_method"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" reports the card the token resolves to, with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expiry"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" null because a capture does not echo it, and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"reference_transaction_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" points at the authorization it captured."},"children":[]}]}]}]},"components/examples/VoidTransactionRequestExample":{"id":"components/examples/VoidTransactionRequestExample","value":{"type":"VOID"},"summary":"Void an unsettled transaction","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Voids the sale created by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"saleWithCard"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" before it settles. A void needs only the transaction "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; the amount is always the full original amount. Send it to the transaction ID being voided."},"children":[]}]}]}]},"components/examples/VoidTransactionResponseExample":{"id":"components/examples/VoidTransactionResponseExample","value":{"id":"TRANSACTION-01KEW38F2RT6N4Z1AJGV5MPQ82","reference_transaction_id":"TRANSACTION-01KEW32V6YNV11T33XGDR7TGWC","type":"CANCEL","result":"APPROVED","client_id":"CLIENT-01KFDKXMQ637EKEAY410MSQSXB","client_dba":"Acme Jewelry","integrations":["TSYS"],"response_code":"00","response_description":"Approved","batch_id":"BATCH-01KEW32V6YNV11T33XGDR7TGWC","is_settled":false,"time_created":"2026-07-15T17:30:44Z","amount":10000,"tip":0,"currency":"USD","payment_method":{"type":"CARD","truncated_pan":"****-****-****-5439","payment_token":"PAYMENT_TOKEN-01KFDKXMQ637EKEAY410MSQSXB","expiry":null,"first_name":"John","last_name":"Doe","entry_method":"keyed","auth_code":"123456","retrieval_reference_number":"000000603076","card_type":"UNKNOWN","card_brand":"Visa","cvv_result_code":null},"initiator":"CUSTOMER","network_transaction_id":"MCC1234567890","metadata":{"order_id":"ORD-10432","sales_channel":"web","customer_reference":"cust-8891"}},"summary":"Void — approved","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The void record. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" comes back as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"CANCEL"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", which is the type returned on void and refund response records, and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"reference_transaction_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" points at the sale that was voided. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expiry"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cvv_result_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are null because neither is re-checked on a void."},"children":[]}]}]}]},"components/examples/RefundTransactionRequestExample":{"id":"components/examples/RefundTransactionRequestExample","value":{"type":"REFUND","amount":2500},"summary":"Partially refund a settled transaction","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Refunds $25.00 of the $100.00 sale created by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"saleWithCard"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The amount must be less than or equal to the original transaction amount; this partial refund shows that rule in use. Send it to the transaction ID being refunded."},"children":[]}]}]}]},"components/examples/RefundTransactionResponseExample":{"id":"components/examples/RefundTransactionResponseExample","value":{"id":"TRANSACTION-01KEW3B7XKC9P5W2DMHY6NRS13","reference_transaction_id":"TRANSACTION-01KEW32V6YNV11T33XGDR7TGWC","type":"REFUND","result":"APPROVED","client_id":"CLIENT-01KFDKXMQ637EKEAY410MSQSXB","client_dba":"Acme Jewelry","integrations":["TSYS"],"response_code":"00","response_description":"Approved","batch_id":null,"is_settled":false,"time_created":"2026-07-16T10:12:58Z","amount":2500,"tip":0,"currency":"USD","payment_method":{"type":"CARD","truncated_pan":"****-****-****-5439","payment_token":"PAYMENT_TOKEN-01KFDKXMQ637EKEAY410MSQSXB","expiry":null,"first_name":"John","last_name":"Doe","entry_method":"keyed","auth_code":"123456","retrieval_reference_number":"000000603076","card_type":"UNKNOWN","card_brand":"Visa","cvv_result_code":null},"initiator":"CUSTOMER","network_transaction_id":"MCC1234567890","metadata":{"order_id":"ORD-10432","sales_channel":"web","customer_reference":"cust-8891"}},"summary":"Partial refund — approved","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The refund record. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is the refunded amount, not the original sale amount. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" comes back as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"CANCEL"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"reference_transaction_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" points at the sale that was refunded. The refund lands in the next open batch, so its own "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"batch_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not yet assigned."},"children":[]}]}]}]},"components/examples/TransactionListResponseExample":{"id":"components/examples/TransactionListResponseExample","value":{"total_count":3,"limit":10,"offset":0,"has_more":false,"transactions":[{"id":"TRANSACTION-01KEW32V6YNV11T33XGDR7TGWC","reference_transaction_id":null,"type":"SALE","result":"APPROVED","client_id":"CLIENT-01KFDKXMQ637EKEAY410MSQSXB","client_dba":"Acme Jewelry","integrations":["TSYS"],"response_code":"00","response_description":"Approved","batch_id":"BATCH-01KEW32V6YNV11T33XGDR7TGWC","is_settled":false,"time_created":"2026-07-15T14:22:05Z","amount":10000,"tip":0,"currency":"USD","payment_method":{"type":"CARD","truncated_pan":"****-****-****-5439","expiry":{"month":"01","year":"2028"},"first_name":"John","last_name":"Doe","entry_method":"keyed","auth_code":"123456","retrieval_reference_number":"000000603076","card_type":"CREDIT","card_brand":"Visa","cvv_result_code":"M","avs_result_code":"Y"},"initiator":"CUSTOMER","network_transaction_id":"MCC1234567890","metadata":{"order_id":"ORD-10432"}},{"id":"TRANSACTION-01KEW32V6YNV11T336VEDKL123","reference_transaction_id":null,"type":"AUTH","result":"APPROVED","client_id":"CLIENT-01KFDKXMQ637EKEAY410MSQSXB","client_dba":"Acme Jewelry","integrations":["TSYS"],"response_code":"00","response_description":"Approved","batch_id":null,"is_settled":false,"time_created":"2026-07-15T15:02:11Z","amount":10000,"tip":0,"currency":"USD","payment_method":{"type":"CARD","truncated_pan":"****-****-****-5439","expiry":{"month":"01","year":"2028"},"first_name":"John","last_name":"Doe","entry_method":"keyed","auth_code":"123456","retrieval_reference_number":"000000603076","card_type":"CREDIT","card_brand":"Visa","cvv_result_code":"M","avs_result_code":"Y"},"initiator":"CUSTOMER","network_transaction_id":"MCC1234567890","metadata":{"order_id":"ORD-10434"}},{"id":"TRANSACTION-01KEW36C9TQ5N1P7YRFGZ0BVW4","reference_transaction_id":null,"type":"SALE","result":"DECLINED","client_id":"CLIENT-01KFDKXMQ637EKEAY410MSQSXB","client_dba":"Acme Jewelry","integrations":["TSYS"],"response_code":"51","response_description":"Insufficient funds","batch_id":null,"is_settled":false,"time_created":"2026-07-15T15:47:52Z","amount":10000,"tip":0,"currency":"USD","payment_method":{"type":"CARD","truncated_pan":"****-****-****-5439","expiry":{"month":"01","year":"2028"},"first_name":"John","last_name":"Doe","entry_method":"keyed","retrieval_reference_number":"000000603077","card_type":"CREDIT","card_brand":"Visa","cvv_result_code":"M","avs_result_code":"Y"},"initiator":"CUSTOMER","network_transaction_id":null,"metadata":{"order_id":"ORD-10436"}}]},"summary":"First page of a transaction list","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Three transactions from the same merchant and batch — the approved sale, the approved authorization, and the declined sale. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"total_count"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is 3 and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"limit"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is 10, so "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"has_more"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is false and there is no next page to fetch."},"children":[]}]}]}]},"components/examples/TsysIntegrationRequestExample":{"id":"components/examples/TsysIntegrationRequestExample","value":{"client":"CLIENT-01KFDKXMQ637EKEAY410MSQSXB","is_active":true,"processor":"Tsys","integration_details":{"name":"Acme Jewelry LLC","amex_number":"1234567890","association":"123456","bin":"888888","discover_number":"123456789012345","dba":"Acme Jewelry","url":"https://example.apiserver.com","phone_number":17035550123,"fax_number":"+17035550199","mid":"888000001234","mcc":"5944","bank_number":"1234","industry":"R","amex_opt_blue":true,"agent_chain":"012345","store_number":"0001","mvv":"123456","terminal_number":"0001","agent_bank_number":"123456","agent_chain_number":"654321","descriptor_postal":"22150","descriptor_city":"Springfield","descriptor_state":"VA","descriptor_country":"US","descriptor_phone":17035550123,"descriptor_store_number":"0001","address1":"123 Main St","address2":"Suite 100","descriptor_line3":"ACME JEWELRY 703-555-0123","terminal_id":"00000001","v_number":"V1234567","settlement_time":"23:00","merchant_area_code":703,"descriptor_area_code":703,"sharing_group":"AEFGKMQ","merchant_aba_number":"123456789","merchant_settlement_agent_number":"1234","reimbursement_attribute":"0","fcsid":"12345"}},"summary":"Onboard a TSYS merchant integration","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A complete TSYS host configuration for the merchant. Twenty-nine of these fields are required — the gateway enforces them in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"TsysHostDetailsValidator"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — so this payload is close to the minimum a real onboarding needs rather than a generous illustration. The processor-specific identifiers here are illustrative placeholders."},"children":[]}]}]}]},"components/examples/TsysIntegrationResponseExample":{"id":"components/examples/TsysIntegrationResponseExample","value":{"id":"INTEGRATION-01KFDKXMQ637EKEAY410MSQSXB","is_active":true,"client":"CLIENT-01KFDKXMQ637EKEAY410MSQSXB","processor":"Tsys","integration_details":{"name":"Acme Jewelry LLC","dba":"Acme Jewelry","url":"https://example.apiserver.com","phone_number":17035550123,"fax_number":"+17035550199","mid":"888000001234","amex_number":"1234567890","association":"VISA","bin":"431940","discover_number":"601100999999","mcc":"5944","bank_number":"1234","industry":"R","amex_opt_blue":true,"agent_chain":"012345","store_number":"0001","mvv":"123456","terminal_number":"0001","agent_bank_number":"123456","agent_chain_number":"654321","descriptor_postal":"22150","descriptor_city":"Springfield","descriptor_state":"VA","descriptor_country":"US","descriptor_phone":17035550123,"descriptor_store_number":"0001","address1":"123 Main St","address2":"Suite 100","descriptor_line3":"ACME JEWELRY 703-555-0123","terminal_id":"00000001","v_number":"V1234567","settlement_time":"23:00","merchant_area_code":703,"descriptor_area_code":703,"sharing_group":"AEFGKMQ","merchant_aba_number":"123456789","merchant_settlement_agent_number":"1234","reimbursement_attribute":"0","fcsid":"12345","created_by":1042,"created_at":"2026-02-11T09:24:17Z","modified_by":1042,"modified_at":"2026-06-30T14:02:51Z"},"correlation_id":"01KFDKXMQ637EKEAY410MSQSXB"},"summary":"TSYS merchant integration created","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The stored configuration, echoing back what was submitted and adding the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to reference it, the network identifiers TSYS assigns during onboarding ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amex_number"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"discover_number"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"association"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bin"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"), and the audit fields."},"children":[]}]}]}]},"paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/saleWithCard":{"value":{"type":"SALE","amount":10000,"tip":0,"payment_method":{"type":"Card","entry_method":"ECOMMERCE","pan":"4012000098765439","expiry":{"month":1,"year":2028},"cvv":"999","first_name":"John","last_name":"Doe","contact":{"phone":"+17035550123","email":"john.doe@example.com"},"billing_address":{"line1":"123 Main St","line2":"Suite 100","city":"Springfield","state":"VA","postal_code":"22150","country":"US"}},"initiator":"CUSTOMER","metadata":{"order_id":"ORD-10432","sales_channel":"web","customer_reference":"cust-8891"}},"key":"saleWithCard","summary":"Sale with a card","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A single-step sale that authorizes and captures $100.00 in one call, using full card details. This is the transaction the void, refund, and recurring examples all reference."},"children":[]}]}]}],"id":"paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/saleWithCard"},"paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/saleWithToken":{"value":{"type":"SALE","amount":10000,"tip":0,"payment_method":{"type":"Token","payment_token":"PAYMENT_TOKEN-01KFDKXMQ637EKEAY410MSQSXB"},"initiator":"CUSTOMER","metadata":{"order_id":"ORD-10433","sales_channel":"web","customer_reference":"cust-8891"}},"key":"saleWithToken","summary":"Sale with a stored payment token","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The same $100.00 sale, charged against a previously stored payment token instead of raw card details. No PAN, expiry, or CVV is sent."},"children":[]}]}]}],"id":"paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/saleWithToken"},"paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/authWithCard":{"value":{"type":"AUTH","amount":10000,"tip":0,"payment_method":{"type":"Card","entry_method":"ECOMMERCE","pan":"4012000098765439","expiry":{"month":1,"year":2028},"cvv":"999","first_name":"John","last_name":"Doe","contact":{"phone":"+17035550123","email":"john.doe@example.com"},"billing_address":{"line1":"123 Main St","line2":"Suite 100","city":"Springfield","state":"VA","postal_code":"22150","country":"US"}},"initiator":"CUSTOMER","metadata":{"order_id":"ORD-10434","sales_channel":"web","customer_reference":"cust-8891"}},"key":"authWithCard","summary":"Authorization with a card","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A two-step authorization that reserves $100.00 without capturing it. Capture the resulting transaction with the Capture operation; the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"captureCard"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" example there captures exactly this transaction."},"children":[]}]}]}],"id":"paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/authWithCard"},"paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/authWithToken":{"value":{"type":"AUTH","amount":10000,"tip":0,"payment_method":{"type":"Token","payment_token":"PAYMENT_TOKEN-01KFDKXMQ637EKEAY410MSQSXB"},"initiator":"CUSTOMER","metadata":{"order_id":"ORD-10435","sales_channel":"web","customer_reference":"cust-8891"}},"key":"authWithToken","summary":"Authorization with a stored payment token","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A two-step authorization charged against a stored payment token. The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"captureToken"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" example on the Capture operation captures this one."},"children":[]}]}]}],"id":"paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/authWithToken"},"paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/saleWithBankAccount":{"value":{"type":"SALE","amount":10000,"tip":0,"payment_method":{"type":"ACH","account_type":"CHECKING","routing_number":"021000021","account_number":"123456789012","standard_entry_class":"WEB","first_name":"John","last_name":"Doe","description":"Blue jeans"},"metadata":{"order_id":"ORD-10438","sales_channel":"web","customer_reference":"cust-8891"}},"key":"saleWithBankAccount","summary":"Sale charged to a bank account (ACH)","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A $100.00 ACH debit. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ACH"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the gateway matches this value case-insensitively against "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"card"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ach"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"token"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and rejects anything else before reading the rest of the payment method."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"routing_number"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is exactly nine digits and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"account_number"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is four to twenty. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"standard_entry_class"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"description"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are both optional; they default to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"WEB"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ACH Transaction"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"first_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"last_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are supplied because the ACH processor requires them."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A bank account accepts "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"SALE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"PAYOUT"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". It does not accept "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"AUTH"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"id":"paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/saleWithBankAccount"},"paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/payout":{"value":{"type":"PAYOUT","amount":25000,"tip":0,"payment_method":{"type":"ACH","account_type":"CHECKING","routing_number":"021000021","account_number":"123456789012","standard_entry_class":"CCD","first_name":"Dana","last_name":"Reyes","description":"Vendor payment"},"metadata":{"invoice_id":"INV-2291","sales_channel":"api"}},"key":"payout","summary":"Payout to a bank account (ACH credit)","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A $250.00 ACH credit. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"PAYOUT"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", which reverses the direction: funds move from the merchant to the bank account rather than into it."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The payment method is the same "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"BankAccountInput"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" an ACH debit uses, with the same required fields. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"standard_entry_class"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"CCD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" here because the recipient is a business; use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"PPD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when paying an individual."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A bank account accepts "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"SALE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"PAYOUT"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A card accepts neither "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"PAYOUT"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" nor anything but "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"SALE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"AUTH"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", so a payout with a card payment method is rejected with 400 "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INVALID_ACTION"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"id":"paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/payout"},"paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/saleDeclined":{"value":{"type":"SALE","amount":10000,"tip":0,"payment_method":{"type":"Card","entry_method":"ECOMMERCE","pan":"4012000098765439","expiry":{"month":1,"year":2028},"cvv":"999","first_name":"John","last_name":"Doe","contact":{"phone":"+17035550123","email":"john.doe@example.com"},"billing_address":{"line1":"123 Main St","line2":"Suite 100","city":"Springfield","state":"VA","postal_code":"22150","country":"US"}},"initiator":"CUSTOMER","metadata":{"order_id":"ORD-10436","sales_channel":"web","customer_reference":"cust-8891"}},"key":"saleDeclined","summary":"Sale that returns a decline","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An ordinary card sale, identical in shape to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"saleWithCard"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Nothing in this request causes a decline: the card number and amount are the same ordinary values the approved example uses. Do not treat either as a decline trigger — against the live gateway they behave like any other sale. The declined body shown alongside is a fixed sample of what an issuer decline looks like."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Selecting this example and sending it returns the "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"approved"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" sample, because the mock server always answers with the first response example for the operation unless a specific one is named. To see the decline, add the header "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"x-redocly-response-body-example: saleDeclined"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"id":"paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/saleDeclined"},"paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/saleRecurringSubsequent":{"value":{"type":"SALE","amount":10000,"tip":0,"payment_method":{"type":"Card","entry_method":"ECOMMERCE","pan":"4012000098765439","expiry":{"month":1,"year":2028},"first_name":"John","last_name":"Doe","billing_address":{"line1":"123 Main St","line2":"Suite 100","city":"Springfield","state":"VA","postal_code":"22150","country":"US"}},"initiator":"MERCHANT","recurring_details":{"sequence":"SUBSEQUENT","initial_transaction_id":"TRANSACTION-01KEW32V6YNV11T33XGDR7TGWC"},"metadata":{"order_id":"ORD-10437","sales_channel":"recurring","customer_reference":"cust-8891"}},"key":"saleRecurringSubsequent","summary":"Subsequent recurring payment on a stored credential","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A merchant-initiated (MIT) payment billed against the stored-credential agreement that "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"saleWithCard"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" established."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Three rules apply together here. The gateway enforces all three and returns 400 "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INVALID_ACTION"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when one is broken; this schema does not describe them, so a generated client will not catch them first. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"recurring_details"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" requires "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"initiator"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sequence: SUBSEQUENT"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" requires either "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"initial_transaction_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"initial_network_transaction_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Only "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sequence: INITIAL"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" may use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"initiator: CUSTOMER"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"initial_transaction_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" points at the transaction returned by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"saleWithCard"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"initial_network_transaction_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" instead when the agreement began outside this gateway. No CVV is sent — the cardholder is not present."},"children":[]}]}]}],"id":"paths/~1v1~1transactions/post/requestBody/content/application~1json/examples/saleRecurringSubsequent"},"paths/~1v1~1transactions/post/responses/200/content/application~1json/examples/saleWithCard":{"value":{"id":"TRANSACTION-01KEW32V6YNV11T33XGDR7TGWC","reference_transaction_id":null,"type":"SALE","result":"APPROVED","client_id":"CLIENT-01KFDKXMQ637EKEAY410MSQSXB","client_dba":"Acme Jewelry","integrations":["TSYS"],"response_code":"00","response_description":"Approved","batch_id":"BATCH-01KEW32V6YNV11T33XGDR7TGWC","is_settled":false,"time_created":"2026-07-15T14:22:05Z","amount":10000,"tip":0,"currency":"USD","payment_method":{"type":"CARD","truncated_pan":"****-****-****-5439","payment_token":"PAYMENT_TOKEN-01KFDKXMQ637EKEAY410MSQSXB","expiry":{"month":"01","year":"2028"},"first_name":"John","last_name":"Doe","entry_method":"keyed","auth_code":"123456","retrieval_reference_number":"000000603076","card_type":"UNKNOWN","card_brand":"Visa","cvv_result_code":"M","avs_result_code":"Y","avs_response":"Exact Match - Street address and postal code match"},"initiator":"CUSTOMER","network_transaction_id":"MCC1234567890","metadata":{"order_id":"ORD-10432","sales_channel":"web","customer_reference":"cust-8891"}},"key":"saleWithCard","summary":"Sale with a card — approved","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The approved sale. Because a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"SALE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" authorizes and captures in one step, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"batch_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is already assigned and the transaction settles at the next batch close. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"reference_transaction_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is null because this is an original transaction, not a capture, void, or refund of another one."},"children":[]}]}]}],"id":"paths/~1v1~1transactions/post/responses/200/content/application~1json/examples/saleWithCard"},"paths/~1v1~1transactions/post/responses/200/content/application~1json/examples/saleWithToken":{"value":{"id":"TRANSACTION-01KEW33H5PQ2K8M4VNCDW7YRT9","reference_transaction_id":null,"type":"SALE","result":"APPROVED","client_id":"CLIENT-01KFDKXMQ637EKEAY410MSQSXB","client_dba":"Acme Jewelry","integrations":["TSYS"],"response_code":"00","response_description":"Approved","batch_id":"BATCH-01KEW32V6YNV11T33XGDR7TGWC","is_settled":false,"time_created":"2026-07-15T14:31:47Z","amount":10000,"tip":0,"currency":"USD","payment_method":{"type":"CARD","truncated_pan":"****-****-****-5439","payment_token":"PAYMENT_TOKEN-01KFDKXMQ637EKEAY410MSQSXB","expiry":{"month":"01","year":"2028"},"first_name":"John","last_name":"Doe","entry_method":"keyed","auth_code":"123456","retrieval_reference_number":"000000603076","card_type":"UNKNOWN","card_brand":"Visa","cvv_result_code":"M","avs_result_code":"Y","avs_response":"Exact Match - Street address and postal code match"},"initiator":"CUSTOMER","network_transaction_id":"MCC1234567890","metadata":{"order_id":"ORD-10433","sales_channel":"web","customer_reference":"cust-8891"}},"key":"saleWithToken","summary":"Sale with a stored payment token — approved","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The approved token sale. The response reports the card the token resolves to, so "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payment_method.type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"CARD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and the card attributes are present. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payment_token"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" carries the token that funded it."},"children":[]}]}]}],"id":"paths/~1v1~1transactions/post/responses/200/content/application~1json/examples/saleWithToken"},"paths/~1v1~1transactions/post/responses/200/content/application~1json/examples/authWithCard":{"value":{"id":"TRANSACTION-01KEW32V6YNV11T336VEDKL123","reference_transaction_id":null,"type":"AUTH","result":"APPROVED","client_id":"CLIENT-01KFDKXMQ637EKEAY410MSQSXB","client_dba":"Acme Jewelry","integrations":["TSYS"],"response_code":"00","response_description":"Approved","batch_id":null,"is_settled":false,"time_created":"2026-07-15T15:02:11Z","amount":10000,"tip":0,"currency":"USD","payment_method":{"type":"CARD","truncated_pan":"****-****-****-5439","payment_token":"PAYMENT_TOKEN-01KFDKXMQ637EKEAY410MSQSXB","expiry":{"month":"01","year":"2028"},"first_name":"John","last_name":"Doe","entry_method":"keyed","auth_code":"123456","retrieval_reference_number":"000000603076","card_type":"UNKNOWN","card_brand":"Visa","cvv_result_code":"M","avs_result_code":"Y","avs_response":"Exact Match - Street address and postal code match"},"initiator":"CUSTOMER","network_transaction_id":"MCC1234567890","metadata":{"order_id":"ORD-10434","sales_channel":"web","customer_reference":"cust-8891"}},"key":"authWithCard","summary":"Authorization with a card — approved","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The approved authorization. An "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"AUTH"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" does not capture, so "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"batch_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is null and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"is_settled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is false until the transaction is captured. Use this "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" as the path parameter on the Capture operation."},"children":[]}]}]}],"id":"paths/~1v1~1transactions/post/responses/200/content/application~1json/examples/authWithCard"},"paths/~1v1~1transactions/post/responses/200/content/application~1json/examples/authWithToken":{"value":{"id":"TRANSACTION-01KEW34J7RS3N9P5WQDEX8ZTB2","reference_transaction_id":null,"type":"AUTH","result":"APPROVED","client_id":"CLIENT-01KFDKXMQ637EKEAY410MSQSXB","client_dba":"Acme Jewelry","integrations":["TSYS"],"response_code":"00","response_description":"Approved","batch_id":null,"is_settled":false,"time_created":"2026-07-15T15:14:39Z","amount":10000,"tip":0,"currency":"USD","payment_method":{"type":"CARD","truncated_pan":"****-****-****-5439","payment_token":"PAYMENT_TOKEN-01KFDKXMQ637EKEAY410MSQSXB","expiry":{"month":"01","year":"2028"},"first_name":"John","last_name":"Doe","entry_method":"keyed","auth_code":"123456","retrieval_reference_number":"000000603076","card_type":"UNKNOWN","card_brand":"Visa","cvv_result_code":"M","avs_result_code":"Y","avs_response":"Exact Match - Street address and postal code match"},"initiator":"CUSTOMER","network_transaction_id":"MCC1234567890","metadata":{"order_id":"ORD-10435","sales_channel":"web","customer_reference":"cust-8891"}},"key":"authWithToken","summary":"Authorization with a stored payment token — approved","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The approved token authorization. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"batch_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is null until the transaction is captured."},"children":[]}]}]}],"id":"paths/~1v1~1transactions/post/responses/200/content/application~1json/examples/authWithToken"},"paths/~1v1~1transactions/post/responses/200/content/application~1json/examples/payout":{"value":{"id":"TRANSACTION-01KEW3J7NRW9T4M2QVBXK8HZD3","reference_transaction_id":null,"type":"PAYOUT","result":"APPROVED","client_id":"CLIENT-01KFDKXMQ637EKEAY410MSQSXB","client_dba":"Acme Jewelry","integrations":["VERICHECK"],"response_code":"00","response_description":"Approved","batch_id":"BATCH-01KEW32V6YNV11T33XGDR7TGWC","is_settled":false,"is_returned":false,"returned_at":null,"time_created":"2026-07-15T17:31:44Z","amount":25000,"tip":0,"currency":"USD","payment_method":{"type":"ACH","standard_entry_class":"CCD","account_type":"CHECKING","route_number_truncated":"****21","account_number_truncated":"****9012","payment_token":"PAYMENT_TOKEN-01KFDKXMQ637ETEAY410MSQTUH","first_name":"Dana","last_name":"Reyes","description":"Vendor payment"},"metadata":{"invoice_id":"INV-2291","sales_channel":"api"}},"key":"payout","summary":"Payout to a bank account — approved","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The approved payout. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payment_method.type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ACH"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and the account identifiers are truncated, the way they are on any ACH response."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"is_returned"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"false"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"returned_at"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is null because nothing has been returned yet. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"return_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"return_reason"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are absent rather than null — they appear only once a return arrives, which can be days after this response. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"batch_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is assigned, so the payout leaves at the next batch close."},"children":[]}]}]}],"id":"paths/~1v1~1transactions/post/responses/200/content/application~1json/examples/payout"},"paths/~1v1~1transactions/post/responses/200/content/application~1json/examples/saleDeclined":{"value":{"id":"TRANSACTION-01KEW36C9TQ5N1P7YRFGZ0BVW4","reference_transaction_id":null,"type":"SALE","result":"DECLINED","client_id":"CLIENT-01KFDKXMQ637EKEAY410MSQSXB","client_dba":"Acme Jewelry","integrations":["TSYS"],"response_code":"51","response_description":"Insufficient funds","batch_id":null,"is_settled":false,"time_created":"2026-07-15T15:47:52Z","amount":10000,"tip":0,"currency":"USD","payment_method":{"type":"CARD","truncated_pan":"****-****-****-5439","expiry":{"month":"01","year":"2028"},"first_name":"John","last_name":"Doe","entry_method":"keyed","retrieval_reference_number":"000000603077","card_type":"UNKNOWN","card_brand":"Visa","cvv_result_code":"M","avs_result_code":"Y","avs_response":"Exact Match - Street address and postal code match"},"initiator":"CUSTOMER","network_transaction_id":null,"metadata":{"order_id":"ORD-10436","sales_channel":"web","customer_reference":"cust-8891"}},"key":"saleDeclined","summary":"Sale — declined for insufficient funds","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A declined sale. Note this is an HTTP 200 with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"result: DECLINED"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", not an error response: the request was processed correctly and the issuer declined it. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"response_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"51"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is the insufficient-funds code. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"batch_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is null and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"is_settled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is false because a declined transaction is never captured or settled. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"auth_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is absent rather than null — the issuer never issued one."},"children":[]}]}]}],"id":"paths/~1v1~1transactions/post/responses/200/content/application~1json/examples/saleDeclined"},"paths/~1v1~1transactions/post/responses/200/content/application~1json/examples/saleRecurringSubsequent":{"value":{"id":"TRANSACTION-01KEW3D4YMV8Q7T3FNJZ2XPB56","reference_transaction_id":null,"type":"SALE","result":"APPROVED","client_id":"CLIENT-01KFDKXMQ637EKEAY410MSQSXB","client_dba":"Acme Jewelry","integrations":["TSYS"],"response_code":"00","response_description":"Approved","batch_id":"BATCH-01KEXA7M2QP5N8T3VDFGH1JKR9","is_settled":false,"time_created":"2026-08-15T09:00:00Z","amount":10000,"tip":0,"currency":"USD","payment_method":{"type":"CARD","truncated_pan":"****-****-****-5439","payment_token":"PAYMENT_TOKEN-01KFDKXMQ637EKEAY410MSQSXB","expiry":{"month":"01","year":"2028"},"first_name":"John","last_name":"Doe","entry_method":"keyed","auth_code":"123456","retrieval_reference_number":"000000603078","card_type":"UNKNOWN","card_brand":"Visa","cvv_result_code":null,"avs_result_code":"Y","avs_response":"Exact Match - Street address and postal code match"},"initiator":"MERCHANT","recurring_details":{"sequence":"SUBSEQUENT","initial_transaction_id":"TRANSACTION-01KEW32V6YNV11T33XGDR7TGWC"},"network_transaction_id":"MCC1234567890","metadata":{"order_id":"ORD-10437","sales_channel":"recurring","customer_reference":"cust-8891"}},"key":"saleRecurringSubsequent","summary":"Subsequent recurring payment — approved","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The approved recurring payment. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"initiator"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"recurring_details"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" echo the request, and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"network_transaction_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" carries the network-assigned identifier that links this payment to the agreement. The payment falls in a later batch than the initial sale."},"children":[]}]}]}],"id":"paths/~1v1~1transactions/post/responses/200/content/application~1json/examples/saleRecurringSubsequent"},"paths/~1v1~1transactions/post/responses/400/content/application~1json/examples/invalidRequestData":{"value":{"error_code":"INVALID_REQUEST_DATA","error_message":"The API request contains invalid data.","details":{"amount":"Invalid amount","payment_method.pan":"Malformed PAN"},"source":{"system":"TSYS","code":"13","message":"Invalid amount"}},"key":"invalidRequestData","summary":"Invalid field value in the request body","id":"paths/~1v1~1transactions/post/responses/400/content/application~1json/examples/invalidRequestData"},"paths/~1v1~1transactions/post/responses/401/content/application~1json/examples/notAuthenticated":{"value":{"error_code":"NOT_AUTHENTICATED","error_message":"Access credentials missing or invalid.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"notAuthenticated","summary":"Missing or invalid API key","id":"paths/~1v1~1transactions/post/responses/401/content/application~1json/examples/notAuthenticated"},"paths/~1v1~1transactions/post/responses/403/content/application~1json/examples/unauthorizedAction":{"value":{"error_code":"UNAUTHORIZED_ACTION","error_message":"Requested action is unavailable or forbidden.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"unauthorizedAction","summary":"Authenticated but not authorized for this action","id":"paths/~1v1~1transactions/post/responses/403/content/application~1json/examples/unauthorizedAction"},"paths/~1v1~1transactions/post/responses/409/content/application~1json/examples/duplicateAction":{"value":{"error_code":"DUPLICATE_ACTION","error_message":"Duplicate action requested.","details":null,"source":{"system":"TSYS","code":"12","message":"Invalid transaction"}},"key":"duplicateAction","summary":"Duplicate or state-conflicting action","id":"paths/~1v1~1transactions/post/responses/409/content/application~1json/examples/duplicateAction"},"paths/~1v1~1transactions/post/responses/500/content/application~1json/examples/systemError":{"value":{"error_code":"SYSTEM_ERROR","error_message":"Internal system error.","details":null,"source":{"system":"TSYS","code":"96","message":"System malfunction"}},"key":"systemError","summary":"Unhandled server fault or downstream processor error","id":"paths/~1v1~1transactions/post/responses/500/content/application~1json/examples/systemError"},"paths/~1v1~1transactions/post/responses/502/content/application~1json/examples/downstreamError":{"value":{"error_code":"DOWNSTREAM_ERROR","error_message":"Downstream service returned invalid or unexpected response.","details":null,"source":{"system":"VERICHECK","code":"502","message":"Bad Gateway"}},"key":"downstreamError","summary":"The processor returned an invalid or unexpected response","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Distinct from a 500. A 500 is a fault inside the gateway; a 502 means the gateway reached the processor and could not use what came back. Both are safe to retry, but only a 502 says the transaction may have been seen by the processor — reconcile before retrying a payment."},"children":[]}]}]}],"id":"paths/~1v1~1transactions/post/responses/502/content/application~1json/examples/downstreamError"},"paths/~1v1~1transactions~1{id}~1capture/post/requestBody/content/application~1json/examples/captureCard":{"value":{"amount":10000,"tip":0},"key":"captureCard","summary":"Capture a card authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Captures the full $100.00 authorized by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"authWithCard"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Send this to the transaction ID returned by that authorization."},"children":[]}]}]}],"id":"paths/~1v1~1transactions~1{id}~1capture/post/requestBody/content/application~1json/examples/captureCard"},"paths/~1v1~1transactions~1{id}~1capture/post/requestBody/content/application~1json/examples/captureToken":{"value":{"amount":10000,"tip":0},"key":"captureToken","summary":"Capture a stored-token authorization","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Captures the full $100.00 authorized by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"authWithToken"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The capture request body is identical whichever payment method the authorization used — only the response differs."},"children":[]}]}]}],"id":"paths/~1v1~1transactions~1{id}~1capture/post/requestBody/content/application~1json/examples/captureToken"},"paths/~1v1~1transactions~1{id}~1capture/post/responses/200/content/application~1json/examples/captureCard":{"value":{"id":"TRANSACTION-01KEW35B8QP4M2X9YHFT0KDN47","reference_transaction_id":"TRANSACTION-01KEW32V6YNV11T336VEDKL123","type":"CAPTURE","result":"APPROVED","client_id":"CLIENT-01KFDKXMQ637EKEAY410MSQSXB","client_dba":"Acme Jewelry","integrations":["TSYS"],"response_code":"00","response_description":"Approved","batch_id":"BATCH-01KEW32V6YNV11T33XGDR7TGWC","is_settled":false,"time_created":"2026-07-15T16:08:23Z","amount":10000,"tip":0,"currency":"USD","payment_method":{"type":"CARD","truncated_pan":"****-****-****-5439","payment_token":"PAYMENT_TOKEN-01KFDKXMQ637EKEAY410MSQSXB","expiry":null,"first_name":"John","last_name":"Doe","entry_method":"keyed","auth_code":"123456","retrieval_reference_number":"000000603076","card_type":"UNKNOWN","card_brand":"Visa","cvv_result_code":"M"},"initiator":"CUSTOMER","network_transaction_id":"MCC1234567890","metadata":{"order_id":"ORD-10434","sales_channel":"web","customer_reference":"cust-8891"}},"key":"captureCard","summary":"Capture a card authorization — approved","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The capture record. It is a new transaction whose "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"reference_transaction_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" points at the authorization it captured. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expiry"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is null because expiry is not echoed back on capture responses. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"batch_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is now assigned, so the funds settle at the next batch close."},"children":[]}]}]}],"id":"paths/~1v1~1transactions~1{id}~1capture/post/responses/200/content/application~1json/examples/captureCard"},"paths/~1v1~1transactions~1{id}~1capture/post/responses/200/content/application~1json/examples/captureToken":{"value":{"id":"TRANSACTION-01KEW37D0SR6P2Q8ZTGHA1CWX5","reference_transaction_id":"TRANSACTION-01KEW34J7RS3N9P5WQDEX8ZTB2","type":"CAPTURE","result":"APPROVED","client_id":"CLIENT-01KFDKXMQ637EKEAY410MSQSXB","client_dba":"Acme Jewelry","integrations":["TSYS"],"response_code":"00","response_description":"Approved","batch_id":"BATCH-01KEW32V6YNV11T33XGDR7TGWC","is_settled":false,"time_created":"2026-07-15T16:19:05Z","amount":10000,"tip":0,"currency":"USD","payment_method":{"type":"CARD","truncated_pan":"****-****-****-5439","payment_token":"PAYMENT_TOKEN-01KFDKXMQ637EKEAY410MSQSXB","expiry":null,"first_name":"John","last_name":"Doe","entry_method":"keyed","auth_code":"123456","retrieval_reference_number":"000000603076","card_type":"UNKNOWN","card_brand":"Visa","cvv_result_code":"M"},"initiator":"CUSTOMER","network_transaction_id":"MCC1234567890","metadata":{"order_id":"ORD-10435","sales_channel":"web","customer_reference":"cust-8891"}},"key":"captureToken","summary":"Capture a stored-token authorization — approved","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The capture record for a token authorization. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payment_method"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" reports the card the token resolves to, with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expiry"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" null because a capture does not echo it, and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"reference_transaction_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" points at the authorization it captured."},"children":[]}]}]}],"id":"paths/~1v1~1transactions~1{id}~1capture/post/responses/200/content/application~1json/examples/captureToken"},"paths/~1v1~1transactions~1{id}~1capture/post/responses/400/content/application~1json/examples/invalidRequestData":{"value":{"error_code":"INVALID_REQUEST_DATA","error_message":"The API request contains invalid data.","details":{"amount":"Invalid amount","payment_method.pan":"Malformed PAN"},"source":{"system":"TSYS","code":"13","message":"Invalid amount"}},"key":"invalidRequestData","summary":"Invalid field value in the request body","id":"paths/~1v1~1transactions~1{id}~1capture/post/responses/400/content/application~1json/examples/invalidRequestData"},"paths/~1v1~1transactions~1{id}~1capture/post/responses/401/content/application~1json/examples/notAuthenticated":{"value":{"error_code":"NOT_AUTHENTICATED","error_message":"Access credentials missing or invalid.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"notAuthenticated","summary":"Missing or invalid API key","id":"paths/~1v1~1transactions~1{id}~1capture/post/responses/401/content/application~1json/examples/notAuthenticated"},"paths/~1v1~1transactions~1{id}~1capture/post/responses/403/content/application~1json/examples/unauthorizedAction":{"value":{"error_code":"UNAUTHORIZED_ACTION","error_message":"Requested action is unavailable or forbidden.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"unauthorizedAction","summary":"Authenticated but not authorized for this action","id":"paths/~1v1~1transactions~1{id}~1capture/post/responses/403/content/application~1json/examples/unauthorizedAction"},"paths/~1v1~1transactions~1{id}~1capture/post/responses/404/content/application~1json/examples/resourceNotFound":{"value":{"error_code":"RESOURCE_NOT_FOUND","error_message":"Resource not found.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"resourceNotFound","summary":"Resource ID does not exist","id":"paths/~1v1~1transactions~1{id}~1capture/post/responses/404/content/application~1json/examples/resourceNotFound"},"paths/~1v1~1transactions~1{id}~1capture/post/responses/409/content/application~1json/examples/duplicateAction":{"value":{"error_code":"DUPLICATE_ACTION","error_message":"Duplicate action requested.","details":null,"source":{"system":"TSYS","code":"12","message":"Invalid transaction"}},"key":"duplicateAction","summary":"Duplicate or state-conflicting action","id":"paths/~1v1~1transactions~1{id}~1capture/post/responses/409/content/application~1json/examples/duplicateAction"},"paths/~1v1~1transactions~1{id}~1capture/post/responses/500/content/application~1json/examples/systemError":{"value":{"error_code":"SYSTEM_ERROR","error_message":"Internal system error.","details":null,"source":{"system":"TSYS","code":"96","message":"System malfunction"}},"key":"systemError","summary":"Unhandled server fault or downstream processor error","id":"paths/~1v1~1transactions~1{id}~1capture/post/responses/500/content/application~1json/examples/systemError"},"paths/~1v1~1transactions~1{id}~1capture/post/responses/502/content/application~1json/examples/downstreamError":{"value":{"error_code":"DOWNSTREAM_ERROR","error_message":"Downstream service returned invalid or unexpected response.","details":null,"source":{"system":"VERICHECK","code":"502","message":"Bad Gateway"}},"key":"downstreamError","summary":"The processor returned an invalid or unexpected response","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Distinct from a 500. A 500 is a fault inside the gateway; a 502 means the gateway reached the processor and could not use what came back. Both are safe to retry, but only a 502 says the transaction may have been seen by the processor — reconcile before retrying a payment."},"children":[]}]}]}],"id":"paths/~1v1~1transactions~1{id}~1capture/post/responses/502/content/application~1json/examples/downstreamError"},"paths/~1v1~1transactions~1{id}~1cancel/post/requestBody/content/application~1json/examples/voidTransaction":{"value":{"type":"VOID"},"key":"voidTransaction","summary":"Void an unsettled transaction","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Voids the sale created by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"saleWithCard"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" before it settles. A void needs only the transaction "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; the amount is always the full original amount. Send it to the transaction ID being voided."},"children":[]}]}]}],"id":"paths/~1v1~1transactions~1{id}~1cancel/post/requestBody/content/application~1json/examples/voidTransaction"},"paths/~1v1~1transactions~1{id}~1cancel/post/requestBody/content/application~1json/examples/refundTransaction":{"value":{"type":"REFUND","amount":2500},"key":"refundTransaction","summary":"Partially refund a settled transaction","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Refunds $25.00 of the $100.00 sale created by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"saleWithCard"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The amount must be less than or equal to the original transaction amount; this partial refund shows that rule in use. Send it to the transaction ID being refunded."},"children":[]}]}]}],"id":"paths/~1v1~1transactions~1{id}~1cancel/post/requestBody/content/application~1json/examples/refundTransaction"},"paths/~1v1~1transactions~1{id}~1cancel/post/responses/200/content/application~1json/examples/voidTransaction":{"value":{"id":"TRANSACTION-01KEW38F2RT6N4Z1AJGV5MPQ82","reference_transaction_id":"TRANSACTION-01KEW32V6YNV11T33XGDR7TGWC","type":"CANCEL","result":"APPROVED","client_id":"CLIENT-01KFDKXMQ637EKEAY410MSQSXB","client_dba":"Acme Jewelry","integrations":["TSYS"],"response_code":"00","response_description":"Approved","batch_id":"BATCH-01KEW32V6YNV11T33XGDR7TGWC","is_settled":false,"time_created":"2026-07-15T17:30:44Z","amount":10000,"tip":0,"currency":"USD","payment_method":{"type":"CARD","truncated_pan":"****-****-****-5439","payment_token":"PAYMENT_TOKEN-01KFDKXMQ637EKEAY410MSQSXB","expiry":null,"first_name":"John","last_name":"Doe","entry_method":"keyed","auth_code":"123456","retrieval_reference_number":"000000603076","card_type":"UNKNOWN","card_brand":"Visa","cvv_result_code":null},"initiator":"CUSTOMER","network_transaction_id":"MCC1234567890","metadata":{"order_id":"ORD-10432","sales_channel":"web","customer_reference":"cust-8891"}},"key":"voidTransaction","summary":"Void — approved","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The void record. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" comes back as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"CANCEL"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", which is the type returned on void and refund response records, and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"reference_transaction_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" points at the sale that was voided. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expiry"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cvv_result_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are null because neither is re-checked on a void."},"children":[]}]}]}],"id":"paths/~1v1~1transactions~1{id}~1cancel/post/responses/200/content/application~1json/examples/voidTransaction"},"paths/~1v1~1transactions~1{id}~1cancel/post/responses/200/content/application~1json/examples/refundTransaction":{"value":{"id":"TRANSACTION-01KEW3B7XKC9P5W2DMHY6NRS13","reference_transaction_id":"TRANSACTION-01KEW32V6YNV11T33XGDR7TGWC","type":"REFUND","result":"APPROVED","client_id":"CLIENT-01KFDKXMQ637EKEAY410MSQSXB","client_dba":"Acme Jewelry","integrations":["TSYS"],"response_code":"00","response_description":"Approved","batch_id":null,"is_settled":false,"time_created":"2026-07-16T10:12:58Z","amount":2500,"tip":0,"currency":"USD","payment_method":{"type":"CARD","truncated_pan":"****-****-****-5439","payment_token":"PAYMENT_TOKEN-01KFDKXMQ637EKEAY410MSQSXB","expiry":null,"first_name":"John","last_name":"Doe","entry_method":"keyed","auth_code":"123456","retrieval_reference_number":"000000603076","card_type":"UNKNOWN","card_brand":"Visa","cvv_result_code":null},"initiator":"CUSTOMER","network_transaction_id":"MCC1234567890","metadata":{"order_id":"ORD-10432","sales_channel":"web","customer_reference":"cust-8891"}},"key":"refundTransaction","summary":"Partial refund — approved","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The refund record. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is the refunded amount, not the original sale amount. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" comes back as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"CANCEL"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"reference_transaction_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" points at the sale that was refunded. The refund lands in the next open batch, so its own "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"batch_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not yet assigned."},"children":[]}]}]}],"id":"paths/~1v1~1transactions~1{id}~1cancel/post/responses/200/content/application~1json/examples/refundTransaction"},"paths/~1v1~1transactions~1{id}~1cancel/post/responses/400/content/application~1json/examples/invalidRequestData":{"value":{"error_code":"INVALID_REQUEST_DATA","error_message":"The API request contains invalid data.","details":{"amount":"Invalid amount","payment_method.pan":"Malformed PAN"},"source":{"system":"TSYS","code":"13","message":"Invalid amount"}},"key":"invalidRequestData","summary":"Invalid field value in the request body","id":"paths/~1v1~1transactions~1{id}~1cancel/post/responses/400/content/application~1json/examples/invalidRequestData"},"paths/~1v1~1transactions~1{id}~1cancel/post/responses/401/content/application~1json/examples/notAuthenticated":{"value":{"error_code":"NOT_AUTHENTICATED","error_message":"Access credentials missing or invalid.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"notAuthenticated","summary":"Missing or invalid API key","id":"paths/~1v1~1transactions~1{id}~1cancel/post/responses/401/content/application~1json/examples/notAuthenticated"},"paths/~1v1~1transactions~1{id}~1cancel/post/responses/403/content/application~1json/examples/unauthorizedAction":{"value":{"error_code":"UNAUTHORIZED_ACTION","error_message":"Requested action is unavailable or forbidden.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"unauthorizedAction","summary":"Authenticated but not authorized for this action","id":"paths/~1v1~1transactions~1{id}~1cancel/post/responses/403/content/application~1json/examples/unauthorizedAction"},"paths/~1v1~1transactions~1{id}~1cancel/post/responses/404/content/application~1json/examples/resourceNotFound":{"value":{"error_code":"RESOURCE_NOT_FOUND","error_message":"Resource not found.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"resourceNotFound","summary":"Resource ID does not exist","id":"paths/~1v1~1transactions~1{id}~1cancel/post/responses/404/content/application~1json/examples/resourceNotFound"},"paths/~1v1~1transactions~1{id}~1cancel/post/responses/409/content/application~1json/examples/duplicateAction":{"value":{"error_code":"DUPLICATE_ACTION","error_message":"Duplicate action requested.","details":null,"source":{"system":"TSYS","code":"12","message":"Invalid transaction"}},"key":"duplicateAction","summary":"Duplicate or state-conflicting action","id":"paths/~1v1~1transactions~1{id}~1cancel/post/responses/409/content/application~1json/examples/duplicateAction"},"paths/~1v1~1transactions~1{id}~1cancel/post/responses/500/content/application~1json/examples/systemError":{"value":{"error_code":"SYSTEM_ERROR","error_message":"Internal system error.","details":null,"source":{"system":"TSYS","code":"96","message":"System malfunction"}},"key":"systemError","summary":"Unhandled server fault or downstream processor error","id":"paths/~1v1~1transactions~1{id}~1cancel/post/responses/500/content/application~1json/examples/systemError"},"paths/~1v1~1transactions~1{id}~1cancel/post/responses/502/content/application~1json/examples/downstreamError":{"value":{"error_code":"DOWNSTREAM_ERROR","error_message":"Downstream service returned invalid or unexpected response.","details":null,"source":{"system":"VERICHECK","code":"502","message":"Bad Gateway"}},"key":"downstreamError","summary":"The processor returned an invalid or unexpected response","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Distinct from a 500. A 500 is a fault inside the gateway; a 502 means the gateway reached the processor and could not use what came back. Both are safe to retry, but only a 502 says the transaction may have been seen by the processor — reconcile before retrying a payment."},"children":[]}]}]}],"id":"paths/~1v1~1transactions~1{id}~1cancel/post/responses/502/content/application~1json/examples/downstreamError"},"paths/~1v1~1transactions/get/responses/200/content/application~1json/examples/transactionList":{"value":{"total_count":3,"limit":10,"offset":0,"has_more":false,"transactions":[{"id":"TRANSACTION-01KEW32V6YNV11T33XGDR7TGWC","reference_transaction_id":null,"type":"SALE","result":"APPROVED","client_id":"CLIENT-01KFDKXMQ637EKEAY410MSQSXB","client_dba":"Acme Jewelry","integrations":["TSYS"],"response_code":"00","response_description":"Approved","batch_id":"BATCH-01KEW32V6YNV11T33XGDR7TGWC","is_settled":false,"time_created":"2026-07-15T14:22:05Z","amount":10000,"tip":0,"currency":"USD","payment_method":{"type":"CARD","truncated_pan":"****-****-****-5439","expiry":{"month":"01","year":"2028"},"first_name":"John","last_name":"Doe","entry_method":"keyed","auth_code":"123456","retrieval_reference_number":"000000603076","card_type":"CREDIT","card_brand":"Visa","cvv_result_code":"M","avs_result_code":"Y"},"initiator":"CUSTOMER","network_transaction_id":"MCC1234567890","metadata":{"order_id":"ORD-10432"}},{"id":"TRANSACTION-01KEW32V6YNV11T336VEDKL123","reference_transaction_id":null,"type":"AUTH","result":"APPROVED","client_id":"CLIENT-01KFDKXMQ637EKEAY410MSQSXB","client_dba":"Acme Jewelry","integrations":["TSYS"],"response_code":"00","response_description":"Approved","batch_id":null,"is_settled":false,"time_created":"2026-07-15T15:02:11Z","amount":10000,"tip":0,"currency":"USD","payment_method":{"type":"CARD","truncated_pan":"****-****-****-5439","expiry":{"month":"01","year":"2028"},"first_name":"John","last_name":"Doe","entry_method":"keyed","auth_code":"123456","retrieval_reference_number":"000000603076","card_type":"CREDIT","card_brand":"Visa","cvv_result_code":"M","avs_result_code":"Y"},"initiator":"CUSTOMER","network_transaction_id":"MCC1234567890","metadata":{"order_id":"ORD-10434"}},{"id":"TRANSACTION-01KEW36C9TQ5N1P7YRFGZ0BVW4","reference_transaction_id":null,"type":"SALE","result":"DECLINED","client_id":"CLIENT-01KFDKXMQ637EKEAY410MSQSXB","client_dba":"Acme Jewelry","integrations":["TSYS"],"response_code":"51","response_description":"Insufficient funds","batch_id":null,"is_settled":false,"time_created":"2026-07-15T15:47:52Z","amount":10000,"tip":0,"currency":"USD","payment_method":{"type":"CARD","truncated_pan":"****-****-****-5439","expiry":{"month":"01","year":"2028"},"first_name":"John","last_name":"Doe","entry_method":"keyed","retrieval_reference_number":"000000603077","card_type":"CREDIT","card_brand":"Visa","cvv_result_code":"M","avs_result_code":"Y"},"initiator":"CUSTOMER","network_transaction_id":null,"metadata":{"order_id":"ORD-10436"}}]},"key":"transactionList","summary":"First page of a transaction list","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Three transactions from the same merchant and batch — the approved sale, the approved authorization, and the declined sale. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"total_count"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is 3 and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"limit"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is 10, so "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"has_more"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is false and there is no next page to fetch."},"children":[]}]}]}],"id":"paths/~1v1~1transactions/get/responses/200/content/application~1json/examples/transactionList"},"paths/~1v1~1transactions/get/responses/400/content/application~1json/examples/invalidRequestData":{"value":{"error_code":"INVALID_REQUEST_DATA","error_message":"The API request contains invalid data.","details":{"amount":"Invalid amount","payment_method.pan":"Malformed PAN"},"source":{"system":"TSYS","code":"13","message":"Invalid amount"}},"key":"invalidRequestData","summary":"Invalid field value in the request body","id":"paths/~1v1~1transactions/get/responses/400/content/application~1json/examples/invalidRequestData"},"paths/~1v1~1transactions/get/responses/401/content/application~1json/examples/notAuthenticated":{"value":{"error_code":"NOT_AUTHENTICATED","error_message":"Access credentials missing or invalid.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"notAuthenticated","summary":"Missing or invalid API key","id":"paths/~1v1~1transactions/get/responses/401/content/application~1json/examples/notAuthenticated"},"paths/~1v1~1transactions/get/responses/403/content/application~1json/examples/unauthorizedAction":{"value":{"error_code":"UNAUTHORIZED_ACTION","error_message":"Requested action is unavailable or forbidden.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"unauthorizedAction","summary":"Authenticated but not authorized for this action","id":"paths/~1v1~1transactions/get/responses/403/content/application~1json/examples/unauthorizedAction"},"paths/~1v1~1transactions/get/responses/500/content/application~1json/examples/systemError":{"value":{"error_code":"SYSTEM_ERROR","error_message":"Internal system error.","details":null,"source":{"system":"TSYS","code":"96","message":"System malfunction"}},"key":"systemError","summary":"Unhandled server fault or downstream processor error","id":"paths/~1v1~1transactions/get/responses/500/content/application~1json/examples/systemError"},"paths/~1v1~1transactions~1{id}/get/responses/200/content/application~1json/examples/saleWithCard":{"value":{"id":"TRANSACTION-01KEW32V6YNV11T33XGDR7TGWC","reference_transaction_id":null,"type":"SALE","result":"APPROVED","client_id":"CLIENT-01KFDKXMQ637EKEAY410MSQSXB","client_dba":"Acme Jewelry","integrations":["TSYS"],"response_code":"00","response_description":"Approved","batch_id":"BATCH-01KEW32V6YNV11T33XGDR7TGWC","is_settled":false,"time_created":"2026-07-15T14:22:05Z","amount":10000,"tip":0,"currency":"USD","payment_method":{"type":"CARD","truncated_pan":"****-****-****-5439","payment_token":"PAYMENT_TOKEN-01KFDKXMQ637EKEAY410MSQSXB","expiry":{"month":"01","year":"2028"},"first_name":"John","last_name":"Doe","entry_method":"keyed","auth_code":"123456","retrieval_reference_number":"000000603076","card_type":"CREDIT","card_brand":"Visa","cvv_result_code":"M","avs_result_code":"Y","avs_response":"Exact Match - Street address and postal code match"},"initiator":"CUSTOMER","network_transaction_id":"MCC1234567890","metadata":{"order_id":"ORD-10432","sales_channel":"web","customer_reference":"cust-8891"}},"key":"saleWithCard","summary":"The same sale, read back from reporting","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The sale from "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"SaleWithCardResponseExample"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", read back after the processor reported the card type. Everything else is unchanged; the one difference is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payment_method.card_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", which was "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"UNKNOWN"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on the transaction response and is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"CREDIT"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" here. See "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"TransactionResponse"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for why the two differ."},"children":[]}]}]}],"id":"paths/~1v1~1transactions~1{id}/get/responses/200/content/application~1json/examples/saleWithCard"},"paths/~1v1~1transactions~1{id}/get/responses/400/content/application~1json/examples/invalidRequestData":{"value":{"error_code":"INVALID_REQUEST_DATA","error_message":"The API request contains invalid data.","details":{"amount":"Invalid amount","payment_method.pan":"Malformed PAN"},"source":{"system":"TSYS","code":"13","message":"Invalid amount"}},"key":"invalidRequestData","summary":"Invalid field value in the request body","id":"paths/~1v1~1transactions~1{id}/get/responses/400/content/application~1json/examples/invalidRequestData"},"paths/~1v1~1transactions~1{id}/get/responses/401/content/application~1json/examples/notAuthenticated":{"value":{"error_code":"NOT_AUTHENTICATED","error_message":"Access credentials missing or invalid.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"notAuthenticated","summary":"Missing or invalid API key","id":"paths/~1v1~1transactions~1{id}/get/responses/401/content/application~1json/examples/notAuthenticated"},"paths/~1v1~1transactions~1{id}/get/responses/403/content/application~1json/examples/unauthorizedAction":{"value":{"error_code":"UNAUTHORIZED_ACTION","error_message":"Requested action is unavailable or forbidden.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"unauthorizedAction","summary":"Authenticated but not authorized for this action","id":"paths/~1v1~1transactions~1{id}/get/responses/403/content/application~1json/examples/unauthorizedAction"},"paths/~1v1~1transactions~1{id}/get/responses/404/content/application~1json/examples/resourceNotFound":{"value":{"error_code":"RESOURCE_NOT_FOUND","error_message":"Resource not found.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"resourceNotFound","summary":"Resource ID does not exist","id":"paths/~1v1~1transactions~1{id}/get/responses/404/content/application~1json/examples/resourceNotFound"},"paths/~1v1~1transactions~1{id}/get/responses/500/content/application~1json/examples/systemError":{"value":{"error_code":"SYSTEM_ERROR","error_message":"Internal system error.","details":null,"source":{"system":"TSYS","code":"96","message":"System malfunction"}},"key":"systemError","summary":"Unhandled server fault or downstream processor error","id":"paths/~1v1~1transactions~1{id}/get/responses/500/content/application~1json/examples/systemError"},"paths/~1v1~1batches~1close/post/responses/400/content/application~1json/examples/invalidRequestData":{"value":{"error_code":"INVALID_REQUEST_DATA","error_message":"The API request contains invalid data.","details":{"amount":"Invalid amount","payment_method.pan":"Malformed PAN"},"source":{"system":"TSYS","code":"13","message":"Invalid amount"}},"key":"invalidRequestData","summary":"Invalid field value in the request body","id":"paths/~1v1~1batches~1close/post/responses/400/content/application~1json/examples/invalidRequestData"},"paths/~1v1~1batches~1close/post/responses/401/content/application~1json/examples/notAuthenticated":{"value":{"error_code":"NOT_AUTHENTICATED","error_message":"Access credentials missing or invalid.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"notAuthenticated","summary":"Missing or invalid API key","id":"paths/~1v1~1batches~1close/post/responses/401/content/application~1json/examples/notAuthenticated"},"paths/~1v1~1batches~1close/post/responses/403/content/application~1json/examples/unauthorizedAction":{"value":{"error_code":"UNAUTHORIZED_ACTION","error_message":"Requested action is unavailable or forbidden.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"unauthorizedAction","summary":"Authenticated but not authorized for this action","id":"paths/~1v1~1batches~1close/post/responses/403/content/application~1json/examples/unauthorizedAction"},"paths/~1v1~1batches~1close/post/responses/404/content/application~1json/examples/resourceNotFound":{"value":{"error_code":"RESOURCE_NOT_FOUND","error_message":"Resource not found.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"resourceNotFound","summary":"Resource ID does not exist","id":"paths/~1v1~1batches~1close/post/responses/404/content/application~1json/examples/resourceNotFound"},"paths/~1v1~1batches~1close/post/responses/409/content/application~1json/examples/duplicateAction":{"value":{"error_code":"DUPLICATE_ACTION","error_message":"Duplicate action requested.","details":null,"source":{"system":"TSYS","code":"12","message":"Invalid transaction"}},"key":"duplicateAction","summary":"Duplicate or state-conflicting action","id":"paths/~1v1~1batches~1close/post/responses/409/content/application~1json/examples/duplicateAction"},"paths/~1v1~1batches~1close/post/responses/500/content/application~1json/examples/systemError":{"value":{"error_code":"SYSTEM_ERROR","error_message":"Internal system error.","details":null,"source":{"system":"TSYS","code":"96","message":"System malfunction"}},"key":"systemError","summary":"Unhandled server fault or downstream processor error","id":"paths/~1v1~1batches~1close/post/responses/500/content/application~1json/examples/systemError"},"paths/~1v1~1batches~1close/post/responses/502/content/application~1json/examples/downstreamError":{"value":{"error_code":"DOWNSTREAM_ERROR","error_message":"Downstream service returned invalid or unexpected response.","details":null,"source":{"system":"VERICHECK","code":"502","message":"Bad Gateway"}},"key":"downstreamError","summary":"The processor returned an invalid or unexpected response","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Distinct from a 500. A 500 is a fault inside the gateway; a 502 means the gateway reached the processor and could not use what came back. Both are safe to retry, but only a 502 says the transaction may have been seen by the processor — reconcile before retrying a payment."},"children":[]}]}]}],"id":"paths/~1v1~1batches~1close/post/responses/502/content/application~1json/examples/downstreamError"},"paths/~1v1~1batches/get/responses/400/content/application~1json/examples/invalidRequestData":{"value":{"error_code":"INVALID_REQUEST_DATA","error_message":"The API request contains invalid data.","details":{"amount":"Invalid amount","payment_method.pan":"Malformed PAN"},"source":{"system":"TSYS","code":"13","message":"Invalid amount"}},"key":"invalidRequestData","summary":"Invalid field value in the request body","id":"paths/~1v1~1batches/get/responses/400/content/application~1json/examples/invalidRequestData"},"paths/~1v1~1batches/get/responses/401/content/application~1json/examples/notAuthenticated":{"value":{"error_code":"NOT_AUTHENTICATED","error_message":"Access credentials missing or invalid.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"notAuthenticated","summary":"Missing or invalid API key","id":"paths/~1v1~1batches/get/responses/401/content/application~1json/examples/notAuthenticated"},"paths/~1v1~1batches/get/responses/403/content/application~1json/examples/unauthorizedAction":{"value":{"error_code":"UNAUTHORIZED_ACTION","error_message":"Requested action is unavailable or forbidden.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"unauthorizedAction","summary":"Authenticated but not authorized for this action","id":"paths/~1v1~1batches/get/responses/403/content/application~1json/examples/unauthorizedAction"},"paths/~1v1~1batches/get/responses/500/content/application~1json/examples/systemError":{"value":{"error_code":"SYSTEM_ERROR","error_message":"Internal system error.","details":null,"source":{"system":"TSYS","code":"96","message":"System malfunction"}},"key":"systemError","summary":"Unhandled server fault or downstream processor error","id":"paths/~1v1~1batches/get/responses/500/content/application~1json/examples/systemError"},"paths/~1v1~1batches~1status/get/responses/400/content/application~1json/examples/invalidRequestData":{"value":{"error_code":"INVALID_REQUEST_DATA","error_message":"The API request contains invalid data.","details":{"amount":"Invalid amount","payment_method.pan":"Malformed PAN"},"source":{"system":"TSYS","code":"13","message":"Invalid amount"}},"key":"invalidRequestData","summary":"Invalid field value in the request body","id":"paths/~1v1~1batches~1status/get/responses/400/content/application~1json/examples/invalidRequestData"},"paths/~1v1~1batches~1status/get/responses/401/content/application~1json/examples/notAuthenticated":{"value":{"error_code":"NOT_AUTHENTICATED","error_message":"Access credentials missing or invalid.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"notAuthenticated","summary":"Missing or invalid API key","id":"paths/~1v1~1batches~1status/get/responses/401/content/application~1json/examples/notAuthenticated"},"paths/~1v1~1batches~1status/get/responses/403/content/application~1json/examples/unauthorizedAction":{"value":{"error_code":"UNAUTHORIZED_ACTION","error_message":"Requested action is unavailable or forbidden.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"unauthorizedAction","summary":"Authenticated but not authorized for this action","id":"paths/~1v1~1batches~1status/get/responses/403/content/application~1json/examples/unauthorizedAction"},"paths/~1v1~1batches~1status/get/responses/404/content/application~1json/examples/resourceNotFound":{"value":{"error_code":"RESOURCE_NOT_FOUND","error_message":"Resource not found.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"resourceNotFound","summary":"Resource ID does not exist","id":"paths/~1v1~1batches~1status/get/responses/404/content/application~1json/examples/resourceNotFound"},"paths/~1v1~1batches~1status/get/responses/500/content/application~1json/examples/systemError":{"value":{"error_code":"SYSTEM_ERROR","error_message":"Internal system error.","details":null,"source":{"system":"TSYS","code":"96","message":"System malfunction"}},"key":"systemError","summary":"Unhandled server fault or downstream processor error","id":"paths/~1v1~1batches~1status/get/responses/500/content/application~1json/examples/systemError"},"paths/~1v1~1batches~1transactions/get/responses/400/content/application~1json/examples/invalidRequestData":{"value":{"error_code":"INVALID_REQUEST_DATA","error_message":"The API request contains invalid data.","details":{"amount":"Invalid amount","payment_method.pan":"Malformed PAN"},"source":{"system":"TSYS","code":"13","message":"Invalid amount"}},"key":"invalidRequestData","summary":"Invalid field value in the request body","id":"paths/~1v1~1batches~1transactions/get/responses/400/content/application~1json/examples/invalidRequestData"},"paths/~1v1~1batches~1transactions/get/responses/401/content/application~1json/examples/notAuthenticated":{"value":{"error_code":"NOT_AUTHENTICATED","error_message":"Access credentials missing or invalid.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"notAuthenticated","summary":"Missing or invalid API key","id":"paths/~1v1~1batches~1transactions/get/responses/401/content/application~1json/examples/notAuthenticated"},"paths/~1v1~1batches~1transactions/get/responses/403/content/application~1json/examples/unauthorizedAction":{"value":{"error_code":"UNAUTHORIZED_ACTION","error_message":"Requested action is unavailable or forbidden.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"unauthorizedAction","summary":"Authenticated but not authorized for this action","id":"paths/~1v1~1batches~1transactions/get/responses/403/content/application~1json/examples/unauthorizedAction"},"paths/~1v1~1batches~1transactions/get/responses/500/content/application~1json/examples/systemError":{"value":{"error_code":"SYSTEM_ERROR","error_message":"Internal system error.","details":null,"source":{"system":"TSYS","code":"96","message":"System malfunction"}},"key":"systemError","summary":"Unhandled server fault or downstream processor error","id":"paths/~1v1~1batches~1transactions/get/responses/500/content/application~1json/examples/systemError"},"paths/~1v1~1batches~1{id}~1transactions/get/responses/400/content/application~1json/examples/invalidRequestData":{"value":{"error_code":"INVALID_REQUEST_DATA","error_message":"The API request contains invalid data.","details":{"amount":"Invalid amount","payment_method.pan":"Malformed PAN"},"source":{"system":"TSYS","code":"13","message":"Invalid amount"}},"key":"invalidRequestData","summary":"Invalid field value in the request body","id":"paths/~1v1~1batches~1{id}~1transactions/get/responses/400/content/application~1json/examples/invalidRequestData"},"paths/~1v1~1batches~1{id}~1transactions/get/responses/401/content/application~1json/examples/notAuthenticated":{"value":{"error_code":"NOT_AUTHENTICATED","error_message":"Access credentials missing or invalid.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"notAuthenticated","summary":"Missing or invalid API key","id":"paths/~1v1~1batches~1{id}~1transactions/get/responses/401/content/application~1json/examples/notAuthenticated"},"paths/~1v1~1batches~1{id}~1transactions/get/responses/403/content/application~1json/examples/unauthorizedAction":{"value":{"error_code":"UNAUTHORIZED_ACTION","error_message":"Requested action is unavailable or forbidden.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"unauthorizedAction","summary":"Authenticated but not authorized for this action","id":"paths/~1v1~1batches~1{id}~1transactions/get/responses/403/content/application~1json/examples/unauthorizedAction"},"paths/~1v1~1batches~1{id}~1transactions/get/responses/404/content/application~1json/examples/resourceNotFound":{"value":{"error_code":"RESOURCE_NOT_FOUND","error_message":"Resource not found.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"resourceNotFound","summary":"Resource ID does not exist","id":"paths/~1v1~1batches~1{id}~1transactions/get/responses/404/content/application~1json/examples/resourceNotFound"},"paths/~1v1~1batches~1{id}~1transactions/get/responses/500/content/application~1json/examples/systemError":{"value":{"error_code":"SYSTEM_ERROR","error_message":"Internal system error.","details":null,"source":{"system":"TSYS","code":"96","message":"System malfunction"}},"key":"systemError","summary":"Unhandled server fault or downstream processor error","id":"paths/~1v1~1batches~1{id}~1transactions/get/responses/500/content/application~1json/examples/systemError"},"paths/~1v1~1clients/post/responses/400/content/application~1json/examples/invalidRequestData":{"value":{"error_code":"INVALID_REQUEST_DATA","error_message":"The API request contains invalid data.","details":{"amount":"Invalid amount","payment_method.pan":"Malformed PAN"},"source":{"system":"TSYS","code":"13","message":"Invalid amount"}},"key":"invalidRequestData","summary":"Invalid field value in the request body","id":"paths/~1v1~1clients/post/responses/400/content/application~1json/examples/invalidRequestData"},"paths/~1v1~1clients/post/responses/401/content/application~1json/examples/notAuthenticated":{"value":{"error_code":"NOT_AUTHENTICATED","error_message":"Access credentials missing or invalid.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"notAuthenticated","summary":"Missing or invalid API key","id":"paths/~1v1~1clients/post/responses/401/content/application~1json/examples/notAuthenticated"},"paths/~1v1~1clients/post/responses/403/content/application~1json/examples/unauthorizedAction":{"value":{"error_code":"UNAUTHORIZED_ACTION","error_message":"Requested action is unavailable or forbidden.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"unauthorizedAction","summary":"Authenticated but not authorized for this action","id":"paths/~1v1~1clients/post/responses/403/content/application~1json/examples/unauthorizedAction"},"paths/~1v1~1clients/post/responses/409/content/application~1json/examples/duplicateAction":{"value":{"error_code":"DUPLICATE_ACTION","error_message":"Duplicate action requested.","details":null,"source":{"system":"TSYS","code":"12","message":"Invalid transaction"}},"key":"duplicateAction","summary":"Duplicate or state-conflicting action","id":"paths/~1v1~1clients/post/responses/409/content/application~1json/examples/duplicateAction"},"paths/~1v1~1clients/post/responses/500/content/application~1json/examples/systemError":{"value":{"error_code":"SYSTEM_ERROR","error_message":"Internal system error.","details":null,"source":{"system":"TSYS","code":"96","message":"System malfunction"}},"key":"systemError","summary":"Unhandled server fault or downstream processor error","id":"paths/~1v1~1clients/post/responses/500/content/application~1json/examples/systemError"},"paths/~1v1~1clients~1{clientId}/post/responses/400/content/application~1json/examples/invalidRequestData":{"value":{"error_code":"INVALID_REQUEST_DATA","error_message":"The API request contains invalid data.","details":{"amount":"Invalid amount","payment_method.pan":"Malformed PAN"},"source":{"system":"TSYS","code":"13","message":"Invalid amount"}},"key":"invalidRequestData","summary":"Invalid field value in the request body","id":"paths/~1v1~1clients~1{clientId}/post/responses/400/content/application~1json/examples/invalidRequestData"},"paths/~1v1~1clients~1{clientId}/post/responses/401/content/application~1json/examples/notAuthenticated":{"value":{"error_code":"NOT_AUTHENTICATED","error_message":"Access credentials missing or invalid.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"notAuthenticated","summary":"Missing or invalid API key","id":"paths/~1v1~1clients~1{clientId}/post/responses/401/content/application~1json/examples/notAuthenticated"},"paths/~1v1~1clients~1{clientId}/post/responses/403/content/application~1json/examples/unauthorizedAction":{"value":{"error_code":"UNAUTHORIZED_ACTION","error_message":"Requested action is unavailable or forbidden.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"unauthorizedAction","summary":"Authenticated but not authorized for this action","id":"paths/~1v1~1clients~1{clientId}/post/responses/403/content/application~1json/examples/unauthorizedAction"},"paths/~1v1~1clients~1{clientId}/post/responses/404/content/application~1json/examples/resourceNotFound":{"value":{"error_code":"RESOURCE_NOT_FOUND","error_message":"Resource not found.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"resourceNotFound","summary":"Resource ID does not exist","id":"paths/~1v1~1clients~1{clientId}/post/responses/404/content/application~1json/examples/resourceNotFound"},"paths/~1v1~1clients~1{clientId}/post/responses/409/content/application~1json/examples/duplicateAction":{"value":{"error_code":"DUPLICATE_ACTION","error_message":"Duplicate action requested.","details":null,"source":{"system":"TSYS","code":"12","message":"Invalid transaction"}},"key":"duplicateAction","summary":"Duplicate or state-conflicting action","id":"paths/~1v1~1clients~1{clientId}/post/responses/409/content/application~1json/examples/duplicateAction"},"paths/~1v1~1clients~1{clientId}/post/responses/500/content/application~1json/examples/systemError":{"value":{"error_code":"SYSTEM_ERROR","error_message":"Internal system error.","details":null,"source":{"system":"TSYS","code":"96","message":"System malfunction"}},"key":"systemError","summary":"Unhandled server fault or downstream processor error","id":"paths/~1v1~1clients~1{clientId}/post/responses/500/content/application~1json/examples/systemError"},"paths/~1v1~1clients/get/responses/400/content/application~1json/examples/invalidRequestData":{"value":{"error_code":"INVALID_REQUEST_DATA","error_message":"The API request contains invalid data.","details":{"amount":"Invalid amount","payment_method.pan":"Malformed PAN"},"source":{"system":"TSYS","code":"13","message":"Invalid amount"}},"key":"invalidRequestData","summary":"Invalid field value in the request body","id":"paths/~1v1~1clients/get/responses/400/content/application~1json/examples/invalidRequestData"},"paths/~1v1~1clients/get/responses/401/content/application~1json/examples/notAuthenticated":{"value":{"error_code":"NOT_AUTHENTICATED","error_message":"Access credentials missing or invalid.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"notAuthenticated","summary":"Missing or invalid API key","id":"paths/~1v1~1clients/get/responses/401/content/application~1json/examples/notAuthenticated"},"paths/~1v1~1clients/get/responses/403/content/application~1json/examples/unauthorizedAction":{"value":{"error_code":"UNAUTHORIZED_ACTION","error_message":"Requested action is unavailable or forbidden.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"unauthorizedAction","summary":"Authenticated but not authorized for this action","id":"paths/~1v1~1clients/get/responses/403/content/application~1json/examples/unauthorizedAction"},"paths/~1v1~1clients/get/responses/500/content/application~1json/examples/systemError":{"value":{"error_code":"SYSTEM_ERROR","error_message":"Internal system error.","details":null,"source":{"system":"TSYS","code":"96","message":"System malfunction"}},"key":"systemError","summary":"Unhandled server fault or downstream processor error","id":"paths/~1v1~1clients/get/responses/500/content/application~1json/examples/systemError"},"paths/~1v1~1clients~1{clientId}/get/responses/400/content/application~1json/examples/invalidRequestData":{"value":{"error_code":"INVALID_REQUEST_DATA","error_message":"The API request contains invalid data.","details":{"amount":"Invalid amount","payment_method.pan":"Malformed PAN"},"source":{"system":"TSYS","code":"13","message":"Invalid amount"}},"key":"invalidRequestData","summary":"Invalid field value in the request body","id":"paths/~1v1~1clients~1{clientId}/get/responses/400/content/application~1json/examples/invalidRequestData"},"paths/~1v1~1clients~1{clientId}/get/responses/401/content/application~1json/examples/notAuthenticated":{"value":{"error_code":"NOT_AUTHENTICATED","error_message":"Access credentials missing or invalid.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"notAuthenticated","summary":"Missing or invalid API key","id":"paths/~1v1~1clients~1{clientId}/get/responses/401/content/application~1json/examples/notAuthenticated"},"paths/~1v1~1clients~1{clientId}/get/responses/403/content/application~1json/examples/unauthorizedAction":{"value":{"error_code":"UNAUTHORIZED_ACTION","error_message":"Requested action is unavailable or forbidden.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"unauthorizedAction","summary":"Authenticated but not authorized for this action","id":"paths/~1v1~1clients~1{clientId}/get/responses/403/content/application~1json/examples/unauthorizedAction"},"paths/~1v1~1clients~1{clientId}/get/responses/404/content/application~1json/examples/resourceNotFound":{"value":{"error_code":"RESOURCE_NOT_FOUND","error_message":"Resource not found.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"resourceNotFound","summary":"Resource ID does not exist","id":"paths/~1v1~1clients~1{clientId}/get/responses/404/content/application~1json/examples/resourceNotFound"},"paths/~1v1~1clients~1{clientId}/get/responses/500/content/application~1json/examples/systemError":{"value":{"error_code":"SYSTEM_ERROR","error_message":"Internal system error.","details":null,"source":{"system":"TSYS","code":"96","message":"System malfunction"}},"key":"systemError","summary":"Unhandled server fault or downstream processor error","id":"paths/~1v1~1clients~1{clientId}/get/responses/500/content/application~1json/examples/systemError"},"paths/~1v1~1integrations/post/requestBody/content/application~1json/examples/tsysIntegration":{"value":{"client":"CLIENT-01KFDKXMQ637EKEAY410MSQSXB","is_active":true,"processor":"Tsys","integration_details":{"name":"Acme Jewelry LLC","amex_number":"1234567890","association":"123456","bin":"888888","discover_number":"123456789012345","dba":"Acme Jewelry","url":"https://example.apiserver.com","phone_number":17035550123,"fax_number":"+17035550199","mid":"888000001234","mcc":"5944","bank_number":"1234","industry":"R","amex_opt_blue":true,"agent_chain":"012345","store_number":"0001","mvv":"123456","terminal_number":"0001","agent_bank_number":"123456","agent_chain_number":"654321","descriptor_postal":"22150","descriptor_city":"Springfield","descriptor_state":"VA","descriptor_country":"US","descriptor_phone":17035550123,"descriptor_store_number":"0001","address1":"123 Main St","address2":"Suite 100","descriptor_line3":"ACME JEWELRY 703-555-0123","terminal_id":"00000001","v_number":"V1234567","settlement_time":"23:00","merchant_area_code":703,"descriptor_area_code":703,"sharing_group":"AEFGKMQ","merchant_aba_number":"123456789","merchant_settlement_agent_number":"1234","reimbursement_attribute":"0","fcsid":"12345"}},"key":"tsysIntegration","summary":"Onboard a TSYS merchant integration","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A complete TSYS host configuration for the merchant. Twenty-nine of these fields are required — the gateway enforces them in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"TsysHostDetailsValidator"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — so this payload is close to the minimum a real onboarding needs rather than a generous illustration. The processor-specific identifiers here are illustrative placeholders."},"children":[]}]}]}],"id":"paths/~1v1~1integrations/post/requestBody/content/application~1json/examples/tsysIntegration"},"paths/~1v1~1integrations/post/responses/200/content/application~1json/examples/tsysIntegration":{"value":{"id":"INTEGRATION-01KFDKXMQ637EKEAY410MSQSXB","is_active":true,"client":"CLIENT-01KFDKXMQ637EKEAY410MSQSXB","processor":"Tsys","integration_details":{"name":"Acme Jewelry LLC","dba":"Acme Jewelry","url":"https://example.apiserver.com","phone_number":17035550123,"fax_number":"+17035550199","mid":"888000001234","amex_number":"1234567890","association":"VISA","bin":"431940","discover_number":"601100999999","mcc":"5944","bank_number":"1234","industry":"R","amex_opt_blue":true,"agent_chain":"012345","store_number":"0001","mvv":"123456","terminal_number":"0001","agent_bank_number":"123456","agent_chain_number":"654321","descriptor_postal":"22150","descriptor_city":"Springfield","descriptor_state":"VA","descriptor_country":"US","descriptor_phone":17035550123,"descriptor_store_number":"0001","address1":"123 Main St","address2":"Suite 100","descriptor_line3":"ACME JEWELRY 703-555-0123","terminal_id":"00000001","v_number":"V1234567","settlement_time":"23:00","merchant_area_code":703,"descriptor_area_code":703,"sharing_group":"AEFGKMQ","merchant_aba_number":"123456789","merchant_settlement_agent_number":"1234","reimbursement_attribute":"0","fcsid":"12345","created_by":1042,"created_at":"2026-02-11T09:24:17Z","modified_by":1042,"modified_at":"2026-06-30T14:02:51Z"},"correlation_id":"01KFDKXMQ637EKEAY410MSQSXB"},"key":"tsysIntegration","summary":"TSYS merchant integration created","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The stored configuration, echoing back what was submitted and adding the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to reference it, the network identifiers TSYS assigns during onboarding ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amex_number"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"discover_number"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"association"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bin"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"), and the audit fields."},"children":[]}]}]}],"id":"paths/~1v1~1integrations/post/responses/200/content/application~1json/examples/tsysIntegration"},"paths/~1v1~1integrations/post/responses/400/content/application~1json/examples/invalidRequestData":{"value":{"error_code":"INVALID_REQUEST_DATA","error_message":"The API request contains invalid data.","details":{"amount":"Invalid amount","payment_method.pan":"Malformed PAN"},"source":{"system":"TSYS","code":"13","message":"Invalid amount"}},"key":"invalidRequestData","summary":"Invalid field value in the request body","id":"paths/~1v1~1integrations/post/responses/400/content/application~1json/examples/invalidRequestData"},"paths/~1v1~1integrations/post/responses/401/content/application~1json/examples/notAuthenticated":{"value":{"error_code":"NOT_AUTHENTICATED","error_message":"Access credentials missing or invalid.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"notAuthenticated","summary":"Missing or invalid API key","id":"paths/~1v1~1integrations/post/responses/401/content/application~1json/examples/notAuthenticated"},"paths/~1v1~1integrations/post/responses/403/content/application~1json/examples/unauthorizedAction":{"value":{"error_code":"UNAUTHORIZED_ACTION","error_message":"Requested action is unavailable or forbidden.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"unauthorizedAction","summary":"Authenticated but not authorized for this action","id":"paths/~1v1~1integrations/post/responses/403/content/application~1json/examples/unauthorizedAction"},"paths/~1v1~1integrations/post/responses/409/content/application~1json/examples/duplicateAction":{"value":{"error_code":"DUPLICATE_ACTION","error_message":"Duplicate action requested.","details":null,"source":{"system":"TSYS","code":"12","message":"Invalid transaction"}},"key":"duplicateAction","summary":"Duplicate or state-conflicting action","id":"paths/~1v1~1integrations/post/responses/409/content/application~1json/examples/duplicateAction"},"paths/~1v1~1integrations/post/responses/500/content/application~1json/examples/systemError":{"value":{"error_code":"SYSTEM_ERROR","error_message":"Internal system error.","details":null,"source":{"system":"TSYS","code":"96","message":"System malfunction"}},"key":"systemError","summary":"Unhandled server fault or downstream processor error","id":"paths/~1v1~1integrations/post/responses/500/content/application~1json/examples/systemError"},"paths/~1v1~1integrations~1{id}/post/responses/400/content/application~1json/examples/invalidRequestData":{"value":{"error_code":"INVALID_REQUEST_DATA","error_message":"The API request contains invalid data.","details":{"amount":"Invalid amount","payment_method.pan":"Malformed PAN"},"source":{"system":"TSYS","code":"13","message":"Invalid amount"}},"key":"invalidRequestData","summary":"Invalid field value in the request body","id":"paths/~1v1~1integrations~1{id}/post/responses/400/content/application~1json/examples/invalidRequestData"},"paths/~1v1~1integrations~1{id}/post/responses/401/content/application~1json/examples/notAuthenticated":{"value":{"error_code":"NOT_AUTHENTICATED","error_message":"Access credentials missing or invalid.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"notAuthenticated","summary":"Missing or invalid API key","id":"paths/~1v1~1integrations~1{id}/post/responses/401/content/application~1json/examples/notAuthenticated"},"paths/~1v1~1integrations~1{id}/post/responses/403/content/application~1json/examples/unauthorizedAction":{"value":{"error_code":"UNAUTHORIZED_ACTION","error_message":"Requested action is unavailable or forbidden.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"unauthorizedAction","summary":"Authenticated but not authorized for this action","id":"paths/~1v1~1integrations~1{id}/post/responses/403/content/application~1json/examples/unauthorizedAction"},"paths/~1v1~1integrations~1{id}/post/responses/404/content/application~1json/examples/resourceNotFound":{"value":{"error_code":"RESOURCE_NOT_FOUND","error_message":"Resource not found.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"resourceNotFound","summary":"Resource ID does not exist","id":"paths/~1v1~1integrations~1{id}/post/responses/404/content/application~1json/examples/resourceNotFound"},"paths/~1v1~1integrations~1{id}/post/responses/500/content/application~1json/examples/systemError":{"value":{"error_code":"SYSTEM_ERROR","error_message":"Internal system error.","details":null,"source":{"system":"TSYS","code":"96","message":"System malfunction"}},"key":"systemError","summary":"Unhandled server fault or downstream processor error","id":"paths/~1v1~1integrations~1{id}/post/responses/500/content/application~1json/examples/systemError"},"paths/~1v1~1integrations/get/responses/400/content/application~1json/examples/invalidRequestData":{"value":{"error_code":"INVALID_REQUEST_DATA","error_message":"The API request contains invalid data.","details":{"amount":"Invalid amount","payment_method.pan":"Malformed PAN"},"source":{"system":"TSYS","code":"13","message":"Invalid amount"}},"key":"invalidRequestData","summary":"Invalid field value in the request body","id":"paths/~1v1~1integrations/get/responses/400/content/application~1json/examples/invalidRequestData"},"paths/~1v1~1integrations/get/responses/401/content/application~1json/examples/notAuthenticated":{"value":{"error_code":"NOT_AUTHENTICATED","error_message":"Access credentials missing or invalid.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"notAuthenticated","summary":"Missing or invalid API key","id":"paths/~1v1~1integrations/get/responses/401/content/application~1json/examples/notAuthenticated"},"paths/~1v1~1integrations/get/responses/403/content/application~1json/examples/unauthorizedAction":{"value":{"error_code":"UNAUTHORIZED_ACTION","error_message":"Requested action is unavailable or forbidden.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"unauthorizedAction","summary":"Authenticated but not authorized for this action","id":"paths/~1v1~1integrations/get/responses/403/content/application~1json/examples/unauthorizedAction"},"paths/~1v1~1integrations/get/responses/500/content/application~1json/examples/systemError":{"value":{"error_code":"SYSTEM_ERROR","error_message":"Internal system error.","details":null,"source":{"system":"TSYS","code":"96","message":"System malfunction"}},"key":"systemError","summary":"Unhandled server fault or downstream processor error","id":"paths/~1v1~1integrations/get/responses/500/content/application~1json/examples/systemError"},"paths/~1v1~1integrations~1{id}/get/responses/400/content/application~1json/examples/invalidRequestData":{"value":{"error_code":"INVALID_REQUEST_DATA","error_message":"The API request contains invalid data.","details":{"amount":"Invalid amount","payment_method.pan":"Malformed PAN"},"source":{"system":"TSYS","code":"13","message":"Invalid amount"}},"key":"invalidRequestData","summary":"Invalid field value in the request body","id":"paths/~1v1~1integrations~1{id}/get/responses/400/content/application~1json/examples/invalidRequestData"},"paths/~1v1~1integrations~1{id}/get/responses/401/content/application~1json/examples/notAuthenticated":{"value":{"error_code":"NOT_AUTHENTICATED","error_message":"Access credentials missing or invalid.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"notAuthenticated","summary":"Missing or invalid API key","id":"paths/~1v1~1integrations~1{id}/get/responses/401/content/application~1json/examples/notAuthenticated"},"paths/~1v1~1integrations~1{id}/get/responses/403/content/application~1json/examples/unauthorizedAction":{"value":{"error_code":"UNAUTHORIZED_ACTION","error_message":"Requested action is unavailable or forbidden.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"unauthorizedAction","summary":"Authenticated but not authorized for this action","id":"paths/~1v1~1integrations~1{id}/get/responses/403/content/application~1json/examples/unauthorizedAction"},"paths/~1v1~1integrations~1{id}/get/responses/404/content/application~1json/examples/resourceNotFound":{"value":{"error_code":"RESOURCE_NOT_FOUND","error_message":"Resource not found.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"resourceNotFound","summary":"Resource ID does not exist","id":"paths/~1v1~1integrations~1{id}/get/responses/404/content/application~1json/examples/resourceNotFound"},"paths/~1v1~1integrations~1{id}/get/responses/500/content/application~1json/examples/systemError":{"value":{"error_code":"SYSTEM_ERROR","error_message":"Internal system error.","details":null,"source":{"system":"TSYS","code":"96","message":"System malfunction"}},"key":"systemError","summary":"Unhandled server fault or downstream processor error","id":"paths/~1v1~1integrations~1{id}/get/responses/500/content/application~1json/examples/systemError"},"paths/~1v1~1integrations~1summary~1{id}/get/responses/400/content/application~1json/examples/invalidRequestData":{"value":{"error_code":"INVALID_REQUEST_DATA","error_message":"The API request contains invalid data.","details":{"amount":"Invalid amount","payment_method.pan":"Malformed PAN"},"source":{"system":"TSYS","code":"13","message":"Invalid amount"}},"key":"invalidRequestData","summary":"Invalid field value in the request body","id":"paths/~1v1~1integrations~1summary~1{id}/get/responses/400/content/application~1json/examples/invalidRequestData"},"paths/~1v1~1integrations~1summary~1{id}/get/responses/401/content/application~1json/examples/notAuthenticated":{"value":{"error_code":"NOT_AUTHENTICATED","error_message":"Access credentials missing or invalid.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"notAuthenticated","summary":"Missing or invalid API key","id":"paths/~1v1~1integrations~1summary~1{id}/get/responses/401/content/application~1json/examples/notAuthenticated"},"paths/~1v1~1integrations~1summary~1{id}/get/responses/403/content/application~1json/examples/unauthorizedAction":{"value":{"error_code":"UNAUTHORIZED_ACTION","error_message":"Requested action is unavailable or forbidden.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"unauthorizedAction","summary":"Authenticated but not authorized for this action","id":"paths/~1v1~1integrations~1summary~1{id}/get/responses/403/content/application~1json/examples/unauthorizedAction"},"paths/~1v1~1integrations~1summary~1{id}/get/responses/404/content/application~1json/examples/resourceNotFound":{"value":{"error_code":"RESOURCE_NOT_FOUND","error_message":"Resource not found.","details":null,"source":{"system":null,"code":null,"message":null}},"key":"resourceNotFound","summary":"Resource ID does not exist","id":"paths/~1v1~1integrations~1summary~1{id}/get/responses/404/content/application~1json/examples/resourceNotFound"},"paths/~1v1~1integrations~1summary~1{id}/get/responses/500/content/application~1json/examples/systemError":{"value":{"error_code":"SYSTEM_ERROR","error_message":"Internal system error.","details":null,"source":{"system":"TSYS","code":"96","message":"System malfunction"}},"key":"systemError","summary":"Unhandled server fault or downstream processor error","id":"paths/~1v1~1integrations~1summary~1{id}/get/responses/500/content/application~1json/examples/systemError"}},"securitySchemeStore":{"ApiKeyAuth":{"id":"ApiKeyAuth","type":"apiKey","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key authentication. Include the API key in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Api-Key"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"WARNING"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": API key-based authentication offers no cryptographic security; always use "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.mozilla.org/en-US/docs/Glossary/HTTPS"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"HTTPS"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":":"},"children":[]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"  Api-Key: AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe\n","language":"http"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"  Api-Key: AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe\n"},"children":[]}]}],"in":"header","paramName":"Api-Key"}},"servers":[{"url":"/_mock/apis/openapi","isMockServer":true,"description":"Mock server (simulated responses)"}],"specType":"openapi"},"options":{"codeSamples":{"skipOptionalParameters":true,"languages":[{"lang":"Payload","label":"Payload"},{"lang":"curl","label":"cURL"},{"lang":"JavaScript","label":"JS"},{"lang":"C#","label":"C#"},{"lang":"Python","label":"Python"},{"lang":"Go","label":"Go"},{"lang":"Ruby","label":"Ruby"},{"lang":"Java","label":"Java"},{"lang":"Node.js","label":"Node.js"},{"lang":"PHP","label":"PHP"},{"lang":"R","label":"R"}]},"mockServer":{"url":"/_mock/apis/openapi","position":"replace","description":"Mock server (simulated responses)","strictExamples":false,"errorIfForcedExampleNotFound":false},"disableRouter":true,"downloadUrls":[{"url":"/_bundle/apis/openapi.json?download"},{"url":"/_bundle/apis/openapi.yaml?download"}],"excludeFromSearch":false,"replayFeatures":{"graphql":false},"specType":"openapi","markdocOptions":{"tags":{},"nodes":{},"components":{}},"metadata":{"title":"Gateway API","description":"Our public APIs enable clients to integrate with the Gateway API server. Our APIs use RESTful architecture, conform with OpenAPI specifications, and are PCI-DSS compliant.\n\n### Request IDs\n\nEvery response — successful or not — includes an `x-request-id` header containing a GUID that uniquely identifies the request.\n\n```http\nx-request-id: 73039bd9-c380-4186-bffe-259125144a56\n```\n\nLog this value with your request and supply it when contacting support so that a specific request can be traced.\n\n### Mock responses in this reference\n\nRequests sent from this reference go to a mock server, not the live gateway. Responses are generated from the examples in this description, so the values in them are illustrative and must not be used in a real integration. See the production server in the Servers list for live testing."}},"baseSlug":"/apis/openapi","routesMapping":{}}