Send requests to an ISO 8583 host over TCP.Responses are matched to requests by STAN (field 11), so several requests can be in
flight on one connection at once.Example
async with ISO8583Client("127.0.0.1", 8583) as client: response = await client.send(sample_message()) print(response.fields[39])
Parameters
str
required
Host name or address
int
required
TCP port
WireFormat | None
default:"None"
Byte layout of messages (defaults to ASCII with a binary bitmap)
Framing | None
default:"None"
Length header and optional TPDU (defaults to a 2-byte binary header)
float
default:"10.0"
Seconds to wait for a response
ssl_module.SSLContext | bool | None
default:"None"
True or an SSLContext to connect over TLS
ISO8583Version
default:"ISO8583Version.V1987"
ISO 8583 version used to decode responses
connect()
async def connect() -> None
Open the connection. send() also connects on demand.
close()
async def close() -> None
Close the connection. Requests still waiting fail with ConnectionError.
Send a request and return the matching response.Parameters
ISO8583Message
required
Request message. It must have a STAN (field 11).
float | None
default:"None"
Seconds to wait for the response (defaults to the client timeout)
ISO8583Message
The decoded response
Raises
TimeoutError: No response arrived in time
ConnectionError: The connection closed before the response arrived
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"iso8583sim","description":"Parse, build, validate and simulate ISO 8583 payment messages in Python.","colors":{"primary":"#5f7500","light":"#a6c433","dark":"#4a5c00"},"logo":{"light":"https://mintcdn.com/iso8583sim/ZhjVhzk39SWG2_E-/logo/light.svg?fit=max\u0026auto=format\u0026n=ZhjVhzk39SWG2_E-\u0026q=85\u0026s=30e70d0e911fd951334821b22aabddd6","dark":"https://mintcdn.com/iso8583sim/ZhjVhzk39SWG2_E-/logo/dark.svg?fit=max\u0026auto=format\u0026n=ZhjVhzk39SWG2_E-\u0026q=85\u0026s=58c136e87afbb59d86c7a0e7c25936ab","href":"https://iso8583sim.com"},"favicon":"https://mintcdn.com/iso8583sim/ZhjVhzk39SWG2_E-/favicon.svg?fit=max\u0026auto=format\u0026n=ZhjVhzk39SWG2_E-\u0026q=85\u0026s=2a487664f2c574f202e891f8d4b669ef","api":{"playground":{"proxy":false}},"background":{"color":{"light":"#f4f5f2","dark":"#0f120f"}},"navbar":{"links":[{"href":"https://pypi.org/project/iso8583sim/","label":"PyPI"}],"primary":{"type":"github","href":"https://github.com/bassrehab/ISO8583-Simulator"}},"footer":{"socials":{"github":"https://github.com/bassrehab/ISO8583-Simulator","website":"https://iso8583sim.com"}},"fonts":{"family":"IBM Plex Sans"},"icons":{"library":"lucide"},"contextual":{"options":["copy","view","chatgpt","claude","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Website","icon":"globe","href":"https://iso8583sim.com"},{"anchor":"Changelog","icon":"list","href":"https://github.com/bassrehab/ISO8583-Simulator/blob/main/CHANGELOG.md"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"iso8583sim","hasAudioNarration":false,"actualSubdomain":"iso8583sim","customDomains":["iso8583sim.com"],"gitSource":{"type":"github","owner":"bassrehab","repo":"iso8583-simulator","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6ac0f818b2b0263bbe982c60","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Guides","count":32},{"language":"default","tag":"Python API","count":26},{"language":"default","tag":"Core","count":21},{"language":"default","tag":"REST API","count":16},{"language":"default","tag":"Messages","count":6},{"language":"default","tag":"Get started","count":5},{"language":"default","tag":"LLM","count":4},{"language":"default","tag":"Networking","count":4},{"language":"default","tag":"Tools and interfaces","count":4},{"language":"default","tag":"LLM features","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[]}
{"page":{"pagePath":"api/net/client","slug":"/api/net/client","pageMetadata":{"title":"Client","description":"Asyncio TCP client that sends ISO 8583 requests and waits for their responses.","href":"/api/net/client"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Asyncio TCP client that sends ISO 8583 requests and waits for their responses.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,ResponseField}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:_jsx(_components.code,{children:`iso8583sim.net.client`})}),`\n`,_jsx(Heading,{level:`2`,id:`iso8583client`,children:_jsx(_components.code,{children:`ISO8583Client`})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`9`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`9`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`ISO8583Client(`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` host: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`str`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` port: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`int`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` wire_format: WireFormat `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`|`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` None`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` None`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` framing: Framing `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`|`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` None`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` None`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` timeout: `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`float`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 10.0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ssl: ssl_module.SSLContext `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`|`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:` bool`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` |`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` None`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` None`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` version: `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`ISO8583Version`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ISO8583Version.V1987,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Send requests to an ISO 8583 host over TCP.`}),`\n`,_jsx(_components.p,{children:`Responses are matched to requests by STAN (field 11), so several requests can be in\nflight on one connection at once.`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Example`})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`async`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` with`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ISO8583Client(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"127.0.0.1\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`8583`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`as`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` client:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` response `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` client.send(sample_message())`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:` print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(response.fields[`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`39`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`])`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Parameters`})}),`\n`,_jsx(ResponseField,{name:`host`,type:`str`,required:true,id:`param-host`,children:_jsx(_components.p,{children:`Host name or address`})}),`\n`,_jsx(ResponseField,{name:`port`,type:`int`,required:true,id:`param-port`,children:_jsx(_components.p,{children:`TCP port`})}),`\n`,_jsx(ResponseField,{name:`wire_format`,type:`WireFormat | None`,default:`None`,id:`param-wire-format`,children:_jsx(_components.p,{children:`Byte layout of messages (defaults to ASCII with a binary bitmap)`})}),`\n`,_jsx(ResponseField,{name:`framing`,type:`Framing | None`,default:`None`,id:`param-framing`,children:_jsx(_components.p,{children:`Length header and optional TPDU (defaults to a 2-byte binary header)`})}),`\n`,_jsx(ResponseField,{name:`timeout`,type:`float`,default:`10.0`,id:`param-timeout`,children:_jsx(_components.p,{children:`Seconds to wait for a response`})}),`\n`,_jsx(ResponseField,{name:`ssl`,type:`ssl_module.SSLContext | bool | None`,default:`None`,id:`param-ssl`,children:_jsx(_components.p,{children:`True or an SSLContext to connect over TLS`})}),`\n`,_jsx(ResponseField,{name:`version`,type:`ISO8583Version`,default:`ISO8583Version.V1987`,id:`param-version`,children:_jsx(_components.p,{children:`ISO 8583 version used to decode responses`})}),`\n`,_jsx(Heading,{level:`3`,id:`connect`,children:_jsx(_components.code,{children:`connect()`})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`async`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` def`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` connect`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`() -> `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`None`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Open the connection. send() also connects on demand.`}),`\n`,_jsx(Heading,{level:`3`,id:`close`,children:_jsx(_components.code,{children:`close()`})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`async`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` def`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` close`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`() -> `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`None`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Close the connection. Requests still waiting fail with ConnectionError.`}),`\n`,_jsx(Heading,{level:`3`,id:`send`,children:_jsx(_components.code,{children:`send()`})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`async`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` def`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` send`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`message`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: ISO8583Message, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`timeout`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`float`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` |`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` None`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` None`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) -> ISO8583Message`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Send a request and return the matching response.`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Parameters`})}),`\n`,_jsx(ResponseField,{name:`message`,type:`ISO8583Message`,required:true,id:`param-message`,children:_jsx(_components.p,{children:`Request message. It must have a STAN (field 11).`})}),`\n`,_jsx(ResponseField,{name:`timeout`,type:`float | None`,default:`None`,id:`param-timeout-1`,children:_jsx(_components.p,{children:`Seconds to wait for the response (defaults to the client timeout)`})}),`\n`,_jsx(ResponseField,{name:`Returns`,type:`ISO8583Message`,id:`param-returns`,children:_jsx(_components.p,{children:`The decoded response`})}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Raises`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`TimeoutError`}),`: No response arrived in time`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ConnectionError`}),`: The connection closed before the response arrived`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Client","description":"Asyncio TCP client that sends ISO 8583 requests and waits for their responses.","href":"/api/net/client"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"ISO8583Client","slug":"iso8583client","depth":2,"children":[{"title":"connect()","slug":"connect","depth":3,"children":[]},{"title":"close()","slug":"close","depth":3,"children":[]},{"title":"send()","slug":"send","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":[],"subdomain":"iso8583sim","siteName":"iso8583sim","title":"Client - iso8583sim","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-27T17:42:11.613Z","originalFileLocation":"api/net/client.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Asyncio TCP client that sends ISO 8583 requests and waits for their responses.\">\u003cmeta data-mint-head name=\"application-name\" content=\"iso8583sim\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/iso8583sim/Pu86LjvG04WQHsjW/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/iso8583sim/Pu86LjvG04WQHsjW/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/iso8583sim/Pu86LjvG04WQHsjW/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/iso8583sim/Pu86LjvG04WQHsjW/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/iso8583sim/Pu86LjvG04WQHsjW/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/iso8583sim/Pu86LjvG04WQHsjW/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/iso8583sim/Pu86LjvG04WQHsjW/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/iso8583sim/Pu86LjvG04WQHsjW/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/iso8583sim/Pu86LjvG04WQHsjW/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Client - iso8583sim\">\u003cmeta data-mint-head property=\"og:description\" content=\"Asyncio TCP client that sends ISO 8583 requests and waits for their responses.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"iso8583sim\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://iso8583sim.com/docs/api/net/client\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://iso8583sim.mintlify.site/docs/_mintlify/api/og/v2?division=Networking\u0026amp;title=Client\u0026amp;description=Asyncio+TCP+client+that+sends+ISO+8583+requests+and+waits+for+their+responses.\u0026amp;theme=c7ae27398c89a0d2eda0102e\u0026amp;signature=7bb1abadd15b6f63c63f7e7393c9953b4d4b4246734b6327b7910796f7975871\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Client - iso8583sim\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Asyncio TCP client that sends ISO 8583 requests and waits for their responses.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://iso8583sim.mintlify.site/docs/_mintlify/api/og/v2?division=Networking\u0026amp;title=Client\u0026amp;description=Asyncio+TCP+client+that+sends+ISO+8583+requests+and+waits+for+their+responses.\u0026amp;theme=c7ae27398c89a0d2eda0102e\u0026amp;signature=7bb1abadd15b6f63c63f7e7393c9953b4d4b4246734b6327b7910796f7975871\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/iso8583sim/Pu86LjvG04WQHsjW/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"iso8583sim\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5f7500\">\u003clink data-mint-head rel=\"canonical\" href=\"https://iso8583sim.com/docs/api/net/client\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api/net/client.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://iso8583sim.com/#organization\",\"name\":\"iso8583sim\",\"url\":\"https://iso8583sim.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/iso8583sim/ZhjVhzk39SWG2_E-/logo/light.svg?fit=max\u0026auto=format\u0026n=ZhjVhzk39SWG2_E-\u0026q=85\u0026s=30e70d0e911fd951334821b22aabddd6\"}},{\"@type\":\"WebSite\",\"@id\":\"https://iso8583sim.com/docs#website\",\"name\":\"iso8583sim\",\"url\":\"https://iso8583sim.com/docs\",\"publisher\":{\"@id\":\"https://iso8583sim.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://iso8583sim.com/docs/api/net/client#webpage\",\"url\":\"https://iso8583sim.com/docs/api/net/client\",\"name\":\"Client\",\"description\":\"Asyncio TCP client that sends ISO 8583 requests and waits for their responses.\",\"dateModified\":\"2026-09-27T17:42:11.613Z\",\"isPartOf\":{\"@id\":\"https://iso8583sim.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://iso8583sim.com/docs/api/net/client#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://iso8583sim.com/docs/api/net/client#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Networking\",\"item\":\"https://iso8583sim.com/docs/api/net/framing\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Client\",\"item\":\"https://iso8583sim.com/docs/api/net/client\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://iso8583sim.com/docs/api/net/client#article\",\"headline\":\"Client\",\"name\":\"Client\",\"description\":\"Asyncio TCP client that sends ISO 8583 requests and waits for their responses.\",\"url\":\"https://iso8583sim.com/docs/api/net/client\",\"mainEntityOfPage\":{\"@id\":\"https://iso8583sim.com/docs/api/net/client#webpage\"},\"dateModified\":\"2026-09-27T17:42:11.613Z\",\"publisher\":{\"@id\":\"https://iso8583sim.com/#organization\"},\"isPartOf\":{\"@id\":\"https://iso8583sim.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"iso8583sim\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"iso8583sim\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/api/net/client.md","siteName":"iso8583sim","nav":{"global":{"anchors":[{"anchor":"Website","icon":"globe","href":"https://iso8583sim.com"},{"anchor":"Changelog","icon":"list","href":"https://github.com/bassrehab/ISO8583-Simulator/blob/main/CHANGELOG.md"}]},"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"Python API","groups":[{"group":"Core","pages":[{"title":"Types","href":"/api/core/types"},{"title":"Parser","href":"/api/core/parser"},{"title":"Builder","href":"/api/core/builder"},{"title":"Validator","href":"/api/core/validator"},{"title":"Network rules","href":"/api/core/network_rules"},{"title":"EMV","href":"/api/core/emv"},{"title":"Codes","href":"/api/core/codes"},{"title":"Describe","href":"/api/core/describe"},{"title":"Convert","href":"/api/core/convert"},{"title":"Samples","href":"/api/core/samples"},{"title":"Pool","href":"/api/core/pool"}]},{"group":"Security","pages":[{"title":"PIN blocks","href":"/api/security/pinblock"},{"title":"MACs","href":"/api/security/mac"}]},{"group":"Wire formats","pages":[{"title":"WireFormat","href":"/api/wire/format"},{"title":"Encode and decode","href":"/api/wire/codec"}]},{"group":"Networking","pages":[{"title":"Framing","description":"Message framing for TCP: length headers and TPDUs.","href":"/api/net/framing"},{"title":"Client","href":"/api/net/client"},{"title":"Mock host","description":"Mock issuer host: an asyncio TCP server that answers ISO 8583 requests by rules.","href":"/api/net/host"},{"title":"Load testing","href":"/api/net/load"}]},{"group":"LLM","pages":[{"title":"Base","href":"/api/llm/base"},{"title":"Explainer","href":"/api/llm/explainer"},{"title":"Generator","href":"/api/llm/generator"},{"title":"Providers","href":"/api/llm/providers"}]},{"group":"Servers","pages":[{"title":"MCP server","href":"/api/mcp/server"},{"title":"REST app","href":"/api/web/app"}]},{"group":"Demo","pages":[{"title":"Demo helpers","href":"/api/demo"}]}]},{"tab":"REST API","pages":[{"title":"REST API","href":"/rest"}]}]},"basePath":"","title":"Client - iso8583sim","deploymentId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","buildId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","dynamics":[],"chunks":[]}