{
"message": "The given data was invalid.",
"errors": {
"name": [
"The name field is required."
]
}
}
Payins
Create Payin
Creates a payin (payment intent) for an order. Requires order_id and either type or gateway_id.
For card payments, the response includes a direct_link to the payment page.
For bank wire payments, the response includes bank transfer details in provider.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Truust","colors":{"primary":"#073963","light":"#058ed8","dark":"#073963"},"logo":{"light":"https://mintcdn.com/socialpay/eRLQ9ToOrOIOj92q/assets/logo-truust.png?fit=max\u0026auto=format\u0026n=eRLQ9ToOrOIOj92q\u0026q=85\u0026s=1952722bf3c061af44d2195d279d6953","dark":"https://mintcdn.com/socialpay/eRLQ9ToOrOIOj92q/assets/logo-truust.png?fit=max\u0026auto=format\u0026n=eRLQ9ToOrOIOj92q\u0026q=85\u0026s=1952722bf3c061af44d2195d279d6953","href":"https://truust.io"},"favicon":"https://mintcdn.com/socialpay/eRLQ9ToOrOIOj92q/assets/logo-truust.png?fit=max\u0026auto=format\u0026n=eRLQ9ToOrOIOj92q\u0026q=85\u0026s=1952722bf3c061af44d2195d279d6953","navbar":{"links":[{"href":"https://truust.io","label":"Truust Website"},{"href":"https://truust.io/contact/","label":"Contact Us"}]},"footer":{"socials":{"website":"https://truust.io"}},"contextual":{"options":["copy","chatgpt","claude","perplexity","grok","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Dashboard","icon":"chart-line","href":"http://dashboard-sandbox.truust.io"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"socialpay","hasAudioNarration":false,"actualSubdomain":"socialpay","customDomains":["docs.truust.io"],"gitSource":{"type":"github","owner":"truust-io","repo":"docs.truust.io","deployBranch":"master","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6ae89a23f8e61e223f91fd82","clientVersion":"0.0.4094","searchFilterCounts":[{"language":"default","tag":"API Reference","count":146},{"language":"default","tag":"Customers","count":13},{"language":"default","tag":"Orders","count":11},{"language":"default","tag":"Verifications","count":10},{"language":"default","tag":"Documentation","count":8},{"language":"default","tag":"Payins","count":7},{"language":"default","tag":"Bundles","count":6},{"language":"default","tag":"Account","count":5},{"language":"default","tag":"Wallets","count":5},{"language":"default","tag":"Platform","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"table td:first-child code{white-space:nowrap}"}],"page":{"pagePath":"api-reference/create-payin","slug":"/api-reference/create-payin","pageMetadata":{"title":"Create Payin","openapi":"POST /payins","description":"Creates a payin (payment intent) for an order. Requires `order_id` and either `type` or `gateway_id`.\n\nFor card payments, the response includes a `direct_link` to the payment page.\nFor bank wire payments, the response includes bank transfer details in `provider`.\n","href":"/api-reference/create-payin"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Creates a payin (payment intent) for an order. Requires \", _jsx(_components.code, {\n children: \"order_id\"\n }), \" and either \", _jsx(_components.code, {\n children: \"type\"\n }), \" or \", _jsx(_components.code, {\n children: \"gateway_id\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"For card payments, the response includes a \", _jsx(_components.code, {\n children: \"direct_link\"\n }), \" to the payment page.\\nFor bank wire payments, the response includes bank transfer details in \", _jsx(_components.code, {\n children: \"provider\"\n }), \".\"]\n })]\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create Payin","openapi":"POST /payins","description":"Creates a payin (payment intent) for an order. Requires `order_id` and either `type` or `gateway_id`.\n\nFor card payments, the response includes a `direct_link` to the payment page.\nFor bank wire payments, the response includes bank transfer details in `provider`.\n","href":"/api-reference/create-payin"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Create payin","description":"Creates a payin (payment intent) for an order. Requires `order_id` and either `type` or `gateway_id`.\n\nFor card payments, the response includes a `direct_link` to the payment page.\nFor bank wire payments, the response includes bank transfer details in `provider`.\n","operationId":"createPayin","tags":["Payins"],"requestBody":"b5ac687e-dc62-4eef-ad0f-2715e2101fbf","responses":{"200":"1a128b4e-e932-4491-ae15-84ab4d2f8de0","404":"329e17b4-28b4-48f9-88b5-1b1e47cb200c"},"method":"post","type":"path","servers":["0f42c800-8246-4ac3-9108-23b6b071ae36","82d02f21-f641-4af8-8110-3ba7289f1338"],"security":["ba798aec-ece0-4b40-af38-d7b7451a8091"],"path":"/payins","baseUrlOptions":["https://{subdomain}.truust.io/2.0","https://{subdomain}-sandbox.truust.io/2.0"],"title":"Create payin","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["order_id","type"],"example":{"order_id":4950,"type":"REDSYS_V2","save_card":1},"properties":{"order_id":{"type":"integer","description":"ID of the order to pay.","example":4950,"isRequired":true,"uniqueKey":"order_id","typeLabel":"integer"},"type":{"type":"string","description":"Payment method type. Valid values include `BANKWIRE`, `WALLET`, and any registered gateway type for the account\n(e.g. `REDSYS_V2`, `ADDON`, `ADDON_V2`, `ADDON_ICE`, `ADDON_HPP`, `ADDON_APPLE_PAY`, `AZUPAY`, `DCP`, `EPX`,\n`REDSYS_APPLE_PAY`, `REDSYS_AUTH`, `STRIPE`, `DOCOMO`, `SIBS_MBWAY`, `SIBS_MULTIBANCO`, `SEQURA`, `UNNAX`,\n`PAYPAL`, `BIZUM`, `INESPAY`).\n","example":"REDSYS_V2","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"gateway_id":{"type":"integer","description":"Gateway ID to use. Alternative to `type`.","uniqueKey":"gateway_id","typeLabel":"integer"},"card_id":{"type":"integer","description":"Saved card ID to charge (for recurring or one-click payments).","uniqueKey":"card_id","typeLabel":"integer"},"wallet_id":{"type":"integer","description":"Wallet ID to debit. Required when `type` is `WALLET`.","uniqueKey":"wallet_id","typeLabel":"integer"},"save_card":{"type":"integer","enum":[0,1],"description":"Set to `1` to tokenize and save the card for future use.","uniqueKey":"save_card","typeLabel":"enum\u003cinteger>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"order_id":4950,"type":"REDSYS_V2","save_card":1}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"1a128b4e-e932-4491-ae15-84ab4d2f8de0":{"description":"Payin created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer","uniqueKey":"id","typeLabel":"integer"},"self":{"type":"string","example":"/2.0/payins/456","uniqueKey":"self","typeLabel":"string"},"reference":{"oneOf":[{"type":"string","description":"Provider's payment reference ID.","uniqueKey":"reference.oneOf.0","typeLabel":"string"},{"type":"null","description":"Provider's payment reference ID.","uniqueKey":"reference.oneOf.1","typeLabel":"null"}],"uniqueKey":"reference","typeLabel":"string | null"},"type":{"type":"string","description":"Payment method type (e.g. `CARD`, `BANKWIRE`, `WALLET`).","uniqueKey":"type","typeLabel":"string"},"subtype":{"oneOf":[{"type":"string","uniqueKey":"subtype.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"subtype.oneOf.1","typeLabel":"null"}],"uniqueKey":"subtype","typeLabel":"string | null"},"status":{"type":"string","enum":["CREATED","AUTHORIZED","CONFIRMED","DENIED","REFUNDED","CANCELLED"],"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"provider":{"type":"object","additionalProperties":true,"description":"Raw provider response data.","uniqueKey":"provider","typeLabel":"object"},"tag":{"oneOf":[{"type":"string","uniqueKey":"tag.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"tag.oneOf.1","typeLabel":"null"}],"uniqueKey":"tag","typeLabel":"string | null"},"direct_link":{"oneOf":[{"type":"string","format":"uri","description":"Payment page URL. Only present when status is `CREATED` or `AUTHORIZED`.","uniqueKey":"direct_link.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","description":"Payment page URL. Only present when status is `CREATED` or `AUTHORIZED`.","uniqueKey":"direct_link.oneOf.1","typeLabel":"null"}],"uniqueKey":"direct_link","typeLabel":"string\u003curi> | null"},"created_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"created_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"created_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"created_at","typeLabel":"string\u003cdate-time> | null"},"confirmed_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"confirmed_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"confirmed_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"confirmed_at","typeLabel":"string\u003cdate-time> | null"},"denied_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"denied_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"denied_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"denied_at","typeLabel":"string\u003cdate-time> | null"},"connections":{"type":"object","description":"Hypermedia links to related resources.","additionalProperties":{"type":"string","uniqueKey":"connections.additionalProperties","typeLabel":"string"},"uniqueKey":"connections","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":123,"self":"/2.0/payins/456","reference":"\u003cstring>","type":"\u003cstring>","subtype":"\u003cstring>","status":"CREATED","provider":{},"tag":"\u003cstring>","direct_link":"\u003cstring>","created_at":"2023-11-07T05:31:56Z","confirmed_at":"2023-11-07T05:31:56Z","denied_at":"2023-11-07T05:31:56Z","connections":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"329e17b4-28b4-48f9-88b5-1b1e47cb200c":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"The given data was invalid.","uniqueKey":"message","typeLabel":"string"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"errors.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"errors.additionalProperties","typeLabel":"string[]"},"example":{"name":["The name field is required."]},"uniqueKey":"errors","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"The given data was invalid.","errors":{"name":["The name field is required."]}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"ba798aec-ece0-4b40-af38-d7b7451a8091":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Use your account's **Secret Key** as the Bearer token.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"0f42c800-8246-4ac3-9108-23b6b071ae36":{"url":"https://{subdomain}.truust.io/2.0","description":"Production","variables":{"subdomain":{"default":"your-subdomain","description":"Your account subdomain"}}},"82d02f21-f641-4af8-8110-3ba7289f1338":{"url":"https://{subdomain}-sandbox.truust.io/2.0","description":"Sandbox","variables":{"subdomain":{"default":"your-subdomain","description":"Your account subdomain"}}}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Use your account's **Secret Key** as the Bearer token.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Use your account's **Secret Key** as the Bearer token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.yaml"},"subdomain":"socialpay","siteName":"Truust","title":"Create Payin - Truust","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-03-12T07:06:50.183Z","originalFileLocation":"api-reference/create-payin.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=\"Creates a payin (payment intent) for an order. Requires order_id and either type or gateway_id. For card payments, the response includes a direct_link to the payment page. For bank wire payments, the response includes bank transfer details in provider.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Truust\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/socialpay/iG2BZRyj_cp1_SCh/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/socialpay/iG2BZRyj_cp1_SCh/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/socialpay/iG2BZRyj_cp1_SCh/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/socialpay/iG2BZRyj_cp1_SCh/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/socialpay/iG2BZRyj_cp1_SCh/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/socialpay/iG2BZRyj_cp1_SCh/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/socialpay/iG2BZRyj_cp1_SCh/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/socialpay/iG2BZRyj_cp1_SCh/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/socialpay/iG2BZRyj_cp1_SCh/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create Payin - Truust\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates a payin (payment intent) for an order. Requires order_id and either type or gateway_id. For card payments, the response includes a direct_link to the payment page. For bank wire payments, the response includes bank transfer details in provider.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Truust\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.truust.io/api-reference/create-payin\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://socialpay.mintlify.site/_mintlify/api/og/v2?division=Payins\u0026amp;title=Create+Payin\u0026amp;description=Creates+a+payin+%28payment+intent%29+for+an+order.+Requires+%60order_id%60+and+either+%60type%60+or+%60gateway_id%60.%0A%0AFor+card+payments%2C+the+response+includes+a+%60direct_link%60+\u0026amp;theme=07ebb1876c42192d9d839b55\u0026amp;signature=3e296a43d1653b6fc0fb82d89a3984a579d589c4c96cb7dec3405a682c53fe81\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create Payin - Truust\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates a payin (payment intent) for an order. Requires order_id and either type or gateway_id. For card payments, the response includes a direct_link to the payment page. For bank wire payments, the response includes bank transfer details in provider.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://socialpay.mintlify.site/_mintlify/api/og/v2?division=Payins\u0026amp;title=Create+Payin\u0026amp;description=Creates+a+payin+%28payment+intent%29+for+an+order.+Requires+%60order_id%60+and+either+%60type%60+or+%60gateway_id%60.%0A%0AFor+card+payments%2C+the+response+includes+a+%60direct_link%60+\u0026amp;theme=07ebb1876c42192d9d839b55\u0026amp;signature=3e296a43d1653b6fc0fb82d89a3984a579d589c4c96cb7dec3405a682c53fe81\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/socialpay/iG2BZRyj_cp1_SCh/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Truust\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#073963\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.truust.io/api-reference/create-payin\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/create-payin.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.truust.io/#organization\",\"name\":\"Truust\",\"url\":\"https://docs.truust.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/socialpay/eRLQ9ToOrOIOj92q/assets/logo-truust.png?fit=max\u0026auto=format\u0026n=eRLQ9ToOrOIOj92q\u0026q=85\u0026s=1952722bf3c061af44d2195d279d6953\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.truust.io#website\",\"name\":\"Truust\",\"url\":\"https://docs.truust.io\",\"publisher\":{\"@id\":\"https://docs.truust.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.truust.io/api-reference/create-payin#webpage\",\"url\":\"https://docs.truust.io/api-reference/create-payin\",\"name\":\"Create Payin\",\"description\":\"Creates a payin (payment intent) for an order. Requires order_id and either type or gateway_id. For card payments, the response includes a direct_link to the payment page. For bank wire payments, the response includes bank transfer details in provider.\",\"dateModified\":\"2026-03-12T07:06:50.183Z\",\"isPartOf\":{\"@id\":\"https://docs.truust.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.truust.io/api-reference/create-payin#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.truust.io/api-reference/create-payin#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.truust.io/api-reference\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Payins\",\"item\":\"https://docs.truust.io/api-reference/list-payins\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create Payin\",\"item\":\"https://docs.truust.io/api-reference/create-payin\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.truust.io/api-reference/create-payin#apireference\",\"headline\":\"Create Payin\",\"name\":\"Create Payin\",\"description\":\"Creates a payin (payment intent) for an order. Requires order_id and either type or gateway_id. For card payments, the response includes a direct_link to the payment page. For bank wire payments, the response includes bank transfer details in provider.\",\"url\":\"https://docs.truust.io/api-reference/create-payin\",\"mainEntityOfPage\":{\"@id\":\"https://docs.truust.io/api-reference/create-payin#webpage\"},\"dateModified\":\"2026-03-12T07:06:50.183Z\",\"publisher\":{\"@id\":\"https://docs.truust.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.truust.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Truust\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Truust","nav":{"global":{"anchors":[{"anchor":"Dashboard","icon":"chart-line","href":"http://dashboard-sandbox.truust.io"}]},"anchors":[{"anchor":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":"/introduction"}]},{"anchor":"API Reference","icon":"code","groups":[{"group":"API Reference","pages":[{"title":"API Reference","href":"/api-reference"},{"group":"Account","pages":[{"title":"Get Current Account","openapi":"GET /accounts/me","href":"/api-reference/get-account"},{"title":"Update Account","openapi":"PUT /accounts/me","href":"/api-reference/update-account"},{"title":"Create Account","openapi":"POST /accounts","href":"/api-reference/create-account"},{"title":"Get Account Fees","openapi":"GET /accounts/fees/{currency}","href":"/api-reference/get-account-fees"},{"title":"Verify Account","openapi":"POST /accounts/verify","href":"/api-reference/verify-account"}]},{"group":"Customers","pages":[{"title":"List Customers","openapi":"GET /customers","href":"/api-reference/list-customers"},{"title":"Create Customer","openapi":"POST /customers","href":"/api-reference/create-customer"},{"title":"Get Customer","openapi":"GET /customers/{uuid}","href":"/api-reference/get-customer"},{"title":"Update Customer","openapi":"PUT /customers/{uuid}","href":"/api-reference/update-customer"},{"title":"List Customer Wallets","openapi":"GET /customers/{uuid}/wallets","href":"/api-reference/list-customer-wallets"},{"title":"List Customer Cards","openapi":"GET /customers/{uuid}/cards","href":"/api-reference/list-customer-cards"},{"title":"Add Card to Customer","openapi":"POST /customers/{uuid}/cards","href":"/api-reference/create-card"},{"title":"List Customer Bank Accounts","openapi":"GET /customers/{uuid}/bankaccounts","href":"/api-reference/list-customer-bank-accounts"},{"title":"List Customer Addresses","openapi":"GET /customers/{uuid}/addresses","href":"/api-reference/list-customer-addresses"},{"title":"Add Address to Customer","openapi":"POST /customers/{uuid}/addresses","href":"/api-reference/create-customer-address"},{"title":"Get Customer Address","openapi":"GET /customers/{uuid}/addresses/{address_uuid}","href":"/api-reference/get-customer-address"},{"title":"Update Customer Address","openapi":"PUT /customers/{uuid}/addresses/{address_uuid}","href":"/api-reference/update-customer-address"},{"title":"List Customer Subscriptions","openapi":"GET /customers/{uuid}/subscriptions","href":"/api-reference/list-customer-subscriptions"}]},{"group":"Orders","pages":[{"title":"List Orders","openapi":"GET /orders","href":"/api-reference/list-orders"},{"title":"Create Order","openapi":"POST /orders","href":"/api-reference/create-order"},{"title":"Get Order","openapi":"GET /orders/{id}","href":"/api-reference/get-order"},{"title":"Update Order","openapi":"PUT /orders/{id}","href":"/api-reference/update-order"},{"title":"Get Order Payin","openapi":"GET /orders/{id}/payin","href":"/api-reference/get-order-payin"},{"title":"Get Order Payout","openapi":"GET /orders/{id}/payout","href":"/api-reference/get-order-payout"},{"title":"Accept Order","openapi":"POST /orders/{id}/accept","href":"/api-reference/accept-order"},{"title":"Cancel Order","openapi":"POST /orders/{id}/cancel","href":"/api-reference/cancel-order"},{"title":"Validate Order","openapi":"POST /orders/{id}/validate","href":"/api-reference/validate-order"},{"title":"Send Order Receipt","openapi":"POST /orders/{id}/receipt","href":"/api-reference/send-order-receipt"},{"title":"Reimburse Order","openapi":"POST /orders/{id}/reimburse","href":"/api-reference/reimburse-order"}]},{"group":"Payins","pages":[{"title":"List Payins","openapi":"GET /payins","description":null,"href":"/api-reference/list-payins"},{"title":"Create Payin","openapi":"POST /payins","href":"/api-reference/create-payin"},{"title":"Get Payin","openapi":"GET /payins/{id}","description":null,"href":"/api-reference/get-payin"},{"title":"Sync Payin Status","openapi":"PUT /payins/{id}","href":"/api-reference/sync-payin"},{"title":"Refund Payin","openapi":"POST /payins/{id}/refund","href":"/api-reference/refund-payin"},{"title":"Cancel Pre-Authorization","openapi":"POST /payins/{id}/cancelpreauth","href":"/api-reference/cancel-pre-auth"},{"title":"Request to Pay","openapi":"POST /payins/{id}/request","href":"/api-reference/request-to-pay"}]},{"group":"Payouts","pages":[{"title":"List Payouts","openapi":"GET /payouts","href":"/api-reference/list-payouts"},{"title":"Create Payout","openapi":"POST /payouts","href":"/api-reference/create-payout"},{"title":"Get Payout","openapi":"GET /payouts/{id}","href":"/api-reference/get-payout"},{"title":"Sync Payout Status","openapi":"POST /payouts/{id}/update","href":"/api-reference/sync-payout"}]},{"group":"Wallets","pages":[{"title":"List Wallets","openapi":"GET /wallets","href":"/api-reference/list-wallets"},{"title":"Create Wallet","openapi":"POST /wallets","href":"/api-reference/create-wallet"},{"title":"Get Wallet","openapi":"GET /wallets/{uuid}","href":"/api-reference/get-wallet"},{"title":"Update Wallet","openapi":"PUT /wallets/{uuid}","href":"/api-reference/update-wallet"},{"title":"List Wallet Transactions","openapi":"GET /wallets/{uuid}/transactions","href":"/api-reference/list-wallet-transactions"}]},{"group":"Bank Accounts","pages":[{"title":"Create Bank Account","openapi":"POST /bankaccounts","href":"/api-reference/create-bank-account"},{"title":"Get Bank Account","openapi":"GET /bankaccounts/{uuid}","href":"/api-reference/get-bank-account"},{"title":"Get Bank Account Validation","openapi":"GET /bankaccounts/validation","href":"/api-reference/get-bank-account-validation"}]},{"group":"Cards","pages":[{"title":"Get Card","openapi":"GET /cards/{uuid}","href":"/api-reference/get-card"},{"title":"Delete Card","openapi":"DELETE /cards/{uuid}","href":"/api-reference/delete-card"}]},{"group":"Subscriptions","pages":[{"title":"List Subscriptions","openapi":"GET /subscriptions","href":"/api-reference/list-subscriptions"},{"title":"Create Subscription","openapi":"POST /subscriptions","href":"/api-reference/create-subscription"},{"title":"Get Subscription","openapi":"GET /subscriptions/{id}","href":"/api-reference/get-subscription"},{"title":"Cancel Subscription","openapi":"PUT /subscriptions/{id}/cancel","href":"/api-reference/cancel-subscription"}]},{"group":"Verifications","pages":[{"title":"List Verifications","openapi":"GET /verifications","href":"/api-reference/list-verifications"},{"title":"Get Verification","openapi":"GET /verifications/{uuid}","href":"/api-reference/get-verification"},{"title":"Submit Verification (KYC)","openapi":"PUT /verifications/{uuid}","href":"/api-reference/submit-verification"},{"title":"Request Verification Review","openapi":"POST /verifications/{uuid}/request","href":"/api-reference/request-verification"},{"title":"Create KYC for a Customer","openapi":"POST /customers/{uuid}/verify","href":"/api-reference/create-customer-verification"},{"title":"Get KYC Verification for a Customer","openapi":"GET /customers/{uuid}/verification","href":"/api-reference/get-customer-verification"},{"title":"List Verification Documents","openapi":"GET /verifications/{uuid}/documents","href":"/api-reference/list-verification-documents"},{"title":"Upload Verification Document","openapi":"POST /verifications/{uuid}/documents","href":"/api-reference/upload-verification-document"},{"title":"Get Verification Document","openapi":"GET /verifications/{uuid}/documents/{document_uuid}","href":"/api-reference/get-verification-document"},{"title":"Update Verification Document","openapi":"PUT /verifications/{uuid}/documents/{document_uuid}","href":"/api-reference/update-verification-document"}]},{"group":"Bundles","pages":[{"title":"List Bundles","openapi":"GET /bundles","href":"/api-reference/list-bundles"},{"title":"Create Bundle","openapi":"POST /bundles","href":"/api-reference/create-bundle"},{"title":"List Expired Bundles","openapi":"GET /bundles/expired","href":"/api-reference/list-expired-bundles"},{"title":"Get Bundle","openapi":"GET /bundles/{bundle_id}","href":"/api-reference/get-bundle"},{"title":"Update Bundle","openapi":"PUT /bundles/{bundle_id}","href":"/api-reference/update-bundle"},{"title":"List Orders for a Bundle","openapi":"GET /bundles/{bundle_id}/orders","href":"/api-reference/list-bundle-orders"}]},{"group":"Refunds","pages":[{"title":"List Refunds","openapi":"GET /refunds","href":"/api-reference/list-refunds"},{"title":"Get Refund","openapi":"GET /refunds/{id}","href":"/api-reference/get-refund"}]}]}]}]},"basePath":"","title":"Create Payin - Truust","buildId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","deploymentId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C-hEh3I2.js","utils-CnF4QiUD.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C7PVNbel.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-8ytevL2A.js","snippetPresets-BT1alx3v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BLXC0i_W.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CyLIGI9_.js","shallow-DC0lGVIW.js","getApiPlaygroundDisplay-CgDQ85tN.js","CodeSnippet-6-I-Gpv9.js","CodeSnippets-BAk1kDdu.js","Page-C945cI-W.js","getPastedJson-B276RuWN.js","icon-BqP8etTm.js","MethodPill-DM6sbxG1.js","DuplicateIcon-PyJglOaE.js","createIcon-CMeOMAc_.js","DynamicMarkdown-BoyYAA8K.js","SectionHeading-DAYv3gvZ.js","axios-vUo_bRtp.js","Markdown-BhTTmazV.js","clsx-CR-RHrVC.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CBUH0-zX.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BmARFYNC.js"]}