{"items":[{"type":"link","label":"API specification for Glomo","link":"/api-reference/openapi","routeSlug":"/api-reference/openapi","content":{"contentType":"overview","meta":{"name":"API specification for Glomo"},"children":[{"nodeType":"container","panels":[{"title":"Download OpenAPI description","titleTranslationKey":"download.description.title","children":[{"kind":"download","label":"openapi.json","url":"/_bundle/api-reference/openapi.json?download"},{"kind":"download","label":"openapi.yaml","url":"/_bundle/api-reference/openapi.yaml?download"}]},{"title":"Overview","titleTranslationKey":"info.title","children":[{"kind":"email","title":"E-mail","titleTranslationKey":"info.contact.name","email":"developer@glomopay.com","label":"developer@glomopay.com","withCopyButton":true,"copyContent":"developer@glomopay.com"},{"kind":"externallink","title":"License","titleTranslationKey":"info.license","label":"Apache 2.0","url":"http://www.apache.org/licenses/LICENSE-2.0.html"},{"kind":"externallink","label":"Terms of Service","labelTranslationKey":"info.termsOfService","url":"https://www.glomopay.com/legal#terms-and-conditions"}]},{"title":"Languages","titleTranslationKey":"languages.title","children":[{"kind":"languages","options":[{"key":"curl","title":"curl","lang":"curl"},{"key":"javascript","title":"JavaScript","lang":"JavaScript"},{"key":"node","title":"Node.js","lang":"Node.js"},{"key":"python","title":"Python","lang":"Python"},{"key":"java","title":"Java","lang":"Java"},{"key":"csharp","title":"C#","lang":"C#"},{"key":"php","title":"PHP","lang":"PHP"},{"key":"go","title":"Go","lang":"Go"},{"key":"ruby","title":"Ruby","lang":"Ruby"},{"key":"r","title":"R","lang":"R"},{"key":"payload","title":"Payload","lang":"Payload"}]}]},{"title":"Servers","titleTranslationKey":"servers.title","children":[{"kind":"servers","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"mode":"default"}]}],"children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"header","level":1,"label":"API specification for Glomo (1.0.0)","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":"The Glomo API follows REST architecture, utilizing resource-oriented URLs for clarity. It handles form-encoded request bodies, delivers responses in JSON format, and operates with standard HTTP methods, authentication, and response codes."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can download the complete API collection by using the download options on the right."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The machine-readable description is also published at a stable URL, bundled into a single self-contained document with every "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"$ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" resolved:"},"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":"link","inline":true,"attributes":{"href":"https://docs.glomo.one/openapi.yaml"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"https://docs.glomo.one/openapi.yaml"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://docs.glomo.one/openapi.json"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"https://docs.glomo.one/openapi.json"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Point an API client or an AI coding agent at either URL to generate calls directly from the contract."},"children":[]}]}]}]}],"sectionId":"/api-reference/openapi"}],"sectionId":"/api-reference/openapi"}]}]}},{"type":"separator","label":"Authentication","content":null},{"type":"group","label":"API Key","link":"/api-reference/openapi/api_key","routeSlug":"/api-reference/openapi/api_key","items":[{"label":"Rotate API key","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/api_key/rotateapikey","routeSlug":"/api-reference/openapi/api_key/rotateapikey","metadata":{"seo":{"title":"Rotate API key","description":"Rotates the secret API key for your account, generating a new key immediately. The previous key remains valid until expire_after_in_seconds has elapsed, giving you time to update your integrations. Once the expiry period passes, the old key is revoked and any requests using it will return 401 Unauthorized."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"rotateApiKey","name":"Rotate API key","isWebhook":false,"pointer":"/paths/~1api-keys~1rotate/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Rotate API key","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":"Rotates the secret API key for your account, generating a new key immediately. The previous key remains valid until "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expire_after_in_seconds"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" has elapsed, giving you time to update your integrations. Once the expiry period passes, the old key is revoked and any requests using it will return "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"401 Unauthorized"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_0"}},"schemaId":"schema_0","pointer":"/paths/~1api-keys~1rotate/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api-keys/rotate","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_0"}},"responseCodes":["200","400","401"],"pointer":"/api-keys/rotate","href":"api_key/rotateapikey","openApiOperationId":"rotateApiKey","summary":"Rotate API key"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"schemaId":"schema_0","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_0"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"API key rotated successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1"}},"schemaId":"schema_1"},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bad request — invalid "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expire_after_in_seconds"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" value"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_2","exampleIds":["paths/~1api-keys~1rotate/post/responses/400/content/application~1json/examples/non_integer","paths/~1api-keys~1rotate/post/responses/400/content/application~1json/examples/out_of_range"]}},"schemaId":"schema_2","exampleIds":["paths/~1api-keys~1rotate/post/responses/400/content/application~1json/examples/non_integer","paths/~1api-keys~1rotate/post/responses/400/content/application~1json/examples/out_of_range"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized — missing or invalid API key"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_3","exampleIds":["paths/~1api-keys~1rotate/post/responses/401/content/application~1json/example"]}},"schemaId":"schema_3","exampleIds":["paths/~1api-keys~1rotate/post/responses/401/content/application~1json/example"]}],"pointer":"/paths/~1api-keys~1rotate/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_1","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1"}}},{"code":"400","schemaId":"schema_2","exampleIds":["paths/~1api-keys~1rotate/post/responses/400/content/application~1json/examples/non_integer","paths/~1api-keys~1rotate/post/responses/400/content/application~1json/examples/out_of_range"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_2","exampleIds":["paths/~1api-keys~1rotate/post/responses/400/content/application~1json/examples/non_integer","paths/~1api-keys~1rotate/post/responses/400/content/application~1json/examples/out_of_range"]}}},{"code":"401","schemaId":"schema_3","exampleIds":["paths/~1api-keys~1rotate/post/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_3","exampleIds":["paths/~1api-keys~1rotate/post/responses/401/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/api_key/rotateapikey"}],"panels":[]}]},"httpPath":"/api-keys/rotate"}],"content":{"contentType":"group","meta":{"name":"api_key"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"API Key","showPageActions":true},{"nodeType":"markdoc","content":"Manage your Glomo API keys. Use this resource to rotate your secret key and maintain secure access to the API."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api-keys/rotate","summary":"Rotate API key","prefix":{"name":"post","color":"post"},"badges":[],"link":"/api_key/rotateapikey","deprecated":false}]}]}]}]}},{"type":"separator","label":"Multi Currency Account","content":null},{"type":"group","label":"Balance","link":"/api-reference/openapi/balance","routeSlug":"/api-reference/openapi/balance","items":[{"type":"link","label":"Balance","link":"/api-reference/openapi/balance/balance","routeSlug":"/api-reference/openapi/balance/balance","httpVerb":"schema","content":{"contentType":"item","itemVariant":"schema","meta":{"name":"Balance"},"seo":{"title":"Balance"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Balance","showPageActions":true}],"panels":[]},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"schemaDefinition","attributes":{"showWriteOnly":true,"schemaRef":"#/components/schemas/Balance"},"children":[]}]}]}},{"type":"link","label":"AllBalances","link":"/api-reference/openapi/balance/allbalances","routeSlug":"/api-reference/openapi/balance/allbalances","httpVerb":"schema","content":{"contentType":"item","itemVariant":"schema","meta":{"name":"AllBalances"},"seo":{"title":"AllBalances"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"AllBalances","showPageActions":true}],"panels":[]},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"schemaDefinition","attributes":{"showWriteOnly":true,"schemaRef":"#/components/schemas/AllBalances"},"children":[]}]}]}},{"label":"Retrieve balances","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/balance/getbalance","routeSlug":"/api-reference/openapi/balance/getbalance","metadata":{"seo":{"title":"Retrieve balances","description":"Retrieves available balances for all currencies."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getBalance","name":"Retrieve balances","isWebhook":false,"pointer":"/paths/~1balances/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve balances","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves available balances for all currencies.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/balances","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","401"],"pointer":"/balances","href":"balance/getbalance","openApiOperationId":"getBalance","summary":"Retrieve balances"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AllBalances"}},"schemaId":"components/schemas/AllBalances"},{"code":"401","description":"Unauthorized"}],"pointer":"/paths/~1balances/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/AllBalances","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AllBalances"}}},{"code":"401"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/balance/getbalance"}],"panels":[]}]},"httpPath":"/balances"}],"content":{"contentType":"group","meta":{"name":"Balance"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Balance","showPageActions":true},{"nodeType":"markdoc","content":"This resource represents your Glomo balance. You can retrieve it to see the current balance on your Glomo account in all currencies enabled for your account."}],"panels":[{"children":[{"kind":"group-items","title":"Schemas","titleTranslationKey":"schemas","items":[{"title":"Balance","link":"/balance/balance","deprecated":false},{"title":"AllBalances","link":"/balance/allbalances","deprecated":false}]},{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/balances","summary":"Retrieve balances","prefix":{"name":"get","color":"get"},"badges":[],"link":"/balance/getbalance","deprecated":false}]}]}]}]}},{"type":"group","label":"Balance Conversions","link":"/api-reference/openapi/balance_conversions","routeSlug":"/api-reference/openapi/balance_conversions","items":[{"type":"link","label":"BalanceConversion","link":"/api-reference/openapi/balance_conversions/balanceconversion","routeSlug":"/api-reference/openapi/balance_conversions/balanceconversion","httpVerb":"schema","content":{"contentType":"item","itemVariant":"schema","meta":{"name":"BalanceConversion"},"seo":{"title":"BalanceConversion"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"BalanceConversion","showPageActions":true}],"panels":[]},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"schemaDefinition","attributes":{"showWriteOnly":true,"schemaRef":"#/components/schemas/BalanceConversion"},"children":[]}]}]}},{"label":"Convert balances","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/balance_conversions/createbalanceconversion","routeSlug":"/api-reference/openapi/balance_conversions/createbalanceconversion","metadata":{"seo":{"title":"Convert balances","description":"Converts balance from one currency to another. In the API you can either send target_amount or source_amount and the API will calculate the other amount for you."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createBalanceConversion","name":"Convert balances","isWebhook":false,"pointer":"/paths/~1balance_conversions/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Convert balances","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":"Converts balance from one currency to another. In the API you can either send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"target_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and the API will calculate the other amount for you."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_4","exampleIds":["paths/~1balance_conversions/post/requestBody/content/application~1json/examples/convert_source_amount","paths/~1balance_conversions/post/requestBody/content/application~1json/examples/receive_target_amount"]}},"schemaId":"schema_4","exampleIds":["paths/~1balance_conversions/post/requestBody/content/application~1json/examples/convert_source_amount","paths/~1balance_conversions/post/requestBody/content/application~1json/examples/receive_target_amount"],"pointer":"/paths/~1balance_conversions/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/balance_conversions","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_4","exampleIds":["paths/~1balance_conversions/post/requestBody/content/application~1json/examples/convert_source_amount","paths/~1balance_conversions/post/requestBody/content/application~1json/examples/receive_target_amount"]}},"responseCodes":["201","400"],"pointer":"/balance_conversions","href":"balance_conversions/createbalanceconversion","openApiOperationId":"createBalanceConversion","summary":"Convert balances"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"schemaId":"schema_4","exampleIds":["paths/~1balance_conversions/post/requestBody/content/application~1json/examples/convert_source_amount","paths/~1balance_conversions/post/requestBody/content/application~1json/examples/receive_target_amount"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_4","exampleIds":["paths/~1balance_conversions/post/requestBody/content/application~1json/examples/convert_source_amount","paths/~1balance_conversions/post/requestBody/content/application~1json/examples/receive_target_amount"]}},"examples":[{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Balance conversion created successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BalanceConversion"}},"schemaId":"components/schemas/BalanceConversion"},{"code":"400","description":"Bad request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_5"}},"schemaId":"schema_5"}],"pointer":"/paths/~1balance_conversions/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/BalanceConversion","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BalanceConversion"}}},{"code":"400","schemaId":"schema_5","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_5"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/balance_conversions/createbalanceconversion"}],"panels":[]}]},"httpPath":"/balance_conversions"},{"label":"List all Balance Conversions","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/balance_conversions/getbalanceconversions","routeSlug":"/api-reference/openapi/balance_conversions/getbalanceconversions","metadata":{"seo":{"title":"List all Balance Conversions","description":"Returns a list of your balance conversions. The balance conversions are returned sorted by creation date, with the most recent beneficiary appearing first."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getBalanceConversions","name":"List all Balance Conversions","isWebhook":false,"pointer":"/paths/~1balance_conversions/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List all Balance Conversions","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns a list of your balance conversions. The balance conversions are returned sorted by creation date, with the most recent beneficiary appearing first.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"source_currency","in":"query","schemaId":"schema_6","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency code in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format. Supported currencies: USD, EUR, GBP, AED, SGD and AUD. When both "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"target_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are sent they must differ, or the request returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"USD"},{"name":"target_currency","in":"query","schemaId":"schema_6","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency code in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format. Supported currencies: USD, EUR, GBP, AED, SGD and AUD. When both "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"target_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are sent they must differ, or the request returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"EUR"},{"name":"before","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return only resources created at or before this time. Send an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_8601"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" timestamp with an offset, such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-02-18T12:03:44Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-02-18T17:33:44+05:30"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A timestamp without an offset is read as UTC. A bare date ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") means the end of that day in UTC ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"23:59:59.999999Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). An invalid value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Use this to avoid page drift. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/platform/pagination#parameters"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameters"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"example":"2025-02-18T12:03:44Z"},{"name":"after","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return only resources created at or after this time. Send an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_8601"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" timestamp with an offset, such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-01-18T12:03:44Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-01-18T17:33:44+05:30"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A timestamp without an offset is read as UTC. A bare date ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") means the start of that day in UTC ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"00:00:00Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). An invalid value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Use this to avoid page drift. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/platform/pagination#parameters"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameters"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"example":"2025-01-18T12:03:44Z"},{"name":"per_page","in":"query","schemaId":"schema_8","description":"Number of resources per page. Should be between 1 and 100."},{"name":"page","in":"query","schemaId":"schema_9","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Page number for pagination. Starts from 1. Get the next page number from the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"next"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field in the response."},"children":[]}]}]}]}],"pointer":"/paths/~1balance_conversions/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/balance_conversions","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"source_currency","in":"query","example":"USD","schemaId":"schema_6"},{"name":"target_currency","in":"query","example":"EUR","schemaId":"schema_6"},{"name":"before","in":"query","example":"2025-02-18T12:03:44Z","schemaId":"schema_7"},{"name":"after","in":"query","example":"2025-01-18T12:03:44Z","schemaId":"schema_7"},{"name":"per_page","in":"query","schemaId":"schema_8"},{"name":"page","in":"query","schemaId":"schema_9"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","400"],"pointer":"/balance_conversions","href":"balance_conversions/getbalanceconversions","openApiOperationId":"getBalanceConversions","summary":"List all Balance Conversions"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"List of balance conversions matching the filters","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_10"}},"schemaId":"schema_10"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_11"}},"schemaId":"schema_11"}],"pointer":"/paths/~1balance_conversions/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_10","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_10"}}},{"code":"400","schemaId":"schema_11","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_11"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/balance_conversions/getbalanceconversions"}],"panels":[]}]},"httpPath":"/balance_conversions"}],"content":{"contentType":"group","meta":{"name":"balance_conversions"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Balance Conversions","showPageActions":true},{"nodeType":"markdoc","content":"Balance Conversion resource represents the details of the balance conversion. The balance conversion is the conversion of the balance from one supported currency to another supported currency."}],"panels":[{"children":[{"kind":"group-items","title":"Schemas","titleTranslationKey":"schemas","items":[{"title":"BalanceConversion","link":"/balance_conversions/balanceconversion","deprecated":false}]},{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/balance_conversions","summary":"Convert balances","prefix":{"name":"post","color":"post"},"badges":[],"link":"/balance_conversions/createbalanceconversion","deprecated":false},{"title":"/balance_conversions","summary":"List all Balance Conversions","prefix":{"name":"get","color":"get"},"badges":[],"link":"/balance_conversions/getbalanceconversions","deprecated":false}]}]}]}]}},{"type":"group","label":"FX","link":"/api-reference/openapi/fx_rate","routeSlug":"/api-reference/openapi/fx_rate","items":[{"label":"Get Mid-Market Rate","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/fx_rate/getmidmarketrate","routeSlug":"/api-reference/openapi/fx_rate/getmidmarketrate","metadata":{"seo":{"title":"Get Mid-Market Rate","description":"Returns the current mid-market exchange rate for a given currency pair.This is the base rate before any FX fees — FX fees will be charged on top of this rate."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getMidMarketRate","name":"Get Mid-Market Rate","isWebhook":false,"pointer":"/paths/~1fx-rate/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Mid-Market Rate","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":"Returns the current mid-market exchange rate for a given currency pair."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This is the base rate before any FX fees — FX fees will be charged on top of this rate."},"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":"Notes:"},"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":"This returns the mid-market rate only. FX fees are charged separately on top of this rate during actual conversions."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The rate is cached and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_at"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" indicates when the cached rate expires."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"source_currency","in":"query","schemaId":"schema_6","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The source currency code in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format (e.g. USD)."},"children":[]}]}]}],"required":true,"example":"USD"},{"name":"target_currency","in":"query","schemaId":"schema_6","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The target currency code in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format (e.g. EUR)."},"children":[]}]}]}],"required":true,"example":"EUR"}],"pointer":"/paths/~1fx-rate/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/fx-rate","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"source_currency","in":"query","required":true,"example":"USD","schemaId":"schema_6"},{"name":"target_currency","in":"query","required":true,"example":"EUR","schemaId":"schema_6"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","400","401"],"pointer":"/fx-rate","href":"fx_rate/getmidmarketrate","openApiOperationId":"getMidMarketRate","summary":"Get Mid-Market Rate"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_12"}},"schemaId":"schema_12"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_13","exampleIds":["paths/~1fx-rate/get/responses/400/content/application~1json/examples/missing_currency","paths/~1fx-rate/get/responses/400/content/application~1json/examples/invalid_currency","paths/~1fx-rate/get/responses/400/content/application~1json/examples/non_string_currency"]}},"schemaId":"schema_13","exampleIds":["paths/~1fx-rate/get/responses/400/content/application~1json/examples/missing_currency","paths/~1fx-rate/get/responses/400/content/application~1json/examples/invalid_currency","paths/~1fx-rate/get/responses/400/content/application~1json/examples/non_string_currency"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_14"}},"schemaId":"schema_14"}],"pointer":"/paths/~1fx-rate/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_12","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_12"}}},{"code":"400","schemaId":"schema_13","exampleIds":["paths/~1fx-rate/get/responses/400/content/application~1json/examples/missing_currency","paths/~1fx-rate/get/responses/400/content/application~1json/examples/invalid_currency","paths/~1fx-rate/get/responses/400/content/application~1json/examples/non_string_currency"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_13","exampleIds":["paths/~1fx-rate/get/responses/400/content/application~1json/examples/missing_currency","paths/~1fx-rate/get/responses/400/content/application~1json/examples/invalid_currency","paths/~1fx-rate/get/responses/400/content/application~1json/examples/non_string_currency"]}}},{"code":"401","schemaId":"schema_14","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_14"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/fx_rate/getmidmarketrate"}],"panels":[]}]},"httpPath":"/fx-rate"}],"content":{"contentType":"group","meta":{"name":"fx_rate"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"FX","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":"Returns the current mid-market exchange rate for a given currency pair. This is the base rate before any FX fees — FX fees will be charged on top of this rate."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/fx-rate","summary":"Get Mid-Market Rate","prefix":{"name":"get","color":"get"},"badges":[],"link":"/fx_rate/getmidmarketrate","deprecated":false}]}]}]}]}},{"type":"separator","label":"Payin","content":null},{"type":"group","label":"Payment Link","link":"/api-reference/openapi/payment_link","routeSlug":"/api-reference/openapi/payment_link","items":[{"type":"link","label":"PaymentLink","link":"/api-reference/openapi/payment_link/paymentlink","routeSlug":"/api-reference/openapi/payment_link/paymentlink","httpVerb":"schema","content":{"contentType":"item","itemVariant":"schema","meta":{"name":"PaymentLink"},"seo":{"title":"PaymentLink"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"PaymentLink","showPageActions":true}],"panels":[]},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"schemaDefinition","attributes":{"showWriteOnly":true,"schemaRef":"#/components/schemas/PaymentLink"},"children":[]}]}]}},{"label":"Create a new Payment Link","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/payment_link/createpayin","routeSlug":"/api-reference/openapi/payment_link/createpayin","metadata":{"seo":{"title":"Create a new Payment Link","description":"Create a shareable URL for a hosted payment page in one of two ways:"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createPayin","name":"Create a new Payment Link","isWebhook":false,"pointer":"/paths/~1payin/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a new Payment Link","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 shareable URL for a hosted payment page in one of two ways:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"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":"Payment link without quote"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — specify the amount, currency, expiry and payment methods"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"inline ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"PaymentLink"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"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":"Payment link with quote"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — pass a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"quote_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" from "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /quotes"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"resource: payin"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") to"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"bind the payment link to a quote. When supplied, the quote is the single source of truth for"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"amount, currency, payment method, expiry and fee splits; the locked fields ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":","},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_at"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"price_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payment_methods"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"split_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") must not be sent"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"CreatePaymentLinkWithQuoteRequest"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"quote_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is supplied, the payment link's"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"expiry is set to the quote's expiry."},"children":[]}]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The request variant is selected by the presence of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"quote_id"},"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":"Pass "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"split_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to declare your share of a dynamic pricing rule's fee for this payment link. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#tag/pricing_split"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Dynamic Fee Split"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". If a split on the payment link later stops resolving — Glomo deleted the underlying rule, or the rule is no longer dynamic — opening the checkout returns a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", the payment link is expired, and you must issue a new one."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Payment link creation does not take a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"request_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and has no duplicate-request check. Sending the same request twice without a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"quote_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" creates two payment links, and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v1/payin"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" has no "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"request_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" filter."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"To check complete list of API validations, click "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/platform/validations#validations-for-creating-payment-links"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"here"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_15"}},"schemaId":"schema_15","pointer":"/paths/~1payin/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/payin","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_15"}},"responseCodes":["201","400"],"pointer":"/payin","href":"payment_link/createpayin","openApiOperationId":"createPayin","summary":"Create a new Payment Link"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"schemaId":"schema_15","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_15"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Payment link created successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaymentLinkResponse"}},"schemaId":"components/schemas/PaymentLinkResponse"},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bad Request — validation error. For quote-based payment links, possible messages include "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"quote_id not found"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"quote_id is not a payin quote"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"quote_id has expired"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"quote_id has already been used"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount cannot be specified when quote_id is present"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (likewise for any other locked field: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_at"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"price_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payment_methods"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"split_ids"},"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":"For "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"split_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", every id must resolve to a live dynamic rule declared by your business, every dynamic rule on the same dimension must be declared, and every declared payment method must be enabled for your business."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_5","exampleIds":["paths/~1payin/post/responses/400/content/application~1json/examples/amount_conflict","paths/~1payin/post/responses/400/content/application~1json/examples/quote_not_found","paths/~1payin/post/responses/400/content/application~1json/examples/quote_not_payin","paths/~1payin/post/responses/400/content/application~1json/examples/quote_expired","paths/~1payin/post/responses/400/content/application~1json/examples/quote_already_used","paths/~1payin/post/responses/400/content/application~1json/examples/locked_field_amount","paths/~1payin/post/responses/400/content/application~1json/examples/locked_field_split_ids","paths/~1payin/post/responses/400/content/application~1json/examples/split_ids_unresolved","paths/~1payin/post/responses/400/content/application~1json/examples/split_ids_incomplete","paths/~1payin/post/responses/400/content/application~1json/examples/split_ids_method_not_enabled","paths/~1payin/post/responses/400/content/application~1json/examples/split_ids_required"]}},"schemaId":"schema_5","exampleIds":["paths/~1payin/post/responses/400/content/application~1json/examples/amount_conflict","paths/~1payin/post/responses/400/content/application~1json/examples/quote_not_found","paths/~1payin/post/responses/400/content/application~1json/examples/quote_not_payin","paths/~1payin/post/responses/400/content/application~1json/examples/quote_expired","paths/~1payin/post/responses/400/content/application~1json/examples/quote_already_used","paths/~1payin/post/responses/400/content/application~1json/examples/locked_field_amount","paths/~1payin/post/responses/400/content/application~1json/examples/locked_field_split_ids","paths/~1payin/post/responses/400/content/application~1json/examples/split_ids_unresolved","paths/~1payin/post/responses/400/content/application~1json/examples/split_ids_incomplete","paths/~1payin/post/responses/400/content/application~1json/examples/split_ids_method_not_enabled","paths/~1payin/post/responses/400/content/application~1json/examples/split_ids_required"]}],"pointer":"/paths/~1payin/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/PaymentLinkResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaymentLinkResponse"}}},{"code":"400","schemaId":"schema_5","exampleIds":["paths/~1payin/post/responses/400/content/application~1json/examples/amount_conflict","paths/~1payin/post/responses/400/content/application~1json/examples/quote_not_found","paths/~1payin/post/responses/400/content/application~1json/examples/quote_not_payin","paths/~1payin/post/responses/400/content/application~1json/examples/quote_expired","paths/~1payin/post/responses/400/content/application~1json/examples/quote_already_used","paths/~1payin/post/responses/400/content/application~1json/examples/locked_field_amount","paths/~1payin/post/responses/400/content/application~1json/examples/locked_field_split_ids","paths/~1payin/post/responses/400/content/application~1json/examples/split_ids_unresolved","paths/~1payin/post/responses/400/content/application~1json/examples/split_ids_incomplete","paths/~1payin/post/responses/400/content/application~1json/examples/split_ids_method_not_enabled","paths/~1payin/post/responses/400/content/application~1json/examples/split_ids_required"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_5","exampleIds":["paths/~1payin/post/responses/400/content/application~1json/examples/amount_conflict","paths/~1payin/post/responses/400/content/application~1json/examples/quote_not_found","paths/~1payin/post/responses/400/content/application~1json/examples/quote_not_payin","paths/~1payin/post/responses/400/content/application~1json/examples/quote_expired","paths/~1payin/post/responses/400/content/application~1json/examples/quote_already_used","paths/~1payin/post/responses/400/content/application~1json/examples/locked_field_amount","paths/~1payin/post/responses/400/content/application~1json/examples/locked_field_split_ids","paths/~1payin/post/responses/400/content/application~1json/examples/split_ids_unresolved","paths/~1payin/post/responses/400/content/application~1json/examples/split_ids_incomplete","paths/~1payin/post/responses/400/content/application~1json/examples/split_ids_method_not_enabled","paths/~1payin/post/responses/400/content/application~1json/examples/split_ids_required"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/payment_link/createpayin"}],"panels":[]}]},"httpPath":"/payin"},{"label":"List all payment links","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/payment_link/getpayins","routeSlug":"/api-reference/openapi/payment_link/getpayins","metadata":{"seo":{"title":"List all payment links","description":"Returns a list of your payment links. The payment links are returned sorted by creation date, with the most recent payment link appearing first."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getPayins","name":"List all payment links","isWebhook":false,"pointer":"/paths/~1payin/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List all payment links","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns a list of your payment links. The payment links are returned sorted by creation date, with the most recent payment link appearing first.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"customer_id","in":"query","schemaId":"schema_7","description":"Payment links of customer to filter"},{"name":"status","in":"query","schemaId":"schema_16","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return only payment links in this status. Uses the same values as the payment link's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field."},"children":[]}]}]}]},{"name":"before","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return only resources created at or before this time. Send an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_8601"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" timestamp with an offset, such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-02-18T12:03:44Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-02-18T17:33:44+05:30"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A timestamp without an offset is read as UTC. A bare date ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") means the end of that day in UTC ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"23:59:59.999999Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). An invalid value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Use this to avoid page drift. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/platform/pagination#parameters"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameters"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"example":"2025-02-18T12:03:44Z"},{"name":"after","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return only resources created at or after this time. Send an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_8601"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" timestamp with an offset, such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-01-18T12:03:44Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-01-18T17:33:44+05:30"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A timestamp without an offset is read as UTC. A bare date ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") means the start of that day in UTC ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"00:00:00Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). An invalid value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Use this to avoid page drift. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/platform/pagination#parameters"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameters"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"example":"2025-01-18T12:03:44Z"},{"name":"per_page","in":"query","schemaId":"schema_8","description":"Number of resources per page. Should be between 1 and 100."},{"name":"page","in":"query","schemaId":"schema_9","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Page number for pagination. Starts from 1. Get the next page number from the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"next"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field in the response."},"children":[]}]}]}]}],"pointer":"/paths/~1payin/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/payin","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"customer_id","in":"query","schemaId":"schema_7"},{"name":"status","in":"query","schemaId":"schema_16"},{"name":"before","in":"query","example":"2025-02-18T12:03:44Z","schemaId":"schema_7"},{"name":"after","in":"query","example":"2025-01-18T12:03:44Z","schemaId":"schema_7"},{"name":"per_page","in":"query","schemaId":"schema_8"},{"name":"page","in":"query","schemaId":"schema_9"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","400"],"pointer":"/payin","href":"payment_link/getpayins","openApiOperationId":"getPayins","summary":"List all payment links"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"List of payment links matching the filters","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_17"}},"schemaId":"schema_17"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_18"}},"schemaId":"schema_18"}],"pointer":"/paths/~1payin/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_17","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_17"}}},{"code":"400","schemaId":"schema_18","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_18"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/payment_link/getpayins"}],"panels":[]}]},"httpPath":"/payin"},{"label":"Retrieve a payment link","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/payment_link/getpayinbyid","routeSlug":"/api-reference/openapi/payment_link/getpayinbyid","metadata":{"seo":{"title":"Retrieve a payment link","description":"Retrieve details of a payment link."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getPayinById","name":"Retrieve a payment link","isWebhook":false,"pointer":"/paths/~1payin~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve a payment link","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 payment link.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the payment link. Starts with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"plink_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" followed by letters and digits. An ID of any other shape is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and a message saying it must start with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"plink_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; a well-formed ID that doesn't match a payment link on your account returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"404"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true,"example":"plink_678a4c88hpAjf"}],"pointer":"/paths/~1payin~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/payin/{id}","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"plink_678a4c88hpAjf","schemaId":"schema_7"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/payin/{id}","href":"payment_link/getpayinbyid","openApiOperationId":"getPayinById","summary":"Retrieve a payment link"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Payment link retrieved successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaymentLinkResponse"}},"schemaId":"components/schemas/PaymentLinkResponse"},{"code":"404","description":"Payment link not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}},"schemaId":"components/schemas/EntityNotFound"}],"pointer":"/paths/~1payin~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/PaymentLinkResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaymentLinkResponse"}}},{"code":"404","schemaId":"components/schemas/EntityNotFound","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/payment_link/getpayinbyid"}],"panels":[]}]},"httpPath":"/payin/{id}"},{"label":"Update an existing payment link","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/payment_link/updatepayin","routeSlug":"/api-reference/openapi/payment_link/updatepayin","metadata":{"seo":{"title":"Update an existing payment link","description":"Extends or reschedules a payment link that is still live. Only expires_at and reminder_frequencycan be changed — no other field on a payment link is editable, and the amount, currency and customerare fixed at creation."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updatePayin","name":"Update an existing payment link","isWebhook":false,"pointer":"/paths/~1payin~1{id}/patch","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update an existing payment link","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":"Extends or reschedules a payment link that is still live. Only "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_at"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"reminder_frequency"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"can be changed — no other field on a payment link is editable, and the amount, currency and customer"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"are fixed at creation."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The link must not have reached a terminal state. A payin that is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"success"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"failed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cancelled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":","},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expired"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rejected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" cannot be updated and the call returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with the message"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Payin cannot be updated from current state"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Use this to give a customer more time rather than"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"cancelling and re-issuing the link, which would change the URL your customer already has."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_19","description":"The unique identifier of the payment link to update.","required":true}],"pointer":"/paths/~1payin~1{id}/patch/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_20"}},"schemaId":"schema_20","pointer":"/paths/~1payin~1{id}/patch/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/payin/{id}","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"plink_678a4c88hpAjf","schemaId":"schema_19"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_20"}},"responseCodes":["200","400","404"],"pointer":"/payin/{id}","href":"payment_link/updatepayin","openApiOperationId":"updatePayin","summary":"Update an existing payment link"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"schemaId":"schema_20","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_20"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Payment link updated successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaymentLinkResponse"}},"schemaId":"components/schemas/PaymentLinkResponse"},{"code":"400","description":"Bad request"},{"code":"404","description":"Payment link not found"}],"pointer":"/paths/~1payin~1{id}/patch/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/PaymentLinkResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaymentLinkResponse"}}},{"code":"400"},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/payment_link/updatepayin"}],"panels":[]}]},"httpPath":"/payin/{id}"},{"label":"Cancel a payment link","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/payment_link/cancelpayin","routeSlug":"/api-reference/openapi/payment_link/cancelpayin","metadata":{"seo":{"title":"Cancel a payment link","description":"Invalidate payment link and prevent further transactions"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"cancelPayin","name":"Cancel a payment link","isWebhook":false,"pointer":"/paths/~1payin~1{id}~1cancel/patch","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Cancel a payment link","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Invalidate payment link and prevent further transactions\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the payment link to cancel. Starts with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"plink_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" followed by letters and digits. An ID of any other shape is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and a message saying it must start with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"plink_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; a well-formed ID that doesn't match a payment link on your account returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"404"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true,"example":"plink_678a4c88hpAjf"}],"pointer":"/paths/~1payin~1{id}~1cancel/patch/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/payin/{id}/cancel","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"plink_678a4c88hpAjf","schemaId":"schema_7"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/payin/{id}/cancel","href":"payment_link/cancelpayin","openApiOperationId":"cancelPayin","summary":"Cancel a payment link"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Payment link canceled successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaymentLinkResponse"}},"schemaId":"components/schemas/PaymentLinkResponse"},{"code":"404","description":"Payment link not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}},"schemaId":"components/schemas/EntityNotFound"}],"pointer":"/paths/~1payin~1{id}~1cancel/patch/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/PaymentLinkResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaymentLinkResponse"}}},{"code":"404","schemaId":"components/schemas/EntityNotFound","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/payment_link/cancelpayin"}],"panels":[]}]},"httpPath":"/payin/{id}/cancel"},{"label":"Update RFI documents for a payment link","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/payment_link/updatepayinrfi","routeSlug":"/api-reference/openapi/payment_link/updatepayinrfi","metadata":{"seo":{"title":"Update RFI documents for a payment link","description":"Updates the RFI (Request for Information) document status for a payment link. This endpoint is used to submit required documents when a payment link is in 'action_required' status due to sanction screening."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updatePayinRfi","name":"Update RFI documents for a payment link","isWebhook":false,"pointer":"/paths/~1payin~1{id}~1update-rfi/patch","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update RFI documents for a payment link","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":"Updates the RFI (Request for Information) document status for a payment link. This endpoint is used to submit required documents when a payment link is in 'action_required' status due to sanction screening."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_7","description":"The ID of the payment link to update RFI for","required":true,"example":"plink_678a4c88hpAjf"}],"pointer":"/paths/~1payin~1{id}~1update-rfi/patch/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_21"}},"schemaId":"schema_21","pointer":"/paths/~1payin~1{id}~1update-rfi/patch/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/payin/{id}/update-rfi","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"plink_678a4c88hpAjf","schemaId":"schema_7"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_21"}},"responseCodes":["200","400","404"],"pointer":"/payin/{id}/update-rfi","href":"payment_link/updatepayinrfi","openApiOperationId":"updatePayinRfi","summary":"Update RFI documents for a payment link"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"schemaId":"schema_21","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_21"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"RFI document updated successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaymentLinkResponse"}},"schemaId":"components/schemas/PaymentLinkResponse"},{"code":"400","description":"Bad request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_22"}},"schemaId":"schema_22"},{"code":"404","description":"Payment link not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}},"schemaId":"components/schemas/EntityNotFound"}],"pointer":"/paths/~1payin~1{id}~1update-rfi/patch/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/PaymentLinkResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaymentLinkResponse"}}},{"code":"400","schemaId":"schema_22","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_22"}}},{"code":"404","schemaId":"components/schemas/EntityNotFound","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/payment_link/updatepayinrfi"}],"panels":[]}]},"httpPath":"/payin/{id}/update-rfi"},{"label":"Mock review a payment link","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/payment_link/mockreviewpaymentlink","routeSlug":"/api-reference/openapi/payment_link/mockreviewpaymentlink","metadata":{"seo":{"title":"Mock review a payment link","description":"Mark an under_review payment link reviewed"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"mockReviewPaymentLink","name":"Mock review a payment link","isWebhook":false,"pointer":"/paths/~1payin~1{id}~1mock_mark_reviewed/patch","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Mock review a payment link","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":"Mark an under_review payment link reviewed"},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the payment link to review. Starts with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"plink_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" followed by letters and digits. An ID of any other shape is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and a message saying it must start with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"plink_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; a well-formed ID that doesn't match a payment link on your account returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"404"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true,"example":"plink_E602dMzgjpDC"}],"pointer":"/paths/~1payin~1{id}~1mock_mark_reviewed/patch/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/payin/{id}/mock_mark_reviewed","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"plink_E602dMzgjpDC","schemaId":"schema_7"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","400","404"],"pointer":"/payin/{id}/mock_mark_reviewed","href":"payment_link/mockreviewpaymentlink","openApiOperationId":"mockReviewPaymentLink","summary":"Mock review a payment link"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Payment link successfully marked reviewed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaymentLink"}},"schemaId":"components/schemas/PaymentLink"},{"code":"400","description":"Bad request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_23"}},"schemaId":"schema_23"},{"code":"404","description":"Payment link not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}},"schemaId":"components/schemas/EntityNotFound"}],"pointer":"/paths/~1payin~1{id}~1mock_mark_reviewed/patch/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/PaymentLink","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaymentLink"}}},{"code":"400","schemaId":"schema_23","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_23"}}},{"code":"404","schemaId":"components/schemas/EntityNotFound","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/payment_link/mockreviewpaymentlink"}],"panels":[]}]},"httpPath":"/payin/{id}/mock_mark_reviewed"}],"content":{"contentType":"group","meta":{"name":"payment_link"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Payment Link","showPageActions":true},{"nodeType":"markdoc","content":"A payment link is a shareable URL that will take your customers to a Glomo-hosted payment page. The payment page can only be accessed by your customer after the completion of 1FA via their email."}],"panels":[{"children":[{"kind":"group-items","title":"Schemas","titleTranslationKey":"schemas","items":[{"title":"PaymentLink","link":"/payment_link/paymentlink","deprecated":false}]},{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/payin","summary":"Create a new Payment Link","prefix":{"name":"post","color":"post"},"badges":[],"link":"/payment_link/createpayin","deprecated":false},{"title":"/payin","summary":"List all payment links","prefix":{"name":"get","color":"get"},"badges":[],"link":"/payment_link/getpayins","deprecated":false},{"title":"/payin/{id}","summary":"Retrieve a payment link","prefix":{"name":"get","color":"get"},"badges":[],"link":"/payment_link/getpayinbyid","deprecated":false},{"title":"/payin/{id}","summary":"Update an existing payment link","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/payment_link/updatepayin","deprecated":false},{"title":"/payin/{id}/cancel","summary":"Cancel a payment link","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/payment_link/cancelpayin","deprecated":false},{"title":"/payin/{id}/update-rfi","summary":"Update RFI documents for a payment link","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/payment_link/updatepayinrfi","deprecated":false},{"title":"/payin/{id}/mock_mark_reviewed","summary":"Mock review a payment link","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/payment_link/mockreviewpaymentlink","deprecated":false}]}]}]}]}},{"type":"group","label":"Orders","link":"/api-reference/openapi/orders","routeSlug":"/api-reference/openapi/orders","items":[{"type":"link","label":"Orders","link":"/api-reference/openapi/orders/orders","routeSlug":"/api-reference/openapi/orders/orders","httpVerb":"schema","content":{"contentType":"item","itemVariant":"schema","meta":{"name":"Orders"},"seo":{"title":"Orders"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Orders","showPageActions":true}],"panels":[]},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"schemaDefinition","attributes":{"showWriteOnly":true,"schemaRef":"#/components/schemas/Orders"},"children":[]}]}]}},{"label":"Create a new order","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/orders/createorder","routeSlug":"/api-reference/openapi/orders/createorder","metadata":{"seo":{"title":"Create a new order","description":"Create an order for checkout in one of two ways:"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createOrder","name":"Create a new order","isWebhook":false,"pointer":"/paths/~1orders/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a new order","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 an order for checkout in one of two ways:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"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":"Order without quote"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - specify the amount, currency and payment methods inline"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Orders"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"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":"Order with quote"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - pass a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"quote_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" from "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /quotes"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"resource: payin"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") to bind"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the order to a quote. When supplied, the quote is the single source of truth for amount,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"currency, payment method, expiry and fee splits; the locked fields ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":","},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"price_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payment_methods"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"split_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") must not be sent ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"CreateOrderWithQuoteRequest"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"quote_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is supplied, the order's expiry is set to the quote's expiry."},"children":[]}]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The request variant is selected by the presence of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"quote_id"},"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":"An "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"account funding"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" order is bound to a quote with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"resource_type: account_funding"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and also requires "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"beneficiary_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A declined order answers "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"422"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code"},"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":"Pass "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"split_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to declare your share of a dynamic pricing rule's fee for this order. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#tag/pricing_split"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Dynamic Fee Split"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". If a split on the order later stops resolving (Glomo deleted the underlying rule, or the rule is no longer dynamic) opening the checkout returns a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", the order is expired, and you must issue a new one."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"To check complete list of API validations, click "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/platform/validations#validations-for-creating-orders"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"here"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_24"}},"schemaId":"schema_24","pointer":"/paths/~1orders/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/orders","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_24"}},"responseCodes":["201","400","422"],"pointer":"/orders","href":"orders/createorder","openApiOperationId":"createOrder","summary":"Create a new order"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"schemaId":"schema_24","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_24"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Order created successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/OrderResponse"}},"schemaId":"components/schemas/OrderResponse"},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bad Request — validation error. For quote-based orders, possible messages include "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"quote_id not found"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"quote_id is not a payin quote"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"quote_id has expired"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"quote_id has already been used"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount cannot be specified when quote_id is present"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (likewise for any other locked field: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"price_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payment_methods"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"split_ids"},"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":"For "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"split_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", every id must resolve to a live dynamic rule declared by your business, every dynamic rule on the same dimension must be declared, and every declared payment method must be enabled for your business."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_25","exampleIds":["paths/~1orders/post/responses/400/content/application~1json/examples/currency_not_supported","paths/~1orders/post/responses/400/content/application~1json/examples/duplicate_request_id","paths/~1orders/post/responses/400/content/application~1json/examples/quote_not_found","paths/~1orders/post/responses/400/content/application~1json/examples/quote_not_payin","paths/~1orders/post/responses/400/content/application~1json/examples/quote_expired","paths/~1orders/post/responses/400/content/application~1json/examples/quote_already_used","paths/~1orders/post/responses/400/content/application~1json/examples/locked_field_amount","paths/~1orders/post/responses/400/content/application~1json/examples/locked_field_split_ids","paths/~1orders/post/responses/400/content/application~1json/examples/split_ids_unresolved","paths/~1orders/post/responses/400/content/application~1json/examples/split_ids_incomplete","paths/~1orders/post/responses/400/content/application~1json/examples/split_ids_method_not_enabled","paths/~1orders/post/responses/400/content/application~1json/examples/split_ids_required"]}},"schemaId":"schema_25","exampleIds":["paths/~1orders/post/responses/400/content/application~1json/examples/currency_not_supported","paths/~1orders/post/responses/400/content/application~1json/examples/duplicate_request_id","paths/~1orders/post/responses/400/content/application~1json/examples/quote_not_found","paths/~1orders/post/responses/400/content/application~1json/examples/quote_not_payin","paths/~1orders/post/responses/400/content/application~1json/examples/quote_expired","paths/~1orders/post/responses/400/content/application~1json/examples/quote_already_used","paths/~1orders/post/responses/400/content/application~1json/examples/locked_field_amount","paths/~1orders/post/responses/400/content/application~1json/examples/locked_field_split_ids","paths/~1orders/post/responses/400/content/application~1json/examples/split_ids_unresolved","paths/~1orders/post/responses/400/content/application~1json/examples/split_ids_incomplete","paths/~1orders/post/responses/400/content/application~1json/examples/split_ids_method_not_enabled","paths/~1orders/post/responses/400/content/application~1json/examples/split_ids_required"]},{"code":"422","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unprocessable Entity - the request was well formed but the order was declined. Returned for account funding orders, which carry a machine-readable "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" beside the message."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"order_cap_unavailable"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payment_method_unavailable"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" share the same customer-safe message, so branch on "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", never on "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"message"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The cap applies to the "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"destination"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" currency - the amount credited, not the amount charged to the card."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_26","exampleIds":["paths/~1orders/post/responses/422/content/application~1json/examples/order_amount_above_cap","paths/~1orders/post/responses/422/content/application~1json/examples/order_cap_unavailable","paths/~1orders/post/responses/422/content/application~1json/examples/beneficiary_missing","paths/~1orders/post/responses/422/content/application~1json/examples/quote_resource_type_missing"]}},"schemaId":"schema_26","exampleIds":["paths/~1orders/post/responses/422/content/application~1json/examples/order_amount_above_cap","paths/~1orders/post/responses/422/content/application~1json/examples/order_cap_unavailable","paths/~1orders/post/responses/422/content/application~1json/examples/beneficiary_missing","paths/~1orders/post/responses/422/content/application~1json/examples/quote_resource_type_missing"]}],"pointer":"/paths/~1orders/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/OrderResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/OrderResponse"}}},{"code":"400","schemaId":"schema_25","exampleIds":["paths/~1orders/post/responses/400/content/application~1json/examples/currency_not_supported","paths/~1orders/post/responses/400/content/application~1json/examples/duplicate_request_id","paths/~1orders/post/responses/400/content/application~1json/examples/quote_not_found","paths/~1orders/post/responses/400/content/application~1json/examples/quote_not_payin","paths/~1orders/post/responses/400/content/application~1json/examples/quote_expired","paths/~1orders/post/responses/400/content/application~1json/examples/quote_already_used","paths/~1orders/post/responses/400/content/application~1json/examples/locked_field_amount","paths/~1orders/post/responses/400/content/application~1json/examples/locked_field_split_ids","paths/~1orders/post/responses/400/content/application~1json/examples/split_ids_unresolved","paths/~1orders/post/responses/400/content/application~1json/examples/split_ids_incomplete","paths/~1orders/post/responses/400/content/application~1json/examples/split_ids_method_not_enabled","paths/~1orders/post/responses/400/content/application~1json/examples/split_ids_required"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_25","exampleIds":["paths/~1orders/post/responses/400/content/application~1json/examples/currency_not_supported","paths/~1orders/post/responses/400/content/application~1json/examples/duplicate_request_id","paths/~1orders/post/responses/400/content/application~1json/examples/quote_not_found","paths/~1orders/post/responses/400/content/application~1json/examples/quote_not_payin","paths/~1orders/post/responses/400/content/application~1json/examples/quote_expired","paths/~1orders/post/responses/400/content/application~1json/examples/quote_already_used","paths/~1orders/post/responses/400/content/application~1json/examples/locked_field_amount","paths/~1orders/post/responses/400/content/application~1json/examples/locked_field_split_ids","paths/~1orders/post/responses/400/content/application~1json/examples/split_ids_unresolved","paths/~1orders/post/responses/400/content/application~1json/examples/split_ids_incomplete","paths/~1orders/post/responses/400/content/application~1json/examples/split_ids_method_not_enabled","paths/~1orders/post/responses/400/content/application~1json/examples/split_ids_required"]}}},{"code":"422","schemaId":"schema_26","exampleIds":["paths/~1orders/post/responses/422/content/application~1json/examples/order_amount_above_cap","paths/~1orders/post/responses/422/content/application~1json/examples/order_cap_unavailable","paths/~1orders/post/responses/422/content/application~1json/examples/beneficiary_missing","paths/~1orders/post/responses/422/content/application~1json/examples/quote_resource_type_missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_26","exampleIds":["paths/~1orders/post/responses/422/content/application~1json/examples/order_amount_above_cap","paths/~1orders/post/responses/422/content/application~1json/examples/order_cap_unavailable","paths/~1orders/post/responses/422/content/application~1json/examples/beneficiary_missing","paths/~1orders/post/responses/422/content/application~1json/examples/quote_resource_type_missing"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/orders/createorder"}],"panels":[]}]},"httpPath":"/orders"},{"label":"List all orders","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/orders/getorders","routeSlug":"/api-reference/openapi/orders/getorders","metadata":{"seo":{"title":"List all orders","description":"Returns a list of your orders. The orders are returned sorted by creation date, with the most recent order appearing first."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getOrders","name":"List all orders","isWebhook":false,"pointer":"/paths/~1orders/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List all orders","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns a list of your orders. The orders are returned sorted by creation date, with the most recent order appearing first.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"customer_id","in":"query","schemaId":"schema_7","description":"Orders of customer to filter"},{"name":"status","in":"query","schemaId":"schema_16","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return only orders in this status. Uses the same values as the order's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field."},"children":[]}]}]}]},{"name":"request_id","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return only the order created with this "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"request_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"unique_order_request_id_123"},{"name":"before","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return only resources created at or before this time. Send an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_8601"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" timestamp with an offset, such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-02-18T12:03:44Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-02-18T17:33:44+05:30"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A timestamp without an offset is read as UTC. A bare date ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") means the end of that day in UTC ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"23:59:59.999999Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). An invalid value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Use this to avoid page drift. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/platform/pagination#parameters"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameters"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"example":"2025-02-18T12:03:44Z"},{"name":"after","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return only resources created at or after this time. Send an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_8601"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" timestamp with an offset, such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-01-18T12:03:44Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-01-18T17:33:44+05:30"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A timestamp without an offset is read as UTC. A bare date ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") means the start of that day in UTC ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"00:00:00Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). An invalid value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Use this to avoid page drift. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/platform/pagination#parameters"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameters"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"example":"2025-01-18T12:03:44Z"},{"name":"per_page","in":"query","schemaId":"schema_8","description":"Number of resources per page. Should be between 1 and 100."},{"name":"page","in":"query","schemaId":"schema_9","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Page number for pagination. Starts from 1. Get the next page number from the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"next"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field in the response."},"children":[]}]}]}]}],"pointer":"/paths/~1orders/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/orders","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"customer_id","in":"query","schemaId":"schema_7"},{"name":"status","in":"query","schemaId":"schema_16"},{"name":"request_id","in":"query","example":"unique_order_request_id_123","schemaId":"schema_7"},{"name":"before","in":"query","example":"2025-02-18T12:03:44Z","schemaId":"schema_7"},{"name":"after","in":"query","example":"2025-01-18T12:03:44Z","schemaId":"schema_7"},{"name":"per_page","in":"query","schemaId":"schema_8"},{"name":"page","in":"query","schemaId":"schema_9"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","400"],"pointer":"/orders","href":"orders/getorders","openApiOperationId":"getOrders","summary":"List all orders"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"List of orders matching the filters","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_27"}},"schemaId":"schema_27"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_18"}},"schemaId":"schema_18"}],"pointer":"/paths/~1orders/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_27","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_27"}}},{"code":"400","schemaId":"schema_18","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_18"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/orders/getorders"}],"panels":[]}]},"httpPath":"/orders"},{"label":"Retrieve an order","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/orders/getorderbyid","routeSlug":"/api-reference/openapi/orders/getorderbyid","metadata":{"seo":{"title":"Retrieve an order","description":"Retrieve details of an order."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getOrderById","name":"Retrieve an order","isWebhook":false,"pointer":"/paths/~1orders~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve an order","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieve details of an order.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the order. Starts with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"order_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" followed by letters and digits. An ID of any other shape is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and a message saying it must start with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"order_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; a well-formed ID that doesn't match an order on your account returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"404"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true,"example":"order_678a4c88hpAjf"}],"pointer":"/paths/~1orders~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/orders/{id}","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"order_678a4c88hpAjf","schemaId":"schema_7"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/orders/{id}","href":"orders/getorderbyid","openApiOperationId":"getOrderById","summary":"Retrieve an order"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Payment link retrieved successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/OrderResponse"}},"schemaId":"components/schemas/OrderResponse"},{"code":"404","description":"Payment link not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}},"schemaId":"components/schemas/EntityNotFound"}],"pointer":"/paths/~1orders~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/OrderResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/OrderResponse"}}},{"code":"404","schemaId":"components/schemas/EntityNotFound","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/orders/getorderbyid"}],"panels":[]}]},"httpPath":"/orders/{id}"},{"label":"Update RFI documents for an order","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/orders/updateorderrfi","routeSlug":"/api-reference/openapi/orders/updateorderrfi","metadata":{"seo":{"title":"Update RFI documents for an order","description":"Updates the RFI (Request for Information) document status for an order. This endpoint is used to submit required documents when an order is in 'action_required' status due to sanction screening."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateOrderRfi","name":"Update RFI documents for an order","isWebhook":false,"pointer":"/paths/~1orders~1{id}~1update-rfi/patch","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update RFI documents for an order","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":"Updates the RFI (Request for Information) document status for an order. This endpoint is used to submit required documents when an order is in 'action_required' status due to sanction screening."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_7","description":"The ID of the order to update RFI for","required":true,"example":"order_678a4c88hpAjf"}],"pointer":"/paths/~1orders~1{id}~1update-rfi/patch/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_21"}},"schemaId":"schema_21","pointer":"/paths/~1orders~1{id}~1update-rfi/patch/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/orders/{id}/update-rfi","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"order_678a4c88hpAjf","schemaId":"schema_7"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_21"}},"responseCodes":["200","400","404"],"pointer":"/orders/{id}/update-rfi","href":"orders/updateorderrfi","openApiOperationId":"updateOrderRfi","summary":"Update RFI documents for an order"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"schemaId":"schema_21","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_21"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"RFI document updated successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/OrderResponse"}},"schemaId":"components/schemas/OrderResponse"},{"code":"400","description":"Bad request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_28"}},"schemaId":"schema_28"},{"code":"404","description":"Order not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}},"schemaId":"components/schemas/EntityNotFound"}],"pointer":"/paths/~1orders~1{id}~1update-rfi/patch/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/OrderResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/OrderResponse"}}},{"code":"400","schemaId":"schema_28","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_28"}}},{"code":"404","schemaId":"components/schemas/EntityNotFound","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/orders/updateorderrfi"}],"panels":[]}]},"httpPath":"/orders/{id}/update-rfi"}],"content":{"contentType":"group","meta":{"name":"Orders"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Orders","showPageActions":true},{"nodeType":"markdoc","content":"This resource represents the order details. The order is the request to receive payment from your customer."}],"panels":[{"children":[{"kind":"group-items","title":"Schemas","titleTranslationKey":"schemas","items":[{"title":"Orders","link":"/orders/orders","deprecated":false}]},{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/orders","summary":"Create a new order","prefix":{"name":"post","color":"post"},"badges":[],"link":"/orders/createorder","deprecated":false},{"title":"/orders","summary":"List all orders","prefix":{"name":"get","color":"get"},"badges":[],"link":"/orders/getorders","deprecated":false},{"title":"/orders/{id}","summary":"Retrieve an order","prefix":{"name":"get","color":"get"},"badges":[],"link":"/orders/getorderbyid","deprecated":false},{"title":"/orders/{id}/update-rfi","summary":"Update RFI documents for an order","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/orders/updateorderrfi","deprecated":false}]}]}]}]}},{"type":"group","label":"Customer","link":"/api-reference/openapi/customer","routeSlug":"/api-reference/openapi/customer","items":[{"type":"link","label":"Customer","link":"/api-reference/openapi/customer/customer","routeSlug":"/api-reference/openapi/customer/customer","httpVerb":"schema","content":{"contentType":"item","itemVariant":"schema","meta":{"name":"Customer"},"seo":{"title":"Customer"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Customer","showPageActions":true}],"panels":[]},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"schemaDefinition","attributes":{"showWriteOnly":true,"schemaRef":"#/components/schemas/Customer"},"children":[]}]}]}},{"label":"Create a new customer","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/customer/createcustomer","routeSlug":"/api-reference/openapi/customer/createcustomer","metadata":{"seo":{"title":"Create a new customer","description":"Creates a customer with basic information such as name, contact information, and address. To check complete list of API validations, click here."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createCustomer","name":"Create a new customer","isWebhook":false,"pointer":"/paths/~1customer/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a new customer","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":"Creates a customer with basic information such as name, contact information, and address. To check complete list of API validations, click "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/platform/validations#validations-for-creating-customers"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"here"},"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":"Some fields are required only for a particular flow. "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Account funding"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" additionally requires "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"dob"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nationality"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and reads "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"kyc.last_kyc_date"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"LRS"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" requires "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"phone"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"kyc.pan_number"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for a customer in India. Creating a customer is not idempotent - a second create with an email already on your account returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Email has already been taken"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and does not return the existing record. Store the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" against your own user, or recover it with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v1/customer?email_address="},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/Customer"}},"schemaId":"components/schemas/Customer","pointer":"/paths/~1customer/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/customer","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/Customer"}},"responseCodes":["201","400"],"pointer":"/customer","href":"customer/createcustomer","openApiOperationId":"createCustomer","summary":"Create a new customer"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"schemaId":"components/schemas/Customer","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/Customer"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Customer created successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Customer"}},"schemaId":"components/schemas/Customer"},{"code":"400","description":"Bad request"}],"pointer":"/paths/~1customer/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/Customer","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Customer"}}},{"code":"400"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/customer/createcustomer"}],"panels":[]}]},"httpPath":"/customer"},{"label":"List all customers","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/customer/getcustomers","routeSlug":"/api-reference/openapi/customer/getcustomers","metadata":{"seo":{"title":"List all customers","description":"Returns a list of your customers. The customers are returned sorted by creation date, with the most recent customers appearing first."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getCustomers","name":"List all customers","isWebhook":false,"pointer":"/paths/~1customer/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List all customers","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns a list of your customers. The customers are returned sorted by creation date, with the most recent customers appearing first.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"customer_type","in":"query","schemaId":"schema_29","description":"Type of customer to filter"},{"name":"email_address","in":"query","schemaId":"schema_30","description":"Filter customers by email address"},{"name":"tax_identification_number","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter customers by PAN (tax identification number), for customers created with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"kyc.pan_number"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Matched exactly on the normalised value (case-insensitive; the value is trimmed and upper-cased before matching), so a partial PAN returns no results. An invalid PAN format returns a 400 error."},"children":[]}]}]}]},{"name":"before","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return only resources created at or before this time. Send an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_8601"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" timestamp with an offset, such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-02-18T12:03:44Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-02-18T17:33:44+05:30"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A timestamp without an offset is read as UTC. A bare date ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") means the end of that day in UTC ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"23:59:59.999999Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). An invalid value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Use this to avoid page drift. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/platform/pagination#parameters"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameters"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"example":"2025-02-18T12:03:44Z"},{"name":"after","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return only resources created at or after this time. Send an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_8601"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" timestamp with an offset, such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-01-18T12:03:44Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-01-18T17:33:44+05:30"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A timestamp without an offset is read as UTC. A bare date ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") means the start of that day in UTC ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"00:00:00Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). An invalid value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Use this to avoid page drift. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/platform/pagination#parameters"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameters"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"example":"2025-01-18T12:03:44Z"},{"name":"per_page","in":"query","schemaId":"schema_8","description":"Number of resources per page. Should be between 1 and 100."},{"name":"page","in":"query","schemaId":"schema_9","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Page number for pagination. Starts from 1. Get the next page number from the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"next"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field in the response."},"children":[]}]}]}]}],"pointer":"/paths/~1customer/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/customer","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"customer_type","in":"query","schemaId":"schema_29"},{"name":"email_address","in":"query","schemaId":"schema_30"},{"name":"tax_identification_number","in":"query","schemaId":"schema_7"},{"name":"before","in":"query","example":"2025-02-18T12:03:44Z","schemaId":"schema_7"},{"name":"after","in":"query","example":"2025-01-18T12:03:44Z","schemaId":"schema_7"},{"name":"per_page","in":"query","schemaId":"schema_8"},{"name":"page","in":"query","schemaId":"schema_9"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","400"],"pointer":"/customer","href":"customer/getcustomers","openApiOperationId":"getCustomers","summary":"List all customers"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"List of customers matching the filters","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_31"}},"schemaId":"schema_31"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_11"}},"schemaId":"schema_11"}],"pointer":"/paths/~1customer/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_31","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_31"}}},{"code":"400","schemaId":"schema_11","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_11"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/customer/getcustomers"}],"panels":[]}]},"httpPath":"/customer"},{"label":"Retrieve a customer","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/customer/getcustomerbyid","routeSlug":"/api-reference/openapi/customer/getcustomerbyid","metadata":{"seo":{"title":"Retrieve a customer","description":"Retrieves details of a Customer."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getCustomerById","name":"Retrieve a customer","isWebhook":false,"pointer":"/paths/~1customer~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve a customer","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves details of a Customer.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the customer. Starts with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cust_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" followed by letters and digits. An ID of any other shape is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and a message saying it must start with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cust_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; a well- formed ID that doesn't match a customer on your account returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"404"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true,"example":"cust_5JU9yv0lGSUP"}],"pointer":"/paths/~1customer~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/customer/{id}","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"cust_5JU9yv0lGSUP","schemaId":"schema_7"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/customer/{id}","href":"customer/getcustomerbyid","openApiOperationId":"getCustomerById","summary":"Retrieve a customer"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Customer retrieved successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Customer"}},"schemaId":"components/schemas/Customer"},{"code":"404","description":"Customer not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}},"schemaId":"components/schemas/EntityNotFound"}],"pointer":"/paths/~1customer~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/Customer","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Customer"}}},{"code":"404","schemaId":"components/schemas/EntityNotFound","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/customer/getcustomerbyid"}],"panels":[]}]},"httpPath":"/customer/{id}"},{"label":"Update a customer","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/customer/updatecustomer","routeSlug":"/api-reference/openapi/customer/updatecustomer","metadata":{"seo":{"title":"Update a customer","description":"Updates the contact details of an existing customer. Only the customer's email and phone can be updated. This is a partial update — send only the fields you want to change; any field you omit is left untouched. You must supply at least one of email or phone, and a supplied field cannot be sent as blank or null. The phone number is validated against the customer's stored country. To check the complete list of API validations, click here.Account funding partners can also update the address and kyc.last_kyc_date, in the same shape as on create, for example after a re-KYC. Other fields, such as name, dob and kyc.pan_number, are not updated."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateCustomer","name":"Update a customer","isWebhook":false,"pointer":"/paths/~1customer~1{id}/patch","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a customer","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":"Updates the contact details of an existing customer. Only the customer's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"email"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"phone"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" can be updated. This is a partial update — send only the fields you want to change; any field you omit is left untouched. You must supply at least one of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"email"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"phone"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and a supplied field cannot be sent as blank or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The phone number is validated against the customer's stored country. To check the complete list of API validations, click "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/platform/validations#validations-for-updating-customers"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"here"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Account funding"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" partners can also update the address and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"kyc.last_kyc_date"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", in the same shape as on create, for example after a re-KYC. Other fields, such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"dob"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"kyc.pan_number"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", are not updated."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the customer. Starts with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cust_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" followed by letters and digits. An ID of any other shape is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and a message saying it must start with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cust_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; a well- formed ID that doesn't match a customer on your account returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"404"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true,"example":"cust_5JU9yv0lGSUP"}],"pointer":"/paths/~1customer~1{id}/patch/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_32"}},"schemaId":"schema_32","pointer":"/paths/~1customer~1{id}/patch/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/customer/{id}","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"cust_5JU9yv0lGSUP","schemaId":"schema_7"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_32"}},"responseCodes":["200","400","404"],"pointer":"/customer/{id}","href":"customer/updatecustomer","openApiOperationId":"updateCustomer","summary":"Update a customer"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"schemaId":"schema_32","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_32"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Customer updated successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Customer"}},"schemaId":"components/schemas/Customer"},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bad request — no updatable field was supplied, a supplied field was blank, the email or phone was invalid, or the customer ID was malformed."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_33"}},"schemaId":"schema_33"},{"code":"404","description":"Customer not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}},"schemaId":"components/schemas/EntityNotFound"}],"pointer":"/paths/~1customer~1{id}/patch/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/Customer","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Customer"}}},{"code":"400","schemaId":"schema_33","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_33"}}},{"code":"404","schemaId":"components/schemas/EntityNotFound","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/customer/updatecustomer"}],"panels":[]}]},"httpPath":"/customer/{id}"},{"label":"Register a customer's bank account","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/customer/createcustomerbankaccount","routeSlug":"/api-reference/openapi/customer/createcustomerbankaccount","metadata":{"seo":{"title":"Register a customer's bank account","description":"Registers the bank account a customer sends money from."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createCustomerBankAccount","name":"Register a customer's bank account","isWebhook":false,"pointer":"/paths/~1customer~1{id}~1bank-accounts/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Register a customer's bank account","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":"Registers the bank account a customer sends money from."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A customer holds one bank account at a time. Registering another one replaces the existing account, so use this endpoint to correct an account or to move a customer to a new bank."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For an LRS remittance, register the customer's Indian bank account with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /customer/{id}/bank_account"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"createLrsCustomerBankAccount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") instead. Accounts registered here have "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"acccus_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" IDs and cannot be used as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"lrs.bank_account_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on an order."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_7","description":"The ID of the customer","required":true,"example":"cust_5JU9yv0lGSUP"}],"pointer":"/paths/~1customer~1{id}~1bank-accounts/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CustomerBankAccount"}},"schemaId":"components/schemas/CustomerBankAccount","pointer":"/paths/~1customer~1{id}~1bank-accounts/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/customer/{id}/bank-accounts","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"cust_5JU9yv0lGSUP","schemaId":"schema_7"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CustomerBankAccount"}},"responseCodes":["201","400","404"],"pointer":"/customer/{id}/bank-accounts","href":"customer/createcustomerbankaccount","openApiOperationId":"createCustomerBankAccount","summary":"Register a customer's bank account"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"schemaId":"components/schemas/CustomerBankAccount","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CustomerBankAccount"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Bank account registered. Any account previously registered against this customer is no longer in use.\n","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CustomerBankAccount"}},"schemaId":"components/schemas/CustomerBankAccount"},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The request is missing an account number or a bank name, or carries neither "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bic_primary"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" nor "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bic_secondary"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"code":"404","description":"Customer not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}},"schemaId":"components/schemas/EntityNotFound"}],"pointer":"/paths/~1customer~1{id}~1bank-accounts/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/CustomerBankAccount","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CustomerBankAccount"}}},{"code":"400"},{"code":"404","schemaId":"components/schemas/EntityNotFound","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/customer/createcustomerbankaccount"}],"panels":[]}]},"httpPath":"/customer/{id}/bank-accounts"},{"label":"List a customer's bank accounts","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/customer/getcustomerbankaccounts","routeSlug":"/api-reference/openapi/customer/getcustomerbankaccounts","metadata":{"seo":{"title":"List a customer's bank accounts","description":"Returns the bank accounts registered against a customer."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getCustomerBankAccounts","name":"List a customer's bank accounts","isWebhook":false,"pointer":"/paths/~1customer~1{id}~1bank-accounts/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List a customer's bank accounts","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns the bank accounts registered against a customer.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_7","description":"The ID of the customer","required":true,"example":"cust_5JU9yv0lGSUP"}],"pointer":"/paths/~1customer~1{id}~1bank-accounts/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/customer/{id}/bank-accounts","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"cust_5JU9yv0lGSUP","schemaId":"schema_7"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/customer/{id}/bank-accounts","href":"customer/getcustomerbankaccounts","openApiOperationId":"getCustomerBankAccounts","summary":"List a customer's bank accounts"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Bank accounts retrieved successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_34"}},"schemaId":"schema_34"},{"code":"404","description":"Customer not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}},"schemaId":"components/schemas/EntityNotFound"}],"pointer":"/paths/~1customer~1{id}~1bank-accounts/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_34","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_34"}}},{"code":"404","schemaId":"components/schemas/EntityNotFound","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/customer/getcustomerbankaccounts"}],"panels":[]}]},"httpPath":"/customer/{id}/bank-accounts"}],"content":{"contentType":"group","meta":{"name":"Customer"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Customer","showPageActions":true},{"nodeType":"markdoc","content":"This resource represents a customer of your business. The customer can be an individual or a business from whom you will receive payments."}],"panels":[{"children":[{"kind":"group-items","title":"Schemas","titleTranslationKey":"schemas","items":[{"title":"Customer","link":"/customer/customer","deprecated":false}]},{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/customer","summary":"Create a new customer","prefix":{"name":"post","color":"post"},"badges":[],"link":"/customer/createcustomer","deprecated":false},{"title":"/customer","summary":"List all customers","prefix":{"name":"get","color":"get"},"badges":[],"link":"/customer/getcustomers","deprecated":false},{"title":"/customer/{id}","summary":"Retrieve a customer","prefix":{"name":"get","color":"get"},"badges":[],"link":"/customer/getcustomerbyid","deprecated":false},{"title":"/customer/{id}","summary":"Update a customer","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/customer/updatecustomer","deprecated":false},{"title":"/customer/{id}/bank-accounts","summary":"Register a customer's bank account","prefix":{"name":"post","color":"post"},"badges":[],"link":"/customer/createcustomerbankaccount","deprecated":false},{"title":"/customer/{id}/bank-accounts","summary":"List a customer's bank accounts","prefix":{"name":"get","color":"get"},"badges":[],"link":"/customer/getcustomerbankaccounts","deprecated":false}]}]}]}]}},{"type":"group","label":"Payment","link":"/api-reference/openapi/payment","routeSlug":"/api-reference/openapi/payment","items":[{"type":"link","label":"Payment","link":"/api-reference/openapi/payment/payment","routeSlug":"/api-reference/openapi/payment/payment","httpVerb":"schema","content":{"contentType":"item","itemVariant":"schema","meta":{"name":"Payment"},"seo":{"title":"Payment"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Payment","showPageActions":true}],"panels":[]},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"schemaDefinition","attributes":{"showWriteOnly":true,"schemaRef":"#/components/schemas/Payment"},"children":[]}]}]}},{"label":"Create a payment","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/payment/createpayment","routeSlug":"/api-reference/openapi/payment/createpayment","metadata":{"seo":{"title":"Create a payment","description":"Creates a payment for an order or subscription. For initial payments, card details and a callback URL are required. For subsequent payments on as_presented subscriptions, the card from the last successful payment is reused, and request_id, amount, and currency are required instead."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createPayment","name":"Create a payment","isWebhook":false,"pointer":"/paths/~1payment/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a payment","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":"Creates a payment for an order or subscription. For initial payments, card details and a callback URL are required. For subsequent payments on "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"as_presented"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" subscriptions, the card from the last successful payment is reused, and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"request_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are required instead."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Either "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"order_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"subscription_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" must be provided, but not both."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"On a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"subsequent"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" auto debit for an "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"as_presented"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" subscription, pass "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"split_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to price that charge from your declared share of a dynamic pricing rule. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#tag/pricing_split"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Dynamic Fee Split"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The splits apply to that charge only and do not modify the subscription's own declaration. Omit "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"split_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and Glomo prices the charge from the subscription's declaration; if that declaration no longer resolves, the auto debit is rejected with a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" until you pass a valid "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"split_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to override it."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreatePaymentRequest","exampleIds":["paths/~1payment/post/requestBody/content/application~1json/examples/initial_payment","paths/~1payment/post/requestBody/content/application~1json/examples/subsequent_payment","paths/~1payment/post/requestBody/content/application~1json/examples/subsequent_payment_with_splits"]}},"schemaId":"components/schemas/CreatePaymentRequest","exampleIds":["paths/~1payment/post/requestBody/content/application~1json/examples/initial_payment","paths/~1payment/post/requestBody/content/application~1json/examples/subsequent_payment","paths/~1payment/post/requestBody/content/application~1json/examples/subsequent_payment_with_splits"],"pointer":"/paths/~1payment/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/payment","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreatePaymentRequest","exampleIds":["paths/~1payment/post/requestBody/content/application~1json/examples/initial_payment","paths/~1payment/post/requestBody/content/application~1json/examples/subsequent_payment","paths/~1payment/post/requestBody/content/application~1json/examples/subsequent_payment_with_splits"]}},"responseCodes":["201","400"],"pointer":"/payment","href":"payment/createpayment","openApiOperationId":"createPayment","summary":"Create a payment"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"schemaId":"components/schemas/CreatePaymentRequest","exampleIds":["paths/~1payment/post/requestBody/content/application~1json/examples/initial_payment","paths/~1payment/post/requestBody/content/application~1json/examples/subsequent_payment","paths/~1payment/post/requestBody/content/application~1json/examples/subsequent_payment_with_splits"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreatePaymentRequest","exampleIds":["paths/~1payment/post/requestBody/content/application~1json/examples/initial_payment","paths/~1payment/post/requestBody/content/application~1json/examples/subsequent_payment","paths/~1payment/post/requestBody/content/application~1json/examples/subsequent_payment_with_splits"]}},"examples":[{},{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Payment created successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CreatePaymentResponse","exampleIds":["paths/~1payment/post/responses/201/content/application~1json/example"]}},"schemaId":"components/schemas/CreatePaymentResponse","exampleIds":["paths/~1payment/post/responses/201/content/application~1json/example"]},{"code":"400","description":"Bad request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_35","exampleIds":["paths/~1payment/post/responses/400/content/application~1json/examples/missing_order_or_subscription","paths/~1payment/post/responses/400/content/application~1json/examples/duplicate_request_id","paths/~1payment/post/responses/400/content/application~1json/examples/split_ids_on_fixed_frequency","paths/~1payment/post/responses/400/content/application~1json/examples/subscription_declaration_stale","paths/~1payment/post/responses/400/content/application~1json/examples/split_ids_unresolved"]}},"schemaId":"schema_35","exampleIds":["paths/~1payment/post/responses/400/content/application~1json/examples/missing_order_or_subscription","paths/~1payment/post/responses/400/content/application~1json/examples/duplicate_request_id","paths/~1payment/post/responses/400/content/application~1json/examples/split_ids_on_fixed_frequency","paths/~1payment/post/responses/400/content/application~1json/examples/subscription_declaration_stale","paths/~1payment/post/responses/400/content/application~1json/examples/split_ids_unresolved"]}],"pointer":"/paths/~1payment/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/CreatePaymentResponse","exampleIds":["paths/~1payment/post/responses/201/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CreatePaymentResponse","exampleIds":["paths/~1payment/post/responses/201/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_35","exampleIds":["paths/~1payment/post/responses/400/content/application~1json/examples/missing_order_or_subscription","paths/~1payment/post/responses/400/content/application~1json/examples/duplicate_request_id","paths/~1payment/post/responses/400/content/application~1json/examples/split_ids_on_fixed_frequency","paths/~1payment/post/responses/400/content/application~1json/examples/subscription_declaration_stale","paths/~1payment/post/responses/400/content/application~1json/examples/split_ids_unresolved"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_35","exampleIds":["paths/~1payment/post/responses/400/content/application~1json/examples/missing_order_or_subscription","paths/~1payment/post/responses/400/content/application~1json/examples/duplicate_request_id","paths/~1payment/post/responses/400/content/application~1json/examples/split_ids_on_fixed_frequency","paths/~1payment/post/responses/400/content/application~1json/examples/subscription_declaration_stale","paths/~1payment/post/responses/400/content/application~1json/examples/split_ids_unresolved"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/payment/createpayment"}],"panels":[]}]},"httpPath":"/payment"},{"label":"List all payments","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/payment/getpayments","routeSlug":"/api-reference/openapi/payment/getpayments","metadata":{"seo":{"title":"List all payments","description":"Returns a list of your payments, sorted by creation date with the most recent first."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getPayments","name":"List all payments","isWebhook":false,"pointer":"/paths/~1payment/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List all payments","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":"Returns a list of your payments, sorted by creation date with the most recent first."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filters combine with AND, with one exception: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payin_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"subscription_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are mutually exclusive"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and sending both returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"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":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" filter accepts only "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"in_progress"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"success"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"failed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"action_required"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; any other"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". That is not the same set of values a payment can come back with, and the filter"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"does not map onto the response field one-for-one: a payment returned with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status: under_review"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"matched by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status=in_progress"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and some payments returned with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status: in_progress"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are not matched"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status=in_progress"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at all. Treat the filter as a coarse narrowing and read "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on each"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"payment you get back."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"compliance_status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is a separate field with its own filter and moves independently of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Most"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"payments have no compliance status at all, so filtering on it will exclude them."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"customer_id","in":"query","schemaId":"schema_7","description":"The unique identifier for the customer.","example":"cust_E602sMzgjpDC"},{"name":"status","in":"query","schemaId":"schema_36","description":"Status of payin to filter","example":"success"},{"name":"compliance_status","in":"query","schemaId":"schema_37","description":"Filters payments by the outcome of their compliance review.","example":"approved"},{"name":"payin_id","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier for the payin. Accepts a payment link ID ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"plink_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"), an order ID"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"order_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") or an Add Balance top-up ID ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"addfunds_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). Any other value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"plink_E602dMzgjpDC"},{"name":"payment_type","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":"Filters payments by their payin type. Use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"add_funds"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to list only Add Balance top-ups crediting your Funded Balance."},"children":[]}]}]}],"example":"add_funds"},{"name":"subscription_id","in":"query","schemaId":"schema_7","description":"The unique identifier for the subscription.","example":"sub_68877570b5zeE"},{"name":"currency","in":"query","schemaId":"schema_39","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filters on the payment's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"requested_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"converted_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the currency the merchant asked for, which is also the currency of the order or payment link the payment belongs to. It does not filter on "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payment_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", the currency the customer was actually charged in. Those two differ whenever local payments are in play: a card payment against a USD order is commonly charged to the customer in AED, and that payment matches "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"USD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", not "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"AED"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Matching is case-insensitive."},"children":[]}]}]}],"example":"USD"},{"name":"request_id","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return only the payment created with this "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"request_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"unique_request_id_123"},{"name":"before","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return only resources created at or before this time. Send an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_8601"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" timestamp with an offset, such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-02-18T12:03:44Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-02-18T17:33:44+05:30"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A timestamp without an offset is read as UTC. A bare date ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") means the end of that day in UTC ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"23:59:59.999999Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). An invalid value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Use this to avoid page drift. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/platform/pagination#parameters"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameters"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"example":"2025-02-18T12:03:44Z"},{"name":"after","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return only resources created at or after this time. Send an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_8601"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" timestamp with an offset, such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-01-18T12:03:44Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-01-18T17:33:44+05:30"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A timestamp without an offset is read as UTC. A bare date ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") means the start of that day in UTC ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"00:00:00Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). An invalid value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Use this to avoid page drift. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/platform/pagination#parameters"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameters"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"example":"2025-01-18T12:03:44Z"},{"name":"per_page","in":"query","schemaId":"schema_8","description":"Number of resources per page. Should be between 1 and 100."},{"name":"page","in":"query","schemaId":"schema_9","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Page number for pagination. Starts from 1. Get the next page number from the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"next"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field in the response."},"children":[]}]}]}]}],"pointer":"/paths/~1payment/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/payment","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"customer_id","in":"query","example":"cust_E602sMzgjpDC","schemaId":"schema_7"},{"name":"status","in":"query","example":"success","schemaId":"schema_36"},{"name":"compliance_status","in":"query","example":"approved","schemaId":"schema_37"},{"name":"payin_id","in":"query","example":"plink_E602dMzgjpDC","schemaId":"schema_7"},{"name":"payment_type","in":"query","example":"add_funds","schemaId":"schema_38"},{"name":"subscription_id","in":"query","example":"sub_68877570b5zeE","schemaId":"schema_7"},{"name":"currency","in":"query","example":"USD","schemaId":"schema_39"},{"name":"request_id","in":"query","example":"unique_request_id_123","schemaId":"schema_7"},{"name":"before","in":"query","example":"2025-02-18T12:03:44Z","schemaId":"schema_7"},{"name":"after","in":"query","example":"2025-01-18T12:03:44Z","schemaId":"schema_7"},{"name":"per_page","in":"query","schemaId":"schema_8"},{"name":"page","in":"query","schemaId":"schema_9"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","400"],"pointer":"/payment","href":"payment/getpayments","openApiOperationId":"getPayments","summary":"List all payments"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List of payments matching the filters. "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" If filters do not match, API will return an empty list."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_40"}},"schemaId":"schema_40"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_41"}},"schemaId":"schema_41"}],"pointer":"/paths/~1payment/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_40","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_40"}}},{"code":"400","schemaId":"schema_41","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_41"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/payment/getpayments"}],"panels":[]}]},"httpPath":"/payment"},{"label":"Create a mock payment","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/payment/createmockpayment","routeSlug":"/api-reference/openapi/payment/createmockpayment","metadata":{"seo":{"title":"Create a mock payment","description":"This API is only available in sandbox mode. Sends a mock bank transfer into one of your virtual accounts. See Test it in sandbox."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createMockPayment","name":"Create a mock payment","isWebhook":false,"pointer":"/paths/~1payment~1mock/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a mock payment","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":"This API is only available in sandbox mode. Sends a mock bank transfer into one of your virtual accounts. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/payin/payment-methods/bank-transfer/set-up#test-it-in-sandbox"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Test it in sandbox"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_42","exampleIds":["paths/~1payment~1mock/post/requestBody/content/application~1json/examples/matched_transfer","paths/~1payment~1mock/post/requestBody/content/application~1json/examples/amount_mismatch","paths/~1payment~1mock/post/requestBody/content/application~1json/examples/unmatched_transfer","paths/~1payment~1mock/post/requestBody/content/application~1json/examples/sanctions_hit"]}},"schemaId":"schema_42","exampleIds":["paths/~1payment~1mock/post/requestBody/content/application~1json/examples/matched_transfer","paths/~1payment~1mock/post/requestBody/content/application~1json/examples/amount_mismatch","paths/~1payment~1mock/post/requestBody/content/application~1json/examples/unmatched_transfer","paths/~1payment~1mock/post/requestBody/content/application~1json/examples/sanctions_hit"],"pointer":"/paths/~1payment~1mock/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/payment/mock","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_42","exampleIds":["paths/~1payment~1mock/post/requestBody/content/application~1json/examples/matched_transfer","paths/~1payment~1mock/post/requestBody/content/application~1json/examples/amount_mismatch","paths/~1payment~1mock/post/requestBody/content/application~1json/examples/unmatched_transfer","paths/~1payment~1mock/post/requestBody/content/application~1json/examples/sanctions_hit"]}},"responseCodes":["201","400"],"pointer":"/payment/mock","href":"payment/createmockpayment","openApiOperationId":"createMockPayment","summary":"Create a mock payment"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"schemaId":"schema_42","exampleIds":["paths/~1payment~1mock/post/requestBody/content/application~1json/examples/matched_transfer","paths/~1payment~1mock/post/requestBody/content/application~1json/examples/amount_mismatch","paths/~1payment~1mock/post/requestBody/content/application~1json/examples/unmatched_transfer","paths/~1payment~1mock/post/requestBody/content/application~1json/examples/sanctions_hit"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_42","exampleIds":["paths/~1payment~1mock/post/requestBody/content/application~1json/examples/matched_transfer","paths/~1payment~1mock/post/requestBody/content/application~1json/examples/amount_mismatch","paths/~1payment~1mock/post/requestBody/content/application~1json/examples/unmatched_transfer","paths/~1payment~1mock/post/requestBody/content/application~1json/examples/sanctions_hit"]}},"examples":[{},{},{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Payment created successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Payment","exampleIds":["paths/~1payment~1mock/post/responses/201/content/application~1json/examples/matched_transfer","paths/~1payment~1mock/post/responses/201/content/application~1json/examples/amount_mismatch","paths/~1payment~1mock/post/responses/201/content/application~1json/examples/unmatched_transfer","paths/~1payment~1mock/post/responses/201/content/application~1json/examples/sanctions_hit"]}},"schemaId":"components/schemas/Payment","exampleIds":["paths/~1payment~1mock/post/responses/201/content/application~1json/examples/matched_transfer","paths/~1payment~1mock/post/responses/201/content/application~1json/examples/amount_mismatch","paths/~1payment~1mock/post/responses/201/content/application~1json/examples/unmatched_transfer","paths/~1payment~1mock/post/responses/201/content/application~1json/examples/sanctions_hit"]},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bad request: a field is invalid or missing, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" was sent with a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payin_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or there is no virtual"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"account for the transfer ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"No active <transfer_type> virtual account for this payment"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_43","exampleIds":["paths/~1payment~1mock/post/responses/400/content/application~1json/examples/currency_with_payin","paths/~1payment~1mock/post/responses/400/content/application~1json/examples/no_virtual_account"]}},"schemaId":"schema_43","exampleIds":["paths/~1payment~1mock/post/responses/400/content/application~1json/examples/currency_with_payin","paths/~1payment~1mock/post/responses/400/content/application~1json/examples/no_virtual_account"]}],"pointer":"/paths/~1payment~1mock/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/Payment","exampleIds":["paths/~1payment~1mock/post/responses/201/content/application~1json/examples/matched_transfer","paths/~1payment~1mock/post/responses/201/content/application~1json/examples/amount_mismatch","paths/~1payment~1mock/post/responses/201/content/application~1json/examples/unmatched_transfer","paths/~1payment~1mock/post/responses/201/content/application~1json/examples/sanctions_hit"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Payment","exampleIds":["paths/~1payment~1mock/post/responses/201/content/application~1json/examples/matched_transfer","paths/~1payment~1mock/post/responses/201/content/application~1json/examples/amount_mismatch","paths/~1payment~1mock/post/responses/201/content/application~1json/examples/unmatched_transfer","paths/~1payment~1mock/post/responses/201/content/application~1json/examples/sanctions_hit"]}}},{"code":"400","schemaId":"schema_43","exampleIds":["paths/~1payment~1mock/post/responses/400/content/application~1json/examples/currency_with_payin","paths/~1payment~1mock/post/responses/400/content/application~1json/examples/no_virtual_account"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_43","exampleIds":["paths/~1payment~1mock/post/responses/400/content/application~1json/examples/currency_with_payin","paths/~1payment~1mock/post/responses/400/content/application~1json/examples/no_virtual_account"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/payment/createmockpayment"}],"panels":[]}]},"httpPath":"/payment/mock"},{"label":"Retrieve a payment\n","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/payment/getpaymentbyid","routeSlug":"/api-reference/openapi/payment/getpaymentbyid","metadata":{"seo":{"title":"Retrieve a payment\n","description":"Retrieves a single payment by ID. The payment must belong to the merchant the API key authenticates as — an ID that exists but belongs to another merchant returns 404, not 403. An ID that is not a well-formed payment ID is rejected with 400 before any lookup happens, so 400 and 404 here mean different things: malformed versus not yours."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getPaymentById","name":"Retrieve a payment\n","isWebhook":false,"pointer":"/paths/~1payment~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve a payment\n","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":"Retrieves a single payment by ID. The payment must belong to the merchant the API key authenticates as — an ID that exists but belongs to another merchant returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"404"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", not "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"403"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". An ID that is not a well-formed payment ID is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" before any lookup happens, so "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"404"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" here mean different things: malformed versus not yours."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier for the payment. Starts with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payt_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" followed by letters and digits. An ID of any other shape is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and a message saying it must start with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payt_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; a well-formed ID that doesn't match a payment on your account returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"404"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true,"example":"payt_E602dMzgjpDC"}],"pointer":"/paths/~1payment~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/payment/{id}","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"payt_E602dMzgjpDC","schemaId":"schema_7"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/payment/{id}","href":"payment/getpaymentbyid","openApiOperationId":"getPaymentById","summary":"Retrieve a payment\n"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Payment found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Payment"}},"schemaId":"components/schemas/Payment"},{"code":"404","description":"Payment not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}},"schemaId":"components/schemas/EntityNotFound"}],"pointer":"/paths/~1payment~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/Payment","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Payment"}}},{"code":"404","schemaId":"components/schemas/EntityNotFound","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/payment/getpaymentbyid"}],"panels":[]}]},"httpPath":"/payment/{id}"},{"label":"List eligible payins","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/payment/geteligiblepayins","routeSlug":"/api-reference/openapi/payment/geteligiblepayins","metadata":{"seo":{"title":"List eligible payins","description":"Lists the open payment links and orders that an unmatched bank transfer can connect to."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getEligiblePayins","name":"List eligible payins","isWebhook":false,"pointer":"/paths/~1payment~1{id}~1eligible-payins/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List eligible payins","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":"Lists the open payment links and orders that an unmatched bank transfer can connect to."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For the full flow, see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/payin/action-required"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resolving Action Required Payments"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_44","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier for the payment. Starts with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payt_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" followed by letters and digits. An ID of any other shape is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and a message saying it must start with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payt_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; a well-formed ID that doesn't match a payment on your account returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"404"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true,"example":"payt_6aad0bc0cZtlS"}],"pointer":"/paths/~1payment~1{id}~1eligible-payins/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"customer_id","in":"query","schemaId":"schema_7","description":"Returns only the payins of this customer. This is an exact match.\n","example":"cust_69eb2cf0FYSDF"},{"name":"reference_number","in":"query","schemaId":"schema_7","description":"Returns only the payins with this reference number. This is an exact match.\n","example":"RG12FF590"},{"name":"invoice_number","in":"query","schemaId":"schema_7","description":"Returns only the payins with this invoice number. This is an exact match.\n","example":"R0001"}],"pointer":"/paths/~1payment~1{id}~1eligible-payins/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/payment/{id}/eligible-payins","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"payt_6aad0bc0cZtlS","schemaId":"schema_44"}],"query":[{"name":"customer_id","in":"query","required":false,"example":"cust_69eb2cf0FYSDF","schemaId":"schema_7"},{"name":"reference_number","in":"query","required":false,"example":"RG12FF590","schemaId":"schema_7"},{"name":"invoice_number","in":"query","required":false,"example":"R0001","schemaId":"schema_7"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","400","401","404"],"pointer":"/payment/{id}/eligible-payins","href":"payment/geteligiblepayins","openApiOperationId":"getEligiblePayins","summary":"List eligible payins"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The eligible payins for this payment. The endpoint returns a maximum of 10 payins, the newest first. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"eligible_payins"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is an empty array when no payin matches."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_45","exampleIds":["paths/~1payment~1{id}~1eligible-payins/get/responses/200/content/application~1json/examples/eligible","paths/~1payment~1{id}~1eligible-payins/get/responses/200/content/application~1json/examples/none"]}},"schemaId":"schema_45","exampleIds":["paths/~1payment~1{id}~1eligible-payins/get/responses/200/content/application~1json/examples/eligible","paths/~1payment~1{id}~1eligible-payins/get/responses/200/content/application~1json/examples/none"]},{"code":"400","description":"Bad request. The payment identifier is not valid, or the payment cannot connect to a payin.\n","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_46"}},"schemaId":"schema_46"},{"code":"401","description":"Unauthorized. The bearer token is absent or not valid."},{"code":"404","description":"Glomo did not find the payment. This message also applies to a payment of a different business.\n","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_47"}},"schemaId":"schema_47"}],"pointer":"/paths/~1payment~1{id}~1eligible-payins/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_45","exampleIds":["paths/~1payment~1{id}~1eligible-payins/get/responses/200/content/application~1json/examples/eligible","paths/~1payment~1{id}~1eligible-payins/get/responses/200/content/application~1json/examples/none"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_45","exampleIds":["paths/~1payment~1{id}~1eligible-payins/get/responses/200/content/application~1json/examples/eligible","paths/~1payment~1{id}~1eligible-payins/get/responses/200/content/application~1json/examples/none"]}}},{"code":"400","schemaId":"schema_46","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_46"}}},{"code":"401"},{"code":"404","schemaId":"schema_47","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_47"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/payment/geteligiblepayins"}],"panels":[]}]},"httpPath":"/payment/{id}/eligible-payins"},{"label":"Connect a payin","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/payment/connectpayin","routeSlug":"/api-reference/openapi/payment/connectpayin","metadata":{"seo":{"title":"Connect a payin","description":"Connects an unmatched bank transfer to one of your open payment links or orders. Find the payin first with List eligible payins."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"connectPayin","name":"Connect a payin","isWebhook":false,"pointer":"/paths/~1payment~1{id}~1connect-payin/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Connect a payin","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":"Connects an unmatched bank transfer to one of your open payment links or orders. Find the payin first with "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/api-reference/openapi/payment/geteligiblepayins"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List eligible payins"},"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":"For the full flow, see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/payin/action-required"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resolving Action Required Payments"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_44","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier for the payment. Starts with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payt_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" followed by letters and digits. An ID of any other shape is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and a message saying it must start with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payt_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; a well-formed ID that doesn't match a payment on your account returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"404"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true,"example":"payt_6aad0bc0cZtlS"}],"pointer":"/paths/~1payment~1{id}~1connect-payin/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_48"}},"schemaId":"schema_48","pointer":"/paths/~1payment~1{id}~1connect-payin/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/payment/{id}/connect-payin","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"payt_6aad0bc0cZtlS","schemaId":"schema_44"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_48"}},"responseCodes":["200","400","401","404"],"pointer":"/payment/{id}/connect-payin","href":"payment/connectpayin","openApiOperationId":"connectPayin","summary":"Connect a payin"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"schemaId":"schema_48","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_48"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Glomo connected the payin. The body is the payment object. It has the same shape as "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/api-reference/openapi/payment/getpaymentbyid"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Retrieve a payment"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Read "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payin_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payin_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"converted_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"converted_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fee_breakdown"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Payment","exampleIds":["paths/~1payment~1{id}~1connect-payin/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/Payment","exampleIds":["paths/~1payment~1{id}~1connect-payin/post/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad request. The payment identifier is not valid, the payment cannot connect to a payin, or the payin cannot receive a payment.\n","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_49"}},"schemaId":"schema_49"},{"code":"401","description":"Unauthorized. The bearer token is absent or not valid."},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Glomo did not find the payment or the payin. This message also applies to a resource of a different business, and to a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payin_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" that is absent or unknown."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_50"}},"schemaId":"schema_50"}],"pointer":"/paths/~1payment~1{id}~1connect-payin/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/Payment","exampleIds":["paths/~1payment~1{id}~1connect-payin/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Payment","exampleIds":["paths/~1payment~1{id}~1connect-payin/post/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_49","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_49"}}},{"code":"401"},{"code":"404","schemaId":"schema_50","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_50"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/payment/connectpayin"}],"panels":[]}]},"httpPath":"/payment/{id}/connect-payin"},{"label":"Mock funds available","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/payment/mockupdatepaymentfundsavailable","routeSlug":"/api-reference/openapi/payment/mockupdatepaymentfundsavailable","metadata":{"seo":{"title":"Mock funds available","description":"This API is only available in sandbox mode. Updates the funds_available status of a payment to simulate  the availability of funds for testing purposes."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"mockUpdatePaymentFundsAvailable","name":"Mock funds available","isWebhook":false,"pointer":"/paths/~1payment~1{id}~1mock-funds-available/patch","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Mock funds available","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":"This API is only available in sandbox mode. Updates the funds_available status of a payment to simulate  the availability of funds for testing purposes."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_51","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the payment to mark funds as available for. The payment must already be in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"success"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" status, must not have direct settlement enabled, and must have a transaction recorded against it; otherwise the call is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". If funds are already available the call is a no-op and returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"200"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1payment~1{id}~1mock-funds-available/patch/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/payment/{id}/mock-funds-available","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"payt_E602dMzgjpDC","schemaId":"schema_51"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","400","401","404"],"pointer":"/payment/{id}/mock-funds-available","href":"payment/mockupdatepaymentfundsavailable","openApiOperationId":"mockUpdatePaymentFundsAvailable","summary":"Mock funds available"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Payment funds available status updated successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_52"}},"schemaId":"schema_52"},{"code":"400","description":"Bad Request - Payment validation failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_53"}},"schemaId":"schema_53"},{"code":"401","description":"Unauthorized - Invalid or missing authentication token"},{"code":"404","description":"Not Found - Payment with the specified ID not found"}],"pointer":"/paths/~1payment~1{id}~1mock-funds-available/patch/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_52","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_52"}}},{"code":"400","schemaId":"schema_53","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_53"}}},{"code":"401"},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/payment/mockupdatepaymentfundsavailable"}],"panels":[]}]},"httpPath":"/payment/{id}/mock-funds-available"}],"content":{"contentType":"group","meta":{"name":"Payment"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Payment","showPageActions":true},{"nodeType":"markdoc","content":"This resource represents a payment attempt made by your customer. The payment can either be successfully completed or failed, depending on various factors."}],"panels":[{"children":[{"kind":"group-items","title":"Schemas","titleTranslationKey":"schemas","items":[{"title":"Payment","link":"/payment/payment","deprecated":false}]},{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/payment","summary":"Create a payment","prefix":{"name":"post","color":"post"},"badges":[],"link":"/payment/createpayment","deprecated":false},{"title":"/payment","summary":"List all payments","prefix":{"name":"get","color":"get"},"badges":[],"link":"/payment/getpayments","deprecated":false},{"title":"/payment/mock","summary":"Create a mock payment","prefix":{"name":"post","color":"post"},"badges":[],"link":"/payment/createmockpayment","deprecated":false},{"title":"/payment/{id}","summary":"Retrieve a payment\n","prefix":{"name":"get","color":"get"},"badges":[],"link":"/payment/getpaymentbyid","deprecated":false},{"title":"/payment/{id}/eligible-payins","summary":"List eligible payins","prefix":{"name":"get","color":"get"},"badges":[],"link":"/payment/geteligiblepayins","deprecated":false},{"title":"/payment/{id}/connect-payin","summary":"Connect a payin","prefix":{"name":"post","color":"post"},"badges":[],"link":"/payment/connectpayin","deprecated":false},{"title":"/payment/{id}/mock-funds-available","summary":"Mock funds available","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/payment/mockupdatepaymentfundsavailable","deprecated":false}]}]}]}]}},{"type":"group","label":"Refund","link":"/api-reference/openapi/refund","routeSlug":"/api-reference/openapi/refund","items":[{"type":"link","label":"Refund","link":"/api-reference/openapi/refund/refund","routeSlug":"/api-reference/openapi/refund/refund","httpVerb":"schema","content":{"contentType":"item","itemVariant":"schema","meta":{"name":"Refund"},"seo":{"title":"Refund"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Refund","showPageActions":true}],"panels":[]},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"schemaDefinition","attributes":{"showWriteOnly":true,"schemaRef":"#/components/schemas/Refund"},"children":[]}]}]}},{"label":"Create refund for a payment","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/refund/createrefund","routeSlug":"/api-reference/openapi/refund/createrefund","metadata":{"seo":{"title":"Create refund for a payment","description":"Creates refund for a payment entity if the payment is in success state and no other refund exists."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createRefund","name":"Create refund for a payment","isWebhook":false,"pointer":"/paths/~1refunds/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create refund for a payment","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Creates refund for a payment entity if the payment is in success state and no other refund exists.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_54"}},"schemaId":"schema_54","pointer":"/paths/~1refunds/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/refunds","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_54"}},"responseCodes":["201","400"],"pointer":"/refunds","href":"refund/createrefund","openApiOperationId":"createRefund","summary":"Create refund for a payment"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"schemaId":"schema_54","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_54"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Refund created successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Refund"}},"schemaId":"components/schemas/Refund"},{"code":"400","description":"Bad request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_55","exampleIds":["paths/~1refunds/post/responses/400/content/application~1json/examples/refund_in_progress","paths/~1refunds/post/responses/400/content/application~1json/examples/duplicate_request_id"]}},"schemaId":"schema_55","exampleIds":["paths/~1refunds/post/responses/400/content/application~1json/examples/refund_in_progress","paths/~1refunds/post/responses/400/content/application~1json/examples/duplicate_request_id"]}],"pointer":"/paths/~1refunds/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/Refund","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Refund"}}},{"code":"400","schemaId":"schema_55","exampleIds":["paths/~1refunds/post/responses/400/content/application~1json/examples/refund_in_progress","paths/~1refunds/post/responses/400/content/application~1json/examples/duplicate_request_id"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_55","exampleIds":["paths/~1refunds/post/responses/400/content/application~1json/examples/refund_in_progress","paths/~1refunds/post/responses/400/content/application~1json/examples/duplicate_request_id"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/refund/createrefund"}],"panels":[]}]},"httpPath":"/refunds"},{"label":"List all refunds","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/refund/getrefunds","routeSlug":"/api-reference/openapi/refund/getrefunds","metadata":{"seo":{"title":"List all refunds","description":"Returns a list of refunds in response. The refunds are returned sorted by creation date, with the most recent refund appearing first."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getRefunds","name":"List all refunds","isWebhook":false,"pointer":"/paths/~1refunds/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List all refunds","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns a list of refunds in response. The refunds are returned sorted by creation date, with the most recent refund appearing first.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"customer_id","in":"query","schemaId":"schema_7","description":"Refunds of customer to filter"},{"name":"payment_method","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Refunds of payment_methods to filter"},"children":[]}]}]}]},{"name":"payment_id","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Refunds of payment_id to filter"},"children":[]}]}]}]},{"name":"request_id","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return only the refund created with this "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"request_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"unique_refund_request_id_123"},{"name":"status","in":"query","schemaId":"schema_56","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return only refunds in this status. Uses the same values as the refund's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field."},"children":[]}]}]}]},{"name":"before","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return only resources created at or before this time. Send an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_8601"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" timestamp with an offset, such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-02-18T12:03:44Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-02-18T17:33:44+05:30"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A timestamp without an offset is read as UTC. A bare date ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") means the end of that day in UTC ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"23:59:59.999999Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). An invalid value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Use this to avoid page drift. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/platform/pagination#parameters"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameters"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"example":"2025-02-18T12:03:44Z"},{"name":"after","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return only resources created at or after this time. Send an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_8601"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" timestamp with an offset, such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-01-18T12:03:44Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-01-18T17:33:44+05:30"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A timestamp without an offset is read as UTC. A bare date ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") means the start of that day in UTC ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"00:00:00Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). An invalid value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Use this to avoid page drift. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/platform/pagination#parameters"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameters"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"example":"2025-01-18T12:03:44Z"},{"name":"per_page","in":"query","schemaId":"schema_8","description":"Number of resources per page. Should be between 1 and 100."},{"name":"page","in":"query","schemaId":"schema_9","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Page number for pagination. Starts from 1. Get the next page number from the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"next"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field in the response."},"children":[]}]}]}]}],"pointer":"/paths/~1refunds/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/refunds","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"customer_id","in":"query","schemaId":"schema_7"},{"name":"payment_method","in":"query","schemaId":"schema_7"},{"name":"payment_id","in":"query","schemaId":"schema_7"},{"name":"request_id","in":"query","example":"unique_refund_request_id_123","schemaId":"schema_7"},{"name":"status","in":"query","schemaId":"schema_56"},{"name":"before","in":"query","example":"2025-02-18T12:03:44Z","schemaId":"schema_7"},{"name":"after","in":"query","example":"2025-01-18T12:03:44Z","schemaId":"schema_7"},{"name":"per_page","in":"query","schemaId":"schema_8"},{"name":"page","in":"query","schemaId":"schema_9"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","401"],"pointer":"/refunds","href":"refund/getrefunds","openApiOperationId":"getRefunds","summary":"List all refunds"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"List of Refunds matching the filters","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_57"}},"schemaId":"schema_57"},{"code":"401","description":"Unauthorized"}],"pointer":"/paths/~1refunds/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_57","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_57"}}},{"code":"401"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/refund/getrefunds"}],"panels":[]}]},"httpPath":"/refunds"},{"label":"Retrieve a refund\n","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/refund/getrefundbyid","routeSlug":"/api-reference/openapi/refund/getrefundbyid","metadata":{"seo":{"title":"Retrieve a refund\n","description":"Retrieves a single refund by ID, including its current status."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getRefundById","name":"Retrieve a refund\n","isWebhook":false,"pointer":"/paths/~1refunds~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve a refund\n","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":"Retrieves a single refund by ID, including its current status."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A failed refund carries "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"error_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"error_message"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", but these are not yet the specific reason"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"recorded against the refund — every failure currently reports the same generic bank-failure value."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Do not branch on them."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The refund must belong to the merchant the API key authenticates as — an ID that exists but belongs"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"to another merchant returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"404"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", not "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"403"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". An ID that is not a well-formed refund ID is rejected"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" before any lookup happens."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier for the refund. Starts with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"refund_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" followed by letters and digits. An ID of any other shape is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and a message saying it must start with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"refund_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; a well-formed ID that doesn't match a refund on your account returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"404"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true,"example":"refund_E602dMzgjpDC"}],"pointer":"/paths/~1refunds~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/refunds/{id}","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"refund_E602dMzgjpDC","schemaId":"schema_7"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/refunds/{id}","href":"refund/getrefundbyid","openApiOperationId":"getRefundById","summary":"Retrieve a refund\n"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Refund found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Refund"}},"schemaId":"components/schemas/Refund"},{"code":"404","description":"Refund not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}},"schemaId":"components/schemas/EntityNotFound"}],"pointer":"/paths/~1refunds~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/Refund","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Refund"}}},{"code":"404","schemaId":"components/schemas/EntityNotFound","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/refund/getrefundbyid"}],"panels":[]}]},"httpPath":"/refunds/{id}"},{"label":"Mock update a refund","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/refund/mockupdaterefund","routeSlug":"/api-reference/openapi/refund/mockupdaterefund","metadata":{"seo":{"title":"Mock update a refund","description":"Sandbox only. Moves a refund to success or failed so you can test how your integration handles each outcome."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"mockUpdateRefund","name":"Mock update a refund","isWebhook":false,"pointer":"/paths/~1refunds~1{id}~1mock_update_status/patch","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Mock update a refund","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":"Sandbox only. Moves a refund to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"success"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"failed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" so you can test how your integration handles each outcome."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the refund. Starts with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"refund_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" followed by letters and digits. An ID of any other shape is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and a message saying it must start with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"refund_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; a well-formed ID that doesn't match a refund on your account returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"404"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true,"example":"refund_E602dMzgjpDC"}],"pointer":"/paths/~1refunds~1{id}~1mock_update_status/patch/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_58"}},"schemaId":"schema_58","pointer":"/paths/~1refunds~1{id}~1mock_update_status/patch/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/refunds/{id}/mock_update_status","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"refund_E602dMzgjpDC","schemaId":"schema_7"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_58"}},"responseCodes":["200","400","404"],"pointer":"/refunds/{id}/mock_update_status","href":"refund/mockupdaterefund","openApiOperationId":"mockUpdateRefund","summary":"Mock update a refund"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"schemaId":"schema_58","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_58"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Refund updated successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Refund"}},"schemaId":"components/schemas/Refund"},{"code":"400","description":"Bad request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_59"}},"schemaId":"schema_59"},{"code":"404","description":"Refund not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}},"schemaId":"components/schemas/EntityNotFound"}],"pointer":"/paths/~1refunds~1{id}~1mock_update_status/patch/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/Refund","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Refund"}}},{"code":"400","schemaId":"schema_59","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_59"}}},{"code":"404","schemaId":"components/schemas/EntityNotFound","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/refund/mockupdaterefund"}],"panels":[]}]},"httpPath":"/refunds/{id}/mock_update_status"}],"content":{"contentType":"group","meta":{"name":"Refund"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Refund","showPageActions":true},{"nodeType":"markdoc","content":"This resource represents a refund transaction from your Glomo account to your customer. You can retrieve it to see the details of the refund transaction."}],"panels":[{"children":[{"kind":"group-items","title":"Schemas","titleTranslationKey":"schemas","items":[{"title":"Refund","link":"/refund/refund","deprecated":false}]},{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/refunds","summary":"Create refund for a payment","prefix":{"name":"post","color":"post"},"badges":[],"link":"/refund/createrefund","deprecated":false},{"title":"/refunds","summary":"List all refunds","prefix":{"name":"get","color":"get"},"badges":[],"link":"/refund/getrefunds","deprecated":false},{"title":"/refunds/{id}","summary":"Retrieve a refund\n","prefix":{"name":"get","color":"get"},"badges":[],"link":"/refund/getrefundbyid","deprecated":false},{"title":"/refunds/{id}/mock_update_status","summary":"Mock update a refund","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/refund/mockupdaterefund","deprecated":false}]}]}]}]}},{"type":"group","label":"Price","link":"/api-reference/openapi/price","routeSlug":"/api-reference/openapi/price","items":[{"type":"link","label":"Price","link":"/api-reference/openapi/price/price","routeSlug":"/api-reference/openapi/price/price","httpVerb":"schema","content":{"contentType":"item","itemVariant":"schema","meta":{"name":"Price"},"seo":{"title":"Price"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Price","showPageActions":true}],"panels":[]},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"schemaDefinition","attributes":{"showWriteOnly":true,"schemaRef":"#/components/schemas/Price"},"children":[]}]}]}},{"label":"Create a new price","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/price/createprice","routeSlug":"/api-reference/openapi/price/createprice","metadata":{"seo":{"title":"Create a new price","description":"Creates a price governing the referral fee applied to payins, which you then attach to a payin or anorder by passing its ID as price_id. The fee it produces is returned as referral_fee on thepayment and in a quote's fees breakdown."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createPrice","name":"Create a new price","isWebhook":false,"pointer":"/paths/~1prices/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a new price","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":"Creates a price governing the referral fee applied to payins, which you then attach to a payin or an"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"order by passing its ID as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"price_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The fee it produces is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"referral_fee"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"payment and in a quote's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fees"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" breakdown."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Every price created here governs the referral fee — there is no fee type to choose, which is why the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Price object carries no "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fee_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /prices"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" lists these and only these."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pricing_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" selects the shape of the rule and which other fields are permitted — sending a field"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"belonging to the other shape is rejected rather than ignored:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fixed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" requires "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fees_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fees_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and must not include "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bps"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"percentage"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" requires "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bps"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and must not include "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fees_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fees_currency"},"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":"The first referral-fee price you create becomes your default automatically, whether or not you send"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"set_as_default"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". After that, sending "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"set_as_default: true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" promotes this price and demotes the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"previous default — a business has at most one default referral-fee price at a time. The default is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"what applies when a payin does not name a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"price_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_60"}},"schemaId":"schema_60","pointer":"/paths/~1prices/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/prices","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_60"}},"responseCodes":["201","400"],"pointer":"/prices","href":"price/createprice","openApiOperationId":"createPrice","summary":"Create a new price"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"schemaId":"schema_60","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_60"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Payout created successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Price"}},"schemaId":"components/schemas/Price"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_41"}},"schemaId":"schema_41"}],"pointer":"/paths/~1prices/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/Price","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Price"}}},{"code":"400","schemaId":"schema_41","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_41"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/price/createprice"}],"panels":[]}]},"httpPath":"/prices"},{"label":"List all prices","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/price/getprices","routeSlug":"/api-reference/openapi/price/getprices","metadata":{"seo":{"title":"List all prices","description":"Returns the referral-fee prices configured for your business, sorted by creation date with the mostrecent first."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getPrices","name":"List all prices","isWebhook":false,"pointer":"/paths/~1prices/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List all prices","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":"Returns the referral-fee prices configured for your business, sorted by creation date with the most"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"recent first."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Only referral fees are returned. Glomo's other pricing — transaction fees, FX fees — is not exposed"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"through this endpoint and cannot be filtered in, so an empty list means you have configured no"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"referral fees, not that your account has no pricing."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Available to a platform business and to a business hosted by a platform. Any other merchant is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"401"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"before","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return only resources created at or before this time. Send an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_8601"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" timestamp with an offset, such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-02-18T12:03:44Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-02-18T17:33:44+05:30"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A timestamp without an offset is read as UTC. A bare date ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") means the end of that day in UTC ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"23:59:59.999999Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). An invalid value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Use this to avoid page drift. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/platform/pagination#parameters"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameters"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"example":"2025-02-18T12:03:44Z"},{"name":"after","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return only resources created at or after this time. Send an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_8601"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" timestamp with an offset, such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-01-18T12:03:44Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-01-18T17:33:44+05:30"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A timestamp without an offset is read as UTC. A bare date ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") means the start of that day in UTC ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"00:00:00Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). An invalid value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Use this to avoid page drift. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/platform/pagination#parameters"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameters"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"example":"2025-01-18T12:03:44Z"},{"name":"per_page","in":"query","schemaId":"schema_8","description":"Number of resources per page. Should be between 1 and 100."},{"name":"page","in":"query","schemaId":"schema_9","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Page number for pagination. Starts from 1. Get the next page number from the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"next"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field in the response."},"children":[]}]}]}]}],"pointer":"/paths/~1prices/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/prices","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"before","in":"query","example":"2025-02-18T12:03:44Z","schemaId":"schema_7"},{"name":"after","in":"query","example":"2025-01-18T12:03:44Z","schemaId":"schema_7"},{"name":"per_page","in":"query","schemaId":"schema_8"},{"name":"page","in":"query","schemaId":"schema_9"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","400"],"pointer":"/prices","href":"price/getprices","openApiOperationId":"getPrices","summary":"List all prices"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"List of prices matching the filters","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_61"}},"schemaId":"schema_61"},{"code":"400","description":"Bad request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_41"}},"schemaId":"schema_41"}],"pointer":"/paths/~1prices/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_61","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_61"}}},{"code":"400","schemaId":"schema_41","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_41"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/price/getprices"}],"panels":[]}]},"httpPath":"/prices"},{"label":"Retrieve a price\n","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/price/getpricebyid","routeSlug":"/api-reference/openapi/price/getpricebyid","metadata":{"seo":{"title":"Retrieve a price\n","description":"Retrieves a single price by ID. Note that the response does not indicate whether this price is yourcurrent default — that flag is accepted on create but is not returned on read."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getPriceById","name":"Retrieve a price\n","isWebhook":false,"pointer":"/paths/~1prices~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve a price\n","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":"Retrieves a single price by ID. Note that the response does not indicate whether this price is your"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"current default — that flag is accepted on create but is not returned on read."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The same access rule as listing applies: available to a platform business and to a business hosted by"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"a platform, and any other merchant is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"401"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A price ID that is not yours returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"404"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Entity not found: Price"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; one that is not well-formed is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" before the lookup."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier for the price. Starts with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"price_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" followed by letters and digits. An ID of any other shape is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and a message saying it must start with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"price_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; a well-formed ID that doesn't match a price on your account returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"404"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true,"example":"price_E602dMzgjpDC"}],"pointer":"/paths/~1prices~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/prices/{id}","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"price_E602dMzgjpDC","schemaId":"schema_7"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/prices/{id}","href":"price/getpricebyid","openApiOperationId":"getPriceById","summary":"Retrieve a price\n"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Price found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_62"}},"schemaId":"schema_62"},{"code":"404","description":"Price not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}},"schemaId":"components/schemas/EntityNotFound"}],"pointer":"/paths/~1prices~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_62","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_62"}}},{"code":"404","schemaId":"components/schemas/EntityNotFound","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/price/getpricebyid"}],"panels":[]}]},"httpPath":"/prices/{id}"}],"content":{"contentType":"group","meta":{"name":"Price"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Price","showPageActions":true},{"nodeType":"markdoc","content":"This resource represents the details of the referral fees to be configured at the order or payment link level. Only platform businesses are allowed to create prices. The first Price created is set as default for a business."}],"panels":[{"children":[{"kind":"group-items","title":"Schemas","titleTranslationKey":"schemas","items":[{"title":"Price","link":"/price/price","deprecated":false}]},{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/prices","summary":"Create a new price","prefix":{"name":"post","color":"post"},"badges":[],"link":"/price/createprice","deprecated":false},{"title":"/prices","summary":"List all prices","prefix":{"name":"get","color":"get"},"badges":[],"link":"/price/getprices","deprecated":false},{"title":"/prices/{id}","summary":"Retrieve a price\n","prefix":{"name":"get","color":"get"},"badges":[],"link":"/price/getpricebyid","deprecated":false}]}]}]}]}},{"type":"group","label":"Dynamic Fee Split","link":"/api-reference/openapi/pricing_split","routeSlug":"/api-reference/openapi/pricing_split","items":[{"type":"link","label":"DynamicPrice","link":"/api-reference/openapi/pricing_split/dynamicprice","routeSlug":"/api-reference/openapi/pricing_split/dynamicprice","httpVerb":"schema","content":{"contentType":"item","itemVariant":"schema","meta":{"name":"DynamicPrice"},"seo":{"title":"DynamicPrice"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"DynamicPrice","showPageActions":true}],"panels":[]},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"schemaDefinition","attributes":{"showWriteOnly":true,"schemaRef":"#/components/schemas/DynamicPrice"},"children":[]}]}]}},{"type":"link","label":"PricingSplit","link":"/api-reference/openapi/pricing_split/pricingsplit","routeSlug":"/api-reference/openapi/pricing_split/pricingsplit","httpVerb":"schema","content":{"contentType":"item","itemVariant":"schema","meta":{"name":"PricingSplit"},"seo":{"title":"PricingSplit"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"PricingSplit","showPageActions":true}],"panels":[]},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"schemaDefinition","attributes":{"showWriteOnly":true,"schemaRef":"#/components/schemas/PricingSplit"},"children":[]}]}]}},{"label":"List dynamic pricing rules","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/pricing_split/getdynamicprices","routeSlug":"/api-reference/openapi/pricing_split/getdynamicprices","metadata":{"seo":{"title":"List dynamic pricing rules","description":"Returns the payin pricing rules configured for your business whose fee bearer is dynamic. These are the rules you may declare a share of, with Create a pricing split."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getDynamicPrices","name":"List dynamic pricing rules","isWebhook":false,"pointer":"/paths/~1prices~1dynamic/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List dynamic pricing rules","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":"Returns the payin pricing rules configured for your business whose fee bearer is dynamic. These are the rules you may declare a share of, with "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#tag/pricing_split"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create a pricing split"},"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":"Use the rule's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pricing_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to decide what to declare: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bps"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"percentage"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" rule, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fixed_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fixed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" rule."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"per_page","in":"query","schemaId":"schema_8","description":"Number of resources per page. Should be between 1 and 100."},{"name":"page","in":"query","schemaId":"schema_9","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Page number for pagination. Starts from 1. Get the next page number from the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"next"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field in the response."},"children":[]}]}]}]}],"pointer":"/paths/~1prices~1dynamic/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/prices/dynamic","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"per_page","in":"query","schemaId":"schema_8"},{"name":"page","in":"query","schemaId":"schema_9"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","400","401"],"pointer":"/prices/dynamic","href":"pricing_split/getdynamicprices","openApiOperationId":"getDynamicPrices","summary":"List dynamic pricing rules"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"List of dynamic pricing rules available to your business","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_63","exampleIds":["paths/~1prices~1dynamic/get/responses/200/content/application~1json/example"]}},"schemaId":"schema_63","exampleIds":["paths/~1prices~1dynamic/get/responses/200/content/application~1json/example"]},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bad Request — invalid pagination parameters"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_64"}},"schemaId":"schema_64"},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized — invalid or missing authentication token"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_65"}},"schemaId":"schema_65"}],"pointer":"/paths/~1prices~1dynamic/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_63","exampleIds":["paths/~1prices~1dynamic/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_63","exampleIds":["paths/~1prices~1dynamic/get/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_64","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_64"}}},{"code":"401","schemaId":"schema_65","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_65"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/pricing_split/getdynamicprices"}],"panels":[]}]},"httpPath":"/prices/dynamic"},{"label":"Create a pricing split","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/pricing_split/createpricingsplit","routeSlug":"/api-reference/openapi/pricing_split/createpricingsplit","metadata":{"seo":{"title":"Create a pricing split","description":"Declare your share of a dynamic pricing rule's fee. The customer bears the remainder. List the rules you may declare against with List dynamic pricing rules."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createPricingSplit","name":"Create a pricing split","isWebhook":false,"pointer":"/paths/~1prices~1dynamic-splits/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a pricing split","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":"Declare your share of a dynamic pricing rule's fee. The customer bears the remainder. List the rules you may declare against with "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#tag/pricing_split"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List dynamic pricing rules"},"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":"Provide "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"price_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and exactly one of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bps"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fixed_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Declare "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bps"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" against a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"percentage"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" rule and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fixed_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" against a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fixed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" rule. Your share cannot exceed the rule's own total: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bps"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" cannot exceed the rule's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bps"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fixed_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" cannot exceed the rule's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fees_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Each rule is held to its own ceiling."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Amounts are in minor units (cents) and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bps"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is basis points, so 100 is 1%. A "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bps"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is valid and means the customer bears the whole fee."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pass the returned "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"split_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when you create a payment link, an order, a payin quote, a subscription or an auto debit. Until you pass it, the dynamic rule is never applied and pricing falls back to your normal (non-dynamic) rules."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreatePricingSplitRequest","exampleIds":["paths/~1prices~1dynamic-splits/post/requestBody/content/application~1json/examples/percentage_split","paths/~1prices~1dynamic-splits/post/requestBody/content/application~1json/examples/percentage_split_with_bounds","paths/~1prices~1dynamic-splits/post/requestBody/content/application~1json/examples/fixed_split","paths/~1prices~1dynamic-splits/post/requestBody/content/application~1json/examples/customer_bears_whole_fee"]}},"schemaId":"components/schemas/CreatePricingSplitRequest","exampleIds":["paths/~1prices~1dynamic-splits/post/requestBody/content/application~1json/examples/percentage_split","paths/~1prices~1dynamic-splits/post/requestBody/content/application~1json/examples/percentage_split_with_bounds","paths/~1prices~1dynamic-splits/post/requestBody/content/application~1json/examples/fixed_split","paths/~1prices~1dynamic-splits/post/requestBody/content/application~1json/examples/customer_bears_whole_fee"],"pointer":"/paths/~1prices~1dynamic-splits/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/prices/dynamic-splits","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreatePricingSplitRequest","exampleIds":["paths/~1prices~1dynamic-splits/post/requestBody/content/application~1json/examples/percentage_split","paths/~1prices~1dynamic-splits/post/requestBody/content/application~1json/examples/percentage_split_with_bounds","paths/~1prices~1dynamic-splits/post/requestBody/content/application~1json/examples/fixed_split","paths/~1prices~1dynamic-splits/post/requestBody/content/application~1json/examples/customer_bears_whole_fee"]}},"responseCodes":["201","400","401"],"pointer":"/prices/dynamic-splits","href":"pricing_split/createpricingsplit","openApiOperationId":"createPricingSplit","summary":"Create a pricing split"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"schemaId":"components/schemas/CreatePricingSplitRequest","exampleIds":["paths/~1prices~1dynamic-splits/post/requestBody/content/application~1json/examples/percentage_split","paths/~1prices~1dynamic-splits/post/requestBody/content/application~1json/examples/percentage_split_with_bounds","paths/~1prices~1dynamic-splits/post/requestBody/content/application~1json/examples/fixed_split","paths/~1prices~1dynamic-splits/post/requestBody/content/application~1json/examples/customer_bears_whole_fee"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreatePricingSplitRequest","exampleIds":["paths/~1prices~1dynamic-splits/post/requestBody/content/application~1json/examples/percentage_split","paths/~1prices~1dynamic-splits/post/requestBody/content/application~1json/examples/percentage_split_with_bounds","paths/~1prices~1dynamic-splits/post/requestBody/content/application~1json/examples/fixed_split","paths/~1prices~1dynamic-splits/post/requestBody/content/application~1json/examples/customer_bears_whole_fee"]}},"examples":[{},{},{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Pricing split created successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PricingSplit","exampleIds":["paths/~1prices~1dynamic-splits/post/responses/201/content/application~1json/example"]}},"schemaId":"components/schemas/PricingSplit","exampleIds":["paths/~1prices~1dynamic-splits/post/responses/201/content/application~1json/example"]},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bad Request — validation error. The rule must belong to your business, have a dynamic fee bearer, price "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payin"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"transaction_fees"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", be currently effective and be the latest effective version of the rule. Your declared share must match the rule's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pricing_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and must not exceed the rule's own total."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_66","exampleIds":["paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/price_id_missing","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/price_id_not_found","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/not_dynamic","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/not_payin","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/not_transaction_fees","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/not_effective_yet","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/superseded","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/neither_or_both","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/bps_required","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/bps_exceeds_rule","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/fixed_amount_required","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/fixed_amount_exceeds_rule","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/fee_currency_mismatch","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/bounds_on_fixed_rule","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/bound_without_currency","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/min_fee_above_max_fee"]}},"schemaId":"schema_66","exampleIds":["paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/price_id_missing","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/price_id_not_found","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/not_dynamic","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/not_payin","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/not_transaction_fees","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/not_effective_yet","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/superseded","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/neither_or_both","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/bps_required","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/bps_exceeds_rule","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/fixed_amount_required","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/fixed_amount_exceeds_rule","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/fee_currency_mismatch","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/bounds_on_fixed_rule","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/bound_without_currency","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/min_fee_above_max_fee"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized — invalid or missing authentication token"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_65"}},"schemaId":"schema_65"}],"pointer":"/paths/~1prices~1dynamic-splits/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/PricingSplit","exampleIds":["paths/~1prices~1dynamic-splits/post/responses/201/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PricingSplit","exampleIds":["paths/~1prices~1dynamic-splits/post/responses/201/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_66","exampleIds":["paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/price_id_missing","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/price_id_not_found","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/not_dynamic","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/not_payin","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/not_transaction_fees","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/not_effective_yet","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/superseded","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/neither_or_both","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/bps_required","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/bps_exceeds_rule","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/fixed_amount_required","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/fixed_amount_exceeds_rule","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/fee_currency_mismatch","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/bounds_on_fixed_rule","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/bound_without_currency","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/min_fee_above_max_fee"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_66","exampleIds":["paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/price_id_missing","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/price_id_not_found","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/not_dynamic","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/not_payin","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/not_transaction_fees","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/not_effective_yet","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/superseded","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/neither_or_both","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/bps_required","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/bps_exceeds_rule","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/fixed_amount_required","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/fixed_amount_exceeds_rule","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/fee_currency_mismatch","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/bounds_on_fixed_rule","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/bound_without_currency","paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/min_fee_above_max_fee"]}}},{"code":"401","schemaId":"schema_65","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_65"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/pricing_split/createpricingsplit"}],"panels":[]}]},"httpPath":"/prices/dynamic-splits"},{"label":"List pricing splits","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/pricing_split/getpricingsplits","routeSlug":"/api-reference/openapi/pricing_split/getpricingsplits","metadata":{"seo":{"title":"List pricing splits","description":"Returns the pricing splits your business has declared, sorted by creation date with the most recent split first. Pass price_id to return only the splits declared against one dynamic pricing rule."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getPricingSplits","name":"List pricing splits","isWebhook":false,"pointer":"/paths/~1prices~1dynamic-splits/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List pricing splits","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":"Returns the pricing splits your business has declared, sorted by creation date with the most recent split first. Pass "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"price_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to return only the splits declared against one dynamic pricing rule."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"price_id","in":"query","schemaId":"schema_7","description":"Return only the splits declared against this dynamic pricing rule.","example":"price_5JU9yv0lGSUP"},{"name":"per_page","in":"query","schemaId":"schema_8","description":"Number of resources per page. Should be between 1 and 100."},{"name":"page","in":"query","schemaId":"schema_9","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Page number for pagination. Starts from 1. Get the next page number from the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"next"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field in the response."},"children":[]}]}]}]}],"pointer":"/paths/~1prices~1dynamic-splits/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/prices/dynamic-splits","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"price_id","in":"query","example":"price_5JU9yv0lGSUP","schemaId":"schema_7"},{"name":"per_page","in":"query","schemaId":"schema_8"},{"name":"page","in":"query","schemaId":"schema_9"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","400","401"],"pointer":"/prices/dynamic-splits","href":"pricing_split/getpricingsplits","openApiOperationId":"getPricingSplits","summary":"List pricing splits"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"List of pricing splits matching the filters","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_67","exampleIds":["paths/~1prices~1dynamic-splits/get/responses/200/content/application~1json/example"]}},"schemaId":"schema_67","exampleIds":["paths/~1prices~1dynamic-splits/get/responses/200/content/application~1json/example"]},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bad Request — invalid pagination parameters"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_64"}},"schemaId":"schema_64"},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized — invalid or missing authentication token"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_65"}},"schemaId":"schema_65"}],"pointer":"/paths/~1prices~1dynamic-splits/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_67","exampleIds":["paths/~1prices~1dynamic-splits/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_67","exampleIds":["paths/~1prices~1dynamic-splits/get/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_64","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_64"}}},{"code":"401","schemaId":"schema_65","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_65"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/pricing_split/getpricingsplits"}],"panels":[]}]},"httpPath":"/prices/dynamic-splits"}],"content":{"contentType":"group","meta":{"name":"pricing_split"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Dynamic Fee Split","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":"You can configure a payin or subscription with your own pricing splits. The split declares merchant's share out of the total pricing rule and rest of it gets charged to the customer. The split needs to be explicitly passed in the API calls to be applied, otherwise system configured pricing rules apply. Use this resource to list the dynamic rules you may declare against, and to create and list your declarations. Pass the resulting split ids as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"split_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on a payment link, an order, a payin quote, a subscription or an auto debit."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Schemas","titleTranslationKey":"schemas","items":[{"title":"DynamicPrice","link":"/pricing_split/dynamicprice","deprecated":false},{"title":"PricingSplit","link":"/pricing_split/pricingsplit","deprecated":false}]},{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/prices/dynamic","summary":"List dynamic pricing rules","prefix":{"name":"get","color":"get"},"badges":[],"link":"/pricing_split/getdynamicprices","deprecated":false},{"title":"/prices/dynamic-splits","summary":"Create a pricing split","prefix":{"name":"post","color":"post"},"badges":[],"link":"/pricing_split/createpricingsplit","deprecated":false},{"title":"/prices/dynamic-splits","summary":"List pricing splits","prefix":{"name":"get","color":"get"},"badges":[],"link":"/pricing_split/getpricingsplits","deprecated":false}]}]}]}]}},{"type":"group","label":"Payment Session","link":"/api-reference/openapi/payment_session","routeSlug":"/api-reference/openapi/payment_session","items":[{"label":"Create a payment session","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/payment_session/createpaymentsession","routeSlug":"/api-reference/openapi/payment_session/createpaymentsession","metadata":{"seo":{"title":"Create a payment session","description":"Creates a payment session — a configurable workflow that wraps a payment journey with pre-steps and/or post-steps such as identity verification, compliance checks, or data collection. The exact step sequence is determined by the session_type configured for your business."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createPaymentSession","name":"Create a payment session","isWebhook":false,"pointer":"/paths/~1payment-sessions/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a payment session","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":"Creates a payment session — a configurable workflow that wraps a payment journey with pre-steps and/or post-steps such as identity verification, compliance checks, or data collection. The exact step sequence is determined by the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"session_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" configured for your business."},"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":" The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"kyc_lrs"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" session type adds a KYC verification step before the LRS remittance checkout, ensuring the customer is verified before funds are transferred."},"children":[]}]}]},{"$$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":"token"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" returned in the response should be passed to the Glomo Web SDK to launch the guided UI for the customer."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Optionally associate the session with an existing customer via "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"customer_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or pre-populate customer details using "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"email"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Both fields are optional and mutually exclusive — passing both returns a 400 error. Omitting both creates an anonymous session."},"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":"Prefilling steps:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Pass prefill data to pre-populate steps in the flow so the customer skips re-entering known values. Include only the data relevant to your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"session_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"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":"KYC prefill"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — identity details ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pan"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"phone"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"country"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"dob"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") used to prefill"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the KYC step. Two request shapes are supported: "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"v1"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" places the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"kyc"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" object at the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"top level; "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"v2"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" nests it under "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"data.kyc"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (recommended, and the shape used alongside"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"other "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"data"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" groups). Provide only one shape — supplying "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"kyc"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at both the top level and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"under "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"data"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" returns a 400 error. When any of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pan"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"phone"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"dob"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is supplied, pair"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"it with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"email"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; these fields cannot be combined with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"customer_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (which is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"authoritative), and supplying them without any identifier returns a 400 error. When"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"phone"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is supplied, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"country"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (ISO 3166-1 alpha-3) is required and is used to validate"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the phone number format."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"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":"Scheme prefill"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"data.scheme"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") — investment scheme details ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"plan"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":","},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"distributor_arn"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") used to prefill the scheme plan and amount step. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" must be supplied together."},"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":"Sessions for a named scheme:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" pass "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"data.scheme.scheme_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to open the session for one scheme. A distributor must send it; see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/capital-markets/distributor/set-up"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Open payment sessions as a distributor"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A fund can name one of its own schemes."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Contact support if you receive a 403 error — payment sessions must be enabled for your business."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":false,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_68","exampleIds":["paths/~1payment-sessions/post/requestBody/content/application~1json/examples/anonymous","paths/~1payment-sessions/post/requestBody/content/application~1json/examples/with_email","paths/~1payment-sessions/post/requestBody/content/application~1json/examples/with_customer_id","paths/~1payment-sessions/post/requestBody/content/application~1json/examples/with_kyc_prefill_v1","paths/~1payment-sessions/post/requestBody/content/application~1json/examples/with_kyc_prefill_v2","paths/~1payment-sessions/post/requestBody/content/application~1json/examples/with_scheme_prefill","paths/~1payment-sessions/post/requestBody/content/application~1json/examples/with_scheme_code"]}},"schemaId":"schema_68","exampleIds":["paths/~1payment-sessions/post/requestBody/content/application~1json/examples/anonymous","paths/~1payment-sessions/post/requestBody/content/application~1json/examples/with_email","paths/~1payment-sessions/post/requestBody/content/application~1json/examples/with_customer_id","paths/~1payment-sessions/post/requestBody/content/application~1json/examples/with_kyc_prefill_v1","paths/~1payment-sessions/post/requestBody/content/application~1json/examples/with_kyc_prefill_v2","paths/~1payment-sessions/post/requestBody/content/application~1json/examples/with_scheme_prefill","paths/~1payment-sessions/post/requestBody/content/application~1json/examples/with_scheme_code"],"pointer":"/paths/~1payment-sessions/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/payment-sessions","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_68","exampleIds":["paths/~1payment-sessions/post/requestBody/content/application~1json/examples/anonymous","paths/~1payment-sessions/post/requestBody/content/application~1json/examples/with_email","paths/~1payment-sessions/post/requestBody/content/application~1json/examples/with_customer_id","paths/~1payment-sessions/post/requestBody/content/application~1json/examples/with_kyc_prefill_v1","paths/~1payment-sessions/post/requestBody/content/application~1json/examples/with_kyc_prefill_v2","paths/~1payment-sessions/post/requestBody/content/application~1json/examples/with_scheme_prefill","paths/~1payment-sessions/post/requestBody/content/application~1json/examples/with_scheme_code"]}},"responseCodes":["201","400","401","403","404","409","422"],"pointer":"/payment-sessions","href":"payment_session/createpaymentsession","openApiOperationId":"createPaymentSession","summary":"Create a payment session"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"schemaId":"schema_68","exampleIds":["paths/~1payment-sessions/post/requestBody/content/application~1json/examples/anonymous","paths/~1payment-sessions/post/requestBody/content/application~1json/examples/with_email","paths/~1payment-sessions/post/requestBody/content/application~1json/examples/with_customer_id","paths/~1payment-sessions/post/requestBody/content/application~1json/examples/with_kyc_prefill_v1","paths/~1payment-sessions/post/requestBody/content/application~1json/examples/with_kyc_prefill_v2","paths/~1payment-sessions/post/requestBody/content/application~1json/examples/with_scheme_prefill","paths/~1payment-sessions/post/requestBody/content/application~1json/examples/with_scheme_code"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_68","exampleIds":["paths/~1payment-sessions/post/requestBody/content/application~1json/examples/anonymous","paths/~1payment-sessions/post/requestBody/content/application~1json/examples/with_email","paths/~1payment-sessions/post/requestBody/content/application~1json/examples/with_customer_id","paths/~1payment-sessions/post/requestBody/content/application~1json/examples/with_kyc_prefill_v1","paths/~1payment-sessions/post/requestBody/content/application~1json/examples/with_kyc_prefill_v2","paths/~1payment-sessions/post/requestBody/content/application~1json/examples/with_scheme_prefill","paths/~1payment-sessions/post/requestBody/content/application~1json/examples/with_scheme_code"]}},"examples":[{},{},{},{},{},{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Payment session created successfully.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaymentSession","exampleIds":["paths/~1payment-sessions/post/responses/201/content/application~1json/example"]}},"schemaId":"components/schemas/PaymentSession","exampleIds":["paths/~1payment-sessions/post/responses/201/content/application~1json/example"]},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bad request — validation error, including an invalid format for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"email"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"customer_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pan"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"phone"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"country"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"dob"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"phone"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" supplied without "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"country"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; mutually exclusive fields provided; prefill fields supplied without an identifier; KYC prefill supplied both at the top level (v1) and under "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"data"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (v2); "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"data"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" that is not an object; or a blank or missing "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"scheme_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (required for distributors). Validation errors carry a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Validation failed: "},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" prefix in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"message"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_69"}},"schemaId":"schema_69"},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized — missing or invalid JWT token."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_65"}},"schemaId":"schema_65"},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden — payment sessions are not enabled for this business. For a distributor, also:"},"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":"code","inline":true,"attributes":{"content":"No active relationship with this fund"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Scheme not enabled for this relationship"},"children":[]}]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_70"}},"schemaId":"schema_70"},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Not found — "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"scheme_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" does not match an active scheme you can use."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_71"}},"schemaId":"schema_71"},{"code":"409","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Conflict — the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pan"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" supplied is already registered under a different email, on an existing customer or an in-progress KYC."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_72"}},"schemaId":"schema_72"},{"code":"422","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unprocessable entity — with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"scheme_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":":"},"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":"code","inline":true,"attributes":{"content":"plan must match the scheme"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Scheme is not available for distribution"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (a direct plan, for a distributor) - "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Fund is not configured for scheme sessions"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Distributor ARN is not configured for this fund"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"customer_id is not supported for relationship-originated sessions"},"children":[]}]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_73"}},"schemaId":"schema_73"}],"pointer":"/paths/~1payment-sessions/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/PaymentSession","exampleIds":["paths/~1payment-sessions/post/responses/201/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaymentSession","exampleIds":["paths/~1payment-sessions/post/responses/201/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_69","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_69"}}},{"code":"401","schemaId":"schema_65","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_65"}}},{"code":"403","schemaId":"schema_70","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_70"}}},{"code":"404","schemaId":"schema_71","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_71"}}},{"code":"409","schemaId":"schema_72","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_72"}}},{"code":"422","schemaId":"schema_73","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_73"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/payment_session/createpaymentsession"}],"panels":[]}]},"httpPath":"/payment-sessions"}],"content":{"contentType":"group","meta":{"name":"payment_session"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Payment Session","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":"A Payment Session is a configurable workflow that wraps a payment journey with pre-steps and/or post-steps — such as identity verification, compliance checks, or data collection — before or after the core payment. The session type is configured per business and determines the exact step sequence. Creating a session returns a short-lived JWT token that is passed to the Glomo Web SDK to launch the guided UI."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/payment-sessions","summary":"Create a payment session","prefix":{"name":"post","color":"post"},"badges":[],"link":"/payment_session/createpaymentsession","deprecated":false}]}]}]}]}},{"type":"group","label":"Distributor Link","link":"/api-reference/openapi/distributor_link","routeSlug":"/api-reference/openapi/distributor_link","items":[{"label":"Create a distributor link","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/distributor_link/createdistributorlink","routeSlug":"/api-reference/openapi/distributor_link/createdistributorlink","metadata":{"seo":{"title":"Create a distributor link","description":"Creates a reusable link for one of a fund's schemes. Share the returned url with any number of investors: each open starts a new payment session for the scheme, credited to the distributor, prefilled with the scheme, the distributor's ARN and the amount if one was set. The link does not expire; it stops working when the relationship with the fund is disabled, the scheme is no longer allowed or is closed, or the link is disabled."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createDistributorLink","name":"Create a distributor link","isWebhook":false,"pointer":"/paths/~1distributor-links/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a distributor link","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":"Creates a reusable link for one of a fund's schemes. Share the returned "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"url"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with any number of investors: each open starts a new payment session for the scheme, credited to the distributor, prefilled with the scheme, the distributor's ARN and the amount if one was set. The link does not expire; it stops working when the relationship with the fund is disabled, the scheme is no longer allowed or is closed, or the link is disabled."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A distributor calls it for a scheme the fund has enabled for it. A fund can call it for one of its own schemes."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Distributor links are enabled per business. Contact support if you receive "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Feature not enabled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/capital-markets/distributor/share-a-link"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"One Click Distributor Link"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for the full flow."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_74","exampleIds":["paths/~1distributor-links/post/requestBody/content/application~1json/example"]}},"schemaId":"schema_74","exampleIds":["paths/~1distributor-links/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1distributor-links/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/distributor-links","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_74","exampleIds":["paths/~1distributor-links/post/requestBody/content/application~1json/example"]}},"responseCodes":["201","400","401","403","404","422"],"pointer":"/distributor-links","href":"distributor_link/createdistributorlink","openApiOperationId":"createDistributorLink","summary":"Create a distributor link"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"schemaId":"schema_74","exampleIds":["paths/~1distributor-links/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_74","exampleIds":["paths/~1distributor-links/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Link created.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_75","exampleIds":["paths/~1distributor-links/post/responses/201/content/application~1json/example"]}},"schemaId":"schema_75","exampleIds":["paths/~1distributor-links/post/responses/201/content/application~1json/example"]},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bad request — distributor links are not enabled for the business ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Feature not enabled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"), or a validation error: a blank or missing "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"scheme_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or an "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" that is not a positive integer. Validation errors carry a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Validation failed: "},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" prefix in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"message"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_76"}},"schemaId":"schema_76"},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized — missing or invalid JWT token."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_14"}},"schemaId":"schema_14"},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forbidden — "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"No active relationship with this fund"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Scheme not enabled for this relationship"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_77"}},"schemaId":"schema_77"},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Not found — "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"scheme_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" does not match an active scheme you can use."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_71"}},"schemaId":"schema_71"},{"code":"422","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unprocessable — "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"distributor_arn does not match the registered ARN"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Amount must be between <min> and <max> USD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Scheme is not available for distribution"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (a direct plan), or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Fund is not configured for scheme sessions"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_78"}},"schemaId":"schema_78"}],"pointer":"/paths/~1distributor-links/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"schema_75","exampleIds":["paths/~1distributor-links/post/responses/201/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_75","exampleIds":["paths/~1distributor-links/post/responses/201/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_76","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_76"}}},{"code":"401","schemaId":"schema_14","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_14"}}},{"code":"403","schemaId":"schema_77","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_77"}}},{"code":"404","schemaId":"schema_71","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_71"}}},{"code":"422","schemaId":"schema_78","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_78"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/distributor_link/createdistributorlink"}],"panels":[]}]},"httpPath":"/distributor-links"}],"content":{"contentType":"group","meta":{"name":"distributor_link"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Distributor Link","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":"A distributor link is one reusable URL for a fund's scheme. Each time an investor opens it, a new payment session starts for the scheme, credited to the distributor. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/capital-markets/distributor/share-a-link"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"One Click Distributor Link"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for the flow."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/distributor-links","summary":"Create a distributor link","prefix":{"name":"post","color":"post"},"badges":[],"link":"/distributor_link/createdistributorlink","deprecated":false}]}]}]}]}},{"type":"group","label":"LRS","link":"/api-reference/openapi/lrs","routeSlug":"/api-reference/openapi/lrs","items":[{"label":"Register a customer's LRS bank account","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/lrs/createlrscustomerbankaccount","routeSlug":"/api-reference/openapi/lrs/createlrscustomerbankaccount","metadata":{"seo":{"title":"Register a customer's LRS bank account","description":"Registers the Indian bank account an LRS remittance is debited from. Pass the returned id (acclrs_...) as lrs.bank_account_id when you create an LRS order."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createLrsCustomerBankAccount","name":"Register a customer's LRS bank account","isWebhook":false,"pointer":"/paths/~1customer~1{id}~1bank_account/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Register a customer's LRS bank account","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":"Registers the Indian bank account an LRS remittance is debited from. Pass the returned "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"acclrs_..."},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"lrs.bank_account_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when you create an LRS order."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This is not the same endpoint as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /customer/{id}/bank-accounts"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"createCustomerBankAccount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"), and the two sets of accounts are kept apart:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A customer can hold several LRS bank accounts. Registering another one adds to the list, whereas"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"createCustomerBankAccount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" keeps one account per customer and replaces it. Registering the same"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"account number at the same bank twice is rejected here."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"LRS bank accounts are not returned by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /customer/{id}/bank-accounts"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and a bank account from"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /customer/{id}/bank-accounts"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" cannot be used as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"lrs.bank_account_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The account number is returned in full, as sent."},"children":[]}]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_7","description":"The ID of the customer","required":true,"example":"cust_68468bfcxaGo2"}],"pointer":"/paths/~1customer~1{id}~1bank_account/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/LrsCustomerBankAccount","exampleIds":["paths/~1customer~1{id}~1bank_account/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/LrsCustomerBankAccount","exampleIds":["paths/~1customer~1{id}~1bank_account/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1customer~1{id}~1bank_account/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/customer/{id}/bank_account","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"cust_68468bfcxaGo2","schemaId":"schema_7"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/LrsCustomerBankAccount","exampleIds":["paths/~1customer~1{id}~1bank_account/post/requestBody/content/application~1json/example"]}},"responseCodes":["201","400","401"],"pointer":"/customer/{id}/bank_account","href":"lrs/createlrscustomerbankaccount","openApiOperationId":"createLrsCustomerBankAccount","summary":"Register a customer's LRS bank account"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"schemaId":"components/schemas/LrsCustomerBankAccount","exampleIds":["paths/~1customer~1{id}~1bank_account/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/LrsCustomerBankAccount","exampleIds":["paths/~1customer~1{id}~1bank_account/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"LRS bank account registered","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/LrsCustomerBankAccount","exampleIds":["paths/~1customer~1{id}~1bank_account/post/responses/201/content/application~1json/example"]}},"schemaId":"components/schemas/LrsCustomerBankAccount","exampleIds":["paths/~1customer~1{id}~1bank_account/post/responses/201/content/application~1json/example"]},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bad Request — "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bank_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"account_number"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is missing, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bank_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not a value returned by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /lrs/banks"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for your account, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"account_number"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not all digits or its length is outside the range the bank accepts, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bank_customer_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not all digits or its length is outside the range the bank accepts, the customer does not exist on your account, or the same account number is already registered for this customer at the same bank."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_79","exampleIds":["paths/~1customer~1{id}~1bank_account/post/responses/400/content/application~1json/examples/account_number_missing","paths/~1customer~1{id}~1bank_account/post/responses/400/content/application~1json/examples/bank_code_not_valid","paths/~1customer~1{id}~1bank_account/post/responses/400/content/application~1json/examples/bank_code_not_enabled","paths/~1customer~1{id}~1bank_account/post/responses/400/content/application~1json/examples/bank_customer_id_not_digits","paths/~1customer~1{id}~1bank_account/post/responses/400/content/application~1json/examples/customer_not_found","paths/~1customer~1{id}~1bank_account/post/responses/400/content/application~1json/examples/duplicate_account"]}},"schemaId":"schema_79","exampleIds":["paths/~1customer~1{id}~1bank_account/post/responses/400/content/application~1json/examples/account_number_missing","paths/~1customer~1{id}~1bank_account/post/responses/400/content/application~1json/examples/bank_code_not_valid","paths/~1customer~1{id}~1bank_account/post/responses/400/content/application~1json/examples/bank_code_not_enabled","paths/~1customer~1{id}~1bank_account/post/responses/400/content/application~1json/examples/bank_customer_id_not_digits","paths/~1customer~1{id}~1bank_account/post/responses/400/content/application~1json/examples/customer_not_found","paths/~1customer~1{id}~1bank_account/post/responses/400/content/application~1json/examples/duplicate_account"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized — invalid or missing authentication token"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_14"}},"schemaId":"schema_14"}],"pointer":"/paths/~1customer~1{id}~1bank_account/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/LrsCustomerBankAccount","exampleIds":["paths/~1customer~1{id}~1bank_account/post/responses/201/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/LrsCustomerBankAccount","exampleIds":["paths/~1customer~1{id}~1bank_account/post/responses/201/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_79","exampleIds":["paths/~1customer~1{id}~1bank_account/post/responses/400/content/application~1json/examples/account_number_missing","paths/~1customer~1{id}~1bank_account/post/responses/400/content/application~1json/examples/bank_code_not_valid","paths/~1customer~1{id}~1bank_account/post/responses/400/content/application~1json/examples/bank_code_not_enabled","paths/~1customer~1{id}~1bank_account/post/responses/400/content/application~1json/examples/bank_customer_id_not_digits","paths/~1customer~1{id}~1bank_account/post/responses/400/content/application~1json/examples/customer_not_found","paths/~1customer~1{id}~1bank_account/post/responses/400/content/application~1json/examples/duplicate_account"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_79","exampleIds":["paths/~1customer~1{id}~1bank_account/post/responses/400/content/application~1json/examples/account_number_missing","paths/~1customer~1{id}~1bank_account/post/responses/400/content/application~1json/examples/bank_code_not_valid","paths/~1customer~1{id}~1bank_account/post/responses/400/content/application~1json/examples/bank_code_not_enabled","paths/~1customer~1{id}~1bank_account/post/responses/400/content/application~1json/examples/bank_customer_id_not_digits","paths/~1customer~1{id}~1bank_account/post/responses/400/content/application~1json/examples/customer_not_found","paths/~1customer~1{id}~1bank_account/post/responses/400/content/application~1json/examples/duplicate_account"]}}},{"code":"401","schemaId":"schema_14","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_14"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/lrs/createlrscustomerbankaccount"}],"panels":[]}]},"httpPath":"/customer/{id}/bank_account"},{"label":"List a customer's LRS bank accounts","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/lrs/getlrscustomerbankaccounts","routeSlug":"/api-reference/openapi/lrs/getlrscustomerbankaccounts","metadata":{"seo":{"title":"List a customer's LRS bank accounts","description":"Returns the LRS bank accounts stored against a customer, including those registered with POST /customer/{id}/bank_account. Account numbers are returned in full. May include accounts added through other flows, with IDs that do not start with acclrs_. Extra fields can include the account holder's name and internal verification data; treat them as sensitive and don't rely on them."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getLrsCustomerBankAccounts","name":"List a customer's LRS bank accounts","isWebhook":false,"pointer":"/paths/~1customer~1{id}~1bank_account/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List a customer's LRS bank accounts","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":"Returns the LRS bank accounts stored against a customer, including those registered with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /customer/{id}/bank_account"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Account numbers are returned in full. May include accounts added through other flows, with IDs that do not start with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"acclrs_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Extra fields can include the account holder's name and internal verification data; treat them as sensitive and don't rely on them."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_7","description":"The ID of the customer","required":true,"example":"cust_68468bfcxaGo2"}],"pointer":"/paths/~1customer~1{id}~1bank_account/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/customer/{id}/bank_account","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"cust_68468bfcxaGo2","schemaId":"schema_7"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","400","401"],"pointer":"/customer/{id}/bank_account","href":"lrs/getlrscustomerbankaccounts","openApiOperationId":"getLrsCustomerBankAccounts","summary":"List a customer's LRS bank accounts"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"LRS bank accounts retrieved. Empty when the customer has none.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_80","exampleIds":["paths/~1customer~1{id}~1bank_account/get/responses/200/content/application~1json/example"]}},"schemaId":"schema_80","exampleIds":["paths/~1customer~1{id}~1bank_account/get/responses/200/content/application~1json/example"]},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bad Request — the customer does not exist on your account."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_81"}},"schemaId":"schema_81"},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized — invalid or missing authentication token"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_14"}},"schemaId":"schema_14"}],"pointer":"/paths/~1customer~1{id}~1bank_account/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_80","exampleIds":["paths/~1customer~1{id}~1bank_account/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_80","exampleIds":["paths/~1customer~1{id}~1bank_account/get/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_81","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_81"}}},{"code":"401","schemaId":"schema_14","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_14"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/lrs/getlrscustomerbankaccounts"}],"panels":[]}]},"httpPath":"/customer/{id}/bank_account"},{"label":"Retrieve a customer's LRS bank account","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/lrs/getlrscustomerbankaccountbyid","routeSlug":"/api-reference/openapi/lrs/getlrscustomerbankaccountbyid","metadata":{"seo":{"title":"Retrieve a customer's LRS bank account","description":"Returns one LRS bank account stored against a customer. The account number is returned in full. May include accounts added through other flows, with IDs that do not start with acclrs_. Extra fields can include the account holder's name and internal verification data; treat them as sensitive and don't rely on them."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getLrsCustomerBankAccountById","name":"Retrieve a customer's LRS bank account","isWebhook":false,"pointer":"/paths/~1customer~1{id}~1bank_account~1{bank_account_id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve a customer's LRS bank account","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":"Returns one LRS bank account stored against a customer. The account number is returned in full. May include accounts added through other flows, with IDs that do not start with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"acclrs_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Extra fields can include the account holder's name and internal verification data; treat them as sensitive and don't rely on them."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_7","description":"The ID of the customer","required":true,"example":"cust_68468bfcxaGo2"},{"name":"bank_account_id","in":"path","schemaId":"schema_7","description":"The ID of the LRS bank account","required":true,"example":"acclrs_68468c03g9xt7"}],"pointer":"/paths/~1customer~1{id}~1bank_account~1{bank_account_id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/customer/{id}/bank_account/{bank_account_id}","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"cust_68468bfcxaGo2","schemaId":"schema_7"},{"name":"bank_account_id","in":"path","required":true,"example":"acclrs_68468c03g9xt7","schemaId":"schema_7"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","400","401","404"],"pointer":"/customer/{id}/bank_account/{bank_account_id}","href":"lrs/getlrscustomerbankaccountbyid","openApiOperationId":"getLrsCustomerBankAccountById","summary":"Retrieve a customer's LRS bank account"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"LRS bank account retrieved","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/LrsCustomerBankAccount","exampleIds":["paths/~1customer~1{id}~1bank_account~1{bank_account_id}/get/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/LrsCustomerBankAccount","exampleIds":["paths/~1customer~1{id}~1bank_account~1{bank_account_id}/get/responses/200/content/application~1json/example"]},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bad Request — the customer does not exist on your account."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_81"}},"schemaId":"schema_81"},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized — invalid or missing authentication token"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_14"}},"schemaId":"schema_14"},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Not Found — the customer has no bank account with this ID."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_82"}},"schemaId":"schema_82"}],"pointer":"/paths/~1customer~1{id}~1bank_account~1{bank_account_id}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/LrsCustomerBankAccount","exampleIds":["paths/~1customer~1{id}~1bank_account~1{bank_account_id}/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/LrsCustomerBankAccount","exampleIds":["paths/~1customer~1{id}~1bank_account~1{bank_account_id}/get/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_81","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_81"}}},{"code":"401","schemaId":"schema_14","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_14"}}},{"code":"404","schemaId":"schema_82","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_82"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/lrs/getlrscustomerbankaccountbyid"}],"panels":[]}]},"httpPath":"/customer/{id}/bank_account/{bank_account_id}"},{"label":"Update the bank customer ID on an LRS bank account","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/lrs/updatelrscustomerbankaccount","routeSlug":"/api-reference/openapi/lrs/updatelrscustomerbankaccount","metadata":{"seo":{"title":"Update the bank customer ID on an LRS bank account","description":"Sets bank_customer_id on a customer's LRS bank account, for example to correct a value the customer entered wrongly. Any existing value is replaced. The value is checked against the rules of the account's bank."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateLrsCustomerBankAccount","name":"Update the bank customer ID on an LRS bank account","isWebhook":false,"pointer":"/paths/~1customer~1{id}~1bank_account~1{bank_account_id}/patch","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update the bank customer ID on an LRS bank account","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":"Sets "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bank_customer_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on a customer's LRS bank account, for example to correct a value the customer entered wrongly. Any existing value is replaced. The value is checked against the rules of the account's bank."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_7","description":"The ID of the customer","required":true,"example":"cust_68468bfcxaGo2"},{"name":"bank_account_id","in":"path","schemaId":"schema_7","description":"The ID of the LRS bank account","required":true,"example":"acclrs_68468c03g9xt7"}],"pointer":"/paths/~1customer~1{id}~1bank_account~1{bank_account_id}/patch/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_83","exampleIds":["paths/~1customer~1{id}~1bank_account~1{bank_account_id}/patch/requestBody/content/application~1json/example"]}},"schemaId":"schema_83","exampleIds":["paths/~1customer~1{id}~1bank_account~1{bank_account_id}/patch/requestBody/content/application~1json/example"],"pointer":"/paths/~1customer~1{id}~1bank_account~1{bank_account_id}/patch/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/customer/{id}/bank_account/{bank_account_id}","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"cust_68468bfcxaGo2","schemaId":"schema_7"},{"name":"bank_account_id","in":"path","required":true,"example":"acclrs_68468c03g9xt7","schemaId":"schema_7"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_83","exampleIds":["paths/~1customer~1{id}~1bank_account~1{bank_account_id}/patch/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","401","404"],"pointer":"/customer/{id}/bank_account/{bank_account_id}","href":"lrs/updatelrscustomerbankaccount","openApiOperationId":"updateLrsCustomerBankAccount","summary":"Update the bank customer ID on an LRS bank account"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"schemaId":"schema_83","exampleIds":["paths/~1customer~1{id}~1bank_account~1{bank_account_id}/patch/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_83","exampleIds":["paths/~1customer~1{id}~1bank_account~1{bank_account_id}/patch/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Bank customer ID updated","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/LrsCustomerBankAccount","exampleIds":["paths/~1customer~1{id}~1bank_account~1{bank_account_id}/patch/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/LrsCustomerBankAccount","exampleIds":["paths/~1customer~1{id}~1bank_account~1{bank_account_id}/patch/responses/200/content/application~1json/example"]},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bad Request — the customer does not exist on your account, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bank_customer_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is missing for a bank that uses one, or it is not all digits or its length is outside the range the bank accepts."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_84","exampleIds":["paths/~1customer~1{id}~1bank_account~1{bank_account_id}/patch/responses/400/content/application~1json/examples/customer_not_found","paths/~1customer~1{id}~1bank_account~1{bank_account_id}/patch/responses/400/content/application~1json/examples/bank_customer_id_missing","paths/~1customer~1{id}~1bank_account~1{bank_account_id}/patch/responses/400/content/application~1json/examples/bank_customer_id_not_digits"]}},"schemaId":"schema_84","exampleIds":["paths/~1customer~1{id}~1bank_account~1{bank_account_id}/patch/responses/400/content/application~1json/examples/customer_not_found","paths/~1customer~1{id}~1bank_account~1{bank_account_id}/patch/responses/400/content/application~1json/examples/bank_customer_id_missing","paths/~1customer~1{id}~1bank_account~1{bank_account_id}/patch/responses/400/content/application~1json/examples/bank_customer_id_not_digits"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized — invalid or missing authentication token"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_14"}},"schemaId":"schema_14"},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Not Found — the customer has no bank account with this ID."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_82"}},"schemaId":"schema_82"}],"pointer":"/paths/~1customer~1{id}~1bank_account~1{bank_account_id}/patch/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/LrsCustomerBankAccount","exampleIds":["paths/~1customer~1{id}~1bank_account~1{bank_account_id}/patch/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/LrsCustomerBankAccount","exampleIds":["paths/~1customer~1{id}~1bank_account~1{bank_account_id}/patch/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_84","exampleIds":["paths/~1customer~1{id}~1bank_account~1{bank_account_id}/patch/responses/400/content/application~1json/examples/customer_not_found","paths/~1customer~1{id}~1bank_account~1{bank_account_id}/patch/responses/400/content/application~1json/examples/bank_customer_id_missing","paths/~1customer~1{id}~1bank_account~1{bank_account_id}/patch/responses/400/content/application~1json/examples/bank_customer_id_not_digits"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_84","exampleIds":["paths/~1customer~1{id}~1bank_account~1{bank_account_id}/patch/responses/400/content/application~1json/examples/customer_not_found","paths/~1customer~1{id}~1bank_account~1{bank_account_id}/patch/responses/400/content/application~1json/examples/bank_customer_id_missing","paths/~1customer~1{id}~1bank_account~1{bank_account_id}/patch/responses/400/content/application~1json/examples/bank_customer_id_not_digits"]}}},{"code":"401","schemaId":"schema_14","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_14"}}},{"code":"404","schemaId":"schema_82","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_82"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/lrs/updatelrscustomerbankaccount"}],"panels":[]}]},"httpPath":"/customer/{id}/bank_account/{bank_account_id}"},{"label":"Create an LRS quote","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/lrs/createlrsquote","routeSlug":"/api-reference/openapi/lrs/createlrsquote","metadata":{"seo":{"title":"Create an LRS quote","description":"Creates a quote for an LRS remittance (resource: payin) or an LRS withdrawal (resource: payout). Use it to show the customer the exchange rate, the GST and the converted amount before they proceed. Payout quotes expire 30 minutes after they are created; for a payin quote, rely on the returned expires_at."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createLrsQuote","name":"Create an LRS quote","isWebhook":false,"pointer":"/paths/~1lrs~1quotes/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create an LRS quote","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":"Creates a quote for an LRS remittance ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"resource: payin"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") or an LRS withdrawal ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"resource: payout"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). Use it to show the customer the exchange rate, the GST and the converted amount before they proceed. Payout quotes expire 30 minutes after they are created; for a payin quote, rely on the returned "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_at"},"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":"This is not the same endpoint as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /quotes"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"createQuote"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). To create an LRS order, pass the payin quote's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"lrs.lrs_quote_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /orders"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"USD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" equal to the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"USD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" side of the quote: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"from.amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"USD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"to.amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when it is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INR"},"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":"For a payin quote, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bank_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is required and must be a bank enabled for your account (see "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /lrs/banks"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). Either direction between "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INR"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"USD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is supported. For a payout quote, only "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"USD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INR"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is supported and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bank_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" must not be sent. LRS must be enabled for your account."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateLrsQuoteRequest","exampleIds":["paths/~1lrs~1quotes/post/requestBody/content/application~1json/examples/payin_inr_to_usd","paths/~1lrs~1quotes/post/requestBody/content/application~1json/examples/payout_usd_to_inr"]}},"schemaId":"components/schemas/CreateLrsQuoteRequest","exampleIds":["paths/~1lrs~1quotes/post/requestBody/content/application~1json/examples/payin_inr_to_usd","paths/~1lrs~1quotes/post/requestBody/content/application~1json/examples/payout_usd_to_inr"],"pointer":"/paths/~1lrs~1quotes/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/lrs/quotes","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateLrsQuoteRequest","exampleIds":["paths/~1lrs~1quotes/post/requestBody/content/application~1json/examples/payin_inr_to_usd","paths/~1lrs~1quotes/post/requestBody/content/application~1json/examples/payout_usd_to_inr"]}},"responseCodes":["201","400","401","422"],"pointer":"/lrs/quotes","href":"lrs/createlrsquote","openApiOperationId":"createLrsQuote","summary":"Create an LRS quote"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"schemaId":"components/schemas/CreateLrsQuoteRequest","exampleIds":["paths/~1lrs~1quotes/post/requestBody/content/application~1json/examples/payin_inr_to_usd","paths/~1lrs~1quotes/post/requestBody/content/application~1json/examples/payout_usd_to_inr"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateLrsQuoteRequest","exampleIds":["paths/~1lrs~1quotes/post/requestBody/content/application~1json/examples/payin_inr_to_usd","paths/~1lrs~1quotes/post/requestBody/content/application~1json/examples/payout_usd_to_inr"]}},"examples":[{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Quote created","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/LrsQuote","exampleIds":["paths/~1lrs~1quotes/post/responses/201/content/application~1json/examples/payin_inr_to_usd","paths/~1lrs~1quotes/post/responses/201/content/application~1json/examples/payout_usd_to_inr"]}},"schemaId":"components/schemas/LrsQuote","exampleIds":["paths/~1lrs~1quotes/post/responses/201/content/application~1json/examples/payin_inr_to_usd","paths/~1lrs~1quotes/post/responses/201/content/application~1json/examples/payout_usd_to_inr"]},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bad Request — a required field is missing, a currency is not "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INR"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"USD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", both currencies are the same, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not a whole number, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bank_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is missing on a payin quote or is not enabled for your account, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bank_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is sent on a payout quote, a payout quote is not "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"USD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INR"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", the amount on a payin quote is outside the bank's limits, the converted amount on a payout quote is outside the range a payout can be sent for, or LRS is not enabled for your account."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_85","exampleIds":["paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/bank_code_missing","paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/bank_code_not_enabled","paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/currency_not_supported","paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/same_currency","paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/amount_not_integer","paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/below_minimum","paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/above_maximum","paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/bank_code_on_payout","paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/payout_corridor","paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/payout_no_options"]}},"schemaId":"schema_85","exampleIds":["paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/bank_code_missing","paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/bank_code_not_enabled","paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/currency_not_supported","paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/same_currency","paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/amount_not_integer","paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/below_minimum","paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/above_maximum","paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/bank_code_on_payout","paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/payout_corridor","paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/payout_no_options"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized — invalid or missing authentication token"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_14"}},"schemaId":"schema_14"},{"code":"422","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unprocessable Entity — no exchange rate is available for the bank right now."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_86"}},"schemaId":"schema_86"}],"pointer":"/paths/~1lrs~1quotes/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/LrsQuote","exampleIds":["paths/~1lrs~1quotes/post/responses/201/content/application~1json/examples/payin_inr_to_usd","paths/~1lrs~1quotes/post/responses/201/content/application~1json/examples/payout_usd_to_inr"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/LrsQuote","exampleIds":["paths/~1lrs~1quotes/post/responses/201/content/application~1json/examples/payin_inr_to_usd","paths/~1lrs~1quotes/post/responses/201/content/application~1json/examples/payout_usd_to_inr"]}}},{"code":"400","schemaId":"schema_85","exampleIds":["paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/bank_code_missing","paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/bank_code_not_enabled","paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/currency_not_supported","paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/same_currency","paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/amount_not_integer","paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/below_minimum","paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/above_maximum","paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/bank_code_on_payout","paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/payout_corridor","paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/payout_no_options"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_85","exampleIds":["paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/bank_code_missing","paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/bank_code_not_enabled","paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/currency_not_supported","paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/same_currency","paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/amount_not_integer","paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/below_minimum","paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/above_maximum","paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/bank_code_on_payout","paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/payout_corridor","paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/payout_no_options"]}}},{"code":"401","schemaId":"schema_14","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_14"}}},{"code":"422","schemaId":"schema_86","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_86"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/lrs/createlrsquote"}],"panels":[]}]},"httpPath":"/lrs/quotes"},{"label":"Retrieve an LRS quote","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/lrs/getlrsquotebyid","routeSlug":"/api-reference/openapi/lrs/getlrsquotebyid","metadata":{"seo":{"title":"Retrieve an LRS quote","description":"Returns any quote on your account by ID. Quotes created with POST /quotes also resolve here, in this shape. Use expires_at to check whether an LRS quote can still be used for an LRS order."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getLrsQuoteById","name":"Retrieve an LRS quote","isWebhook":false,"pointer":"/paths/~1lrs~1quotes~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve an LRS quote","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":"Returns any quote on your account by ID. Quotes created with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /quotes"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" also resolve here, in this shape. Use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_at"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to check whether an LRS quote can still be used for an LRS order."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_7","description":"The ID of the quote","required":true,"example":"quote_6ab60de4Kx7Pq"}],"pointer":"/paths/~1lrs~1quotes~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/lrs/quotes/{id}","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"quote_6ab60de4Kx7Pq","schemaId":"schema_7"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","401","404"],"pointer":"/lrs/quotes/{id}","href":"lrs/getlrsquotebyid","openApiOperationId":"getLrsQuoteById","summary":"Retrieve an LRS quote"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Quote retrieved","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/LrsQuote","exampleIds":["paths/~1lrs~1quotes~1{id}/get/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/LrsQuote","exampleIds":["paths/~1lrs~1quotes~1{id}/get/responses/200/content/application~1json/example"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized — invalid or missing authentication token"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_14"}},"schemaId":"schema_14"},{"code":"404","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Not Found — no quote with this ID exists on your account."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_87"}},"schemaId":"schema_87"}],"pointer":"/paths/~1lrs~1quotes~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/LrsQuote","exampleIds":["paths/~1lrs~1quotes~1{id}/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/LrsQuote","exampleIds":["paths/~1lrs~1quotes~1{id}/get/responses/200/content/application~1json/example"]}}},{"code":"401","schemaId":"schema_14","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_14"}}},{"code":"404","schemaId":"schema_87","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_87"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/lrs/getlrsquotebyid"}],"panels":[]}]},"httpPath":"/lrs/quotes/{id}"},{"label":"List LRS banks","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/lrs/getlrsbanks","routeSlug":"/api-reference/openapi/lrs/getlrsbanks","metadata":{"seo":{"title":"List LRS banks","description":"Returns the banks your customers can remit from under LRS. Only banks enabled for your account are listed, so the list can be empty. Use a bank_code from this list when you register a customer's LRS bank account and when you create an LRS payin quote."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getLrsBanks","name":"List LRS banks","isWebhook":false,"pointer":"/paths/~1lrs~1banks/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List LRS banks","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":"Returns the banks your customers can remit from under LRS. Only banks enabled for your account are listed, so the list can be empty. Use a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bank_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" from this list when you register a customer's LRS bank account and when you create an LRS payin quote."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/lrs/banks","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","401"],"pointer":"/lrs/banks","href":"lrs/getlrsbanks","openApiOperationId":"getLrsBanks","summary":"List LRS banks"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Banks enabled for LRS on your account","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_88","exampleIds":["paths/~1lrs~1banks/get/responses/200/content/application~1json/example"]}},"schemaId":"schema_88","exampleIds":["paths/~1lrs~1banks/get/responses/200/content/application~1json/example"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized — invalid or missing authentication token"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_14"}},"schemaId":"schema_14"}],"pointer":"/paths/~1lrs~1banks/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_88","exampleIds":["paths/~1lrs~1banks/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_88","exampleIds":["paths/~1lrs~1banks/get/responses/200/content/application~1json/example"]}}},{"code":"401","schemaId":"schema_14","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_14"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/lrs/getlrsbanks"}],"panels":[]}]},"httpPath":"/lrs/banks"}],"content":{"contentType":"group","meta":{"name":"lrs"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"LRS","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":"Operations for remittances from customers resident in India under the Liberalised Remittance Scheme (LRS): the banks your customers can remit from, the customer's LRS bank account, and the LRS quote an LRS order is created from. See the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/payin/resident-india-remittance-under-lrs/set-up"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"LRS guide"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for the end-to-end flow."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/customer/{id}/bank_account","summary":"Register a customer's LRS bank account","prefix":{"name":"post","color":"post"},"badges":[],"link":"/lrs/createlrscustomerbankaccount","deprecated":false},{"title":"/customer/{id}/bank_account","summary":"List a customer's LRS bank accounts","prefix":{"name":"get","color":"get"},"badges":[],"link":"/lrs/getlrscustomerbankaccounts","deprecated":false},{"title":"/customer/{id}/bank_account/{bank_account_id}","summary":"Retrieve a customer's LRS bank account","prefix":{"name":"get","color":"get"},"badges":[],"link":"/lrs/getlrscustomerbankaccountbyid","deprecated":false},{"title":"/customer/{id}/bank_account/{bank_account_id}","summary":"Update the bank customer ID on an LRS bank account","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/lrs/updatelrscustomerbankaccount","deprecated":false},{"title":"/lrs/quotes","summary":"Create an LRS quote","prefix":{"name":"post","color":"post"},"badges":[],"link":"/lrs/createlrsquote","deprecated":false},{"title":"/lrs/quotes/{id}","summary":"Retrieve an LRS quote","prefix":{"name":"get","color":"get"},"badges":[],"link":"/lrs/getlrsquotebyid","deprecated":false},{"title":"/lrs/banks","summary":"List LRS banks","prefix":{"name":"get","color":"get"},"badges":[],"link":"/lrs/getlrsbanks","deprecated":false}]}]}]}]}},{"type":"separator","label":"Subscription","content":null},{"type":"group","label":"Subscription","link":"/api-reference/openapi/subscription","routeSlug":"/api-reference/openapi/subscription","items":[{"type":"link","label":"Subscription","link":"/api-reference/openapi/subscription/subscription","routeSlug":"/api-reference/openapi/subscription/subscription","httpVerb":"schema","content":{"contentType":"item","itemVariant":"schema","meta":{"name":"Subscription"},"seo":{"title":"Subscription"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Subscription","showPageActions":true}],"panels":[]},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"schemaDefinition","attributes":{"showWriteOnly":true,"schemaRef":"#/components/schemas/Subscription"},"children":[]}]}]}},{"type":"link","label":"CreateSubscriptionResponse","link":"/api-reference/openapi/subscription/createsubscriptionresponse","routeSlug":"/api-reference/openapi/subscription/createsubscriptionresponse","httpVerb":"schema","content":{"contentType":"item","itemVariant":"schema","meta":{"name":"CreateSubscriptionResponse"},"seo":{"title":"CreateSubscriptionResponse"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"CreateSubscriptionResponse","showPageActions":true}],"panels":[]},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"schemaDefinition","attributes":{"showWriteOnly":true,"schemaRef":"#/components/schemas/CreateSubscriptionResponse"},"children":[]}]}]}},{"label":"List subscriptions","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/subscription/getsubscriptions","routeSlug":"/api-reference/openapi/subscription/getsubscriptions","metadata":{"seo":{"title":"List subscriptions","description":"Returns a list of subscriptions matching some criteria. The subscriptions are returned sorted by creation date, with the most recent subscriptions appearing first."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getSubscriptions","name":"List subscriptions","isWebhook":false,"pointer":"/paths/~1subscriptions/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List subscriptions","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns a list of subscriptions matching some criteria. The subscriptions are returned sorted by creation date, with the most recent subscriptions appearing first.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"status","in":"query","schemaId":"schema_89","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter subscriptions by status. Uses the same values as the subscription's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field."},"children":[]}]}]}],"example":"active"},{"name":"customer_id","in":"query","schemaId":"schema_7","description":"Filter subscriptions by customer ID.","example":"cust_5JU9yv0lGSUP"},{"name":"start_date","in":"query","schemaId":"schema_90","description":"Filter subscriptions with a particular start date, in UTC timezone and ISO 8601 format (YYYY-MM-DD).","example":"2024-01-01"},{"name":"end_date","in":"query","schemaId":"schema_90","description":"Filter subscriptions with a particular end date, in UTC timezone and ISO 8601 format (YYYY-MM-DD).","example":"2024-12-31"},{"name":"before","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return only resources created at or before this time. Send an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_8601"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" timestamp with an offset, such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-02-18T12:03:44Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-02-18T17:33:44+05:30"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A timestamp without an offset is read as UTC. A bare date ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") means the end of that day in UTC ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"23:59:59.999999Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). An invalid value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Use this to avoid page drift. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/platform/pagination#parameters"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameters"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"example":"2025-02-18T12:03:44Z"},{"name":"after","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return only resources created at or after this time. Send an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_8601"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" timestamp with an offset, such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-01-18T12:03:44Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-01-18T17:33:44+05:30"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A timestamp without an offset is read as UTC. A bare date ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") means the start of that day in UTC ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"00:00:00Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). An invalid value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Use this to avoid page drift. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/platform/pagination#parameters"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameters"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"example":"2025-01-18T12:03:44Z"},{"name":"per_page","in":"query","schemaId":"schema_8","description":"Number of resources per page. Should be between 1 and 100."},{"name":"page","in":"query","schemaId":"schema_9","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Page number for pagination. Starts from 1. Get the next page number from the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"next"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field in the response."},"children":[]}]}]}]}],"pointer":"/paths/~1subscriptions/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/subscriptions","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"status","in":"query","example":"active","schemaId":"schema_89"},{"name":"customer_id","in":"query","example":"cust_5JU9yv0lGSUP","schemaId":"schema_7"},{"name":"start_date","in":"query","example":"2024-01-01","schemaId":"schema_90"},{"name":"end_date","in":"query","example":"2024-12-31","schemaId":"schema_90"},{"name":"before","in":"query","example":"2025-02-18T12:03:44Z","schemaId":"schema_7"},{"name":"after","in":"query","example":"2025-01-18T12:03:44Z","schemaId":"schema_7"},{"name":"per_page","in":"query","schemaId":"schema_8"},{"name":"page","in":"query","schemaId":"schema_9"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","400"],"pointer":"/subscriptions","href":"subscription/getsubscriptions","openApiOperationId":"getSubscriptions","summary":"List subscriptions"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"List of subscriptions matching the criteria.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_91"}},"schemaId":"schema_91"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_92"}},"schemaId":"schema_92"}],"pointer":"/paths/~1subscriptions/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_91","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_91"}}},{"code":"400","schemaId":"schema_92","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_92"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/subscription/getsubscriptions"}],"panels":[]}]},"httpPath":"/subscriptions"},{"label":"Create a new subscription","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/subscription/createsubscription","routeSlug":"/api-reference/openapi/subscription/createsubscription","metadata":{"seo":{"title":"Create a new subscription","description":"Creates a new subscription for a customer with specified billing plan and schedule. The subscription will be created in 'created' status and will be activated when the customer completes the first payment."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createSubscription","name":"Create a new subscription","isWebhook":false,"pointer":"/paths/~1subscriptions/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a new subscription","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":"Creates a new subscription for a customer with specified billing plan and schedule. The subscription will be created in 'created' status and will be activated when the customer completes the first payment."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"On an "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"as_presented"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" subscription, pass "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"split_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to declare your share of a dynamic pricing rule's fee. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#tag/pricing_split"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Dynamic Fee Split"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The declaration applies to the first payment and to every subsequent auto debit that does not pass "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"split_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of its own. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"split_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is rejected on a fixed-frequency subscription, because a fixed-frequency plan auto debits without you and so has no point at which to pass a split or replace one that goes stale."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If the subscription's declaration later stops resolving — Glomo deleted the underlying rule, or the rule is no longer dynamic — the next auto debit is rejected with a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" until you pass a valid "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"split_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#tag/Payment"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create a payment"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateSubscriptionRequest","exampleIds":["paths/~1subscriptions/post/requestBody/content/application~1json/examples/monthly_subscription","paths/~1subscriptions/post/requestBody/content/application~1json/examples/as_presented_subscription","paths/~1subscriptions/post/requestBody/content/application~1json/examples/as_presented_subscription_with_splits"]}},"schemaId":"components/schemas/CreateSubscriptionRequest","exampleIds":["paths/~1subscriptions/post/requestBody/content/application~1json/examples/monthly_subscription","paths/~1subscriptions/post/requestBody/content/application~1json/examples/as_presented_subscription","paths/~1subscriptions/post/requestBody/content/application~1json/examples/as_presented_subscription_with_splits"],"pointer":"/paths/~1subscriptions/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/subscriptions","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateSubscriptionRequest","exampleIds":["paths/~1subscriptions/post/requestBody/content/application~1json/examples/monthly_subscription","paths/~1subscriptions/post/requestBody/content/application~1json/examples/as_presented_subscription","paths/~1subscriptions/post/requestBody/content/application~1json/examples/as_presented_subscription_with_splits"]}},"responseCodes":["201","400"],"pointer":"/subscriptions","href":"subscription/createsubscription","openApiOperationId":"createSubscription","summary":"Create a new subscription"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"schemaId":"components/schemas/CreateSubscriptionRequest","exampleIds":["paths/~1subscriptions/post/requestBody/content/application~1json/examples/monthly_subscription","paths/~1subscriptions/post/requestBody/content/application~1json/examples/as_presented_subscription","paths/~1subscriptions/post/requestBody/content/application~1json/examples/as_presented_subscription_with_splits"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateSubscriptionRequest","exampleIds":["paths/~1subscriptions/post/requestBody/content/application~1json/examples/monthly_subscription","paths/~1subscriptions/post/requestBody/content/application~1json/examples/as_presented_subscription","paths/~1subscriptions/post/requestBody/content/application~1json/examples/as_presented_subscription_with_splits"]}},"examples":[{},{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Subscription created successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CreateSubscriptionResponse"}},"schemaId":"components/schemas/CreateSubscriptionResponse"},{"code":"400","description":"Bad Request - validation error or invalid parameters","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_93","exampleIds":["paths/~1subscriptions/post/responses/400/content/application~1json/examples/customer_not_found","paths/~1subscriptions/post/responses/400/content/application~1json/examples/split_ids_on_fixed_frequency","paths/~1subscriptions/post/responses/400/content/application~1json/examples/split_ids_unresolved","paths/~1subscriptions/post/responses/400/content/application~1json/examples/split_ids_incomplete"]}},"schemaId":"schema_93","exampleIds":["paths/~1subscriptions/post/responses/400/content/application~1json/examples/customer_not_found","paths/~1subscriptions/post/responses/400/content/application~1json/examples/split_ids_on_fixed_frequency","paths/~1subscriptions/post/responses/400/content/application~1json/examples/split_ids_unresolved","paths/~1subscriptions/post/responses/400/content/application~1json/examples/split_ids_incomplete"]}],"pointer":"/paths/~1subscriptions/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/CreateSubscriptionResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CreateSubscriptionResponse"}}},{"code":"400","schemaId":"schema_93","exampleIds":["paths/~1subscriptions/post/responses/400/content/application~1json/examples/customer_not_found","paths/~1subscriptions/post/responses/400/content/application~1json/examples/split_ids_on_fixed_frequency","paths/~1subscriptions/post/responses/400/content/application~1json/examples/split_ids_unresolved","paths/~1subscriptions/post/responses/400/content/application~1json/examples/split_ids_incomplete"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_93","exampleIds":["paths/~1subscriptions/post/responses/400/content/application~1json/examples/customer_not_found","paths/~1subscriptions/post/responses/400/content/application~1json/examples/split_ids_on_fixed_frequency","paths/~1subscriptions/post/responses/400/content/application~1json/examples/split_ids_unresolved","paths/~1subscriptions/post/responses/400/content/application~1json/examples/split_ids_incomplete"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/subscription/createsubscription"}],"panels":[]}]},"httpPath":"/subscriptions"},{"label":"Retrieve a subscription by ID","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/subscription/getsubscriptionbyid","routeSlug":"/api-reference/openapi/subscription/getsubscriptionbyid","metadata":{"seo":{"title":"Retrieve a subscription by ID","description":"Retrieves the details of a specific subscription by its unique identifier."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getSubscriptionById","name":"Retrieve a subscription by ID","isWebhook":false,"pointer":"/paths/~1subscriptions~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve a subscription by ID","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves the details of a specific subscription by its unique identifier.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unique identifier of the subscription. Starts with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sub_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" followed by letters and digits. An ID of any other shape is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and a message saying it must start with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sub_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; a well-formed ID that doesn't match a subscription on your account returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"404"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true,"example":"sub_5JU9yv0lGSUP"}],"pointer":"/paths/~1subscriptions~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/subscriptions/{id}","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"sub_5JU9yv0lGSUP","schemaId":"schema_7"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/subscriptions/{id}","href":"subscription/getsubscriptionbyid","openApiOperationId":"getSubscriptionById","summary":"Retrieve a subscription by ID"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Subscription details retrieved successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Subscription"}},"schemaId":"components/schemas/Subscription"},{"code":"404","description":"Subscription not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_94"}},"schemaId":"schema_94"}],"pointer":"/paths/~1subscriptions~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/Subscription","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Subscription"}}},{"code":"404","schemaId":"schema_94","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_94"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/subscription/getsubscriptionbyid"}],"panels":[]}]},"httpPath":"/subscriptions/{id}"},{"label":"Pause a subscription","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/subscription/pausesubscription","routeSlug":"/api-reference/openapi/subscription/pausesubscription","metadata":{"seo":{"title":"Pause a subscription","description":"Pauses an active subscription. While paused, the subscription will not process any payments. A paused subscription can be resumed later using the resume endpoint."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"pauseSubscription","name":"Pause a subscription","isWebhook":false,"pointer":"/paths/~1subscriptions~1{id}~1pause/patch","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Pause a subscription","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Pauses an active subscription. While paused, the subscription will not process any payments. A paused subscription can be resumed later using the resume endpoint.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unique identifier of the subscription to pause. Starts with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sub_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" followed by letters and digits. An ID of any other shape is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and a message saying it must start with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sub_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; a well-formed ID that doesn't match a subscription on your account returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"404"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true,"example":"sub_5JU9yv0lGSUP"}],"pointer":"/paths/~1subscriptions~1{id}~1pause/patch/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/subscriptions/{id}/pause","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"sub_5JU9yv0lGSUP","schemaId":"schema_7"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","400","404"],"pointer":"/subscriptions/{id}/pause","href":"subscription/pausesubscription","openApiOperationId":"pauseSubscription","summary":"Pause a subscription"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Subscription paused successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_95"}},"schemaId":"schema_95"},{"code":"400","description":"Bad Request - subscription cannot be paused from current state","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_96"}},"schemaId":"schema_96"},{"code":"404","description":"Subscription not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_94"}},"schemaId":"schema_94"}],"pointer":"/paths/~1subscriptions~1{id}~1pause/patch/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_95","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_95"}}},{"code":"400","schemaId":"schema_96","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_96"}}},{"code":"404","schemaId":"schema_94","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_94"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/subscription/pausesubscription"}],"panels":[]}]},"httpPath":"/subscriptions/{id}/pause"},{"label":"Resume a paused subscription","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/subscription/resumesubscription","routeSlug":"/api-reference/openapi/subscription/resumesubscription","metadata":{"seo":{"title":"Resume a paused subscription","description":"Resumes a paused subscription. Once resumed, the subscription will continue processing payments according to its original schedule. Only subscriptions in 'paused' status can be resumed."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"resumeSubscription","name":"Resume a paused subscription","isWebhook":false,"pointer":"/paths/~1subscriptions~1{id}~1resume/patch","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Resume a paused subscription","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Resumes a paused subscription. Once resumed, the subscription will continue processing payments according to its original schedule. Only subscriptions in 'paused' status can be resumed.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unique identifier of the subscription to resume. Starts with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sub_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" followed by letters and digits. An ID of any other shape is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and a message saying it must start with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sub_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; a well-formed ID that doesn't match a subscription on your account returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"404"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true,"example":"sub_5JU9yv0lGSUP"}],"pointer":"/paths/~1subscriptions~1{id}~1resume/patch/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/subscriptions/{id}/resume","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"sub_5JU9yv0lGSUP","schemaId":"schema_7"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","400","404"],"pointer":"/subscriptions/{id}/resume","href":"subscription/resumesubscription","openApiOperationId":"resumeSubscription","summary":"Resume a paused subscription"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Subscription resumed successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Subscription"}},"schemaId":"components/schemas/Subscription"},{"code":"400","description":"Bad Request - subscription cannot be resumed from current state","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_97"}},"schemaId":"schema_97"},{"code":"404","description":"Subscription not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_94"}},"schemaId":"schema_94"}],"pointer":"/paths/~1subscriptions~1{id}~1resume/patch/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/Subscription","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Subscription"}}},{"code":"400","schemaId":"schema_97","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_97"}}},{"code":"404","schemaId":"schema_94","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_94"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/subscription/resumesubscription"}],"panels":[]}]},"httpPath":"/subscriptions/{id}/resume"},{"label":"Cancel a subscription","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/subscription/cancelsubscription","routeSlug":"/api-reference/openapi/subscription/cancelsubscription","metadata":{"seo":{"title":"Cancel a subscription","description":"Cancels a subscription. Once cancelled, the subscription will stop processing future payments. This action cannot be undone, but you can create a new subscription if needed."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"cancelSubscription","name":"Cancel a subscription","isWebhook":false,"pointer":"/paths/~1subscriptions~1{id}~1cancel/patch","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Cancel a subscription","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Cancels a subscription. Once cancelled, the subscription will stop processing future payments. This action cannot be undone, but you can create a new subscription if needed.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unique identifier of the subscription to cancel. Starts with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sub_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" followed by letters and digits. An ID of any other shape is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and a message saying it must start with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sub_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; a well-formed ID that doesn't match a subscription on your account returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"404"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true,"example":"sub_5JU9yv0lGSUP"}],"pointer":"/paths/~1subscriptions~1{id}~1cancel/patch/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/subscriptions/{id}/cancel","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"sub_5JU9yv0lGSUP","schemaId":"schema_7"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","400","404"],"pointer":"/subscriptions/{id}/cancel","href":"subscription/cancelsubscription","openApiOperationId":"cancelSubscription","summary":"Cancel a subscription"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Subscription cancelled successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_98"}},"schemaId":"schema_98"},{"code":"400","description":"Bad Request - subscription cannot be cancelled from current state","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_99"}},"schemaId":"schema_99"},{"code":"404","description":"Subscription not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_94"}},"schemaId":"schema_94"}],"pointer":"/paths/~1subscriptions~1{id}~1cancel/patch/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_98","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_98"}}},{"code":"400","schemaId":"schema_99","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_99"}}},{"code":"404","schemaId":"schema_94","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_94"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/subscription/cancelsubscription"}],"panels":[]}]},"httpPath":"/subscriptions/{id}/cancel"},{"label":"Update next payment date","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/subscription/updatenextpaymentdate","routeSlug":"/api-reference/openapi/subscription/updatenextpaymentdate","metadata":{"seo":{"title":"Update next payment date","description":"Updates the next payment date of a subscription."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateNextPaymentDate","name":"Update next payment date","isWebhook":false,"pointer":"/paths/~1subscriptions~1{id}~1next-payment-date/patch","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update next payment date","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Updates the next payment date of a subscription.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unique identifier of the subscription whose next payment date to update. Starts with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sub_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" followed by letters and digits. An ID of any other shape is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and a message saying it must start with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sub_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; a well-formed ID that doesn't match a subscription on your account returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"404"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true,"example":"sub_5JU9yv0lGSUP"}],"pointer":"/paths/~1subscriptions~1{id}~1next-payment-date/patch/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateSubscriptionNextPaymentDate"}},"schemaId":"components/schemas/UpdateSubscriptionNextPaymentDate","pointer":"/paths/~1subscriptions~1{id}~1next-payment-date/patch/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/subscriptions/{id}/next-payment-date","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"sub_5JU9yv0lGSUP","schemaId":"schema_7"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UpdateSubscriptionNextPaymentDate"}},"responseCodes":["200","400","404"],"pointer":"/subscriptions/{id}/next-payment-date","href":"subscription/updatenextpaymentdate","openApiOperationId":"updateNextPaymentDate","summary":"Update next payment date"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"schemaId":"components/schemas/UpdateSubscriptionNextPaymentDate","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateSubscriptionNextPaymentDate"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Subscription updated successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Subscription"}},"schemaId":"components/schemas/Subscription"},{"code":"400","description":"Bad Request - next payment date cannot be updated from current state","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_100"}},"schemaId":"schema_100"},{"code":"404","description":"Subscription not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_94"}},"schemaId":"schema_94"}],"pointer":"/paths/~1subscriptions~1{id}~1next-payment-date/patch/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/Subscription","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Subscription"}}},{"code":"400","schemaId":"schema_100","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_100"}}},{"code":"404","schemaId":"schema_94","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_94"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/subscription/updatenextpaymentdate"}],"panels":[]}]},"httpPath":"/subscriptions/{id}/next-payment-date"}],"content":{"contentType":"group","meta":{"name":"Subscription"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Subscription","showPageActions":true},{"nodeType":"markdoc","content":"This resource represents a recurring billing agreement for a customer. Subscriptions allow businesses to automatically charge customers on a regular schedule according to a defined billing plan."}],"panels":[{"children":[{"kind":"group-items","title":"Schemas","titleTranslationKey":"schemas","items":[{"title":"Subscription","link":"/subscription/subscription","deprecated":false},{"title":"CreateSubscriptionResponse","link":"/subscription/createsubscriptionresponse","deprecated":false}]},{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/subscriptions","summary":"List subscriptions","prefix":{"name":"get","color":"get"},"badges":[],"link":"/subscription/getsubscriptions","deprecated":false},{"title":"/subscriptions","summary":"Create a new subscription","prefix":{"name":"post","color":"post"},"badges":[],"link":"/subscription/createsubscription","deprecated":false},{"title":"/subscriptions/{id}","summary":"Retrieve a subscription by ID","prefix":{"name":"get","color":"get"},"badges":[],"link":"/subscription/getsubscriptionbyid","deprecated":false},{"title":"/subscriptions/{id}/pause","summary":"Pause a subscription","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/subscription/pausesubscription","deprecated":false},{"title":"/subscriptions/{id}/resume","summary":"Resume a paused subscription","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/subscription/resumesubscription","deprecated":false},{"title":"/subscriptions/{id}/cancel","summary":"Cancel a subscription","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/subscription/cancelsubscription","deprecated":false},{"title":"/subscriptions/{id}/next-payment-date","summary":"Update next payment date","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/subscription/updatenextpaymentdate","deprecated":false}]}]}]}]}},{"type":"separator","label":"Quote","content":null},{"type":"group","label":"Quote","link":"/api-reference/openapi/quote","routeSlug":"/api-reference/openapi/quote","items":[{"label":"Create quotes","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/quote/createquote","routeSlug":"/api-reference/openapi/quote/createquote","metadata":{"seo":{"title":"Create quotes","description":"Create one or more pricing quotes for a payout or payin. Each quote locks an exchange rate and fee breakdown for fixed period.Provide exactly one of source_amount or destination_amount."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createQuote","name":"Create quotes","isWebhook":false,"pointer":"/paths/~1quotes/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create quotes","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 one or more pricing quotes for a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payout"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payin"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Each quote locks an exchange rate and fee breakdown for fixed period."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Provide exactly one of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"destination_amount"},"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":"On a payin quote, pass "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"split_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to price the fee from your declared share of a dynamic pricing rule. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#tag/pricing_split"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Dynamic Fee Split"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A payment link or an order created from the quote inherits the quote's splits, so it must not send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"split_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of its own. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"split_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is rejected on a payout quote."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"account funding"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" quote is a payin quote with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payment_method.type: card"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"resource_type: account_funding"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". It takes no subtype, prices in the destination currency, and is the only quote an account funding order can be created from. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/payin/account-funding"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Add funds with a card"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateQuoteRequest","exampleIds":["paths/~1quotes/post/requestBody/content/application~1json/examples/payout_source_amount","paths/~1quotes/post/requestBody/content/application~1json/examples/payout_destination_amount","paths/~1quotes/post/requestBody/content/application~1json/examples/payin_quote","paths/~1quotes/post/requestBody/content/application~1json/examples/payin_quote_with_splits","paths/~1quotes/post/requestBody/content/application~1json/examples/account_funding_quote"]}},"schemaId":"components/schemas/CreateQuoteRequest","exampleIds":["paths/~1quotes/post/requestBody/content/application~1json/examples/payout_source_amount","paths/~1quotes/post/requestBody/content/application~1json/examples/payout_destination_amount","paths/~1quotes/post/requestBody/content/application~1json/examples/payin_quote","paths/~1quotes/post/requestBody/content/application~1json/examples/payin_quote_with_splits","paths/~1quotes/post/requestBody/content/application~1json/examples/account_funding_quote"],"pointer":"/paths/~1quotes/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/quotes","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateQuoteRequest","exampleIds":["paths/~1quotes/post/requestBody/content/application~1json/examples/payout_source_amount","paths/~1quotes/post/requestBody/content/application~1json/examples/payout_destination_amount","paths/~1quotes/post/requestBody/content/application~1json/examples/payin_quote","paths/~1quotes/post/requestBody/content/application~1json/examples/payin_quote_with_splits","paths/~1quotes/post/requestBody/content/application~1json/examples/account_funding_quote"]}},"responseCodes":["201","400","401"],"pointer":"/quotes","href":"quote/createquote","openApiOperationId":"createQuote","summary":"Create quotes"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"schemaId":"components/schemas/CreateQuoteRequest","exampleIds":["paths/~1quotes/post/requestBody/content/application~1json/examples/payout_source_amount","paths/~1quotes/post/requestBody/content/application~1json/examples/payout_destination_amount","paths/~1quotes/post/requestBody/content/application~1json/examples/payin_quote","paths/~1quotes/post/requestBody/content/application~1json/examples/payin_quote_with_splits","paths/~1quotes/post/requestBody/content/application~1json/examples/account_funding_quote"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateQuoteRequest","exampleIds":["paths/~1quotes/post/requestBody/content/application~1json/examples/payout_source_amount","paths/~1quotes/post/requestBody/content/application~1json/examples/payout_destination_amount","paths/~1quotes/post/requestBody/content/application~1json/examples/payin_quote","paths/~1quotes/post/requestBody/content/application~1json/examples/payin_quote_with_splits","paths/~1quotes/post/requestBody/content/application~1json/examples/account_funding_quote"]}},"examples":[{},{},{},{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Quotes created successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_101"}},"schemaId":"schema_101"},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bad Request - missing required parameters, both amounts specified, neither amount specified, invalid currency, an unsupported payment method or subtype, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"local_transfer"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with a non-INR destination, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pay_via_bank"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with a subtype other than "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"local_transfer"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", a subtype sent with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"card"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", a card payin quote without "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"resource_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"resource_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on a non-payin quote, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"split_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on a non-payin quote, an unresolvable "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"split_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" entry, or no available pricing options."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_102","exampleIds":["paths/~1quotes/post/responses/400/content/application~1json/examples/both_amounts","paths/~1quotes/post/responses/400/content/application~1json/examples/missing_payment_method","paths/~1quotes/post/responses/400/content/application~1json/examples/missing_type","paths/~1quotes/post/responses/400/content/application~1json/examples/missing_subtype","paths/~1quotes/post/responses/400/content/application~1json/examples/subtype_on_card","paths/~1quotes/post/responses/400/content/application~1json/examples/unsupported_payment_method","paths/~1quotes/post/responses/400/content/application~1json/examples/card_on_payout_quote","paths/~1quotes/post/responses/400/content/application~1json/examples/resource_type_required","paths/~1quotes/post/responses/400/content/application~1json/examples/resource_type_on_payout","paths/~1quotes/post/responses/400/content/application~1json/examples/unsupported_subtype","paths/~1quotes/post/responses/400/content/application~1json/examples/local_transfer_non_inr","paths/~1quotes/post/responses/400/content/application~1json/examples/pay_via_bank_subtype","paths/~1quotes/post/responses/400/content/application~1json/examples/split_ids_on_payout_quote","paths/~1quotes/post/responses/400/content/application~1json/examples/split_ids_unresolved","paths/~1quotes/post/responses/400/content/application~1json/examples/split_ids_incomplete"]}},"schemaId":"schema_102","exampleIds":["paths/~1quotes/post/responses/400/content/application~1json/examples/both_amounts","paths/~1quotes/post/responses/400/content/application~1json/examples/missing_payment_method","paths/~1quotes/post/responses/400/content/application~1json/examples/missing_type","paths/~1quotes/post/responses/400/content/application~1json/examples/missing_subtype","paths/~1quotes/post/responses/400/content/application~1json/examples/subtype_on_card","paths/~1quotes/post/responses/400/content/application~1json/examples/unsupported_payment_method","paths/~1quotes/post/responses/400/content/application~1json/examples/card_on_payout_quote","paths/~1quotes/post/responses/400/content/application~1json/examples/resource_type_required","paths/~1quotes/post/responses/400/content/application~1json/examples/resource_type_on_payout","paths/~1quotes/post/responses/400/content/application~1json/examples/unsupported_subtype","paths/~1quotes/post/responses/400/content/application~1json/examples/local_transfer_non_inr","paths/~1quotes/post/responses/400/content/application~1json/examples/pay_via_bank_subtype","paths/~1quotes/post/responses/400/content/application~1json/examples/split_ids_on_payout_quote","paths/~1quotes/post/responses/400/content/application~1json/examples/split_ids_unresolved","paths/~1quotes/post/responses/400/content/application~1json/examples/split_ids_incomplete"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized — invalid or missing authentication token"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_65"}},"schemaId":"schema_65"}],"pointer":"/paths/~1quotes/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"schema_101","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_101"}}},{"code":"400","schemaId":"schema_102","exampleIds":["paths/~1quotes/post/responses/400/content/application~1json/examples/both_amounts","paths/~1quotes/post/responses/400/content/application~1json/examples/missing_payment_method","paths/~1quotes/post/responses/400/content/application~1json/examples/missing_type","paths/~1quotes/post/responses/400/content/application~1json/examples/missing_subtype","paths/~1quotes/post/responses/400/content/application~1json/examples/subtype_on_card","paths/~1quotes/post/responses/400/content/application~1json/examples/unsupported_payment_method","paths/~1quotes/post/responses/400/content/application~1json/examples/card_on_payout_quote","paths/~1quotes/post/responses/400/content/application~1json/examples/resource_type_required","paths/~1quotes/post/responses/400/content/application~1json/examples/resource_type_on_payout","paths/~1quotes/post/responses/400/content/application~1json/examples/unsupported_subtype","paths/~1quotes/post/responses/400/content/application~1json/examples/local_transfer_non_inr","paths/~1quotes/post/responses/400/content/application~1json/examples/pay_via_bank_subtype","paths/~1quotes/post/responses/400/content/application~1json/examples/split_ids_on_payout_quote","paths/~1quotes/post/responses/400/content/application~1json/examples/split_ids_unresolved","paths/~1quotes/post/responses/400/content/application~1json/examples/split_ids_incomplete"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_102","exampleIds":["paths/~1quotes/post/responses/400/content/application~1json/examples/both_amounts","paths/~1quotes/post/responses/400/content/application~1json/examples/missing_payment_method","paths/~1quotes/post/responses/400/content/application~1json/examples/missing_type","paths/~1quotes/post/responses/400/content/application~1json/examples/missing_subtype","paths/~1quotes/post/responses/400/content/application~1json/examples/subtype_on_card","paths/~1quotes/post/responses/400/content/application~1json/examples/unsupported_payment_method","paths/~1quotes/post/responses/400/content/application~1json/examples/card_on_payout_quote","paths/~1quotes/post/responses/400/content/application~1json/examples/resource_type_required","paths/~1quotes/post/responses/400/content/application~1json/examples/resource_type_on_payout","paths/~1quotes/post/responses/400/content/application~1json/examples/unsupported_subtype","paths/~1quotes/post/responses/400/content/application~1json/examples/local_transfer_non_inr","paths/~1quotes/post/responses/400/content/application~1json/examples/pay_via_bank_subtype","paths/~1quotes/post/responses/400/content/application~1json/examples/split_ids_on_payout_quote","paths/~1quotes/post/responses/400/content/application~1json/examples/split_ids_unresolved","paths/~1quotes/post/responses/400/content/application~1json/examples/split_ids_incomplete"]}}},{"code":"401","schemaId":"schema_65","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_65"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/quote/createquote"}],"panels":[]}]},"httpPath":"/quotes"}],"content":{"contentType":"group","meta":{"name":"Quote"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Quote","showPageActions":true},{"nodeType":"markdoc","content":"This resource represents a pricing quote for a payout or payin. A quote locks the FX rate and fee breakdown for a fixed period."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/quotes","summary":"Create quotes","prefix":{"name":"post","color":"post"},"badges":[],"link":"/quote/createquote","deprecated":false}]}]}]}]}},{"type":"separator","label":"Payout","content":null},{"type":"group","label":"Payout","link":"/api-reference/openapi/payout","routeSlug":"/api-reference/openapi/payout","items":[{"type":"link","label":"Payout","link":"/api-reference/openapi/payout/payout","routeSlug":"/api-reference/openapi/payout/payout","httpVerb":"schema","content":{"contentType":"item","itemVariant":"schema","meta":{"name":"Payout"},"seo":{"title":"Payout"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Payout","showPageActions":true}],"panels":[]},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"schemaDefinition","attributes":{"showWriteOnly":true,"schemaRef":"#/components/schemas/Payout"},"children":[]}]}]}},{"label":"Create a new payout","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/payout/createpayout","routeSlug":"/api-reference/openapi/payout/createpayout","metadata":{"seo":{"title":"Create a new payout","description":"Create a payout in one of two ways:"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createPayout","name":"Create a new payout","isWebhook":false,"pointer":"/paths/~1payouts/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a new payout","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 payout in one of two ways:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"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":"Payout without quote"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — specify the beneficiary, currencies and amount inline. Fees and the FX"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"rate are determined at creation time ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"CreatePayoutWithoutQuoteRequest"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"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":"Payout with quote"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — pass a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"quote_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" from "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /quotes"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"resource: payout"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") to settle"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"against a locked rate and fee breakdown. The currencies, amount and payment rail are derived from"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the quote and must not be sent ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"CreatePayoutWithQuoteRequest"},"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":"The request variant is selected by the presence of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"quote_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If payout queueing is enabled on your account, every payout is accepted with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status: queued"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", including one that the balance in the source currency already covers, and a payout the balance does not cover is accepted instead of rejected. Glomo releases it automatically once the balance covers the amount plus fees. Fees and the FX rate are fixed at creation and honoured when the payout is released. Without payout queueing, a short balance is rejected at creation."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_103","exampleIds":["paths/~1payouts/post/requestBody/content/application~1json/examples/payout_without_quote","paths/~1payouts/post/requestBody/content/application~1json/examples/payout_with_quote"]}},"schemaId":"schema_103","exampleIds":["paths/~1payouts/post/requestBody/content/application~1json/examples/payout_without_quote","paths/~1payouts/post/requestBody/content/application~1json/examples/payout_with_quote"],"pointer":"/paths/~1payouts/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/payouts","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_103","exampleIds":["paths/~1payouts/post/requestBody/content/application~1json/examples/payout_without_quote","paths/~1payouts/post/requestBody/content/application~1json/examples/payout_with_quote"]}},"responseCodes":["201","400","409"],"pointer":"/payouts","href":"payout/createpayout","openApiOperationId":"createPayout","summary":"Create a new payout"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"schemaId":"schema_103","exampleIds":["paths/~1payouts/post/requestBody/content/application~1json/examples/payout_without_quote","paths/~1payouts/post/requestBody/content/application~1json/examples/payout_with_quote"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_103","exampleIds":["paths/~1payouts/post/requestBody/content/application~1json/examples/payout_without_quote","paths/~1payouts/post/requestBody/content/application~1json/examples/payout_with_quote"]}},"examples":[{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Payout created successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Payout"}},"schemaId":"components/schemas/Payout"},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bad Request — validation error. For quote-based payouts, possible messages include "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"quote_id not found"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"quote_id has expired"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"quote_id has already been used"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_amount cannot be specified when quote_id is present"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (likewise for any other quote-derived field), "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Quote is not compatible with the selected beneficiary"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (the quote's rail is not supported by the chosen beneficiary), and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Quote is not a payout quote"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"quote_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" belongs to a payin quote)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When the balance does not cover the payout and payout queueing is not enabled on your account, the message reads "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Account has insufficient balance to process this transaction. Additional amount required: N."},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" where "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"N"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is the shortfall, in the smallest unit of the source currency."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_41"}},"schemaId":"schema_41"},{"code":"409","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A payout with this "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"request_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" already exists on your account. The existing payout is not returned; look it up with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v1/payouts?request_id=<your_request_id>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_104"}},"schemaId":"schema_104"}],"pointer":"/paths/~1payouts/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/Payout","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Payout"}}},{"code":"400","schemaId":"schema_41","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_41"}}},{"code":"409","schemaId":"schema_104","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_104"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/payout/createpayout"}],"panels":[]}]},"httpPath":"/payouts"},{"label":"List all payouts","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/payout/getpayouts","routeSlug":"/api-reference/openapi/payout/getpayouts","metadata":{"seo":{"title":"List all payouts","description":"Returns a list of your payouts, sorted by creation date with the most recent first. Filters combinewith AND, so a status and a beneficiary_id together return only payouts matching both."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getPayouts","name":"List all payouts","isWebhook":false,"pointer":"/paths/~1payouts/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List all payouts","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":"Returns a list of your payouts, sorted by creation date with the most recent first. Filters combine"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"with AND, so a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"beneficiary_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" together return only payouts matching both."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Payouts in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"draft"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are excluded unconditionally, whatever you filter on; "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /payouts/{id}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" returns"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"them. Creating a payout through this API submits it in the same call, so a payout of your own should"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"not be sitting in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"draft"},"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":"Only beneficiary payouts are returned. A settlement ID will not appear in this list — retrieve those"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"from "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /settlements"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"beneficiary_id","in":"query","schemaId":"schema_7","description":"The unique identifier of the beneficiary","example":"bene_5JU9yv0lGSUP"},{"name":"request_id","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter payouts by the client-provided "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"request_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Returns at most one result."},"children":[]}]}]}],"example":"your-internal-id"},{"name":"status","in":"query","schemaId":"schema_105","description":"Status of payout to filter"},{"name":"before","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return only resources created at or before this time. Send an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_8601"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" timestamp with an offset, such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-02-18T12:03:44Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-02-18T17:33:44+05:30"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A timestamp without an offset is read as UTC. A bare date ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") means the end of that day in UTC ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"23:59:59.999999Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). An invalid value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Use this to avoid page drift. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/platform/pagination#parameters"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameters"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"example":"2025-02-18T12:03:44Z"},{"name":"after","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return only resources created at or after this time. Send an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_8601"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" timestamp with an offset, such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-01-18T12:03:44Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-01-18T17:33:44+05:30"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A timestamp without an offset is read as UTC. A bare date ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") means the start of that day in UTC ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"00:00:00Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). An invalid value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Use this to avoid page drift. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/platform/pagination#parameters"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameters"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"example":"2025-01-18T12:03:44Z"},{"name":"per_page","in":"query","schemaId":"schema_8","description":"Number of resources per page. Should be between 1 and 100."},{"name":"page","in":"query","schemaId":"schema_9","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Page number for pagination. Starts from 1. Get the next page number from the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"next"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field in the response."},"children":[]}]}]}]}],"pointer":"/paths/~1payouts/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/payouts","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"beneficiary_id","in":"query","example":"bene_5JU9yv0lGSUP","schemaId":"schema_7"},{"name":"request_id","in":"query","example":"your-internal-id","schemaId":"schema_7"},{"name":"status","in":"query","schemaId":"schema_105"},{"name":"before","in":"query","example":"2025-02-18T12:03:44Z","schemaId":"schema_7"},{"name":"after","in":"query","example":"2025-01-18T12:03:44Z","schemaId":"schema_7"},{"name":"per_page","in":"query","schemaId":"schema_8"},{"name":"page","in":"query","schemaId":"schema_9"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","400"],"pointer":"/payouts","href":"payout/getpayouts","openApiOperationId":"getPayouts","summary":"List all payouts"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"List of payouts matching the filters","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_106"}},"schemaId":"schema_106"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_41"}},"schemaId":"schema_41"}],"pointer":"/paths/~1payouts/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_106","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_106"}}},{"code":"400","schemaId":"schema_41","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_41"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/payout/getpayouts"}],"panels":[]}]},"httpPath":"/payouts"},{"label":"Retrieve a payout\n","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/payout/getpayoutbyid","routeSlug":"/api-reference/openapi/payout/getpayoutbyid","metadata":{"seo":{"title":"Retrieve a payout\n","description":"Retrieves a single payout by ID."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getPayoutById","name":"Retrieve a payout\n","isWebhook":false,"pointer":"/paths/~1payouts~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve a payout\n","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":"Retrieves a single payout by ID."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unlike "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /payouts"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", this returns a payout in any state, including one still in draft that the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"list endpoint hides. The payout must belong to the merchant the API key authenticates as — an ID"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"that exists but belongs to another merchant returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"404"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", not "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"403"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", so the response does not"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"reveal whether the ID exists. An ID that is not a well-formed payout ID is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"before any lookup happens."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier for the payout. Starts with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payout_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" followed by letters and digits. An ID of any other shape is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and a message saying it must start with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payout_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; a well-formed ID that doesn't match a payout on your account returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"404"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true,"example":"payout_E602dMzgjpDC"}],"pointer":"/paths/~1payouts~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/payouts/{id}","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"payout_E602dMzgjpDC","schemaId":"schema_7"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/payouts/{id}","href":"payout/getpayoutbyid","openApiOperationId":"getPayoutById","summary":"Retrieve a payout\n"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Payout found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Payout"}},"schemaId":"components/schemas/Payout"},{"code":"404","description":"Payout not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}},"schemaId":"components/schemas/EntityNotFound"}],"pointer":"/paths/~1payouts~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/Payout","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Payout"}}},{"code":"404","schemaId":"components/schemas/EntityNotFound","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/payout/getpayoutbyid"}],"panels":[]}]},"httpPath":"/payouts/{id}"},{"label":"Cancel a payout","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/payout/cancelpayout","routeSlug":"/api-reference/openapi/payout/cancelpayout","metadata":{"seo":{"title":"Cancel a payout","description":"Cancel a payout that has not yet reached a stage where it can no longer be stopped. A payout with status: queued can be cancelled at any time while it waits for the balance to cover it. Nothing is reversed, because no funds were held."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"cancelPayout","name":"Cancel a payout","isWebhook":false,"pointer":"/paths/~1payouts~1{id}~1cancel/patch","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Cancel a payout","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 a payout that has not yet reached a stage where it can no longer be stopped. A payout with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status: queued"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" can be cancelled at any time while it waits for the balance to cover it. Nothing is reversed, because no funds were held."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_107","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the payout to cancel. Starts with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payout_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" followed by letters and digits. An ID of any other shape is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and a message saying it must start with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payout_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; a well-formed ID that doesn't match a payout on your account returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"404"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1payouts~1{id}~1cancel/patch/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/payouts/{id}/cancel","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"payout_DdWpHUbOnlg","schemaId":"schema_107"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","400","404"],"pointer":"/payouts/{id}/cancel","href":"payout/cancelpayout","openApiOperationId":"cancelPayout","summary":"Cancel a payout"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Payout cancelled successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_108"}},"schemaId":"schema_108"},{"code":"400","description":"Bad request"},{"code":"404","description":"Payout not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}},"schemaId":"components/schemas/EntityNotFound"}],"pointer":"/paths/~1payouts~1{id}~1cancel/patch/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_108","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_108"}}},{"code":"400"},{"code":"404","schemaId":"components/schemas/EntityNotFound","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/payout/cancelpayout"}],"panels":[]}]},"httpPath":"/payouts/{id}/cancel"},{"label":"Mock update a payout status","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/payout/mockupdatepayoutstatus","routeSlug":"/api-reference/openapi/payout/mockupdatepayoutstatus","metadata":{"seo":{"title":"Mock update a payout status","description":"Drives one of your payouts to a chosen status without any real money moving, so you can exercise yourwebhook handling and reconciliation against statuses that are otherwise hard to reach on demand. Thetarget must be one of pending, queued, success, failed, action_required or cancelled. Thisendpoint is not available in production."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"mockUpdatePayoutStatus","name":"Mock update a payout status","isWebhook":false,"pointer":"/paths/~1payouts~1mock/patch","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Mock update a payout status","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":"Drives one of your payouts to a chosen status without any real money moving, so you can exercise your"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"webhook handling and reconciliation against statuses that are otherwise hard to reach on demand. The"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"target must be one of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pending"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"queued"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"success"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"failed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"action_required"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cancelled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". This"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"endpoint is not available in production."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The transition must be legal from the payout's current status — the same transition rules apply as in"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"production, so this cannot force a payout into a state it could not reach for real. An illegal"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"transition returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"State change not allowed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" rather than quietly doing nothing, so that"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"error usually means the payout is not in the state you assumed."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_109"}},"schemaId":"schema_109","pointer":"/paths/~1payouts~1mock/patch/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/payouts/mock","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_109"}},"responseCodes":["200","400"],"pointer":"/payouts/mock","href":"payout/mockupdatepayoutstatus","openApiOperationId":"mockUpdatePayoutStatus","summary":"Mock update a payout status"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"schemaId":"schema_109","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_109"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Payout updated successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Payout"}},"schemaId":"components/schemas/Payout"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_41"}},"schemaId":"schema_41"}],"pointer":"/paths/~1payouts~1mock/patch/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/Payout","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Payout"}}},{"code":"400","schemaId":"schema_41","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_41"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/payout/mockupdatepayoutstatus"}],"panels":[]}]},"httpPath":"/payouts/mock"}],"content":{"contentType":"group","meta":{"name":"Payout"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Payout","showPageActions":true},{"nodeType":"markdoc","content":"This resource represents the disbursement transactions from your Glomo account to your beneficiaries."}],"panels":[{"children":[{"kind":"group-items","title":"Schemas","titleTranslationKey":"schemas","items":[{"title":"Payout","link":"/payout/payout","deprecated":false}]},{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/payouts","summary":"Create a new payout","prefix":{"name":"post","color":"post"},"badges":[],"link":"/payout/createpayout","deprecated":false},{"title":"/payouts","summary":"List all payouts","prefix":{"name":"get","color":"get"},"badges":[],"link":"/payout/getpayouts","deprecated":false},{"title":"/payouts/{id}","summary":"Retrieve a payout\n","prefix":{"name":"get","color":"get"},"badges":[],"link":"/payout/getpayoutbyid","deprecated":false},{"title":"/payouts/{id}/cancel","summary":"Cancel a payout","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/payout/cancelpayout","deprecated":false},{"title":"/payouts/mock","summary":"Mock update a payout status","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/payout/mockupdatepayoutstatus","deprecated":false}]}]}]}]}},{"type":"group","label":"Beneficiary V2","link":"/api-reference/openapi/beneficiary_v2","routeSlug":"/api-reference/openapi/beneficiary_v2","items":[{"type":"link","label":"BeneficiaryV2","link":"/api-reference/openapi/beneficiary_v2/beneficiaryv2","routeSlug":"/api-reference/openapi/beneficiary_v2/beneficiaryv2","httpVerb":"schema","content":{"contentType":"item","itemVariant":"schema","meta":{"name":"BeneficiaryV2"},"seo":{"title":"BeneficiaryV2"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"BeneficiaryV2","showPageActions":true}],"panels":[]},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"schemaDefinition","attributes":{"showWriteOnly":true,"schemaRef":"#/components/schemas/BeneficiaryV2"},"children":[]}]}]}},{"label":"Create a Beneficiary","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/beneficiary_v2/createbeneficiaryv2","routeSlug":"/api-reference/openapi/beneficiary_v2/createbeneficiaryv2","metadata":{"seo":{"title":"Create a Beneficiary","description":"Creates a beneficiary with structured nested objects for beneficiary details, address, and bank account or UPI information."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createBeneficiaryV2","name":"Create a Beneficiary","isWebhook":false,"pointer":"/paths/~1v2~1beneficiaries/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a Beneficiary","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Creates a beneficiary with structured nested objects for beneficiary details, address, and bank account or UPI information.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/BeneficiaryV2CreateRequest","exampleIds":["paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_usd","paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_eur","paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_gbp","paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_aed","paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_aud","paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_inr","paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_upi_beneficiary","paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/lrs_beneficiary"]}},"schemaId":"components/schemas/BeneficiaryV2CreateRequest","exampleIds":["paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_usd","paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_eur","paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_gbp","paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_aed","paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_aud","paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_inr","paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_upi_beneficiary","paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/lrs_beneficiary"],"pointer":"/paths/~1v2~1beneficiaries/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v2/beneficiaries","servers":[{"url":"https://api.glomopay.com/api","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/BeneficiaryV2CreateRequest","exampleIds":["paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_usd","paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_eur","paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_gbp","paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_aed","paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_aud","paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_inr","paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_upi_beneficiary","paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/lrs_beneficiary"]}},"responseCodes":["201","400","409","422"],"pointer":"/v2/beneficiaries","href":"beneficiary_v2/createbeneficiaryv2","openApiOperationId":"createBeneficiaryV2","summary":"Create a Beneficiary"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api","description":"Production server"}],"schemaId":"components/schemas/BeneficiaryV2CreateRequest","exampleIds":["paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_usd","paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_eur","paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_gbp","paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_aed","paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_aud","paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_inr","paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_upi_beneficiary","paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/lrs_beneficiary"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/BeneficiaryV2CreateRequest","exampleIds":["paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_usd","paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_eur","paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_gbp","paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_aed","paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_aud","paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_inr","paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_upi_beneficiary","paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/lrs_beneficiary"]}},"examples":[{},{},{},{},{},{},{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Beneficiary created successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BeneficiaryV2","exampleIds":["paths/~1v2~1beneficiaries/post/responses/201/content/application~1json/example"]}},"schemaId":"components/schemas/BeneficiaryV2","exampleIds":["paths/~1v2~1beneficiaries/post/responses/201/content/application~1json/example"]},{"code":"400","description":"Bad Request - Validation errors in the request body","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_110","exampleIds":["paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/missing_category","paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/invalid_category","paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/missing_beneficiary_name","paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/invalid_swift_code","paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/lrs_invalid_swift_length","paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/lrs_missing_routing_number","paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/unresolved_bank_details","paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/missing_address"]}},"schemaId":"schema_110","exampleIds":["paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/missing_category","paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/invalid_category","paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/missing_beneficiary_name","paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/invalid_swift_code","paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/lrs_invalid_swift_length","paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/lrs_missing_routing_number","paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/unresolved_bank_details","paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/missing_address"]},{"code":"409","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Conflict - a beneficiary with this account number already exists on your account. The body does not carry the id of the existing record: store the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bene_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" id when you create one, or recover it by listing beneficiaries."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_111"}},"schemaId":"schema_111"},{"code":"422","description":"Unprocessable Entity - Business logic errors (e.g., duplicate bank account)","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_112","exampleIds":["paths/~1v2~1beneficiaries/post/responses/422/content/application~1json/examples/duplicate_account"]}},"schemaId":"schema_112","exampleIds":["paths/~1v2~1beneficiaries/post/responses/422/content/application~1json/examples/duplicate_account"]}],"pointer":"/paths/~1v2~1beneficiaries/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/BeneficiaryV2","exampleIds":["paths/~1v2~1beneficiaries/post/responses/201/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BeneficiaryV2","exampleIds":["paths/~1v2~1beneficiaries/post/responses/201/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_110","exampleIds":["paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/missing_category","paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/invalid_category","paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/missing_beneficiary_name","paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/invalid_swift_code","paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/lrs_invalid_swift_length","paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/lrs_missing_routing_number","paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/unresolved_bank_details","paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/missing_address"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_110","exampleIds":["paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/missing_category","paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/invalid_category","paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/missing_beneficiary_name","paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/invalid_swift_code","paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/lrs_invalid_swift_length","paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/lrs_missing_routing_number","paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/unresolved_bank_details","paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/missing_address"]}}},{"code":"409","schemaId":"schema_111","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_111"}}},{"code":"422","schemaId":"schema_112","exampleIds":["paths/~1v2~1beneficiaries/post/responses/422/content/application~1json/examples/duplicate_account"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_112","exampleIds":["paths/~1v2~1beneficiaries/post/responses/422/content/application~1json/examples/duplicate_account"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/beneficiary_v2/createbeneficiaryv2"}],"panels":[]}]},"httpPath":"/v2/beneficiaries"},{"label":"List Beneficiaries","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/beneficiary_v2/listbeneficiariesv2","routeSlug":"/api-reference/openapi/beneficiary_v2/listbeneficiariesv2","metadata":{"seo":{"title":"List Beneficiaries","description":"Returns a paginated list of beneficiaries. Optionally filter by status."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listBeneficiariesV2","name":"List Beneficiaries","isWebhook":false,"pointer":"/paths/~1v2~1beneficiaries/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List Beneficiaries","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns a paginated list of beneficiaries. Optionally filter by status.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"status","in":"query","schemaId":"schema_113","description":"Filter beneficiaries by status.","example":"active"},{"name":"page","in":"query","schemaId":"schema_114","description":"Page number for pagination.","example":1},{"name":"per_page","in":"query","schemaId":"schema_114","description":"Number of results per page.","example":20}],"pointer":"/paths/~1v2~1beneficiaries/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v2/beneficiaries","servers":[{"url":"https://api.glomopay.com/api","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"status","in":"query","required":false,"example":"active","schemaId":"schema_113"},{"name":"page","in":"query","required":false,"example":1,"schemaId":"schema_114"},{"name":"per_page","in":"query","required":false,"example":20,"schemaId":"schema_114"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","400"],"pointer":"/v2/beneficiaries","href":"beneficiary_v2/listbeneficiariesv2","openApiOperationId":"listBeneficiariesV2","summary":"List Beneficiaries"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"A paginated list of beneficiaries","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_115","exampleIds":["paths/~1v2~1beneficiaries/get/responses/200/content/application~1json/example"]}},"schemaId":"schema_115","exampleIds":["paths/~1v2~1beneficiaries/get/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad Request - Invalid query parameters","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_116","exampleIds":["paths/~1v2~1beneficiaries/get/responses/400/content/application~1json/example"]}},"schemaId":"schema_116","exampleIds":["paths/~1v2~1beneficiaries/get/responses/400/content/application~1json/example"]}],"pointer":"/paths/~1v2~1beneficiaries/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_115","exampleIds":["paths/~1v2~1beneficiaries/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_115","exampleIds":["paths/~1v2~1beneficiaries/get/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_116","exampleIds":["paths/~1v2~1beneficiaries/get/responses/400/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_116","exampleIds":["paths/~1v2~1beneficiaries/get/responses/400/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/beneficiary_v2/listbeneficiariesv2"}],"panels":[]}]},"httpPath":"/v2/beneficiaries"},{"label":"Get a Beneficiary","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/beneficiary_v2/getbeneficiarybyidv2","routeSlug":"/api-reference/openapi/beneficiary_v2/getbeneficiarybyidv2","metadata":{"seo":{"title":"Get a Beneficiary","description":"Retrieves the details of an existing beneficiary by ID."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getBeneficiaryByIdV2","name":"Get a Beneficiary","isWebhook":false,"pointer":"/paths/~1v2~1beneficiaries~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get a Beneficiary","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves the details of an existing beneficiary by ID.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_7","description":"The ID of the beneficiary.","required":true,"example":"bene_698c0615XZocZ"}],"pointer":"/paths/~1v2~1beneficiaries~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v2/beneficiaries/{id}","servers":[{"url":"https://api.glomopay.com/api","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"bene_698c0615XZocZ","schemaId":"schema_7"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/v2/beneficiaries/{id}","href":"beneficiary_v2/getbeneficiarybyidv2","openApiOperationId":"getBeneficiaryByIdV2","summary":"Get a Beneficiary"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Beneficiary details","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BeneficiaryV2","exampleIds":["paths/~1v2~1beneficiaries~1{id}/get/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/BeneficiaryV2","exampleIds":["paths/~1v2~1beneficiaries~1{id}/get/responses/200/content/application~1json/example"]},{"code":"404","description":"Beneficiary not found or does not belong to the authenticated business","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}},"schemaId":"components/schemas/EntityNotFound"}],"pointer":"/paths/~1v2~1beneficiaries~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/BeneficiaryV2","exampleIds":["paths/~1v2~1beneficiaries~1{id}/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BeneficiaryV2","exampleIds":["paths/~1v2~1beneficiaries~1{id}/get/responses/200/content/application~1json/example"]}}},{"code":"404","schemaId":"components/schemas/EntityNotFound","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/beneficiary_v2/getbeneficiarybyidv2"}],"panels":[]}]},"httpPath":"/v2/beneficiaries/{id}"},{"label":"Mock Review a Beneficiary","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/beneficiary_v2/mockreviewbeneficiaryv2","routeSlug":"/api-reference/openapi/beneficiary_v2/mockreviewbeneficiaryv2","metadata":{"seo":{"title":"Mock Review a Beneficiary","description":"Simulates a review action (approve or reject) on a beneficiary. This endpoint is only available in sandbox/non-production environments."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"mockReviewBeneficiaryV2","name":"Mock Review a Beneficiary","isWebhook":false,"pointer":"/paths/~1v2~1beneficiaries~1{id}~1mock-review/patch","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Mock Review a Beneficiary","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Simulates a review action (approve or reject) on a beneficiary. This endpoint is only available in sandbox/non-production environments.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_7","description":"The ID of the beneficiary to review.","required":true,"example":"bene_698c0615XZocZ"}],"pointer":"/paths/~1v2~1beneficiaries~1{id}~1mock-review/patch/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_117","exampleIds":["paths/~1v2~1beneficiaries~1{id}~1mock-review/patch/requestBody/content/application~1json/example"]}},"schemaId":"schema_117","exampleIds":["paths/~1v2~1beneficiaries~1{id}~1mock-review/patch/requestBody/content/application~1json/example"],"pointer":"/paths/~1v2~1beneficiaries~1{id}~1mock-review/patch/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/v2/beneficiaries/{id}/mock-review","servers":[{"url":"https://api.glomopay.com/api","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"bene_698c0615XZocZ","schemaId":"schema_7"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_117","exampleIds":["paths/~1v2~1beneficiaries~1{id}~1mock-review/patch/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","422"],"pointer":"/v2/beneficiaries/{id}/mock-review","href":"beneficiary_v2/mockreviewbeneficiaryv2","openApiOperationId":"mockReviewBeneficiaryV2","summary":"Mock Review a Beneficiary"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api","description":"Production server"}],"schemaId":"schema_117","exampleIds":["paths/~1v2~1beneficiaries~1{id}~1mock-review/patch/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_117","exampleIds":["paths/~1v2~1beneficiaries~1{id}~1mock-review/patch/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Beneficiary status updated successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_118","exampleIds":["paths/~1v2~1beneficiaries~1{id}~1mock-review/patch/responses/200/content/application~1json/example"]}},"schemaId":"schema_118","exampleIds":["paths/~1v2~1beneficiaries~1{id}~1mock-review/patch/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad Request - Invalid review action","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_119","exampleIds":["paths/~1v2~1beneficiaries~1{id}~1mock-review/patch/responses/400/content/application~1json/example"]}},"schemaId":"schema_119","exampleIds":["paths/~1v2~1beneficiaries~1{id}~1mock-review/patch/responses/400/content/application~1json/example"]},{"code":"422","description":"Unprocessable Entity - Beneficiary is already in a terminal state","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_120","exampleIds":["paths/~1v2~1beneficiaries~1{id}~1mock-review/patch/responses/422/content/application~1json/example"]}},"schemaId":"schema_120","exampleIds":["paths/~1v2~1beneficiaries~1{id}~1mock-review/patch/responses/422/content/application~1json/example"]}],"pointer":"/paths/~1v2~1beneficiaries~1{id}~1mock-review/patch/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_118","exampleIds":["paths/~1v2~1beneficiaries~1{id}~1mock-review/patch/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_118","exampleIds":["paths/~1v2~1beneficiaries~1{id}~1mock-review/patch/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_119","exampleIds":["paths/~1v2~1beneficiaries~1{id}~1mock-review/patch/responses/400/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_119","exampleIds":["paths/~1v2~1beneficiaries~1{id}~1mock-review/patch/responses/400/content/application~1json/example"]}}},{"code":"422","schemaId":"schema_120","exampleIds":["paths/~1v2~1beneficiaries~1{id}~1mock-review/patch/responses/422/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_120","exampleIds":["paths/~1v2~1beneficiaries~1{id}~1mock-review/patch/responses/422/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/beneficiary_v2/mockreviewbeneficiaryv2"}],"panels":[]}]},"httpPath":"/v2/beneficiaries/{id}/mock-review"}],"content":{"contentType":"group","meta":{"name":"beneficiary_v2"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Beneficiary V2","showPageActions":true},{"nodeType":"markdoc","content":"This resource represents a payee of a payout initiated by your business. Beneficiary V2 introduces a structured nested format for beneficiary, address, and bank account details, and supports both bank account and UPI payment methods."}],"panels":[{"children":[{"kind":"group-items","title":"Schemas","titleTranslationKey":"schemas","items":[{"title":"BeneficiaryV2","link":"/beneficiary_v2/beneficiaryv2","deprecated":false}]},{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/v2/beneficiaries","summary":"Create a Beneficiary","prefix":{"name":"post","color":"post"},"badges":[],"link":"/beneficiary_v2/createbeneficiaryv2","deprecated":false},{"title":"/v2/beneficiaries","summary":"List Beneficiaries","prefix":{"name":"get","color":"get"},"badges":[],"link":"/beneficiary_v2/listbeneficiariesv2","deprecated":false},{"title":"/v2/beneficiaries/{id}","summary":"Get a Beneficiary","prefix":{"name":"get","color":"get"},"badges":[],"link":"/beneficiary_v2/getbeneficiarybyidv2","deprecated":false},{"title":"/v2/beneficiaries/{id}/mock-review","summary":"Mock Review a Beneficiary","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/beneficiary_v2/mockreviewbeneficiaryv2","deprecated":false}]}]}]}]}},{"type":"group","label":"Bank Account Validation","link":"/api-reference/openapi/bank_account_validation","routeSlug":"/api-reference/openapi/bank_account_validation","items":[{"type":"link","label":"BankAccountValidation","link":"/api-reference/openapi/bank_account_validation/bankaccountvalidation","routeSlug":"/api-reference/openapi/bank_account_validation/bankaccountvalidation","httpVerb":"schema","content":{"contentType":"item","itemVariant":"schema","meta":{"name":"BankAccountValidation"},"seo":{"title":"BankAccountValidation"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"BankAccountValidation","showPageActions":true}],"panels":[]},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"schemaDefinition","attributes":{"showWriteOnly":true,"schemaRef":"#/components/schemas/BankAccountValidation"},"children":[]}]}]}},{"label":"Validate any bank account","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/bank_account_validation/validatebankaccount","routeSlug":"/api-reference/openapi/bank_account_validation/validatebankaccount","metadata":{"seo":{"title":"Validate any bank account","description":"Checks with the destination bank that an account exists and that the holder name matches, so you cancatch a bad account before you pay out to it rather than after a failed transfer."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"validateBankAccount","name":"Validate any bank account","isWebhook":false,"pointer":"/paths/~1bank_account_validation/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Validate any bank account","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":"Checks with the destination bank that an account exists and that the holder name matches, so you can"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"catch a bad account before you pay out to it rather than after a failed transfer."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Identify the account in one of two ways, and only one: pass the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of a bank account already saved"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"against a beneficiary, or pass the account details inline. When "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is present the inline fields are"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ignored."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Validation is chargeable. The request is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" before the provider is called if your"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"balance does not cover the validation fee, unless fee collection is deferred on your account. You are"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"charged only when the provider completes the check; a check it could not complete is not charged."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not the verdict on the account and is not whether you were charged. It reports whether the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"provider returned a usable response at all. A check that completes and does "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"not"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" confirm the holder"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"name still comes back as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status: success"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Read the verdict from "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"validation_message"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", which carries"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the match score, and read "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fee_charged"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to see whether a fee was actually taken."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_121"}},"schemaId":"schema_121","pointer":"/paths/~1bank_account_validation/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/bank_account_validation","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_121"}},"responseCodes":["200","400"],"pointer":"/bank_account_validation","href":"bank_account_validation/validatebankaccount","openApiOperationId":"validateBankAccount","summary":"Validate any bank account"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"schemaId":"schema_121","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_121"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Bank account validation successful","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BankAccountValidation"}},"schemaId":"components/schemas/BankAccountValidation"},{"code":"400","description":"Bad request"}],"pointer":"/paths/~1bank_account_validation/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/BankAccountValidation","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BankAccountValidation"}}},{"code":"400"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/bank_account_validation/validatebankaccount"}],"panels":[]}]},"httpPath":"/bank_account_validation"},{"label":"List all bank account validations","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/bank_account_validation/getbankaccountvalidations","routeSlug":"/api-reference/openapi/bank_account_validation/getbankaccountvalidations","metadata":{"seo":{"title":"List all bank account validations","description":"Returns the bank account validations your business has run, sorted by creation date with the mostrecent first. Because POST /bank_account_validation is chargeable, use this to check whether anaccount has already been validated before paying to validate it again."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getBankAccountValidations","name":"List all bank account validations","isWebhook":false,"pointer":"/paths/~1bank_account_validation/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List all bank account validations","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":"Returns the bank account validations your business has run, sorted by creation date with the most"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"recent first. Because "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /bank_account_validation"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is chargeable, use this to check whether an"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"account has already been validated before paying to validate it again."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"country"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is matched against the country recorded on the validation request, not against the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"beneficiary's current country, so editing a beneficiary does not move its past validations between"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"filters."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"beneficiary_account_id","in":"query","schemaId":"schema_7","description":"The ID of the beneficiary bank account to filter validations","example":"bene_5JU9yv0lGSUP"},{"name":"country","in":"query","schemaId":"schema_122","description":"The ISO 3166-1 alpha-3 code of the country to filter validations"},{"name":"before","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return only resources created at or before this time. Send an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_8601"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" timestamp with an offset, such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-02-18T12:03:44Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-02-18T17:33:44+05:30"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A timestamp without an offset is read as UTC. A bare date ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") means the end of that day in UTC ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"23:59:59.999999Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). An invalid value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Use this to avoid page drift. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/platform/pagination#parameters"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameters"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"example":"2025-02-18T12:03:44Z"},{"name":"after","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return only resources created at or after this time. Send an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_8601"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" timestamp with an offset, such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-01-18T12:03:44Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-01-18T17:33:44+05:30"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A timestamp without an offset is read as UTC. A bare date ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") means the start of that day in UTC ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"00:00:00Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). An invalid value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Use this to avoid page drift. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/platform/pagination#parameters"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameters"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"example":"2025-01-18T12:03:44Z"},{"name":"per_page","in":"query","schemaId":"schema_8","description":"Number of resources per page. Should be between 1 and 100."},{"name":"page","in":"query","schemaId":"schema_9","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Page number for pagination. Starts from 1. Get the next page number from the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"next"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field in the response."},"children":[]}]}]}]}],"pointer":"/paths/~1bank_account_validation/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/bank_account_validation","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"beneficiary_account_id","in":"query","example":"bene_5JU9yv0lGSUP","schemaId":"schema_7"},{"name":"country","in":"query","example":"Ind","schemaId":"schema_122"},{"name":"before","in":"query","example":"2025-02-18T12:03:44Z","schemaId":"schema_7"},{"name":"after","in":"query","example":"2025-01-18T12:03:44Z","schemaId":"schema_7"},{"name":"per_page","in":"query","schemaId":"schema_8"},{"name":"page","in":"query","schemaId":"schema_9"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","400"],"pointer":"/bank_account_validation","href":"bank_account_validation/getbankaccountvalidations","openApiOperationId":"getBankAccountValidations","summary":"List all bank account validations"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"List of bank account validations matching the filters","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_123"}},"schemaId":"schema_123"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_11"}},"schemaId":"schema_11"}],"pointer":"/paths/~1bank_account_validation/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_123","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_123"}}},{"code":"400","schemaId":"schema_11","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_11"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/bank_account_validation/getbankaccountvalidations"}],"panels":[]}]},"httpPath":"/bank_account_validation"}],"content":{"contentType":"group","meta":{"name":"bank_account_validation"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Bank Account Validation","showPageActions":true},{"nodeType":"markdoc","content":"Bank Account Validation resource represents the validation details of a bank account."}],"panels":[{"children":[{"kind":"group-items","title":"Schemas","titleTranslationKey":"schemas","items":[{"title":"BankAccountValidation","link":"/bank_account_validation/bankaccountvalidation","deprecated":false}]},{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/bank_account_validation","summary":"Validate any bank account","prefix":{"name":"post","color":"post"},"badges":[],"link":"/bank_account_validation/validatebankaccount","deprecated":false},{"title":"/bank_account_validation","summary":"List all bank account validations","prefix":{"name":"get","color":"get"},"badges":[],"link":"/bank_account_validation/getbankaccountvalidations","deprecated":false}]}]}]}]}},{"type":"separator","label":"Document","content":null},{"type":"group","label":"Document","link":"/api-reference/openapi/document","routeSlug":"/api-reference/openapi/document","items":[{"type":"link","label":"Document","link":"/api-reference/openapi/document/document","routeSlug":"/api-reference/openapi/document/document","httpVerb":"schema","content":{"contentType":"item","itemVariant":"schema","meta":{"name":"Document"},"seo":{"title":"Document"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Document","showPageActions":true}],"panels":[]},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"schemaDefinition","attributes":{"showWriteOnly":true,"schemaRef":"#/components/schemas/Document"},"children":[]}]}]}},{"label":"Create a new document","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/document/createdocument","routeSlug":"/api-reference/openapi/document/createdocument","metadata":{"seo":{"title":"Create a new document","description":"Uploads a file and returns a document record you can reference from other resources — as the invoiceor supporting paperwork on a payin or payout, or as evidence when responding to a request forinformation (RFI)."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createDocument","name":"Create a new document","isWebhook":false,"pointer":"/paths/~1document/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a new document","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":"Uploads a file and returns a document record you can reference from other resources — as the invoice"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"or supporting paperwork on a payin or payout, or as evidence when responding to a request for"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"information (RFI)."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Send the request as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"multipart/form-data"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The file must be a JPEG, PNG or PDF of at most 10 MB"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(10,485,760 bytes), and the uploaded filename and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"document_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at most 128 characters each."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Upload is a separate step from attaching, and each consumer names the reference differently: pass the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"returned "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"document_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when creating a payin, an order or a refund, and inside the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"documents"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"array when creating a payout or responding to an RFI. Check the schema of the endpoint you are"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"attaching to — the key inside "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"documents"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not the same on every one. A document that is never"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"referenced stays listed but has no effect."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["multipart/form-data"],"mediaTypeSchemas":{"multipart/form-data":{"schemaId":"schema_124"}},"schemaId":"schema_124","pointer":"/paths/~1document/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/document","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"multipart/form-data":{"schemaId":"schema_124"}},"responseCodes":["201","400"],"pointer":"/document","href":"document/createdocument","openApiOperationId":"createDocument","summary":"Create a new document"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"schemaId":"schema_124","mediaTypes":["multipart/form-data"],"mediaTypeSchemas":{"multipart/form-data":{"schemaId":"schema_124"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Document created successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Document"}},"schemaId":"components/schemas/Document"},{"code":"400","description":"Bad request"}],"pointer":"/paths/~1document/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/Document","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Document"}}},{"code":"400"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/document/createdocument"}],"panels":[]}]},"httpPath":"/document"},{"label":"List all documents","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/document/getdocuments","routeSlug":"/api-reference/openapi/document/getdocuments","metadata":{"seo":{"title":"List all documents","description":"Returns a list of your documents. The documents are returned sorted by creation date, with the most recent documents appearing first."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getDocuments","name":"List all documents","isWebhook":false,"pointer":"/paths/~1document/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List all documents","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns a list of your documents. The documents are returned sorted by creation date, with the most recent documents appearing first.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"before","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return only resources created at or before this time. Send an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_8601"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" timestamp with an offset, such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-02-18T12:03:44Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-02-18T17:33:44+05:30"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A timestamp without an offset is read as UTC. A bare date ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") means the end of that day in UTC ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"23:59:59.999999Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). An invalid value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Use this to avoid page drift. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/platform/pagination#parameters"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameters"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"example":"2025-02-18T12:03:44Z"},{"name":"after","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return only resources created at or after this time. Send an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_8601"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" timestamp with an offset, such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-01-18T12:03:44Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-01-18T17:33:44+05:30"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A timestamp without an offset is read as UTC. A bare date ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") means the start of that day in UTC ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"00:00:00Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). An invalid value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Use this to avoid page drift. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/platform/pagination#parameters"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameters"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"example":"2025-01-18T12:03:44Z"},{"name":"per_page","in":"query","schemaId":"schema_8","description":"Number of resources per page. Should be between 1 and 100."},{"name":"page","in":"query","schemaId":"schema_9","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Page number for pagination. Starts from 1. Get the next page number from the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"next"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field in the response."},"children":[]}]}]}]}],"pointer":"/paths/~1document/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/document","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"before","in":"query","example":"2025-02-18T12:03:44Z","schemaId":"schema_7"},{"name":"after","in":"query","example":"2025-01-18T12:03:44Z","schemaId":"schema_7"},{"name":"per_page","in":"query","schemaId":"schema_8"},{"name":"page","in":"query","schemaId":"schema_9"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","400"],"pointer":"/document","href":"document/getdocuments","openApiOperationId":"getDocuments","summary":"List all documents"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"List of documents matching the filters","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_125"}},"schemaId":"schema_125"},{"code":"400","description":"Bad request"}],"pointer":"/paths/~1document/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_125","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_125"}}},{"code":"400"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/document/getdocuments"}],"panels":[]}]},"httpPath":"/document"},{"label":"Get a document by ID","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/document/getdocumentbyid","routeSlug":"/api-reference/openapi/document/getdocumentbyid","metadata":{"seo":{"title":"Get a document by ID","description":"Retrieve a single document by its unique identifier."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getDocumentById","name":"Get a document by ID","isWebhook":false,"pointer":"/paths/~1document~1{document_id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get a document by ID","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieve a single document by its unique identifier.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"document_id","in":"path","schemaId":"schema_126","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the document to retrieve. Starts with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"doc_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" followed by letters and digits. An ID of any other shape is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and a message saying it must start with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"doc_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; a well-formed ID that doesn't match a document on your account returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"404"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1document~1{document_id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/document/{document_id}","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[{"name":"document_id","in":"path","required":true,"example":"doc_12345","schemaId":"schema_126"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","400","401","404"],"pointer":"/document/{document_id}","href":"document/getdocumentbyid","openApiOperationId":"getDocumentById","summary":"Get a document by ID"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Document retrieved successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Document"}},"schemaId":"components/schemas/Document"},{"code":"400","description":"Bad request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_127"}},"schemaId":"schema_127"},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_65"}},"schemaId":"schema_65"},{"code":"404","description":"Document not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_128"}},"schemaId":"schema_128"}],"pointer":"/paths/~1document~1{document_id}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/Document","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Document"}}},{"code":"400","schemaId":"schema_127","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_127"}}},{"code":"401","schemaId":"schema_65","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_65"}}},{"code":"404","schemaId":"schema_128","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_128"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/document/getdocumentbyid"}],"panels":[]}]},"httpPath":"/document/{document_id}"}],"content":{"contentType":"group","meta":{"name":"Document"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Document","showPageActions":true},{"nodeType":"markdoc","content":"Document resource represents the documents details uploaded. This document is used in payin, payout, etc."}],"panels":[{"children":[{"kind":"group-items","title":"Schemas","titleTranslationKey":"schemas","items":[{"title":"Document","link":"/document/document","deprecated":false}]},{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/document","summary":"Create a new document","prefix":{"name":"post","color":"post"},"badges":[],"link":"/document/createdocument","deprecated":false},{"title":"/document","summary":"List all documents","prefix":{"name":"get","color":"get"},"badges":[],"link":"/document/getdocuments","deprecated":false},{"title":"/document/{document_id}","summary":"Get a document by ID","prefix":{"name":"get","color":"get"},"badges":[],"link":"/document/getdocumentbyid","deprecated":false}]}]}]}]}},{"type":"separator","label":"Internal Transfer","content":null},{"type":"group","label":"Internal Transfer","link":"/api-reference/openapi/internal_transfer","routeSlug":"/api-reference/openapi/internal_transfer","items":[{"type":"link","label":"InternalTransfer","link":"/api-reference/openapi/internal_transfer/internaltransfer","routeSlug":"/api-reference/openapi/internal_transfer/internaltransfer","httpVerb":"schema","content":{"contentType":"item","itemVariant":"schema","meta":{"name":"InternalTransfer"},"seo":{"title":"InternalTransfer"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"InternalTransfer","showPageActions":true}],"panels":[]},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"schemaDefinition","attributes":{"showWriteOnly":true,"schemaRef":"#/components/schemas/InternalTransfer"},"children":[]}]}]}},{"label":"Create an internal transfer","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/internal_transfer/createinternaltransfer","routeSlug":"/api-reference/openapi/internal_transfer/createinternaltransfer","metadata":{"seo":{"title":"Create an internal transfer","description":"Creates an internal transfer between two merchant accounts."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createInternalTransfer","name":"Create an internal transfer","isWebhook":false,"pointer":"/paths/~1internal-transfer/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create an internal transfer","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Creates an internal transfer between two merchant accounts.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateInternalTransferRequest"}},"schemaId":"components/schemas/CreateInternalTransferRequest","pointer":"/paths/~1internal-transfer/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/internal-transfer","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateInternalTransferRequest"}},"responseCodes":["201","400","401"],"pointer":"/internal-transfer","href":"internal_transfer/createinternaltransfer","openApiOperationId":"createInternalTransfer","summary":"Create an internal transfer"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"schemaId":"components/schemas/CreateInternalTransferRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateInternalTransferRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Internal transfer created successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/InternalTransfer"}},"schemaId":"components/schemas/InternalTransfer"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_129"}},"schemaId":"schema_129"},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_65"}},"schemaId":"schema_65"}],"pointer":"/paths/~1internal-transfer/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/InternalTransfer","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/InternalTransfer"}}},{"code":"400","schemaId":"schema_129","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_129"}}},{"code":"401","schemaId":"schema_65","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_65"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/internal_transfer/createinternaltransfer"}],"panels":[]}]},"httpPath":"/internal-transfer"}],"content":{"contentType":"group","meta":{"name":"internal_transfer"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Internal Transfer","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":"This resource represents internal fund movements between merchant accounts within the platform–partner model. Internal transfers enable seamless fund movement between merchants who operate under the same platform account. Internal transfers are restricted to accounts linked under the same platform hierarchy. The following transfer directions are supported:"},"children":[]}]}]},{"$$mdtype":"Node","type":"table","attributes":{},"children":[{"$$mdtype":"Node","type":"thead","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Transfer Type"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"tbody","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","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":"P → C"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"From a "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Platform"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (P) account to one of its "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Child"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (C) merchant accounts."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","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":"C → P"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"From a "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Child"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (C) merchant account back to its "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Platform"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (P) account."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","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":"C → C (same P)"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Between "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Child"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (C) accounts under the same "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Platform"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (P)."},"children":[]}]}]}]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Schemas","titleTranslationKey":"schemas","items":[{"title":"InternalTransfer","link":"/internal_transfer/internaltransfer","deprecated":false}]},{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/internal-transfer","summary":"Create an internal transfer","prefix":{"name":"post","color":"post"},"badges":[],"link":"/internal_transfer/createinternaltransfer","deprecated":false}]}]}]}]}},{"type":"separator","label":"Settlement","content":null},{"type":"group","label":"Settlement","link":"/api-reference/openapi/settlement","routeSlug":"/api-reference/openapi/settlement","items":[{"type":"link","label":"Settlement","link":"/api-reference/openapi/settlement/settlement","routeSlug":"/api-reference/openapi/settlement/settlement","httpVerb":"schema","content":{"contentType":"item","itemVariant":"schema","meta":{"name":"Settlement"},"seo":{"title":"Settlement"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Settlement","showPageActions":true}],"panels":[]},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"schemaDefinition","attributes":{"showWriteOnly":true,"schemaRef":"#/components/schemas/Settlement"},"children":[]}]}]}},{"label":"Create a new settlement","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/settlement/createsettlement","routeSlug":"/api-reference/openapi/settlement/createsettlement","metadata":{"seo":{"title":"Create a new settlement","description":"Withdraws an amount from one of your currency balances to the withdrawal account registered for thatcurrency, and returns the resulting settlement in pending."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createSettlement","name":"Create a new settlement","isWebhook":false,"pointer":"/paths/~1settlements/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a new settlement","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":"Withdraws an amount from one of your currency balances to the withdrawal account registered for that"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"currency, and returns the resulting settlement in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pending"},"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":"Only available to businesses on manual settlement mode. On automatic settlement mode Glomo initiates"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"settlements for you and this call returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"403"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — it is not a way to pull a settlement forward."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The destination is not something you choose per request. There is no account field: the withdrawal"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"account already registered against "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"balance_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is used, and a currency with no registered"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"withdrawal account returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"404"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". To settle to a different bank, change the registered withdrawal"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"account rather than the request."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"balance_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in upper case. Unlike most currency parameters on this API it is matched"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"exactly, so a lower-case code will not find your withdrawal account and returns the same "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"404"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateSettlementRequest"}},"schemaId":"components/schemas/CreateSettlementRequest","pointer":"/paths/~1settlements/post/requestBody","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Provide both the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"balance_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/settlements","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateSettlementRequest"}},"responseCodes":["201","400","403","404"],"pointer":"/settlements","href":"settlement/createsettlement","openApiOperationId":"createSettlement","summary":"Create a new settlement"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"schemaId":"components/schemas/CreateSettlementRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateSettlementRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Settlement created successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Settlement"}},"schemaId":"components/schemas/Settlement"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_130"}},"schemaId":"schema_130"},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_131"}},"schemaId":"schema_131"},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_132"}},"schemaId":"schema_132"}],"pointer":"/paths/~1settlements/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/Settlement","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Settlement"}}},{"code":"400","schemaId":"schema_130","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_130"}}},{"code":"403","schemaId":"schema_131","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_131"}}},{"code":"404","schemaId":"schema_132","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_132"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/settlement/createsettlement"}],"panels":[]}]},"httpPath":"/settlements"},{"label":"List all settlements","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/settlement/getsettlements","routeSlug":"/api-reference/openapi/settlement/getsettlements","metadata":{"seo":{"title":"List all settlements","description":"Returns a list of your settlements. The settlements are returned sorted by creation date, with the most recent settlement appearing first."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getSettlements","name":"List all settlements","isWebhook":false,"pointer":"/paths/~1settlements/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List all settlements","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns a list of your settlements. The settlements are returned sorted by creation date, with the most recent settlement appearing first.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"before","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return only resources created at or before this time. Send an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_8601"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" timestamp with an offset, such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-02-18T12:03:44Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-02-18T17:33:44+05:30"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A timestamp without an offset is read as UTC. A bare date ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") means the end of that day in UTC ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"23:59:59.999999Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). An invalid value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Use this to avoid page drift. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/platform/pagination#parameters"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameters"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"example":"2025-02-18T12:03:44Z"},{"name":"after","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return only resources created at or after this time. Send an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_8601"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" timestamp with an offset, such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-01-18T12:03:44Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-01-18T17:33:44+05:30"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A timestamp without an offset is read as UTC. A bare date ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") means the start of that day in UTC ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"00:00:00Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). An invalid value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Use this to avoid page drift. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/platform/pagination#parameters"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameters"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"example":"2025-01-18T12:03:44Z"},{"name":"per_page","in":"query","schemaId":"schema_8","description":"Number of resources per page. Should be between 1 and 100."},{"name":"page","in":"query","schemaId":"schema_9","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Page number for pagination. Starts from 1. Get the next page number from the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"next"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field in the response."},"children":[]}]}]}]}],"pointer":"/paths/~1settlements/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/settlements","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"before","in":"query","example":"2025-02-18T12:03:44Z","schemaId":"schema_7"},{"name":"after","in":"query","example":"2025-01-18T12:03:44Z","schemaId":"schema_7"},{"name":"per_page","in":"query","schemaId":"schema_8"},{"name":"page","in":"query","schemaId":"schema_9"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","400"],"pointer":"/settlements","href":"settlement/getsettlements","openApiOperationId":"getSettlements","summary":"List all settlements"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"List of withdrawals matching the filters","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_133"}},"schemaId":"schema_133"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_11"}},"schemaId":"schema_11"}],"pointer":"/paths/~1settlements/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_133","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_133"}}},{"code":"400","schemaId":"schema_11","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_11"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/settlement/getsettlements"}],"panels":[]}]},"httpPath":"/settlements"},{"label":"Trigger a mock settlement","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/settlement/triggermocksettlement","routeSlug":"/api-reference/openapi/settlement/triggermocksettlement","metadata":{"seo":{"title":"Trigger a mock settlement","description":"This API is only available in sandbox mode. Queues a settlement run for your account so you can exercise settlements without a wait for the daily settlement schedule."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"triggerMockSettlement","name":"Trigger a mock settlement","isWebhook":false,"pointer":"/paths/~1settlements~1mock-trigger/post","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Trigger a mock settlement","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"This API is only available in sandbox mode. Queues a settlement run for your account so you can exercise settlements without a wait for the daily settlement schedule.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/settlements/mock-trigger","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["202","401","404"],"pointer":"/settlements/mock-trigger","href":"settlement/triggermocksettlement","openApiOperationId":"triggerMockSettlement","summary":"Trigger a mock settlement"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"202","description":"Settlement run accepted","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_134"}},"schemaId":"schema_134"},{"code":"401","description":"Unauthorized - Invalid or missing authentication token"},{"code":"404","description":"Not Found - Endpoint is unavailable outside sandbox"}],"pointer":"/paths/~1settlements~1mock-trigger/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"202","schemaId":"schema_134","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_134"}}},{"code":"401"},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/settlement/triggermocksettlement"}],"panels":[]}]},"httpPath":"/settlements/mock-trigger"},{"label":"Retrieve a settlement","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/settlement/getsettlementbyid","routeSlug":"/api-reference/openapi/settlement/getsettlementbyid","metadata":{"seo":{"title":"Retrieve a settlement","description":"Returns a specific settlement by its unique identifier."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getSettlementById","name":"Retrieve a settlement","isWebhook":false,"pointer":"/paths/~1settlements~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve a settlement","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns a specific settlement by its unique identifier.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the settlement. Starts with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"setl_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" followed by letters and digits. An ID of any other shape is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and a message saying it must start with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"setl_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; a well-formed ID that doesn't match a settlement on your account returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"404"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true,"example":"setl_6878e266jt1P3"}],"pointer":"/paths/~1settlements~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/settlements/{id}","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"setl_6878e266jt1P3","schemaId":"schema_7"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","400","404"],"pointer":"/settlements/{id}","href":"settlement/getsettlementbyid","openApiOperationId":"getSettlementById","summary":"Retrieve a settlement"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Settlement found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Settlement"}},"schemaId":"components/schemas/Settlement"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_11"}},"schemaId":"schema_11"},{"code":"404","description":"Settlement not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}},"schemaId":"components/schemas/EntityNotFound"}],"pointer":"/paths/~1settlements~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/Settlement","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Settlement"}}},{"code":"400","schemaId":"schema_11","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_11"}}},{"code":"404","schemaId":"components/schemas/EntityNotFound","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/settlement/getsettlementbyid"}],"panels":[]}]},"httpPath":"/settlements/{id}"},{"label":"Retrieve transactions linked to a settlement","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/settlement/gettransactionslinkedtosettlement","routeSlug":"/api-reference/openapi/settlement/gettransactionslinkedtosettlement","metadata":{"seo":{"title":"Retrieve transactions linked to a settlement","description":"Returns a list of transactions that are linked to a specific settlement by its unique identifier."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getTransactionsLinkedToSettlement","name":"Retrieve transactions linked to a settlement","isWebhook":false,"pointer":"/paths/~1settlements~1{id}~1transactions/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve transactions linked to a settlement","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns a list of transactions that are linked to a specific settlement by its unique identifier.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the settlement. Starts with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"setl_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" followed by letters and digits. An ID of any other shape is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and a message saying it must start with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"setl_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; a well-formed ID that doesn't match a settlement on your account returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"404"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true,"example":"setl_6878e266jt1P3"}],"pointer":"/paths/~1settlements~1{id}~1transactions/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"before","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return only resources created at or before this time. Send an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_8601"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" timestamp with an offset, such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-02-18T12:03:44Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-02-18T17:33:44+05:30"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A timestamp without an offset is read as UTC. A bare date ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") means the end of that day in UTC ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"23:59:59.999999Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). An invalid value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Use this to avoid page drift. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/platform/pagination#parameters"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameters"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"example":"2025-02-18T12:03:44Z"},{"name":"after","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return only resources created at or after this time. Send an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_8601"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" timestamp with an offset, such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-01-18T12:03:44Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-01-18T17:33:44+05:30"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A timestamp without an offset is read as UTC. A bare date ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") means the start of that day in UTC ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"00:00:00Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). An invalid value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Use this to avoid page drift. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/platform/pagination#parameters"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameters"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"example":"2025-01-18T12:03:44Z"},{"name":"per_page","in":"query","schemaId":"schema_8","description":"Number of resources per page. Should be between 1 and 100."},{"name":"page","in":"query","schemaId":"schema_9","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Page number for pagination. Starts from 1. Get the next page number from the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"next"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field in the response."},"children":[]}]}]}]}],"pointer":"/paths/~1settlements~1{id}~1transactions/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/settlements/{id}/transactions","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"setl_6878e266jt1P3","schemaId":"schema_7"}],"query":[{"name":"before","in":"query","example":"2025-02-18T12:03:44Z","schemaId":"schema_7"},{"name":"after","in":"query","example":"2025-01-18T12:03:44Z","schemaId":"schema_7"},{"name":"per_page","in":"query","schemaId":"schema_8"},{"name":"page","in":"query","schemaId":"schema_9"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","400","404"],"pointer":"/settlements/{id}/transactions","href":"settlement/gettransactionslinkedtosettlement","openApiOperationId":"getTransactionsLinkedToSettlement","summary":"Retrieve transactions linked to a settlement"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"List of Transactions matching the filters","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_135"}},"schemaId":"schema_135"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_11"}},"schemaId":"schema_11"},{"code":"404","description":"Settlement not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}},"schemaId":"components/schemas/EntityNotFound"}],"pointer":"/paths/~1settlements~1{id}~1transactions/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_135","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_135"}}},{"code":"400","schemaId":"schema_11","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_11"}}},{"code":"404","schemaId":"components/schemas/EntityNotFound","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/settlement/gettransactionslinkedtosettlement"}],"panels":[]}]},"httpPath":"/settlements/{id}/transactions"}],"content":{"contentType":"group","meta":{"name":"Settlement"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Settlement","showPageActions":true},{"nodeType":"markdoc","content":"This resource represents the settlement details. The settlement is the process of transferring funds from your Glomo account to your bank account."}],"panels":[{"children":[{"kind":"group-items","title":"Schemas","titleTranslationKey":"schemas","items":[{"title":"Settlement","link":"/settlement/settlement","deprecated":false}]},{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/settlements","summary":"Create a new settlement","prefix":{"name":"post","color":"post"},"badges":[],"link":"/settlement/createsettlement","deprecated":false},{"title":"/settlements","summary":"List all settlements","prefix":{"name":"get","color":"get"},"badges":[],"link":"/settlement/getsettlements","deprecated":false},{"title":"/settlements/mock-trigger","summary":"Trigger a mock settlement","prefix":{"name":"post","color":"post"},"badges":[],"link":"/settlement/triggermocksettlement","deprecated":false},{"title":"/settlements/{id}","summary":"Retrieve a settlement","prefix":{"name":"get","color":"get"},"badges":[],"link":"/settlement/getsettlementbyid","deprecated":false},{"title":"/settlements/{id}/transactions","summary":"Retrieve transactions linked to a settlement","prefix":{"name":"get","color":"get"},"badges":[],"link":"/settlement/gettransactionslinkedtosettlement","deprecated":false}]}]}]}]}},{"type":"separator","label":"Virtual Account","content":null},{"type":"group","label":"Virtual Account","link":"/api-reference/openapi/virtual_account","routeSlug":"/api-reference/openapi/virtual_account","items":[{"type":"link","label":"VirtualAccount","link":"/api-reference/openapi/virtual_account/virtualaccount","routeSlug":"/api-reference/openapi/virtual_account/virtualaccount","httpVerb":"schema","content":{"contentType":"item","itemVariant":"schema","meta":{"name":"VirtualAccount"},"seo":{"title":"VirtualAccount"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"VirtualAccount","showPageActions":true}],"panels":[]},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"schemaDefinition","attributes":{"showWriteOnly":true,"schemaRef":"#/components/schemas/VirtualAccount"},"children":[]}]}]}},{"label":"List all Virtual Accounts","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/virtual_account/getvirtualaccounts","routeSlug":"/api-reference/openapi/virtual_account/getvirtualaccounts","metadata":{"seo":{"title":"List all Virtual Accounts","description":"Returns the customer's virtual accounts, sorted by creation date (newest first), using the customer's JWT token for access."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getVirtualAccounts","name":"List all Virtual Accounts","isWebhook":false,"pointer":"/paths/~1virtual-accounts/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List all Virtual Accounts","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns the customer's virtual accounts, sorted by creation date (newest first), using the customer's JWT token for access.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"currency","in":"query","schemaId":"schema_136","description":"Filter virtual accounts by currency"},{"name":"before","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return only resources created at or before this time. Send an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_8601"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" timestamp with an offset, such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-02-18T12:03:44Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-02-18T17:33:44+05:30"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A timestamp without an offset is read as UTC. A bare date ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") means the end of that day in UTC ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"23:59:59.999999Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). An invalid value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Use this to avoid page drift. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/platform/pagination#parameters"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameters"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"example":"2025-02-18T12:03:44Z"},{"name":"after","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return only resources created at or after this time. Send an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_8601"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" timestamp with an offset, such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-01-18T12:03:44Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-01-18T17:33:44+05:30"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A timestamp without an offset is read as UTC. A bare date ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") means the start of that day in UTC ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"00:00:00Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). An invalid value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Use this to avoid page drift. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/platform/pagination#parameters"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameters"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"example":"2025-01-18T12:03:44Z"},{"name":"per_page","in":"query","schemaId":"schema_8","description":"Number of resources per page. Should be between 1 and 100."},{"name":"page","in":"query","schemaId":"schema_9","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Page number for pagination. Starts from 1. Get the next page number from the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"next"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field in the response."},"children":[]}]}]}]}],"pointer":"/paths/~1virtual-accounts/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/virtual-accounts","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"currency","in":"query","example":"USD","schemaId":"components/schemas/Currency"},{"name":"before","in":"query","example":"2025-02-18T12:03:44Z","schemaId":"schema_7"},{"name":"after","in":"query","example":"2025-01-18T12:03:44Z","schemaId":"schema_7"},{"name":"per_page","in":"query","schemaId":"schema_8"},{"name":"page","in":"query","schemaId":"schema_9"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","400","401"],"pointer":"/virtual-accounts","href":"virtual_account/getvirtualaccounts","openApiOperationId":"getVirtualAccounts","summary":"List all Virtual Accounts"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"List of virtual accounts matching the filters","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_137"}},"schemaId":"schema_137"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_138"}},"schemaId":"schema_138"},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_65"}},"schemaId":"schema_65"}],"pointer":"/paths/~1virtual-accounts/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_137","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_137"}}},{"code":"400","schemaId":"schema_138","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_138"}}},{"code":"401","schemaId":"schema_65","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_65"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/virtual_account/getvirtualaccounts"}],"panels":[]}]},"httpPath":"/virtual-accounts"},{"label":"Close a Virtual Account","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/virtual_account/closevirtualaccount","routeSlug":"/api-reference/openapi/virtual_account/closevirtualaccount","metadata":{"seo":{"title":"Close a Virtual Account","description":"Closing active virtual accounts will be based on the specified payment type and currency. The endpoint closes all virtual accounts for a given payment type and currency. Once closed, the virtual account will no longer accept payments."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"closeVirtualAccount","name":"Close a Virtual Account","isWebhook":false,"pointer":"/paths/~1virtual-accounts/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Close a Virtual Account","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Closing active virtual accounts will be based on the specified payment type and currency. The endpoint closes all virtual accounts for a given payment type and currency. Once closed, the virtual account will no longer accept payments.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"payment_type","in":"query","schemaId":"schema_139","description":"The type of payments this virtual account accepts. 'local' for domestic payments within the same country, 'swift' for cross-border payments.\n","required":true,"example":"local"},{"name":"currency","in":"query","schemaId":"schema_136","description":"The currency of the virtual account to close in ISO 4217 format.\n","required":true,"example":"AED"}],"pointer":"/paths/~1virtual-accounts/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/virtual-accounts","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"payment_type","in":"query","required":true,"example":"local","schemaId":"schema_139"},{"name":"currency","in":"query","required":true,"example":"AED","schemaId":"components/schemas/Currency"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","400","401"],"pointer":"/virtual-accounts","href":"virtual_account/closevirtualaccount","openApiOperationId":"closeVirtualAccount","summary":"Close a Virtual Account"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Virtual account closed successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_140"}},"schemaId":"schema_140"},{"code":"400","description":"Bad request - Active account not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_141"}},"schemaId":"schema_141"},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_65"}},"schemaId":"schema_65"}],"pointer":"/paths/~1virtual-accounts/delete/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_140","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_140"}}},{"code":"400","schemaId":"schema_141","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_141"}}},{"code":"401","schemaId":"schema_65","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_65"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/virtual_account/closevirtualaccount"}],"panels":[]}]},"httpPath":"/virtual-accounts"},{"label":"Create a Virtual Account (v2)","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/virtual_account/createvirtualaccountv2","routeSlug":"/api-reference/openapi/virtual_account/createvirtualaccountv2","metadata":{"seo":{"title":"Create a Virtual Account (v2)","description":"Creates a new virtual account with the specified payment type and currency. Virtual accounts provide unique account numbers that can be used to receive payments for customers. This endpoint returns HTTP 202 indicating the request has been accepted and is being processed. You will receive a webhook notification when the virtual account is activated."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createVirtualAccountV2","name":"Create a Virtual Account (v2)","isWebhook":false,"pointer":"/paths/~1v2~1virtual-accounts/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a Virtual Account (v2)","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":"Creates a new virtual account with the specified payment type and currency. Virtual accounts provide unique account numbers that can be used to receive payments for customers. This endpoint returns HTTP 202 indicating the request has been accepted and is being processed. You will receive a "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://glomo-payments--45ac07.preview.redocly.app/api-documentation/webhooks/virtual-account"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"webhook notification"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when the virtual account is activated."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_142"}},"schemaId":"schema_142","pointer":"/paths/~1v2~1virtual-accounts/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v2/virtual-accounts","servers":[{"url":"https://api.glomopay.com/api","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_142"}},"responseCodes":["202","400","401","409"],"pointer":"/v2/virtual-accounts","href":"virtual_account/createvirtualaccountv2","openApiOperationId":"createVirtualAccountV2","summary":"Create a Virtual Account (v2)"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api","description":"Production server"}],"schemaId":"schema_142","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_142"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"202","description":"Virtual account creation request is accepted","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_143","exampleIds":["paths/~1v2~1virtual-accounts/post/responses/202/content/application~1json/example"]}},"schemaId":"schema_143","exampleIds":["paths/~1v2~1virtual-accounts/post/responses/202/content/application~1json/example"]},{"code":"400","description":"Bad request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_138"}},"schemaId":"schema_138"},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_65"}},"schemaId":"schema_65"},{"code":"409","description":"Conflict - Record already exists","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_144"}},"schemaId":"schema_144"}],"pointer":"/paths/~1v2~1virtual-accounts/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"202","schemaId":"schema_143","exampleIds":["paths/~1v2~1virtual-accounts/post/responses/202/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_143","exampleIds":["paths/~1v2~1virtual-accounts/post/responses/202/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_138","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_138"}}},{"code":"401","schemaId":"schema_65","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_65"}}},{"code":"409","schemaId":"schema_144","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_144"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/virtual_account/createvirtualaccountv2"}],"panels":[]}]},"httpPath":"/v2/virtual-accounts"}],"content":{"contentType":"group","meta":{"name":"virtual_account"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Virtual Account","showPageActions":true},{"nodeType":"markdoc","content":"This resource represents virtual account details. A virtual account is a unique account number provisioned for a customer, allowing payments to be received and transactions to be tracked against that customer."}],"panels":[{"children":[{"kind":"group-items","title":"Schemas","titleTranslationKey":"schemas","items":[{"title":"VirtualAccount","link":"/virtual_account/virtualaccount","deprecated":false}]},{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/virtual-accounts","summary":"List all Virtual Accounts","prefix":{"name":"get","color":"get"},"badges":[],"link":"/virtual_account/getvirtualaccounts","deprecated":false},{"title":"/virtual-accounts","summary":"Close a Virtual Account","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/virtual_account/closevirtualaccount","deprecated":false},{"title":"/v2/virtual-accounts","summary":"Create a Virtual Account (v2)","prefix":{"name":"post","color":"post"},"badges":[],"link":"/virtual_account/createvirtualaccountv2","deprecated":false}]}]}]}]}},{"type":"separator","label":"Platform","content":null},{"type":"group","label":"Platform","link":"/api-reference/openapi/platform","routeSlug":"/api-reference/openapi/platform","items":[{"type":"link","label":"Merchant","link":"/api-reference/openapi/platform/merchant","routeSlug":"/api-reference/openapi/platform/merchant","httpVerb":"schema","content":{"contentType":"item","itemVariant":"schema","meta":{"name":"Merchant"},"seo":{"title":"Merchant"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Merchant","showPageActions":true}],"panels":[]},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"schemaDefinition","attributes":{"showWriteOnly":true,"schemaRef":"#/components/schemas/Merchant"},"children":[]}]}]}},{"label":"Onboard a merchant","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/platform/onboardmerchant","routeSlug":"/api-reference/openapi/platform/onboardmerchant","metadata":{"seo":{"title":"Onboard a merchant","description":"Allows platforms to onboard a new merchant onto Glomo."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"onboardMerchant","name":"Onboard a merchant","isWebhook":false,"pointer":"/paths/~1platform~1merchants/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Onboard a merchant","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Allows platforms to onboard a new merchant onto Glomo.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateMerchantRequest","exampleIds":["paths/~1platform~1merchants/post/requestBody/content/application~1json/examples/individual","paths/~1platform~1merchants/post/requestBody/content/application~1json/examples/business"]}},"schemaId":"components/schemas/CreateMerchantRequest","exampleIds":["paths/~1platform~1merchants/post/requestBody/content/application~1json/examples/individual","paths/~1platform~1merchants/post/requestBody/content/application~1json/examples/business"],"pointer":"/paths/~1platform~1merchants/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/platform/merchants","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateMerchantRequest","exampleIds":["paths/~1platform~1merchants/post/requestBody/content/application~1json/examples/individual","paths/~1platform~1merchants/post/requestBody/content/application~1json/examples/business"]}},"responseCodes":["201","202","400","401"],"pointer":"/platform/merchants","href":"platform/onboardmerchant","openApiOperationId":"onboardMerchant","summary":"Onboard a merchant"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"schemaId":"components/schemas/CreateMerchantRequest","exampleIds":["paths/~1platform~1merchants/post/requestBody/content/application~1json/examples/individual","paths/~1platform~1merchants/post/requestBody/content/application~1json/examples/business"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateMerchantRequest","exampleIds":["paths/~1platform~1merchants/post/requestBody/content/application~1json/examples/individual","paths/~1platform~1merchants/post/requestBody/content/application~1json/examples/business"]}},"examples":[{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Merchant onboarded successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/MerchantCreateResponse"}},"schemaId":"components/schemas/MerchantCreateResponse"},{"code":"202","description":"Merchant has been created and submitted for KYB review. It is not active until the review is approved.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/MerchantKybReviewResponse"}},"schemaId":"components/schemas/MerchantKybReviewResponse"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_129"}},"schemaId":"schema_129"},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_65"}},"schemaId":"schema_65"}],"pointer":"/paths/~1platform~1merchants/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"components/schemas/MerchantCreateResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/MerchantCreateResponse"}}},{"code":"202","schemaId":"components/schemas/MerchantKybReviewResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/MerchantKybReviewResponse"}}},{"code":"400","schemaId":"schema_129","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_129"}}},{"code":"401","schemaId":"schema_65","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_65"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/platform/onboardmerchant"}],"panels":[]}]},"httpPath":"/platform/merchants"},{"label":"Retrieve a merchant","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/platform/getmerchant","routeSlug":"/api-reference/openapi/platform/getmerchant","metadata":{"seo":{"title":"Retrieve a merchant","description":"Retrieves details of a specific merchant by their merchant ID."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getMerchant","name":"Retrieve a merchant","isWebhook":false,"pointer":"/paths/~1platform~1merchants~1{merchant_id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve a merchant","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves details of a specific merchant by their merchant ID.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"merchant_id","in":"path","schemaId":"schema_145","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unique identifier of the merchant. Starts with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"merch_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" followed by letters and digits. An ID of any other shape is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and a message saying it must start with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"merch_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; a well-formed ID that doesn't match a merchant under your platform account returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"404"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1platform~1merchants~1{merchant_id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/platform/merchants/{merchant_id}","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[{"name":"merchant_id","in":"path","required":true,"example":"merch_68c777fcOOMpl","schemaId":"schema_145"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","400","401","404"],"pointer":"/platform/merchants/{merchant_id}","href":"platform/getmerchant","openApiOperationId":"getMerchant","summary":"Retrieve a merchant"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Merchant retrieved successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Merchant"}},"schemaId":"components/schemas/Merchant"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_146"}},"schemaId":"schema_146"},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_147"}},"schemaId":"schema_147"},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_148"}},"schemaId":"schema_148"}],"pointer":"/paths/~1platform~1merchants~1{merchant_id}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/Merchant","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Merchant"}}},{"code":"400","schemaId":"schema_146","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_146"}}},{"code":"401","schemaId":"schema_147","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_147"}}},{"code":"404","schemaId":"schema_148","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_148"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/platform/getmerchant"}],"panels":[]}]},"httpPath":"/platform/merchants/{merchant_id}"},{"label":"Update a merchant","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/platform/updatemerchant","routeSlug":"/api-reference/openapi/platform/updatemerchant","metadata":{"seo":{"title":"Update a merchant","description":"Updates an existing merchant. Currently supports attaching a passportobject for individual merchants and a registration_date for businessmerchants; more fields may be supported in future."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateMerchant","name":"Update a merchant","isWebhook":false,"pointer":"/paths/~1platform~1merchants~1{merchant_id}/patch","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a merchant","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":"Updates an existing merchant. Currently supports attaching a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"passport"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"object for individual merchants and a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"registration_date"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for business"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"merchants; more fields may be supported in future."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The applicable field is determined by the merchant's entity type, set at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"onboarding, rather than by the request body: send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"passport"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for an"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"individual merchant and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"registration_date"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for a business merchant. A field"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"that does not apply to the merchant's entity type is ignored."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"merchant_id","in":"path","schemaId":"schema_145","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unique identifier of the merchant. Starts with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"merch_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" followed by letters and digits. An ID of any other shape, or one that doesn't match a merchant under your platform account, returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"404"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1platform~1merchants~1{merchant_id}/patch/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateMerchantRequest","exampleIds":["paths/~1platform~1merchants~1{merchant_id}/patch/requestBody/content/application~1json/examples/individual","paths/~1platform~1merchants~1{merchant_id}/patch/requestBody/content/application~1json/examples/business"]}},"schemaId":"components/schemas/UpdateMerchantRequest","exampleIds":["paths/~1platform~1merchants~1{merchant_id}/patch/requestBody/content/application~1json/examples/individual","paths/~1platform~1merchants~1{merchant_id}/patch/requestBody/content/application~1json/examples/business"],"pointer":"/paths/~1platform~1merchants~1{merchant_id}/patch/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/platform/merchants/{merchant_id}","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[{"name":"merchant_id","in":"path","required":true,"example":"merch_68c777fcOOMpl","schemaId":"schema_145"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UpdateMerchantRequest","exampleIds":["paths/~1platform~1merchants~1{merchant_id}/patch/requestBody/content/application~1json/examples/individual","paths/~1platform~1merchants~1{merchant_id}/patch/requestBody/content/application~1json/examples/business"]}},"responseCodes":["200","400","401","404"],"pointer":"/platform/merchants/{merchant_id}","href":"platform/updatemerchant","openApiOperationId":"updateMerchant","summary":"Update a merchant"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"schemaId":"components/schemas/UpdateMerchantRequest","exampleIds":["paths/~1platform~1merchants~1{merchant_id}/patch/requestBody/content/application~1json/examples/individual","paths/~1platform~1merchants~1{merchant_id}/patch/requestBody/content/application~1json/examples/business"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateMerchantRequest","exampleIds":["paths/~1platform~1merchants~1{merchant_id}/patch/requestBody/content/application~1json/examples/individual","paths/~1platform~1merchants~1{merchant_id}/patch/requestBody/content/application~1json/examples/business"]}},"examples":[{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Merchant updated successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Merchant"}},"schemaId":"components/schemas/Merchant"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_149"}},"schemaId":"schema_149"},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_147"}},"schemaId":"schema_147"},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_150"}},"schemaId":"schema_150"}],"pointer":"/paths/~1platform~1merchants~1{merchant_id}/patch/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/Merchant","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Merchant"}}},{"code":"400","schemaId":"schema_149","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_149"}}},{"code":"401","schemaId":"schema_147","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_147"}}},{"code":"404","schemaId":"schema_150","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_150"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/platform/updatemerchant"}],"panels":[]}]},"httpPath":"/platform/merchants/{merchant_id}"},{"label":"Update merchant status","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/platform/updatemerchantstatus","routeSlug":"/api-reference/openapi/platform/updatemerchantstatus","metadata":{"seo":{"title":"Update merchant status","description":"Allows platforms to update the status of a merchant. This endpoint is available in non-production environments only."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateMerchantStatus","name":"Update merchant status","isWebhook":false,"pointer":"/paths/~1platform~1merchants~1status-update/patch","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update merchant status","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Allows platforms to update the status of a merchant. This endpoint is available in non-production environments only.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_151"}},"schemaId":"schema_151","pointer":"/paths/~1platform~1merchants~1status-update/patch/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/platform/merchants/status-update","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_151"}},"responseCodes":["200","400","401"],"pointer":"/platform/merchants/status-update","href":"platform/updatemerchantstatus","openApiOperationId":"updateMerchantStatus","summary":"Update merchant status"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"schemaId":"schema_151","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_151"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Merchant status updated successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Merchant"}},"schemaId":"components/schemas/Merchant"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_152"}},"schemaId":"schema_152"},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_153"}},"schemaId":"schema_153"}],"pointer":"/paths/~1platform~1merchants~1status-update/patch/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/Merchant","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Merchant"}}},{"code":"400","schemaId":"schema_152","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_152"}}},{"code":"401","schemaId":"schema_153","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_153"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/platform/updatemerchantstatus"}],"panels":[]}]},"httpPath":"/platform/merchants/status-update"}],"content":{"contentType":"group","meta":{"name":"platform"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Platform","showPageActions":true},{"nodeType":"markdoc","content":"This resource provides platform functionality that enables platforms to onboard merchants onto Glomo, with each merchant having their own dedicated Virtual Accounts (VA)."}],"panels":[{"children":[{"kind":"group-items","title":"Schemas","titleTranslationKey":"schemas","items":[{"title":"Merchant","link":"/platform/merchant","deprecated":false}]},{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/platform/merchants","summary":"Onboard a merchant","prefix":{"name":"post","color":"post"},"badges":[],"link":"/platform/onboardmerchant","deprecated":false},{"title":"/platform/merchants/{merchant_id}","summary":"Retrieve a merchant","prefix":{"name":"get","color":"get"},"badges":[],"link":"/platform/getmerchant","deprecated":false},{"title":"/platform/merchants/{merchant_id}","summary":"Update a merchant","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/platform/updatemerchant","deprecated":false},{"title":"/platform/merchants/status-update","summary":"Update merchant status","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/platform/updatemerchantstatus","deprecated":false}]}]}]}]}},{"type":"separator","label":"KYC","content":null},{"type":"group","label":"KYC Link","link":"/api-reference/openapi/kyclink","routeSlug":"/api-reference/openapi/kyclink","items":[{"type":"link","label":"KycLinkDetail","link":"/api-reference/openapi/kyclink/kyclinkdetail","routeSlug":"/api-reference/openapi/kyclink/kyclinkdetail","httpVerb":"schema","content":{"contentType":"item","itemVariant":"schema","meta":{"name":"KycLinkDetail"},"seo":{"title":"KycLinkDetail"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"KycLinkDetail","showPageActions":true}],"panels":[]},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"schemaDefinition","attributes":{"showWriteOnly":true,"schemaRef":"#/components/schemas/KycLinkDetail"},"children":[]}]}]}},{"label":"List KYC links","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/kyclink/listkyclinks","routeSlug":"/api-reference/openapi/kyclink/listkyclinks","metadata":{"seo":{"title":"List KYC links","description":"Returns a list of KYC links. The links are returned sorted by creation date, with the most recent links appearing first. Optionally filter by status."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listKycLinks","name":"List KYC links","isWebhook":false,"pointer":"/paths/~1kyc-links/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List KYC links","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns a list of KYC links. The links are returned sorted by creation date, with the most recent links appearing first. Optionally filter by status.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"status","in":"query","schemaId":"schema_154","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter KYC links by status. Uses the same values as the KYC link's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field."},"children":[]}]}]}],"example":"completed"},{"name":"before","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return only resources created at or before this time. Send an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_8601"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" timestamp with an offset, such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-02-18T12:03:44Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-02-18T17:33:44+05:30"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A timestamp without an offset is read as UTC. A bare date ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") means the end of that day in UTC ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"23:59:59.999999Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). An invalid value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Use this to avoid page drift. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/platform/pagination#parameters"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameters"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"example":"2025-02-18T12:03:44Z"},{"name":"after","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return only resources created at or after this time. Send an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_8601"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" timestamp with an offset, such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-01-18T12:03:44Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-01-18T17:33:44+05:30"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A timestamp without an offset is read as UTC. A bare date ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") means the start of that day in UTC ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"00:00:00Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). An invalid value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Use this to avoid page drift. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/platform/pagination#parameters"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameters"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"example":"2025-01-18T12:03:44Z"},{"name":"per_page","in":"query","schemaId":"schema_8","description":"Number of resources per page. Should be between 1 and 100."},{"name":"page","in":"query","schemaId":"schema_9","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Page number for pagination. Starts from 1. Get the next page number from the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"next"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field in the response."},"children":[]}]}]}]}],"pointer":"/paths/~1kyc-links/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/kyc-links","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"status","in":"query","example":"completed","schemaId":"schema_154"},{"name":"before","in":"query","example":"2025-02-18T12:03:44Z","schemaId":"schema_7"},{"name":"after","in":"query","example":"2025-01-18T12:03:44Z","schemaId":"schema_7"},{"name":"per_page","in":"query","schemaId":"schema_8"},{"name":"page","in":"query","schemaId":"schema_9"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","400","401"],"pointer":"/kyc-links","href":"kyclink/listkyclinks","openApiOperationId":"listKycLinks","summary":"List KYC links"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"List of KYC links matching the criteria.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_155"}},"schemaId":"schema_155"},{"code":"400","description":"Bad request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_156"}},"schemaId":"schema_156"},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_65"}},"schemaId":"schema_65"}],"pointer":"/paths/~1kyc-links/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_155","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_155"}}},{"code":"400","schemaId":"schema_156","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_156"}}},{"code":"401","schemaId":"schema_65","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_65"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/kyclink/listkyclinks"}],"panels":[]}]},"httpPath":"/kyc-links"},{"label":"Create a KYC link","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/kyclink/createkyclink","routeSlug":"/api-reference/openapi/kyclink/createkyclink","metadata":{"seo":{"title":"Create a KYC link","description":"Creates a KYC link that can be shared with a customer to complete identity verification. Optionally associate with an existing customer via customer_id, or with a new customer via email. Both fields are optional and mutually exclusive — passing both will return a 400 error. Omitting both creates an unlinked KYC link."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createKycLink","name":"Create a KYC link","isWebhook":false,"pointer":"/paths/~1kyc-links/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a KYC link","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":"Creates a KYC link that can be shared with a customer to complete identity verification. Optionally associate with an existing customer via "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"customer_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or with a new customer via "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"email"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Both fields are optional and mutually exclusive — passing both will return a 400 error. Omitting both creates an unlinked KYC link."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"By default ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"send_email: true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"), Glomo will send the link to the customer's email address automatically. Set "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"send_email: false"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to suppress the email and distribute the link yourself."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The response contains a summary of the created KYC link. To retrieve full details — including the customer ID, status tracker, and submitted documents — use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /kyc-links/{id}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_157","exampleIds":["paths/~1kyc-links/post/requestBody/content/application~1json/example"]}},"schemaId":"schema_157","exampleIds":["paths/~1kyc-links/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1kyc-links/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/kyc-links","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_157","exampleIds":["paths/~1kyc-links/post/requestBody/content/application~1json/example"]}},"responseCodes":["201","400","401"],"pointer":"/kyc-links","href":"kyclink/createkyclink","openApiOperationId":"createKycLink","summary":"Create a KYC link"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"schemaId":"schema_157","exampleIds":["paths/~1kyc-links/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_157","exampleIds":["paths/~1kyc-links/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"KYC link created successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_158","exampleIds":["paths/~1kyc-links/post/responses/201/content/application~1json/example"]}},"schemaId":"schema_158","exampleIds":["paths/~1kyc-links/post/responses/201/content/application~1json/example"]},{"code":"400","description":"Bad request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_159"}},"schemaId":"schema_159"},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_65"}},"schemaId":"schema_65"}],"pointer":"/paths/~1kyc-links/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"201","schemaId":"schema_158","exampleIds":["paths/~1kyc-links/post/responses/201/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_158","exampleIds":["paths/~1kyc-links/post/responses/201/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_159","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_159"}}},{"code":"401","schemaId":"schema_65","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_65"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/kyclink/createkyclink"}],"panels":[]}]},"httpPath":"/kyc-links"},{"label":"Retrieve a KYC link","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/kyclink/getkyclinkbyid","routeSlug":"/api-reference/openapi/kyclink/getkyclinkbyid","metadata":{"seo":{"title":"Retrieve a KYC link","description":"Retrieves the details of a KYC link by its unique identifier, including the verification status, customer ID and the list of KYC documents submitted."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getKycLinkById","name":"Retrieve a KYC link","isWebhook":false,"pointer":"/paths/~1kyc-links~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve a KYC link","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":"Retrieves the details of a KYC link by its unique identifier, including the verification status, customer ID and the list of KYC documents submitted."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Each document in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"documents"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" array includes a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"document_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field. When the document "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"captured"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"document_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (e.g. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"doc_nYUqLpuYQ0M8"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") can be passed to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /api/v1/document/{document_id}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to retrieve full document details such as the preview URL and file name. The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"document_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when the document has not yet been uploaded ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status: not_captured"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_7","description":"The unique identifier of the KYC link.","required":true,"example":"kyc_69b3f97eSThQY"}],"pointer":"/paths/~1kyc-links~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/kyc-links/{id}","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"kyc_69b3f97eSThQY","schemaId":"schema_7"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","401","404"],"pointer":"/kyc-links/{id}","href":"kyclink/getkyclinkbyid","openApiOperationId":"getKycLinkById","summary":"Retrieve a KYC link"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"KYC link retrieved successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/KycLinkDetail","exampleIds":["paths/~1kyc-links~1{id}/get/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/KycLinkDetail","exampleIds":["paths/~1kyc-links~1{id}/get/responses/200/content/application~1json/example"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_65"}},"schemaId":"schema_65"},{"code":"404","description":"KYC link not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_160"}},"schemaId":"schema_160"}],"pointer":"/paths/~1kyc-links~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/KycLinkDetail","exampleIds":["paths/~1kyc-links~1{id}/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/KycLinkDetail","exampleIds":["paths/~1kyc-links~1{id}/get/responses/200/content/application~1json/example"]}}},{"code":"401","schemaId":"schema_65","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_65"}}},{"code":"404","schemaId":"schema_160","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_160"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/kyclink/getkyclinkbyid"}],"panels":[]}]},"httpPath":"/kyc-links/{id}"}],"content":{"contentType":"group","meta":{"name":"KycLink"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"KYC Link","showPageActions":true},{"nodeType":"markdoc","content":"A KYC link is a shareable URL sent to a customer to complete identity verification. Use this resource to retrieve the KYC link details, including submission status and the documents captured during the verification process."}],"panels":[{"children":[{"kind":"group-items","title":"Schemas","titleTranslationKey":"schemas","items":[{"title":"KycLinkDetail","link":"/kyclink/kyclinkdetail","deprecated":false}]},{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/kyc-links","summary":"List KYC links","prefix":{"name":"get","color":"get"},"badges":[],"link":"/kyclink/listkyclinks","deprecated":false},{"title":"/kyc-links","summary":"Create a KYC link","prefix":{"name":"post","color":"post"},"badges":[],"link":"/kyclink/createkyclink","deprecated":false},{"title":"/kyc-links/{id}","summary":"Retrieve a KYC link","prefix":{"name":"get","color":"get"},"badges":[],"link":"/kyclink/getkyclinkbyid","deprecated":false}]}]}]}]}},{"type":"separator","label":"Investor Portal","content":null},{"type":"group","label":"Investor Journey","link":"/api-reference/openapi/investor_journey","routeSlug":"/api-reference/openapi/investor_journey","items":[{"label":"Create investor journey","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/investor_journey/createinvestorjourney","routeSlug":"/api-reference/openapi/investor_journey/createinvestorjourney","metadata":{"seo":{"title":"Create investor journey","description":"Creates an investor portal URL for the given email, PAN, and scheme. Requires a platform merchant JWT."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createInvestorJourney","name":"Create investor journey","isWebhook":false,"pointer":"/paths/~1investor-journey/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create investor journey","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Creates an investor portal URL for the given email, PAN, and scheme. Requires a platform merchant JWT.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_161","exampleIds":["paths/~1investor-journey/post/requestBody/content/application~1json/example"]}},"schemaId":"schema_161","exampleIds":["paths/~1investor-journey/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1investor-journey/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/investor-journey","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_161","exampleIds":["paths/~1investor-journey/post/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","401"],"pointer":"/investor-journey","href":"investor_journey/createinvestorjourney","openApiOperationId":"createInvestorJourney","summary":"Create investor journey"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"schemaId":"schema_161","exampleIds":["paths/~1investor-journey/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_161","exampleIds":["paths/~1investor-journey/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_162","exampleIds":["paths/~1investor-journey/post/responses/200/content/application~1json/example"]}},"schemaId":"schema_162","exampleIds":["paths/~1investor-journey/post/responses/200/content/application~1json/example"]},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bad Request — validation failed (email/PAN), or scheme_no is unknown or not owned by a child merchant of this platform."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_163","exampleIds":["paths/~1investor-journey/post/responses/400/content/application~1json/examples/validation_failed","paths/~1investor-journey/post/responses/400/content/application~1json/examples/scheme_not_found"]}},"schemaId":"schema_163","exampleIds":["paths/~1investor-journey/post/responses/400/content/application~1json/examples/validation_failed","paths/~1investor-journey/post/responses/400/content/application~1json/examples/scheme_not_found"]},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized — missing/invalid JWT, or the caller is not a platform merchant."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_164","exampleIds":["paths/~1investor-journey/post/responses/401/content/application~1json/examples/missing_token","paths/~1investor-journey/post/responses/401/content/application~1json/examples/not_platform"]}},"schemaId":"schema_164","exampleIds":["paths/~1investor-journey/post/responses/401/content/application~1json/examples/missing_token","paths/~1investor-journey/post/responses/401/content/application~1json/examples/not_platform"]}],"pointer":"/paths/~1investor-journey/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_162","exampleIds":["paths/~1investor-journey/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_162","exampleIds":["paths/~1investor-journey/post/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_163","exampleIds":["paths/~1investor-journey/post/responses/400/content/application~1json/examples/validation_failed","paths/~1investor-journey/post/responses/400/content/application~1json/examples/scheme_not_found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_163","exampleIds":["paths/~1investor-journey/post/responses/400/content/application~1json/examples/validation_failed","paths/~1investor-journey/post/responses/400/content/application~1json/examples/scheme_not_found"]}}},{"code":"401","schemaId":"schema_164","exampleIds":["paths/~1investor-journey/post/responses/401/content/application~1json/examples/missing_token","paths/~1investor-journey/post/responses/401/content/application~1json/examples/not_platform"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_164","exampleIds":["paths/~1investor-journey/post/responses/401/content/application~1json/examples/missing_token","paths/~1investor-journey/post/responses/401/content/application~1json/examples/not_platform"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/investor_journey/createinvestorjourney"}],"panels":[]}]},"httpPath":"/investor-journey"}],"content":{"contentType":"group","meta":{"name":"investor_journey"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Investor Journey","showPageActions":true},{"nodeType":"markdoc","content":"Create investor journey. Platform merchant JWT required."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/investor-journey","summary":"Create investor journey","prefix":{"name":"post","color":"post"},"badges":[],"link":"/investor_journey/createinvestorjourney","deprecated":false}]}]}]}]}},{"type":"separator","label":"Request for Information","content":null},{"type":"group","label":"RFI","link":"/api-reference/openapi/rfi","routeSlug":"/api-reference/openapi/rfi","items":[{"label":"List RFIs","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/rfi/getrfis","routeSlug":"/api-reference/openapi/rfi/getrfis","metadata":{"seo":{"title":"List RFIs","description":"Returns your business's RFIs across every entity type — payments, payins, payouts, refunds, orders and subscriptions — not just a single resource. Use status and search to filter the list, and the pagination parameters to page through results. Results are ordered by created_at descending."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getRfis","name":"List RFIs","isWebhook":false,"pointer":"/paths/~1rfis/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List RFIs","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":"Returns your business's RFIs across every entity type — payments, payins, payouts, refunds, orders and subscriptions — not just a single resource. Use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"search"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to filter the list, and the pagination parameters to page through results. Results are ordered by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"created_at"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" descending."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"status","in":"query","schemaId":"schema_165","description":"Filter RFIs by status.","example":"approved"},{"name":"search","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by an exact match on either the RFI's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or the underlying entity's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"rfi_6a7c5018ZGuKP"},{"name":"before","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return only resources created at or before this time. Send an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_8601"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" timestamp with an offset, such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-02-18T12:03:44Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-02-18T17:33:44+05:30"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A timestamp without an offset is read as UTC. A bare date ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") means the end of that day in UTC ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"23:59:59.999999Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). An invalid value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Use this to avoid page drift. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/platform/pagination#parameters"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameters"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"example":"2025-02-18T12:03:44Z"},{"name":"after","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return only resources created at or after this time. Send an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_8601"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" timestamp with an offset, such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-01-18T12:03:44Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2025-01-18T17:33:44+05:30"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A timestamp without an offset is read as UTC. A bare date ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") means the start of that day in UTC ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"00:00:00Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). An invalid value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Use this to avoid page drift. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/platform/pagination#parameters"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameters"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more details."},"children":[]}]}]}],"example":"2025-01-18T12:03:44Z"},{"name":"per_page","in":"query","schemaId":"schema_8","description":"Number of resources per page. Should be between 1 and 100."},{"name":"page","in":"query","schemaId":"schema_9","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Page number for pagination. Starts from 1. Get the next page number from the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"next"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field in the response."},"children":[]}]}]}]}],"pointer":"/paths/~1rfis/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/rfis","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"status","in":"query","example":"approved","schemaId":"schema_165"},{"name":"search","in":"query","example":"rfi_6a7c5018ZGuKP","schemaId":"schema_7"},{"name":"before","in":"query","example":"2025-02-18T12:03:44Z","schemaId":"schema_7"},{"name":"after","in":"query","example":"2025-01-18T12:03:44Z","schemaId":"schema_7"},{"name":"per_page","in":"query","schemaId":"schema_8"},{"name":"page","in":"query","schemaId":"schema_9"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","400","401"],"pointer":"/rfis","href":"rfi/getrfis","openApiOperationId":"getRfis","summary":"List RFIs"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"List of RFIs matching the filters","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_166"}},"schemaId":"schema_166"},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bad Request. The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" filter is not a recognized value."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_167"}},"schemaId":"schema_167"},{"code":"401","description":"Unauthorized"}],"pointer":"/paths/~1rfis/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_166","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_166"}}},{"code":"400","schemaId":"schema_167","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_167"}}},{"code":"401"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/rfi/getrfis"}],"panels":[]}]},"httpPath":"/rfis"},{"label":"Fetch an RFI","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/rfi/getrfi","routeSlug":"/api-reference/openapi/rfi/getrfi","metadata":{"seo":{"title":"Fetch an RFI","description":"Returns the full detail of a single RFI, including its status, the documents required to resolve it, the instructions to follow, and any reviewer or uploader comments. The RFI is looked up by its id (starting with rfi_), exposed on the underlying resource (for example the rfi object on a Payment) or in the List RFIs response."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getRfi","name":"Fetch an RFI","isWebhook":false,"pointer":"/paths/~1rfis~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Fetch an RFI","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":"Returns the full detail of a single RFI, including its status, the documents required to resolve it, the instructions to follow, and any reviewer or uploader comments. The RFI is looked up by its "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (starting with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rfi_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"), exposed on the underlying resource (for example the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rfi"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" object on a Payment) or in the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/api-reference/openapi/rfi/getrfis"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List RFIs"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" response."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An RFI belonging to a different business, or an unknown "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"404"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the response does not distinguish the two, so RFI existence is not leaked."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the RFI to fetch. Starts with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rfi_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true,"example":"rfi_6a7c5018ZGuKP"}],"pointer":"/paths/~1rfis~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/rfis/{id}","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"rfi_6a7c5018ZGuKP","schemaId":"schema_7"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","401","404"],"pointer":"/rfis/{id}","href":"rfi/getrfi","openApiOperationId":"getRfi","summary":"Fetch an RFI"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"The RFI detail","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/RfiDetail"}},"schemaId":"components/schemas/RfiDetail"},{"code":"401","description":"Unauthorized"},{"code":"404","description":"The RFI could not be found, or does not belong to your business.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}},"schemaId":"components/schemas/EntityNotFound"}],"pointer":"/paths/~1rfis~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/RfiDetail","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/RfiDetail"}}},{"code":"401"},{"code":"404","schemaId":"components/schemas/EntityNotFound","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/rfi/getrfi"}],"panels":[]}]},"httpPath":"/rfis/{id}"},{"label":"Respond to an RFI","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-reference/openapi/rfi/respondrfi","routeSlug":"/api-reference/openapi/rfi/respondrfi","metadata":{"seo":{"title":"Respond to an RFI","description":"Submits the documents requested by a Request for Information (RFI). An RFI is raised when Glomo's compliance checks need additional information — for example, a sanctions-screening hold — before a transaction can be completed. Respond to it using the RFI id exposed on the underlying resource (for example, the rfi.id field on a Payment), or from the rfi webhook sent when the RFI is raised. Payout RFIs can be answered here too; the payout object and payout webhooks don't include the RFI id, so take it from the rfi webhook. See Handle RFI for a Payout."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"respondRfi","name":"Respond to an RFI","isWebhook":false,"pointer":"/paths/~1rfis~1{id}~1respond/patch","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Respond to an RFI","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":"Submits the documents requested by a Request for Information (RFI). An RFI is raised when Glomo's compliance checks need additional information — for example, a sanctions-screening hold — before a transaction can be completed. Respond to it using the RFI "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" exposed on the underlying resource (for example, the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rfi.id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field on a Payment), or from the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rfi"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" webhook sent when the RFI is raised. Payout RFIs can be answered here too; the payout object and payout webhooks don't include the RFI "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", so take it from the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rfi"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" webhook. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/request-for-information/handle-rfi-for-a-payout"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Handle RFI for a Payout"},"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":"Upload each document first using the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/api-reference/openapi/document/createdocument"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create a Document"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint, then submit the resulting "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"doc_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"doc_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") against the matching "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rfi_doc_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" from the RFI's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"documents_required"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" list. Once the documents are submitted successfully, the RFI status transitions to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"submitted"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and the final decision is communicated via the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/platform/webhooks/rfi"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rfi"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" webhook"},"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":"For RFIs that also ask for structured values, read them from the RFI's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fields_required"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" list and send them as a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fields"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" object."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"JWT","scopes":[],"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_7","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the RFI to respond to. Starts with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rfi_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":true,"example":"rfi_6a72a39b38jDD"}],"pointer":"/paths/~1rfis~1{id}~1respond/patch/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_168"}},"schemaId":"schema_168","pointer":"/paths/~1rfis~1{id}~1respond/patch/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/rfis/{id}/respond","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"rfi_6a72a39b38jDD","schemaId":"schema_7"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_168"}},"responseCodes":["200","400","401","403","404","422"],"pointer":"/rfis/{id}/respond","href":"rfi/respondrfi","openApiOperationId":"respondRfi","summary":"Respond to an RFI"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"schemaId":"schema_168","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_168"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The RFI response was submitted successfully; the RFI transitions to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"submitted"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Rfi"}},"schemaId":"components/schemas/Rfi"},{"code":"400","description":"Bad request.\n","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_169"}},"schemaId":"schema_169"},{"code":"401","description":"Unauthorized"},{"code":"403","description":"Forbidden. The RFI belongs to a different business."},{"code":"404","description":"The RFI, or a referenced document, could not be found.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}},"schemaId":"components/schemas/EntityNotFound"},{"code":"422","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The RFI is not awaiting information — for example, it has already been submitted, or is approved, rejected, superseded, expired, or cancelled — and cannot be responded to."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_170"}},"schemaId":"schema_170"}],"pointer":"/paths/~1rfis~1{id}~1respond/patch/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/Rfi","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Rfi"}}},{"code":"400","schemaId":"schema_169","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_169"}}},{"code":"401"},{"code":"403"},{"code":"404","schemaId":"components/schemas/EntityNotFound","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}}},{"code":"422","schemaId":"schema_170","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_170"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/rfi/respondrfi"}],"panels":[]}]},"httpPath":"/rfis/{id}/respond"}],"content":{"contentType":"group","meta":{"name":"rfi"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"RFI","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":"A Request for Information (RFI) is raised when Glomo's compliance checks need additional information — most commonly supporting documents such as a passport — before a transaction can be completed, for example when a payment is placed on a sanctions-screening hold. The RFI "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is exposed on the underlying resource (for example, the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rfi"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" object on a Payment). Use this resource to submit the requested documents and resolve the RFI, including an RFI raised on a payout."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/rfis","summary":"List RFIs","prefix":{"name":"get","color":"get"},"badges":[],"link":"/rfi/getrfis","deprecated":false},{"title":"/rfis/{id}","summary":"Fetch an RFI","prefix":{"name":"get","color":"get"},"badges":[],"link":"/rfi/getrfi","deprecated":false},{"title":"/rfis/{id}/respond","summary":"Respond to an RFI","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/rfi/respondrfi","deprecated":false}]}]}]}]}}],"store":{"schemaStore":{"components/schemas/Balance":{"id":"components/schemas/Balance","kind":"json-schema","title":"Balance","data":{"type":"object","x-tags":["Balance"],"properties":{"currency":{"type":"string","format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency code in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format. For example, USD."},"children":[]}]}]}],"example":"USD"},"amount":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The balance amount in the smallest currency unit. For example, if the amount is $299.00, then 29900 is passed in  this field. In the case of three decimal currencies, such as KWD, BHD and OMR, to represent an amount of 295.991, pass the value as 295990. And in the case of zero decimal currencies such as JPY, for amount ￥295, pass the value as 295."},"children":[]}]}]}],"example":1000}}}},"components/schemas/AllBalances":{"id":"components/schemas/AllBalances","kind":"json-schema","title":"AllBalances","data":{"type":"object","x-tags":["Balance"],"properties":{"available":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The available balance for all currencies. Each entry's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is in the smallest unit of its "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"array","items":{"type":"object","properties":{"currency":{"type":"string","format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency code in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format. For example, USD."},"children":[]}]}]}],"example":"USD"},"amount":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The balance amount in the smallest currency unit. For example, if the amount is $299.00, then 29900 is passed in this field. In the case of three decimal currencies, such as KWD, BHD and OMR, to represent an amount of 295.991, pass the value as 295990. And in the case of zero decimal currencies such as JPY, for amount ￥295, pass the value as 295."},"children":[]}]}]}],"example":1000}}}},"pending":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The pending balance for all currencies. Each entry's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is in the smallest unit of its "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"array","items":{"type":"object","properties":{"currency":{"type":"string","format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency code in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format. For example, USD."},"children":[]}]}]}],"example":"USD"},"amount":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The balance amount in the smallest currency unit. For example, if the amount is $299.00, then 29900 is passed in this field. In the case of three decimal currencies, such as KWD, BHD and OMR, to represent an amount of 295.991, pass the value as 295990. And in the case of zero decimal currencies such as JPY, for amount ￥295, pass the value as 295."},"children":[]}]}]}],"example":1000}}}},"deficit":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The amount owed to Glomo, for all currencies. Each entry's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is in the smallest unit of its "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". This is non-zero when a chargeback or RFI debit was applied against an insufficient balance; it is cleared automatically on your next top-up."},"children":[]}]}]}],"type":"array","items":{"type":"object","properties":{"currency":{"type":"string","format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency code in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format. For example, USD."},"children":[]}]}]}],"example":"USD"},"amount":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The balance amount in the smallest currency unit. For example, if the amount is $299.00, then 29900 is passed in this field. In the case of three decimal currencies, such as KWD, BHD and OMR, to represent an amount of 295.991, pass the value as 295990. And in the case of zero decimal currencies such as JPY, for amount ￥295, pass the value as 295."},"children":[]}]}]}],"example":1000}}}},"funded_balances":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Funded Balance, broken down by state, with every "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in the smallest unit of its "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". This key is present only for merchants on the Funded Balance model; it is absent for all other merchants."},"children":[]}]}]}],"type":"object","properties":{"available":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The available balance, by currency, that can be drawn for debits. Each entry's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is in the smallest unit of its "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"array","items":{"$ref":"#/components/schemas/Balance"}},"pending":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The pending balance, by currency, awaiting maturity to available. Each entry's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is in the smallest unit of its "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"array","items":{"$ref":"#/components/schemas/Balance"}},"deficit":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The amount, by currency, owed to Glomo. Each entry's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is in the smallest unit of its "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". This is non-zero when a chargeback or RFI debit was applied against an insufficient Funded Balance; it is cleared automatically on your next Add Balance top-up."},"children":[]}]}]}],"type":"array","items":{"$ref":"#/components/schemas/Balance"}}}}}}},"components/schemas/Money":{"id":"components/schemas/Money","kind":"json-schema","title":"Money","data":{"type":"object","properties":{"amount":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A positive integer representing the smallest currency unit.  For example, if the amount is $299.00, then pass 29900 in this field.  In the case of three decimal currencies, such as KWD, BHD and OMR, to represent an amount of 295.991, pass the value as 295990.  And in the case of zero decimal currencies such as JPY, for amount ￥295, pass the value as 295."},"children":[]}]}]}],"example":1000},"currency":{"type":"string","format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency code in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format. For example, USD."},"children":[]}]}]}],"example":"USD"}}}},"components/schemas/ConversionRate":{"id":"components/schemas/ConversionRate","kind":"json-schema","title":"ConversionRate","data":{"type":"object","x-tags":["ConversionRate"],"properties":{"currency":{"type":"string","format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency code in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format. For example, USD."},"children":[]}]}]}],"example":"USD"},"rate":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Units of the currency converted to ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"to.currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") per one unit of the currency converted from ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"from.currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"), rounded to 2 decimal places. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1.4"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" means 1 unit of the source currency converts to 1.40 of the target currency. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when no rate was recorded."},"children":[]}]}]}],"example":1.4}}}},"components/schemas/BalanceConversion":{"id":"components/schemas/BalanceConversion","kind":"json-schema","title":"BalanceConversion","data":{"type":"object","x-tags":["balance_conversions"],"properties":{"id":{"type":"string","readOnly":true,"description":"The unique identifier for the balance balance.\n","example":"conv_6776d57dnbTWj"},"from":{"type":"object","$ref":"#/components/schemas/Money","description":"the amount and currency of the balance used for conversion\n"},"to":{"type":"object","$ref":"#/components/schemas/Money","description":"the amount and currency of the balance after conversion\n"},"fees":{"type":"object","$ref":"#/components/schemas/Money","description":"Total fees for the conversion\n"},"mid_market_rate":{"type":"object","$ref":"#/components/schemas/ConversionRate","description":"The mid-market rate at the time of conversion\n"},"status":{"type":"string","readOnly":true,"enum":["pending","success","failed"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The status of the balance conversion."},"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":"code","inline":true,"attributes":{"content":"pending"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the conversion has been created and has not completed yet."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"success"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the converted amount has been credited. Terminal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"failed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the conversion did not complete. Terminal."},"children":[]}]}]}]}],"example":"success"},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"When the balance conversion was created, as an ISO 8601 date-time in UTC.\n","example":"2021-01-01T00:00:00Z"}}}},"components/schemas/PageMeta":{"id":"components/schemas/PageMeta","kind":"json-schema","title":"PageMeta","data":{"type":"object","properties":{"current":{"type":"integer","description":"The current page number.\n","example":2},"previous":{"type":["integer","null"],"description":"The previous page number.\n","example":1},"next":{"type":["integer","null"],"description":"The next page number.\n","example":3},"per_page":{"type":"integer","description":"The number of items per page.\n","example":20},"pages":{"type":"integer","description":"The total number of pages.\n","example":10},"count":{"type":"integer","description":"The total number of items.\n","example":200}}}},"components/schemas/BankAccountValidation":{"id":"components/schemas/BankAccountValidation","kind":"json-schema","title":"BankAccountValidation","data":{"type":"object","x-tags":["bank_account_validation"],"properties":{"id":{"type":"string","readOnly":true,"description":"The unique identifier for the bank account validation.\n","example":"aval_5JU9yv0lGSUP"},"status":{"type":"string","enum":["success","failed"],"description":"The status of the bank account validation. This does not mean the bank account is valid or invalid. It means the validation process was successful or failed.\n"},"validation_message":{"type":"string","description":"The message returned by the bank account validation process.\n","example":"The account is registered to John Doe"},"fee_charged":{"type":["object","null"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The fee charged for the bank account validation. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when no fee was charged."},"children":[]}]}]}],"properties":{"cents":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The fee in the smallest unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency_iso"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (cents for USD). "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"100"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $1.00 when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency_iso"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is USD."},"children":[]}]}]}],"example":100},"currency_iso":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency of the fee, as an uppercase "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" code. Always "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"USD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"USD"}}}}}},"components/schemas/BankAccount":{"id":"components/schemas/BankAccount","kind":"json-schema","title":"BankAccount","data":{"type":"object","x-tags":["bank_account"],"properties":{"country":{"type":"string","format":"iso-3166-1-alpha-3","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The country where the customer is located. Country should be sent as a "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 3166-1 alpha-3"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" code, case-insensitive."},"children":[]}]}]}],"example":"Ind"},"holder_name":{"type":"string","description":"The name of the account holder.\n","example":"John Doe"},"account_number":{"type":"string","description":"The account number of the bank account as provided by the bank.\n","example":"987654321001"},"bic_primary":{"type":"string","description":"The primary BIC of the bank account. This is the BIC of the bank where the account is held. This is also known as the SWIFT code.\n","example":"QWERIN000"},"bic_secondary":{"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":"local routing code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"domestic clearing code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of the bank account. For reference, this is the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"IFSC"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" code in India, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"SORT"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in UK, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ABA"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in the US, etc."},"children":[]}]}]}],"example":"YESB0000002"}}}},"components/schemas/Notes":{"id":"components/schemas/Notes","kind":"json-schema","title":"Notes","data":{"type":["object","null"],"additionalProperties":{"type":"string"},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Optional key-value pairs for attaching custom metadata (e.g. invoice references, project codes). Keys must be strings and cannot collide with reserved field names. Your account may require some "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"notes"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" fields: Glomo configures custom field rules per account, and for beneficiaries they are checked when the beneficiary is created. Some fields are also validated by the beneficiary's country (for example, a PAN format for Indian beneficiaries). A missing required field returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"422"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Validation failed: Notes <field> is required"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and type and validation errors (such as enum constraints) are returned the same way. The rule is set on your account, not by currency or rail. No API lists the fields, but the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"422"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" names each missing one: add that key to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"notes"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with the value your account expects, and ask your Glomo account manager if you don't know what the field should hold. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/payin/custom-fields"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Custom fields"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Each key appears as a separate column in CSV report exports, with corresponding values populating the rows."},"children":[]}]}]}],"example":{"invoice_ref":"INV-2026-001","project":"Alpha"}}},"components/schemas/BeneficiaryV2":{"id":"components/schemas/BeneficiaryV2","kind":"json-schema","title":"BeneficiaryV2","data":{"type":"object","x-tags":["beneficiary_v2"],"properties":{"id":{"type":"string","readOnly":true,"description":"The unique identifier for the beneficiary.\n","example":"ben_5JU9yv0lGSUP"},"name":{"type":"string","description":"The name of the beneficiary.\n","example":"ACME Corporation"},"type":{"type":"string","enum":["individual","business"],"description":"The type of beneficiary.\n","example":"business"},"category":{"type":"string","enum":["payout","lrs"],"readOnly":true,"description":"The category of the beneficiary.\n","example":"payout"},"email":{"type":"string","format":"email","description":"The email address of the beneficiary.\n","example":"finance@acme.com"},"phone":{"type":"string","description":"The phone number of the beneficiary.\n","example":"+1-555-123-4567"},"nickname":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A nickname for the beneficiary. If not provided, auto-generated as \"{beneficiary_name} - {bank_name}\"."},"children":[]}]}]}],"example":"ACME Primary Account"},"address":{"type":"object","description":"The address of the beneficiary.\n","properties":{"address_line1":{"type":"string","description":"The street address of the beneficiary.","example":"123 Business Park"},"address_line2":{"type":"string","description":"The second line of street address of the beneficiary.","example":"Suite 100"},"city":{"type":"string","description":"The city where the beneficiary is located.","example":"New York"},"state":{"type":"string","description":"The state or administrative area where the beneficiary is located.","example":"NY"},"country_code":{"type":"string","format":"iso-3166-1-alpha-3","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The country where the beneficiary is located. Country should be sent as a "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 3166-1 alpha-3"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" code."},"children":[]}]}]}],"example":"USA"},"postal_code":{"type":"string","description":"The postal code of the beneficiary's address.","example":"10001"}}},"bank_account":{"type":"object","description":"The bank account details of the beneficiary.\n","properties":{"account_number":{"type":"string","description":"The account number of the beneficiary.","example":"1234567890"},"name":{"type":"string","description":"The name of the bank where the account is held.","example":"Citibank NA"},"swift_code":{"type":"string","description":"The SWIFT/BIC code of the bank. Must be 8-11 characters with first 6 being letters only.\n","example":"CITIUS33"},"local_routing_number":{"type":"string","description":"The local routing code or domestic clearing code of the bank account. For reference, this is the IFSC code in India, SORT in UK, ABA in the US, etc.\n","example":"021000089"},"currency":{"type":"string","description":"The currency of the bank account.","example":"USD"},"address":{"type":"object","description":"The address of the bank.","properties":{"address_line1":{"type":"string","description":"The street address of the bank.","example":"388 Greenwich Street"},"address_line2":{"type":"string","description":"The second line of street address of the bank.","example":""},"city":{"type":"string","description":"The city where the bank is located.","example":"New York"},"state":{"type":"string","description":"The state or administrative area where the bank is located.","example":"NY"},"country_code":{"type":"string","format":"iso-3166-1-alpha-3","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The country where the bank is located. Country should be sent as a "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 3166-1 alpha-3"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" code."},"children":[]}]}]}],"example":"USA"},"postal_code":{"type":"string","description":"The postal code of the bank's address.","example":"10013"}}},"intermediate_bank":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Details of the intermediate/correspondent bank. Present for LRS category beneficiaries (swift_code is required at creation). May be null for payout category beneficiaries."},"children":[]}]}]}],"properties":{"name":{"type":"string","description":"The name of the intermediate bank.","example":"JPMorgan Chase Bank"},"country":{"type":"string","format":"iso-3166-1-alpha-3","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The country of the intermediate bank. Country should be sent as a "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 3166-1 alpha-3"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" code."},"children":[]}]}]}],"example":"USA"},"swift_code":{"type":"string","description":"The SWIFT code of the intermediate bank.","example":"CHASUS33"},"account_number":{"type":"string","description":"The account number at the intermediate bank.","example":"123456789"}}}}},"status":{"type":"string","enum":["pending","active","rejected"],"readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The current review status of the beneficiary."},"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":"code","inline":true,"attributes":{"content":"active"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the beneficiary can receive payouts."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rejected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the beneficiary did not pass review and cannot receive payouts. Terminal."},"children":[]}]}]}]}],"example":"pending"},"documents":{"type":"array","readOnly":true,"description":"List of document IDs attached to the beneficiary.\n","items":{"type":"string"},"example":["doc_68e7980auYRAs"]},"upi_account":{"type":["object","null"],"description":"The UPI account details of the beneficiary. Present when the beneficiary uses UPI, otherwise null.\n","properties":{"upi_id":{"type":"string","description":"The UPI ID of the beneficiary.","example":"1111111111@ybl"}}},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"Timestamp representing when the beneficiary was created in ISO 8601 format.\n","example":"2025-01-15T10:00:00Z"},"updated_at":{"type":"string","format":"date-time","readOnly":true,"description":"Timestamp representing when the beneficiary was last updated in ISO 8601 format.\n","example":"2025-01-15T10:00:00Z"},"notes":{"$ref":"#/components/schemas/Notes"}}}},"components/schemas/BeneficiaryV2CreateRequest":{"id":"components/schemas/BeneficiaryV2CreateRequest","kind":"json-schema","title":"BeneficiaryV2CreateRequest","data":{"type":"object","required":["category","beneficiary"],"properties":{"category":{"type":"string","enum":["payout","lrs"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The category of the beneficiary."},"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":"code","inline":true,"attributes":{"content":"payout"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - the primary use case. Processes a payout from your Glomo balance."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"lrs"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - a specific case. Processes an LRS (Liberalised Remittance Scheme) payin whose funds"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"go directly to a customer-specific bank account rather than into your Glomo balance."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"account funding"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" beneficiary uses "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payout"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". It is the customer's own account - the account"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the card funds are credited to - not a third party."},"children":[]}]}]}],"example":"payout"},"beneficiary":{"type":"object","required":["name","type","address"],"description":"The beneficiary details including name, contact information, and address.\n","properties":{"name":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The name of the beneficiary. This is a required field. Reserved sandbox test values: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"jexru7"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nerqu8"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"havku9"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"dexru6"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"renvak4"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (any letter case) force a sanctions-screening hit when a payout to this beneficiary is screened."},"children":[]}]}]}],"example":"ACME Corporation"},"type":{"type":"string","enum":["individual","business"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The type of beneficiary. Must be either "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"individual"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"business"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"business"},"email":{"type":"string","format":"email","description":"The email address of the beneficiary.\n","example":"finance@acme.com"},"phone":{"type":"string","description":"The phone number of the beneficiary.\n","example":"+1-555-123-4567"},"nickname":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A nickname for the beneficiary. If not provided, it will be auto-generated as \"{beneficiary_name} - {bank_name}\"."},"children":[]}]}]}],"example":"ACME Primary Account"},"address":{"type":"object","required":["address_line1","city","state","country_code"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The address of the beneficiary. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"address_line1"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"city"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"state"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"country_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are required; "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"address_line2"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"postal_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are optional."},"children":[]}]}]}],"properties":{"address_line1":{"type":"string","description":"The street address of the beneficiary (required).","example":"123 Business Park"},"address_line2":{"type":"string","description":"The second line of street address of the beneficiary (optional).","example":"Suite 100"},"city":{"type":"string","description":"The city where the beneficiary is located (required).","example":"New York"},"state":{"type":"string","description":"The state or administrative area where the beneficiary is located (required).","example":"NY"},"country_code":{"type":"string","format":"iso-3166-1-alpha-3","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The country where the beneficiary is located (required). Country should be sent as a "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 3166-1 alpha-3"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" code."},"children":[]}]}]}],"example":"USA"},"postal_code":{"type":"string","description":"The postal code of the beneficiary's address (optional).","example":"10001"}}},"documents":{"type":"array","description":"Optional list of document IDs to attach to the beneficiary.\n","items":{"type":"string"},"example":["doc_68e7980auYRAs"]}}},"bank_account":{"type":"object","required":["account_number","currency"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The bank account details of the beneficiary."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"category: payout"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"address"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are resolved from the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"swift_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"local_routing_number"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or an IBAN "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"account_number"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Send them only if the identifier cannot be"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"resolved, or to override the resolved values. Both remain required for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"category: lrs"},"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":"Routing identifier rules differ by category:"},"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":"code","inline":true,"attributes":{"content":"category: lrs"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"local_routing_number"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is required. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"swift_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is optional."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"category: payout"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — provide exactly one of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"swift_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"local_routing_number"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", except"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"for EUR and AED accounts identified by an IBAN alone, which send neither."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For the rails each identifier maps to, see"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/payout/rails"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Payout rails"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"properties":{"account_number":{"type":"string","description":"The account number of the beneficiary (required).","example":"1234567890"},"name":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The name of the bank where the account is held. Required for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"category: lrs"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", optional for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"category: payout"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"Citibank NA"},"swift_code":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The SWIFT/BIC code of the bank. Must be 8-11 characters with first 6 being letters only. For LRS category it is optional, and must be exactly 8 characters (no branch suffix like XXX). For payout category, see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/payout/rails"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Payout rails"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"CITIUS33"},"local_routing_number":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The local routing code or domestic clearing code of the bank account. Required for LRS category, optional for payout category. For reference, this is the IFSC code in India, the sort code in the UK, ABA in the US, etc. For payout category, see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/payout/rails"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Payout rails"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"021000089"},"currency":{"type":"string","description":"The currency of the bank account (required).","example":"USD"},"address":{"type":"object","required":["address_line1","city","state","country_code"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The address of the bank. Required for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"category: lrs"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", optional for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"category: payout"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". When sent, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"address_line1"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"city"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"state"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"country_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are required; "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"address_line2"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"postal_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are optional."},"children":[]}]}]}],"properties":{"address_line1":{"type":"string","description":"The street address of the bank (required).","example":"388 Greenwich Street"},"address_line2":{"type":"string","description":"The second line of street address of the bank (optional).","example":""},"city":{"type":"string","description":"The city where the bank is located (required).","example":"New York"},"state":{"type":"string","description":"The state or administrative area where the bank is located (required).","example":"NY"},"country_code":{"type":"string","format":"iso-3166-1-alpha-3","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The country where the bank is located (required). Country should be sent as a "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 3166-1 alpha-3"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" code."},"children":[]}]}]}],"example":"USA"},"postal_code":{"type":"string","description":"The postal code of the bank's address (optional).","example":"10013"}}},"intermediate_bank":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Details of the intermediate/correspondent bank. "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"swift_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is required for LRS category beneficiaries."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Optional for payout category beneficiaries."},"children":[]}]}]}],"properties":{"name":{"type":"string","description":"The name of the intermediate bank (optional).","example":"JPMorgan Chase Bank"},"country":{"type":"string","format":"iso-3166-1-alpha-3","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The country of the intermediate bank (optional). Country should be sent as a "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 3166-1 alpha-3"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" code."},"children":[]}]}]}],"example":"USA"},"swift_code":{"type":"string","description":"The SWIFT/BIC code of the correspondent/intermediary bank used to route the remittance. Required for LRS category, optional for payout category.\n","example":"CHASUS33"},"account_number":{"type":"string","description":"The account number at the intermediate bank (optional).","example":"123456789"}}}}},"upi_account":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"UPI account details. Provide either bank_account or upi_account, not both."},"children":[]}]}]}],"properties":{"upi_id":{"type":"string","description":"The UPI ID of the beneficiary.","example":"1111111111@ybl"}}},"notes":{"$ref":"#/components/schemas/Notes"}}}},"components/schemas/EntityNotFound":{"id":"components/schemas/EntityNotFound","kind":"json-schema","title":"EntityNotFound","data":{"type":"object","properties":{"error":{"type":"string","enum":["Not found"]},"message":{"type":"string","description":"Entity not found","enum":["Entity not found"]}}}},"components/schemas/Customer":{"id":"components/schemas/Customer","kind":"json-schema","title":"Customer","data":{"type":"object","x-tags":["Customer"],"properties":{"id":{"type":"string","readOnly":true,"description":"The unique identifier for the customer.\n","example":"cust_5JU9yv0lGSUP"},"name":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The name of the customer. Reserved sandbox test values: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"jexru7"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"nerqu8"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"havku9"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"dexru6"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"renvak4"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (any letter case) force a sanctions-screening hit whenever this customer is screened."},"children":[]}]}]}],"example":"John Doe"},"customer_type":{"type":"string","enum":["individual","business"],"description":"The type of customer\n"},"email":{"type":"string","format":"email","description":"The email address of the customer.\n","example":"customer@gmail.com"},"phone":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The phone number of the customer, with country code. Phone number validation is done using the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://github.com/daddyz/phonelib?tab=readme-ov-file"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"phonelib"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" library."},"children":[]}]}]}],"example":"+91-9023456789"},"dob":{"type":"string","format":"date","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date of birth of the customer, as a calendar date in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format with no time or time zone. Must be a date before today."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Optional in general, "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"required for account funding"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" customers."},"children":[]}]}]}],"example":"2003-11-29"},"nationality":{"type":"string","format":"iso-3166-1-alpha-3","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The nationality of the customer, as an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 3166-1 alpha-3"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" code. The alpha-2 form is rejected: send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"IND"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", not "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"IN"},"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":"Optional in general, "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"required for account funding"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" customers."},"children":[]}]}]}],"example":"IND"},"tax_identification_number":{"type":"string","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The customer's PAN (tax identification number), derived from the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"kyc.pan_number"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" you send at creation. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" where you sent none, and also where PAN processing is not enabled for your account; the value you sent is stored either way. Searchable via the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"tax_identification_number"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" query parameter on the list-customers endpoint."},"children":[]}]}]}],"example":"BFQPG7654R"},"kyc":{"type":"object","writeOnly":true,"additionalProperties":false,"description":"The KYC records you already hold for this customer. Accepts exactly the two fields below.\n","properties":{"pan_number":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The customer's PAN. Surfaces on the customer as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"tax_identification_number"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Required for LRS customers in India."},"children":[]}]}]}],"example":"BFQPG7654R"},"last_kyc_date":{"type":"string","format":"date","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When you last completed KYC on this customer, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Cannot be in the future."},"children":[]}]}]}],"example":"2026-02-14"}}},"address":{"type":"string","description":"The street address of the customer.\n","example":"123 Main St"},"city":{"type":"string","description":"The city where the customer is located.\n","example":"Anytown"},"state":{"type":"string","description":"The state where the customer is located.\n","example":"Anystate"},"country":{"type":"string","format":"iso-3166-1-alpha-3","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The country where the customer is located. Country should be sent as a "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 3166-1 alpha-3"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" code."},"children":[]}]}]}],"example":"IND"},"pincode":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The postal code/pincode of the customer's address. "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/platform/countries#countries-requiring-pincode"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List of countries where pincode is mandatory"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are listed here."},"children":[]}]}]}],"example":"560048"},"status":{"type":"string","readOnly":true,"description":"The status of the customer.\n","example":"active"},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"When the customer was created, as an ISO 8601 date-time in UTC.\n","example":"2021-06-01T12:00:00Z"},"updated_at":{"type":"string","format":"date-time","readOnly":true,"description":"When the customer was last updated, as an ISO 8601 date-time in UTC.\n","example":"2021-06-01T12:00:00Z"}}}},"components/schemas/CustomerBankAccount":{"id":"components/schemas/CustomerBankAccount","kind":"json-schema","title":"CustomerBankAccount","data":{"type":"object","description":"A bank account registered against a customer.\n","properties":{"id":{"type":"string","description":"Unique identifier of the bank account.","readOnly":true,"example":"acccus_6a5f1c92Xq4Wd"},"account_number":{"type":"string","description":"The customer's bank account number or IBAN. Masked in every response, showing only the last four characters.\n","example":"50100123456789"},"bank_name":{"type":"string","description":"Name of the bank holding the account.","example":"HDFC bank"},"bic_primary":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"SWIFT/BIC code of the bank. Provide this or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bic_secondary"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"HDFCINBBXXX"},"bic_secondary":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Local routing code of the bank — IFSC in India, sort code in the United Kingdom, ABA routing number in the United States. Provide this or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bic_primary"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"HDFC0000123"},"holder_name":{"type":"string","description":"Name on the account. Always the customer's own name, so it is derived from the customer and cannot be set on the request.\n","readOnly":true,"example":"Priya Raghunathan"}}}},"components/schemas/LrsCustomerBankAccount":{"id":"components/schemas/LrsCustomerBankAccount","kind":"json-schema","title":"LrsCustomerBankAccount","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Indian bank account an LRS remittance is debited from. Pass its "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"lrs.bank_account_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on an LRS order."},"children":[]}]}]}],"properties":{"id":{"type":"string","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unique identifier of the LRS bank account. It starts with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"acclrs_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"acclrs_68468c03g9xt7"},"bank_code":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Code of the customer's bank. Must be a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bank_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" returned by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /lrs/banks"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for your account, matched exactly and case-sensitively. An LRS order that uses this account must use a quote created for the same "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bank_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or the order is rejected."},"children":[]}]}]}],"example":"hdfc"},"account_number":{"type":"string","description":"The customer's account number at that bank. Digits only, with a length inside the range that bank accepts. Returned in full, as sent, in the response.\n","example":"12345678901234"},"bank_customer_id":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Optional. The customer's identifier at their bank. For banks that use one, it must contain only digits, with a length inside the range that bank accepts; an invalid value is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"12345678"}}}},"components/schemas/Document":{"id":"components/schemas/Document","kind":"json-schema","title":"Document","data":{"type":"object","x-tags":["Document"],"properties":{"id":{"type":"string","readOnly":true,"description":"The unique identifier for the Document.\n","example":"doc_nYUqLpuYQ0M8"},"document_name":{"type":"string","description":"The name of document\n","example":"invoice"},"file_name":{"type":"string","readOnly":true,"description":"The name of the file you uploaded.\n","example":"invoice_BC8tFdE.pdf"},"preview_url":{"type":"string","readOnly":true,"description":"The URL to preview the document.\n","example":"https://glomopay-service-staging-documents.s3.ap-south-1.amazonaws.com/12345_invoice"},"status":{"type":"string","readOnly":true,"description":"The status of file you uploaded. Values can be uploaded, approved and rejected.\n","example":"uploaded"},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"When the document was created, as an ISO 8601 date-time in UTC.\n","example":"2021-06-01T12:00:00Z"},"updated_at":{"type":"string","format":"date-time","readOnly":true,"description":"When the document was last updated, as an ISO 8601 date-time in UTC.\n","example":"2021-06-01T12:00:00Z"}}}},"components/schemas/SplitIds":{"id":"components/schemas/SplitIds","kind":"json-schema","title":"SplitIds","data":{"type":"array","items":{"type":"string"},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The pricing splits to apply, each entry an "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" returned by "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#tag/pricing_split"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create a pricing split"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A split fixes your share of a dynamic rule's fee and the customer bears the remainder. Omit "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"split_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and no dynamic rule is applied — pricing falls back to your normal (non-dynamic) rules."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"split_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payment_methods"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are independent. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payment_methods"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" restricts which methods the checkout offers. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"split_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" only changes how the fee for a method is priced: a split applies to its own payment method whether or not that method appears in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payment_methods"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and a split never adds a method to the checkout or removes one from it. One checkout can therefore price one method from a dynamic split and another method from your normal rules."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Every id must exist, must belong to your business, and must still point at a live dynamic rule. When two dynamic rules share a dimension — the same payment method, subtype, rail, currency and fee type — declare a split for every one of them or the request is rejected. On payment links and orders, a split whose payment method is not enabled for your business is also rejected."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A subscription only ever charges "},"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":"pay_via_bank"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when SEPA-eligible, so a split declared for any other payment method is rejected at subscription creation and on an auto debit. An auto-debit override must be declared for the method the subscription actually charges."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Glomo can configure your account to require a declaration. On such an account, a payment link, an order, a payin quote or an "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"as_presented"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" subscription that omits "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"split_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is rejected."},"children":[]}]}]}],"example":["psplit_7Kq2mXbTdLp9"]}},"components/schemas/Product":{"id":"components/schemas/Product","kind":"json-schema","title":"Product","data":{"type":"object","description":"Details of the product that the payment is related to.\n","properties":{"name":{"type":"string","description":"Name of the product"},"description":{"type":"string","description":"Description of the product"}},"required":["name"],"example":{"name":"ShieldGuard Insurance","description":"Flexible insurance for belongings travel and digital assets easy to manage"}}},"components/schemas/LrsOrderDetails":{"id":"components/schemas/LrsOrderDetails","kind":"json-schema","title":"LrsOrderDetails","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Send this object to create an LRS order: a remittance from a customer resident in India, funded"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"from their Indian bank account. If you send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"lrs"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"lrs_quote_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"remittance_information"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"required."},"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":"Create the quote first with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /lrs/quotes"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The order's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" must equal the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"USD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" side of"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the quote ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"from.amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"USD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" source quote, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"to.amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for an "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INR"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" source quote), and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" must be "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"USD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Otherwise the order is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The quote must not have expired. The order expires when the quote does."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The customer's country must be India, otherwise the order is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An LRS order doesn't store "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"invoice_number"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"invoice_description"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"invoice_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":","},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"reference_number"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"document_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"product"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; they come back as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or are left out. A value"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"you send is still validated, so leave these fields out."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returned on the order when it was created as an LRS order."},"children":[]}]}]}],"properties":{"lrs_quote_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":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of a quote from "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /lrs/quotes"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", created by your account."},"children":[]}]}]}],"example":"quote_6ab60de4Kx7Pq"},"remittance_information":{"type":"string","maxLength":20,"pattern":"^[a-zA-Z0-9-]*$","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Your reference for the remittance. Up to 20 characters, using only letters, digits and hyphens; spaces and other characters are rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"REF12345"},"bank_account_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":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of the customer's LRS bank account, from "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /customer/{id}/bank_account"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Optional. It must belong to this customer and be at the same bank as the quote's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bank_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A bank account from "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /customer/{id}/bank-accounts"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not accepted here."},"children":[]}]}]}],"example":"acclrs_68468c03g9xt7"},"beneficiary_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":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of a beneficiary created with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"category: lrs"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" through "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /v2/beneficiaries"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", to receive the remittance. Optional."},"children":[]}]}]}],"example":"bene_68468c03g9xua"}},"required":["lrs_quote_id","remittance_information"]}},"components/schemas/Orders":{"id":"components/schemas/Orders","kind":"json-schema","title":"Orders","data":{"type":"object","x-tags":["Orders"],"properties":{"id":{"type":"string","readOnly":true,"description":"The unique identifier for the order.\n","example":"order_678a4c88hpAjf"},"customer_id":{"type":"string","description":"The unique identifier of customer linked to order.\n","example":"cust_E602dMzgjpDC"},"document_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 unique identifier of document linked to order. This document entity should contain the required documents to process incoming payments. Refer this "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#tag/Document"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Document"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" entity for more details."},"children":[]}]}]}],"example":"doc_nYUqLpuYQ0M8"},"status":{"type":"string","readOnly":true,"enum":["active","action_required","under_review","paid","failed","cancelled","expired"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The status of the order."},"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":"code","inline":true,"attributes":{"content":"active"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the order has been created and can be paid."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"action_required"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — Glomo needs more information before the order can be paid. Respond to the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"open RFI to continue."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"under_review"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the information you submitted is being reviewed. The order returns to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"active"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the review passes."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"paid"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the order has been paid in full. Terminal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"failed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the order could not be accepted, for example because the review did not pass. Terminal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cancelled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the order was cancelled before it was paid. Terminal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expired"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the order passed its expiry time without being paid. Not always final: a payment that"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"was already under way when the order expired can still complete it, moving it to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"paid"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}],"example":"active"},"currency":{"type":"string","format":"iso-4217","enum":["USD","EUR","GBP","AED","SGD","AUD"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency the order is collected in, as an uppercase "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" code. Must be one of the listed values; the match is case-sensitive. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INR"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not accepted."},"children":[]}]}]}],"example":"USD"},"amount":{"type":"number","minimum":1,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The amount you want to receive, a positive integer representing the smallest currency unit. For example, if the amount is $299.00, then pass 29900 in this field. In the case of three decimal currencies, such as KWD, BHD and OMR, to represent an amount of 295.991, pass the value as 295990. And in the case of zero decimal currencies such as JPY, for amount ￥295, pass the value as 295."},"children":[]}]}]}],"example":1000},"purpose_code":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Why you are receiving this payment, as a code from a fixed set: see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/payin/purpose-codes"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Payin purpose codes"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". This is not free text. Pass a listed code exactly, for example "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"P1401"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; matching is exact and case-sensitive. Payins and payouts use different sets, so a payout code such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"S1401"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is rejected here. An unrecognised code is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"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":"Optional on orders. When omitted, Glomo applies your account's default payin purpose code if one has been configured."},"children":[]}]}]}],"example":"P1401"},"invoice_number":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Number/Id of the invoice submitted with order. LRS orders (sent with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"lrs"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") don't store this field and return it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", but a value you send is still validated."},"children":[]}]}]}],"example":"RG12FF590"},"invoice_description":{"type":"string","description":"Description about the invoice submitted with order\n","example":"Payment requested for services provided"},"invoice_amount":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The amount on the invoice, in the smallest unit of the order's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", the same unit as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (cents for USD). "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $10.00 when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is USD. Must be greater than or equal to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":1000},"reference_number":{"type":"string","description":"optional identifier to be sent for reconciliations\n","example":"R0001"},"price_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 unique identifier of 'Price' entity linked to the order. This is the referral fee for this order. Note: price_id is only applicable for platform businesses."},"children":[]}]}]}],"example":"price_E602dMzgjpDC"},"split_ids":{"$ref":"#/components/schemas/SplitIds"},"product":{"$ref":"#/components/schemas/Product"},"notes":{"$ref":"#/components/schemas/Notes"},"bank_account_details":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Optional bank account details to associate with the customer for this order. When provided, the bank account will be linked to the customer and associated with this order. Either bic_primary or bic_secondary must be provided when including this field."},"children":[]}]}]}],"properties":{"account_number":{"type":"string","description":"The bank account number\n","example":"1234567890"},"bic_primary":{"type":"string","description":"SWIFT code for the bank account. Will be null if not provided in the request.\n","example":"HDFCINBBDEL"},"bic_secondary":{"type":"string","description":"Local routing code for the bank account like IFSC. Will be null if not provided in the request.\n","example":"HDFC0001097"},"bank_customer_id":{"type":"string","description":"Optional bank customer identifier provided by the bank\n","example":"7189204715"}},"required":["account_number"],"example":{"account_number":"1234567890","bic_primary":"HDFCINBBDEL","bank_customer_id":"7189204715"}},"lrs":{"$ref":"#/components/schemas/LrsOrderDetails"},"payment_methods":{"type":"array","items":{"type":"string","enum":["bank_transfer","pay_via_bank","card"]},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Array of payment methods that should be available for the customer on the checkout page. This field allows you to control which payment options your customers can use to complete the payment. You can specify one or multiple payment methods in the array. Each value must be a payment method enabled on your account; any other value is rejected with a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Omit the field to offer every payment method enabled on your account."},"children":[]}]}]}],"example":["card"]},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"When the order was created, as an ISO 8601 date-time in UTC.\n","example":"2021-06-01T12:00:00Z"},"updated_at":{"type":"string","format":"date-time","readOnly":true,"description":"When the order was last updated, as an ISO 8601 date-time in UTC.\n","example":"2021-06-01T12:00:00Z"},"request_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":"Your unique identifier for this order, used to reject duplicates. If an order with the same "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"request_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" already exists on your account, the request is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and the message "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Order already exists for this request_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; the existing order is not returned. Look it up with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v1/orders?request_id=<your_request_id>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Returned on the order and its webhooks; "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if you sent none."},"children":[]}]}]}],"example":"unique_order_request_id_123"}}}},"components/schemas/OrderResponse":{"id":"components/schemas/OrderResponse","kind":"json-schema","title":"OrderResponse","data":{"allOf":[{"$ref":"#/components/schemas/Orders"},{"type":"object","properties":{"id":{"type":"string","readOnly":true,"description":"The unique identifier for the order.\n","example":"order_678a4c88hpAjf"},"status":{"type":"string","readOnly":true,"enum":["active","action_required","under_review","paid","failed","cancelled","expired"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The status of the order."},"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":"code","inline":true,"attributes":{"content":"active"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - the order has been created and can be paid."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"action_required"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - Glomo needs more information before the order can be paid. Respond to the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"open RFI to continue."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"under_review"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - the information you submitted is being reviewed. The order returns to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"active"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the review passes."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"paid"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - the order has been paid in full. Terminal. This is the success value, not "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"success"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"failed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - the order could not be accepted, for example because the review did not pass. Terminal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cancelled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - the order was cancelled before it was paid. Terminal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expired"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - the order passed its expiry time without being paid. Not always final: a payment that"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"was already under way when the order expired can still complete it, moving it to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"paid"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}],"example":"active"},"rfi_documents":{"type":"array","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List of required documents for RFI (Request for Information). This field is only present when the order status is 'action_required', indicating that sanction screening has been triggered and additional documents are required to proceed with the payment."},"children":[]}]}]}],"items":{"type":"object","properties":{"rfi_doc_id":{"type":"string","description":"Unique identifier for the required RFI document\n","example":"rfidoc_123"},"name":{"type":"string","description":"Name/type of the required document\n","example":"Passport"}},"required":["rfi_doc_id","name"]},"example":[{"rfi_doc_id":"rfidoc_123","name":"Passport"},{"rfi_doc_id":"rfidoc_456","name":"Proof of Address"}]},"expires_at":{"type":"string","format":"date-time","readOnly":true,"description":"When the order expires, as an ISO 8601 date-time in UTC. An order created from a quote inherits the quote's expiry.\n","example":"2026-09-24T22:15:18Z"},"payment_methods":{"type":"array","readOnly":true,"items":{"type":"string","enum":["bank_transfer","pay_via_bank","card"]},"description":"Array of payment methods that should be available for the customer on the checkout page. This field allows you to control which payment options your customers can use to complete the payment. You can specify one or multiple payment methods in the array.\n","example":["card"]},"bank_account_details":{"type":"object","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bank account details associated with the customer for this order. If provided in the request, all fields will be returned. If bic_primary or bic_secondary was not provided in the request, they will be null in the response."},"children":[]}]}]}],"properties":{"account_number":{"type":"string","description":"The bank account number\n","example":"1234567890"},"bic_primary":{"type":["string","null"],"description":"SWIFT code for the bank account. Will be null if not provided in the request.\n","example":"HDFCINBBDEL"},"bic_secondary":{"type":["string","null"],"description":"Local routing code for the bank account like IFSC. Will be null if not provided in the request.\n","example":"HDFC0001097"},"bank_customer_id":{"type":["string","null"],"description":"Bank customer identifier provided by the bank. Will be null if not provided in the request.\n","example":"7189204715"}},"example":{"account_number":"1234567890","bic_primary":"HDFCINBBDEL","bic_secondary":null,"bank_customer_id":"7189204715"}},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"When the order was created, as an ISO 8601 date-time in UTC.\n","example":"2021-06-01T12:00:00Z"},"updated_at":{"type":"string","format":"date-time","readOnly":true,"description":"When the order was last updated, as an ISO 8601 date-time in UTC.\n","example":"2021-06-01T12:00:00Z"}}}]}},"components/schemas/CreateOrderWithQuoteRequest":{"id":"components/schemas/CreateOrderWithQuoteRequest","kind":"json-schema","title":"CreateOrderWithQuoteRequest","data":{"type":"object","title":"CreateOrderWithQuoteRequest","additionalProperties":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create an order against a previously generated quote (see "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /quotes"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"resource: payin"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). When supplied, the quote is the single source of truth for amount, currency, payment method and expiry. The locked fields ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"price_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payment_methods"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") must NOT be sent — including any of them returns a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"properties":{"quote_id":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ID of a quote (from "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /api/v1/quotes"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"resource: \"payin\""},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") to bind this order to. When supplied, the quote is the single source of truth for amount, currency, payment method, and expiry."},"children":[]}]}]}],"example":"quote_3m4n5o6p7q"},"customer_id":{"type":"string","description":"The unique identifier of customer linked to order.\n","example":"cust_E602dMzgjpDC"},"beneficiary_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 account the funds land in, as a beneficiary created through "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#tag/beneficiary_v2/operation/createBeneficiaryV2"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /v2/beneficiaries"},"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":"Required for account funding orders, where it is the customer's own account. Not used by other payin orders."},"children":[]}]}]}],"example":"bene_5JU9yv0lGSUP"},"purpose_code":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Why you are receiving this payment, as a code from a fixed set: see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/payin/purpose-codes"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Payin purpose codes"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". This is not free text. Pass a listed code exactly, for example "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"P1401"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; matching is exact and case-sensitive. Payins and payouts use different sets, so a payout code such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"S1401"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is rejected here. An unrecognised code is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"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":"Optional on orders. When omitted, Glomo applies your account's default payin purpose code if one has been configured."},"children":[]}]}]}],"example":"P1401"},"document_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 unique identifier of document linked to order. This document entity should contain the required documents to process incoming payments. Refer this "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#tag/Document"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Document"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" entity for more details."},"children":[]}]}]}],"example":"doc_nYUqLpuYQ0M8"},"invoice_number":{"type":"string","description":"Number/Id of the invoice submitted with order.\n","example":"RG12FF590"},"invoice_description":{"type":"string","description":"Description about the invoice submitted with order.\n","example":"Payment requested for services provided"},"invoice_amount":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The amount on the invoice, in the smallest unit of the quote's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"destination_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", which is the currency the order is created in (cents for USD). "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $10.00 when that currency is USD. Must be greater than or equal to the quote's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"destination_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":1000},"reference_number":{"type":"string","description":"optional identifier to be sent for reconciliations.\n","example":"R0001"},"product":{"$ref":"#/components/schemas/Product"},"notes":{"$ref":"#/components/schemas/Notes"},"bank_account_details":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Optional bank account details to associate with the customer for this order. When provided, the bank account will be linked to the customer and associated with this order. Either bic_primary or bic_secondary must be provided when including this field."},"children":[]}]}]}],"properties":{"account_number":{"type":"string","description":"The bank account number\n","example":"1234567890"},"bic_primary":{"type":"string","description":"SWIFT code for the bank account. Will be null if not provided in the request.\n","example":"HDFCINBBDEL"},"bic_secondary":{"type":"string","description":"Local routing code for the bank account like IFSC. Will be null if not provided in the request.\n","example":"HDFC0001097"},"bank_customer_id":{"type":"string","description":"Optional bank customer identifier provided by the bank\n","example":"7189204715"}},"required":["account_number"],"example":{"account_number":"1234567890","bic_primary":"HDFCINBBDEL","bank_customer_id":"7189204715"}},"request_id":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Your unique identifier for this order, used to reject duplicates. If an order with the same "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"request_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" already exists on your account, the request is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and the message "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Order already exists for this request_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; the existing order is not returned. Look it up with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v1/orders?request_id=<your_request_id>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Resending with the same "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"quote_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" fails first with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", because the quote has already been used."},"children":[]}]}]}],"example":"unique_order_request_id_123"}}}},"components/schemas/PaymentLink":{"id":"components/schemas/PaymentLink","kind":"json-schema","title":"PaymentLink","data":{"type":"object","x-tags":["payment_link"],"properties":{"id":{"type":"string","readOnly":true,"description":"The unique identifier for the payment link.\n","example":"plink_678a4c88hpAjf"},"customer_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 unique identifier of customer linked to payment_link."},"children":[]}]}]}],"example":"cust_E602dMzgjpDC"},"document_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 unique identifier of document linked to payment_link. This document entity should contain the required documents to process incoming payments. Refer this "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#tag/Document"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Document"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" entity for more details."},"children":[]}]}]}],"example":"doc_nYUqLpuYQ0M8"},"status":{"type":"string","readOnly":true,"enum":["active","action_required","under_review","paid","failed","cancelled","expired"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The status of the payment link."},"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":"code","inline":true,"attributes":{"content":"active"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the payment link has been created and can be paid."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"action_required"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — Glomo needs more information before the payment link can be paid. Respond to the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"open RFI to continue."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"under_review"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the information you submitted is being reviewed. The payment link returns to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"active"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the review passes."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"paid"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the payment link has been paid in full. Terminal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"failed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the payment link could not be accepted, for example because the review did not pass. Terminal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cancelled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the payment link was cancelled before it was paid. Terminal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expired"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the payment link passed its expiry time without being paid. Not always final: a payment that"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"was already under way when the payment link expired can still complete it, moving it to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"paid"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}],"example":"active"},"payment_methods":{"type":"array","items":{"type":"string","enum":["bank_transfer","pay_via_bank","card"]},"description":"Array of payment methods that should be available for the customer on the checkout page. This field allows you to control which payment options your customers can use to complete the payment. You can specify one or multiple payment methods in the array. A listed method that is not set up on your account is ignored rather than rejected.\n","example":["card"]},"currency":{"type":"string","format":"iso-4217","enum":["USD","EUR","GBP","AED","SGD","AUD"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency the payment link is collected in, as an uppercase "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" code. Must be one of the listed values; the match is case-sensitive. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INR"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not accepted."},"children":[]}]}]}],"example":"USD"},"amount":{"type":"number","minimum":1,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The amount you want to receive, a positive integer representing the smallest currency unit. For example, if the amount is $299.00, then pass 29900 in this field. In the case of three decimal currencies, such as KWD, BHD and OMR, to represent an amount of 295.991, pass the value as 295990. And in the case of zero decimal currencies such as JPY, for amount ￥295, pass the value as 295."},"children":[]}]}]}],"example":1000},"purpose_code":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Why you are receiving this payment, as a code from a fixed set: see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/payin/purpose-codes"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Payin purpose codes"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". This is not free text. Pass a listed code exactly, for example "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"P1401"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; matching is exact and case-sensitive. Payins and payouts use different sets, so a payout code such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"S1401"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is rejected here. An unrecognised code is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"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":"Required, unless Glomo has configured a default payin purpose code on your account, in which case an omitted value falls back to that default."},"children":[]}]}]}],"example":"P1401"},"invoice_number":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Number/Id of the invoice submitted with payment_link."},"children":[]}]}]}],"example":"RG12FF590"},"invoice_description":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description about the invoice submitted with payment_link"},"children":[]}]}]}],"example":"Payment requested for services provided"},"reference_number":{"type":"string","description":"optional identifier to be sent for reconciliations\n","example":"R0001"},"expires_at":{"type":"string","format":"date-time","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When the payment link expires. Send an ISO 8601 date-time with a UTC offset or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DDThh:mm:ssZ"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). A value without an offset is read as UTC, and a date without a time is read as 00:00 UTC on that day. Must be later than the time of the request and at most 6 calendar months from now. A past value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with the message "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Validation failed: Expires at must be in the future"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and a value more than 6 months ahead returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Validation failed: Expires at cannot be more than 6 months from now"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Returned in UTC."},"children":[]}]}]}],"example":"2026-12-15T12:00:00Z","x-glomo-relative-example":"P14D"},"last_reminder_sent_at":{"type":["string","null"],"format":"date-time","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When the customer was last reminded to complete the payment by visiting the link, as an ISO 8601 date-time in UTC. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if no reminder has been sent."},"children":[]}]}]}],"example":"2024-09-13T06:32:34Z"},"invoice_amount":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The amount on the invoice, in the smallest unit of the payment link's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", the same unit as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (cents for USD). "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $10.00 when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is USD. Must be greater than or equal to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":1000},"payment_link":{"type":"string","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sharable link which should be shared with customer you want to receive  money from. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"This link gets generated only after the payin has been reviewed and moved to in_progress"},"children":[]}]}]}],"example":"https://staging-api.glomopay-eng.com/v1/payin/pl/8f31597d-e085-497a-b80f-ae97ea9422a0"},"notify_customer":{"type":"boolean","default":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Whether to notify the customer via email when the payment link is created. Defaults to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"false"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to suppress the notification email."},"children":[]}]}]}],"example":true},"reminder_frequency":{"type":"number","description":"The frequency at which you want to remind customers, valid values are 1(remind everyday), 2(remind every alternate day), 7(remind every week), 14(remind every alternate week).\n","example":7},"price_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 unique identifier of 'Price' entity linked to the payment link. This is the referral fee for this payment link. Note: price_id is only applicable for platform businesses."},"children":[]}]}]}],"example":"price_E602dMzgjpDC"},"split_ids":{"$ref":"#/components/schemas/SplitIds"},"product":{"$ref":"#/components/schemas/Product"},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"When the payment link was created, as an ISO 8601 date-time in UTC.\n","example":"2021-06-01T12:00:00Z"},"updated_at":{"type":"string","format":"date-time","readOnly":true,"description":"When the payment link was last updated, as an ISO 8601 date-time in UTC.\n","example":"2021-06-01T12:00:00Z"},"notes":{"$ref":"#/components/schemas/Notes"},"bank_account_details":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Optional bank account details to associate with the customer for this payment link. When provided, the bank account will be linked to the customer and associated with this payment link. Either bic_primary or bic_secondary must be provided when including this field."},"children":[]}]}]}],"properties":{"account_number":{"type":"string","description":"The bank account number\n","example":"1234567890"},"bic_primary":{"type":"string","description":"SWIFT code for the bank account. Will be null if not provided in the request.\n","example":"HDFCINBBDEL"},"bic_secondary":{"type":"string","description":"Local routing code for the bank account like IFSC. Will be null if not provided in the request.\n","example":"HDFC0001097"},"bank_customer_id":{"type":"string","description":"Optional bank customer identifier provided by the bank\n","example":"7189204715"}},"required":["account_number"],"example":{"account_number":"1234567890","bic_primary":"HDFCINBBDEL","bank_customer_id":"7189204715"}}}}},"components/schemas/PaymentLinkResponse":{"id":"components/schemas/PaymentLinkResponse","kind":"json-schema","title":"PaymentLinkResponse","data":{"allOf":[{"$ref":"#/components/schemas/PaymentLink"},{"type":"object","properties":{"id":{"type":"string","readOnly":true,"description":"The unique identifier for the payment link.\n","example":"plink_678a4c88hpAjf"},"expires_at":{"example":"2021-06-15T12:00:00Z"},"status":{"type":"string","readOnly":true,"enum":["active","action_required","under_review","paid","failed","cancelled","expired"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The status of the payment link."},"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":"code","inline":true,"attributes":{"content":"active"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the payment link has been created and can be paid."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"action_required"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — Glomo needs more information before the payment link can be paid. Respond to the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"open RFI to continue."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"under_review"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the information you submitted is being reviewed. The payment link returns to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"active"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the review passes."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"paid"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the payment link has been paid in full. Terminal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"failed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the payment link could not be accepted, for example because the review did not pass. Terminal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cancelled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the payment link was cancelled before it was paid. Terminal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expired"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the payment link passed its expiry time without being paid. Not always final: a payment that"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"was already under way when the payment link expired can still complete it, moving it to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"paid"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}],"example":"active"},"rfi_documents":{"type":"array","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List of required documents for RFI (Request for Information). This field is only present when the payment link status is 'action_required', indicating that sanction screening has been triggered and additional documents are required to proceed with the payment link."},"children":[]}]}]}],"items":{"type":"object","properties":{"rfi_doc_id":{"type":"string","description":"Unique identifier for the required RFI document\n","example":"rfidoc_123"},"name":{"type":"string","description":"Name/type of the required document\n","example":"Passport"}},"required":["rfi_doc_id","name"]},"example":[{"rfi_doc_id":"rfidoc_123","name":"Passport"},{"rfi_doc_id":"rfidoc_456","name":"Proof of Address"}]},"payment_link":{"type":"string","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sharable link which should be shared with customer you want to receive money from. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"This link gets generated only after the payin has been reviewed and moved to in_progress"},"children":[]}]}]}],"example":"https://staging-api.glomopay-eng.com/v1/payin/pl/8f31597d-e085-497a-b80f-ae97ea9422a0"},"last_reminder_sent_at":{"type":["string","null"],"format":"date-time","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When the customer was last reminded to complete the payment by visiting the link, as an ISO 8601 date-time in UTC. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if no reminder has been sent."},"children":[]}]}]}],"example":"2024-09-13T06:32:34Z"},"payment_methods":{"type":"array","readOnly":true,"items":{"type":"string","enum":["bank_transfer","pay_via_bank","card"]},"description":"Array of payment methods that should be available for the customer on the checkout page. This field allows you to control which payment options your customers can use to complete the payment. You can specify one or multiple payment methods in the array.\n","example":["card"]},"bank_account_details":{"type":"object","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bank account details associated with the customer for this payment link. If provided in the request, all fields will be returned. If bic_primary or bic_secondary was not provided in the request, they will be null in the response."},"children":[]}]}]}],"properties":{"account_number":{"type":"string","description":"The bank account number\n","example":"1234567890"},"bic_primary":{"type":["string","null"],"description":"SWIFT code for the bank account. Will be null if not provided in the request.\n","example":"HDFCINBBDEL"},"bic_secondary":{"type":["string","null"],"description":"Local routing code for the bank account like IFSC. Will be null if not provided in the request.\n","example":"HDFC0001097"},"bank_customer_id":{"type":["string","null"],"description":"Bank customer identifier provided by the bank. Will be null if not provided in the request.\n","example":"7189204715"}},"example":{"account_number":"1234567890","bic_primary":"HDFCINBBDEL","bic_secondary":null,"bank_customer_id":"7189204715"}},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"When the payment link was created, as an ISO 8601 date-time in UTC.\n","example":"2021-06-01T12:00:00Z"},"updated_at":{"type":"string","format":"date-time","readOnly":true,"description":"When the payment link was last updated, as an ISO 8601 date-time in UTC.\n","example":"2021-06-01T12:00:00Z"},"notes":{"$ref":"#/components/schemas/Notes"}}}]}},"components/schemas/CreatePaymentLinkWithQuoteRequest":{"id":"components/schemas/CreatePaymentLinkWithQuoteRequest","kind":"json-schema","title":"CreatePaymentLinkWithQuoteRequest","data":{"type":"object","title":"CreatePaymentLinkWithQuoteRequest","additionalProperties":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create a payment link against a previously generated quote (see "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /quotes"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"resource: payin"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). When supplied, the quote is the single source of truth for amount, currency, payment method and expiry. The locked fields ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_at"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"price_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payment_methods"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") must NOT be sent — including any of them returns a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"properties":{"quote_id":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ID of a quote (from "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /api/v1/quotes"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"resource: \"payin\""},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") to bind this payment link to. When supplied, the quote is the single source of truth for amount, currency, payment method, and expiry."},"children":[]}]}]}],"example":"quote_3m4n5o6p7q"},"customer_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 unique identifier of customer linked to payment_link."},"children":[]}]}]}],"example":"cust_E602dMzgjpDC"},"purpose_code":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Why you are receiving this payment, as a code from a fixed set: see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/payin/purpose-codes"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Payin purpose codes"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". This is not free text. Pass a listed code exactly, for example "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"P1401"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; matching is exact and case-sensitive. Payins and payouts use different sets, so a payout code such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"S1401"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is rejected here. An unrecognised code is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"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":"Required, unless Glomo has configured a default payin purpose code on your account, in which case an omitted value falls back to that default."},"children":[]}]}]}],"example":"P1401"},"document_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 unique identifier of document linked to payment_link. This document entity should contain the required documents to process incoming payments. Refer this "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#tag/Document"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Document"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" entity for more details."},"children":[]}]}]}],"example":"doc_nYUqLpuYQ0M8"},"invoice_number":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Number/Id of the invoice submitted with payment_link."},"children":[]}]}]}],"example":"RG12FF590"},"invoice_description":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description about the invoice submitted with payment_link."},"children":[]}]}]}],"example":"Payment requested for services provided"},"invoice_amount":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The amount on the invoice, in the smallest unit of the quote's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"destination_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", which is the currency the payment link is created in (cents for USD). "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $10.00 when that currency is USD. Must be greater than or equal to the quote's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"destination_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":1000},"reference_number":{"type":"string","description":"optional identifier to be sent for reconciliations.\n","example":"R0001"},"notify_customer":{"type":"boolean","default":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Whether to notify the customer via email when the payment link is created. Defaults to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"false"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to suppress the notification email."},"children":[]}]}]}],"example":true},"reminder_frequency":{"type":"number","description":"The frequency at which you want to remind customers, valid values are 1(remind everyday), 2(remind every alternate day), 7(remind every week), 14(remind every alternate week).\n","example":7},"product":{"$ref":"#/components/schemas/Product"},"notes":{"$ref":"#/components/schemas/Notes"},"bank_account_details":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Optional bank account details to associate with the customer for this payment link. When provided, the bank account will be linked to the customer and associated with this payment link. Either bic_primary or bic_secondary must be provided when including this field."},"children":[]}]}]}],"properties":{"account_number":{"type":"string","description":"The bank account number\n","example":"1234567890"},"bic_primary":{"type":"string","description":"SWIFT code for the bank account. Will be null if not provided in the request.\n","example":"HDFCINBBDEL"},"bic_secondary":{"type":"string","description":"Local routing code for the bank account like IFSC. Will be null if not provided in the request.\n","example":"HDFC0001097"},"bank_customer_id":{"type":"string","description":"Optional bank customer identifier provided by the bank\n","example":"7189204715"}},"required":["account_number"],"example":{"account_number":"1234567890","bic_primary":"HDFCINBBDEL","bank_customer_id":"7189204715"}}}}},"components/schemas/AttachedDocument":{"id":"components/schemas/AttachedDocument","kind":"json-schema","title":"AttachedDocument","data":{"type":"object","properties":{"id":{"type":"string","description":"The unique identifier for the Document.\n","example":"doc_nYUqLpuYQ0M8"},"type":{"type":"string","readOnly":true,"description":"The type of the Document.\n","example":"invoice"},"status":{"type":"string","readOnly":true,"enum":["pending","uploaded","rejected","approved"]},"rfi_doc_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 unique identifier for the RFI Document. This will be "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if the document is not an RFI Document."},"children":[]}]}]}],"example":"rfidoc_nYUqLpuYQ0M8"}}}},"components/schemas/Payout":{"id":"components/schemas/Payout","kind":"json-schema","title":"Payout","data":{"type":"object","x-tags":["Payout"],"properties":{"id":{"type":"string","readOnly":true,"description":"The unique identifier for the payout.\n","example":"payout_DdWp_HUbOnlg"},"status":{"type":"string","readOnly":true,"enum":["pending_approval","queued","in_progress","action_required","success","failed","cancelled"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The status of the payout."},"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":"code","inline":true,"attributes":{"content":"pending_approval"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the payout is waiting for a reviewer on your account to approve it. Only"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"used when payout approval is turned on for your account."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"queued"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the payout is waiting for enough balance to cover it. It moves on once funds arrive, or"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"fails with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"QUEUE_EXPIRED"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if they do not arrive in time."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"in_progress"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the payout has been accepted and is being processed or reviewed."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"action_required"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — Glomo needs more information before the payout can proceed. Respond to the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"open RFI to continue."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"success"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the beneficiary has been paid. Terminal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"failed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the payout could not be completed; see "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"error_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Terminal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cancelled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the payout was stopped before it was paid. Terminal."},"children":[]}]}]}]}],"example":"success"},"destination_amount":{"type":"number","minimum":1,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The amount the beneficiary will receive, in the smallest unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"destination_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (paise for INR, cents for USD). "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $10.00 when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"destination_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is USD."},"children":[]}]}]}],"example":1000},"destination_currency":{"type":"string","format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency code in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format. For example, USD."},"children":[]}]}]}],"example":"USD"},"source_amount":{"type":"number","minimum":1,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The amount you intend to send, in the smallest unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (cents for USD). "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $10.00 when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is USD."},"children":[]}]}]}],"example":1000},"source_currency":{"type":"string","format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency code in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format. For example, USD."},"children":[]}]}]}],"example":"USD"},"beneficiary_id":{"type":"string","description":"The unique identifier of the beneficiary the payout is sent to.\n","example":"bene_5JU9yv0lGSUP"},"documents":{"type":"array","items":{"$ref":"#/components/schemas/AttachedDocument"},"description":"The attached documents for the payout.\n"},"purpose_code":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Purpose code of this payout, from the fixed set of "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/payout/purpose-codes"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"payout purpose codes"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"S0017"},"mid_market_rate":{"type":"object","readOnly":true,"properties":{"currency":{"type":["string","null"],"format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The destination currency, as an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" code. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when no rate has been recorded yet."},"children":[]}]}]}],"example":"USD"},"rate":{"type":["number","null"],"format":"float","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Units of the destination currency ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"mid_market_rate.currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") per one unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1.17"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"USD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on a payout from EUR to USD means 1 EUR = 1.17 USD. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when the source and destination currencies are the same. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when no rate has been recorded yet."},"children":[]}]}]}],"example":1.17}},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The mid-market rate at the time of payout creation. The currency represents the destination currency and rate represents the factor of conversion. Example: 1 EUR = 1.17 USD. Rate corresponds to 1.17 and currency is USD."},"children":[]}]}]}]},"fees":{"type":"object","readOnly":true,"properties":{"fx_fee":{"type":"object","properties":{"currency":{"type":["string","null"],"format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency of the FX fee, as an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" code. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" until fees are applied to the payout."},"children":[]}]}]}],"example":"USD"},"amount":{"type":["integer","null"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The FX fee, in the smallest unit of this fee's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", which is the payout's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"200"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $2.00 when that currency is USD. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" until fees are applied to the payout; a zero fee is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":200}},"description":"The foreign exchange fees applied to the payout"},"txn_fee":{"type":"object","properties":{"currency":{"type":["string","null"],"format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency of the transaction fee, as an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" code. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" until fees are applied to the payout."},"children":[]}]}]}],"example":"USD"},"amount":{"type":["integer","null"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The transaction fee, in the smallest unit of this fee's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", which is the payout's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"100"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $1.00 when that currency is USD. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" until fees are applied to the payout; a zero fee is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":100}},"description":"The transaction fees applied to the payout"}},"description":"The fees applied to this payout\n"},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"When the payout was created, as an ISO 8601 date-time in UTC.\n","example":"2021-06-01T12:00:00Z"},"updated_at":{"type":"string","format":"date-time","readOnly":true,"description":"When the payout was last updated, as an ISO 8601 date-time in UTC.\n","example":"2021-06-01T12:00:00Z"},"utr":{"type":["string","null"],"readOnly":true,"description":"(Optional) Unique Transaction Reference for the payout. This is a unique identifier assigned by the bank to track the transaction.\n","example":"AXISN52024112000001234"},"request_id":{"type":["string","null"],"readOnly":true,"maxLength":64,"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":"request_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" you sent when creating this payout, at most 64 characters; "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if you sent none. Look the payout up with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v1/payouts?request_id=<your_request_id>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"your-internal-id"},"payment_rail":{"type":["string","null"],"readOnly":true,"enum":["swift","imps","neft","rtgs","upi","ipp","fts","sepa","fps","npp",null],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The payment rail used to settle this payout. Each local rail serves one corridor: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"upi"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"imps"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"neft"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rtgs"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INR"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ipp"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fts"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"AED"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sepa"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"EUR"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fps"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GBP"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"npp"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"AUD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"swift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is used for international transfers."},"children":[]}]}]}],"example":"swift"},"invoice_number":{"type":["string","null"],"readOnly":true,"maxLength":50,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The invoice reference sent when the payout was created, up to 50 characters. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when none was sent."},"children":[]}]}]}],"example":"INV-2026-001"},"fee_collection_mode":{"type":"string","readOnly":true,"description":"How fees for this payout are collected.\n","example":"merchant"},"error_code":{"type":["string","null"],"readOnly":true,"enum":["QUOTE_EXPIRED","QUEUE_EXPIRED","PAYOUT_REJECTED","INSUFFICIENT_BALANCE","INVALID_BENE_ACCOUNT_NUMBER","INVALID_BENE_ACCOUNT_TYPE","INVALID_BENE_IFSC","INVALID_VPA","INVALID_BENE_NAME","INVALID_BENE_ADDRESS","INVALID_BENE_EMAIL","INVALID_BENE_CONTACT","NAME_MISMATCH",null],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A machine-readable code describing why the payout failed or was cancelled. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" unless the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"payout is in an error state. The accompanying "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"error_description"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" carries the human-readable text."},"children":[]}]}]},{"$$mdtype":"Node","type":"table","attributes":{},"children":[{"$$mdtype":"Node","type":"thead","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Code"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"tbody","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"QUOTE_EXPIRED"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Quote has expired. Please create a new payout with a valid quote."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"QUEUE_EXPIRED"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Payout stayed queued for 30 days because the balance did not cover it. No funds were held."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"PAYOUT_REJECTED"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Payout was rejected by the bank. Please reach out to support. (default fallback)"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INSUFFICIENT_BALANCE"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The balance no longer covered the payout when it came out of review. No funds were held."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INVALID_BENE_ACCOUNT_NUMBER"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Beneficiary account number is invalid."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INVALID_BENE_ACCOUNT_TYPE"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Beneficiary account type is invalid."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INVALID_BENE_IFSC"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Beneficiary IFSC code is invalid."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INVALID_VPA"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"VPA/UPI address is invalid."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INVALID_BENE_NAME"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Beneficiary name is invalid."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INVALID_BENE_ADDRESS"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Beneficiary address or PIN/ZIP code is invalid."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INVALID_BENE_EMAIL"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Beneficiary email is invalid."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INVALID_BENE_CONTACT"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Beneficiary contact/mobile number is invalid."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"NAME_MISMATCH"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Remitter and beneficiary names do not match for the selected purpose."},"children":[]}]}]}]}]}]}],"example":null},"error_description":{"type":["string","null"],"readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A merchant-facing, human-readable description of the error. Operational copy for the merchant. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" unless the payout is in an error state. See "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"customer_error_description"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for the copy meant for the end-customer."},"children":[]}]}]}],"example":null},"customer_error_description":{"type":["string","null"],"readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Customer-facing error copy, written for the merchant to relay to their end-customer. Derives from the same "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"error_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"error_description"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" but targets a different audience. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when there is no "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"error_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or when the error code has no customer-facing variant (some codes are merchant-only)."},"children":[]}]}]}],"example":null},"quote_id":{"type":["string","null"],"readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The identifier of the quote this payout was created against. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for payouts that were not created from a quote."},"children":[]}]}]}],"example":"quote_3m4n5o6p7q"},"taxes":{"type":"array","readOnly":true,"items":{"type":"object","properties":{"name":{"type":"string","description":"The name of the tax withheld.","example":"GST"},"amount":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The tax amount, in the smallest unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". For example, 877 is 8.77 INR."},"children":[]}]}]}],"example":877},"currency":{"type":"string","format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency the tax was withheld in, in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format."},"children":[]}]}]}],"example":"INR"},"bps":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The rate the tax was charged at, in basis points. 1800 is 18%."},"children":[]}]}]}],"example":1800}}},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Taxes withheld on this payout, deducted from the amount before it reached the beneficiary. Present on repatriation payouts (purpose code "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"P0001"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"), where the remitting bank withholds GST on the currency conversion; empty for every other purpose, and empty until the bank has confirmed the payout."},"children":[]}]}]}]},"estimated_credit_date":{"type":["string","null"],"format":"date","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date Glomo expects the beneficiary's account to be credited, as an ISO 8601 date ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") in IST. Set once, when the payout moves to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"in_progress"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and not updated afterwards. It accounts for bank cut-off times, weekends, and settlement holidays for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"destination_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". It is an estimate, not a guarantee; a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"success"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" confirms the beneficiary has been paid. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" until the payout reaches "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"in_progress"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and stays "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for payouts that fail or are cancelled before then."},"children":[]}]}]}],"example":"2026-06-05"},"notes":{"$ref":"#/components/schemas/Notes"}}}},"components/schemas/CreatePayoutWithoutQuoteRequest":{"id":"components/schemas/CreatePayoutWithoutQuoteRequest","kind":"json-schema","title":"CreatePayoutWithoutQuoteRequest","data":{"type":"object","title":"CreatePayoutWithoutQuoteRequest","additionalProperties":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create a payout without a quote by specifying the beneficiary, currencies and amount. Fees and the FX rate are determined at creation time. Use this variant when you have not pre-generated a quote. To create a payout against a locked quote instead, see "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"CreatePayoutWithQuoteRequest"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"properties":{"purpose_code":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Why you are sending this payout, as a code from a fixed set: see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/payout/purpose-codes"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Payout purpose codes"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". This is not free text. Pass a listed code exactly, for example "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"S0802"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; matching is exact and case-sensitive. Payouts and payins use different sets, so a payin code such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"P1401"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is rejected here. An unrecognised code is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"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":"INR payouts on a local rail ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"neft"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"imps"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rtgs"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"upi"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") accept only a subset of the payout codes. A code outside that subset is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", with a message saying the code is not valid for the selected payment rail."},"children":[]}]}]}],"example":"S0802"},"beneficiary_id":{"type":"string","description":"The unique identifier for the beneficiary.\n","example":"bene_5JU9yv0lGSUP"},"source_currency":{"type":"string","format":"iso-4217","enum":["USD","EUR","GBP","AED","SGD","AUD"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency of the balance the payout is paid from, as an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" code from the list above. Any other value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with a message containing "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Source currency is not supported"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"USD"},"destination_currency":{"type":"string","format":"iso-4217","enum":["USD","EUR","GBP","AED","SGD","AUD","INR"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency in which the beneficiary receives the payout. The currency code is in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format."},"children":[]}]}]}],"example":"INR"},"source_amount":{"type":"integer","minimum":1,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The amount you intend to send, in the smallest unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (cents for USD). "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"100000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $1,000.00 when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is USD."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exactly one of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"destination_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" must be provided (not both)."},"children":[]}]}]}],"example":100000},"destination_amount":{"type":"integer","minimum":1,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The amount the beneficiary will receive, in the smallest unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"destination_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (paise for INR, cents for USD). "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"8235000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is ₹82,350.00 when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"destination_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is INR."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exactly one of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"destination_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" must be provided (not both)."},"children":[]}]}]}],"example":8235000},"payment_rail":{"type":"string","default":"swift","enum":["upi","rtgs","neft","imps","ipp","fts","sepa","fps","npp","swift"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The payment rail to use for this payout. Each local rail serves one corridor and is only available when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"destination_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" matches it: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"upi"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"imps"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"neft"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rtgs"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INR"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ipp"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fts"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"AED"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sepa"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"EUR"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fps"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GBP"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"npp"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"AUD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"swift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is used for international transfers and is available on any corridor. The rail must be eligible for the beneficiary and the amount must fall inside the rail's limits. Defaults to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"swift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if omitted; a local rail is not selected automatically."},"children":[]}]}]}],"example":"neft"},"invoice_number":{"type":"string","maxLength":50,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An optional invoice reference for this payout, up to 50 characters. It is returned on the payout as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"invoice_number"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A longer value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with a message containing "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Invoice number must be 50 characters or less"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"INV-2026-001"},"request_id":{"type":"string","maxLength":64,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Your unique identifier for this payout, at most 64 characters, used to reject duplicates. If a payout with the same "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"request_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" already exists on your account, the request is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"409 Conflict"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and the message "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Record already exists"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; no second payout is created and the existing payout is not returned. Look it up with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v1/payouts?request_id=<your_request_id>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A value longer than 64 characters is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"req-7f3a9c20"},"documents":{"type":"array","items":{"type":"string"},"description":"List of document IDs to attach to the payout.\n","example":["doc_5JU9yv0lGSUP","doc_678a5aa9SKkEr"]},"notes":{"$ref":"#/components/schemas/Notes"}}}},"components/schemas/CreatePayoutWithQuoteRequest":{"id":"components/schemas/CreatePayoutWithQuoteRequest","kind":"json-schema","title":"CreatePayoutWithQuoteRequest","data":{"type":"object","title":"CreatePayoutWithQuoteRequest","additionalProperties":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create a payout against a previously generated quote (see "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /quotes"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"resource: payout"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). The quote locks the fees, FX rate, currencies, amount and payment rail. The locked fields ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"destination_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"destination_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payment_rail"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") must NOT be sent — including any of them returns a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"properties":{"quote_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 identifier of a payout quote generated via "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /quotes"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The quote must exist for your business, must be a payout quote, must not have expired, and must not already have been used for another payout."},"children":[]}]}]}],"example":"quote_3m4n5o6p7q"},"beneficiary_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 unique identifier for the beneficiary. The quote's payment rail must be supported by this beneficiary, otherwise the request returns a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"bene_5JU9yv0lGSUP"},"purpose_code":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Why you are sending this payout, as a code from a fixed set: see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/payout/purpose-codes"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Payout purpose codes"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". This is not free text. Pass a listed code exactly, for example "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"S0802"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; matching is exact and case-sensitive. Payouts and payins use different sets, so a payin code such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"P1401"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is rejected here. An unrecognised code is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"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":"INR payouts on a local rail ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"neft"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"imps"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rtgs"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"upi"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") accept only a subset of the payout codes. A code outside that subset is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", with a message saying the code is not valid for the selected payment rail."},"children":[]}]}]}],"example":"S0802"},"invoice_number":{"type":"string","maxLength":50,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An optional invoice reference for this payout, up to 50 characters. It is returned on the payout as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"invoice_number"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A longer value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with a message containing "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Invoice number must be 50 characters or less"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"INV-2026-001"},"request_id":{"type":"string","maxLength":64,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Your unique identifier for this payout, at most 64 characters, used to reject duplicates. If a payout with the same "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"request_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" already exists on your account, the request is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"409 Conflict"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and the message "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Record already exists"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; no second payout is created and the existing payout is not returned. Look it up with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v1/payouts?request_id=<your_request_id>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A value longer than 64 characters is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Resending with the same "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"quote_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" fails first with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", because the quote has already been used; the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"409"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" applies when a new quote is sent with a repeated "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"request_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"req-7f3a9c20"},"documents":{"type":"array","items":{"type":"string"},"description":"List of document IDs to attach to the payout.\n","example":["doc_5JU9yv0lGSUP","doc_678a5aa9SKkEr"]},"notes":{"$ref":"#/components/schemas/Notes"}}}},"components/schemas/CreateQuoteRequest":{"id":"components/schemas/CreateQuoteRequest","kind":"json-schema","title":"CreateQuoteRequest","data":{"type":"object","title":"CreateQuoteRequest","additionalProperties":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create one or more pricing quotes for a payout or payin. A quote locks the FX rate and fee breakdown for a period."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Provide exactly one of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"destination_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"properties":{"resource":{"type":"string","enum":["payout","payin"],"description":"The resource to create quote for.\n","example":"payout"},"resource_type":{"type":"string","enum":["account_funding"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The payin programme this quote is priced under. Payin only, and required when "},"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":"."},"children":[]}]}]}],"example":"account_funding"},"source_currency":{"type":"string","format":"iso-4217","enum":["USD","EUR","GBP","AED","SGD","AUD"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The source currency code, as an uppercase "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" code. Must be one of the listed values; the match is case-sensitive. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INR"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not accepted as a source currency."},"children":[]}]}]}],"example":"USD"},"destination_currency":{"type":"string","format":"iso-4217","enum":["USD","EUR","GBP","AED","SGD","AUD","INR"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The destination currency code, as an uppercase "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" code. Must be one of the listed values; the match is case-sensitive."},"children":[]}]}]}],"example":"INR"},"source_amount":{"type":"integer","minimum":1,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The amount you intend to send, in the smallest unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (cents for USD). "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"10000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $100.00 when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is USD."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Provide exactly one of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"destination_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", not both."},"children":[]}]}]}],"example":10000},"destination_amount":{"type":"integer","minimum":1,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The amount to be received, in the smallest unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"destination_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (paise for INR, cents for USD). "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"882000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is ₹8,820.00 when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"destination_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is INR."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Provide exactly one of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"destination_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", not both."},"children":[]}]}]}],"example":882000},"payment_method":{"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","enum":["bank_transfer","pay_via_bank","card"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The payment method. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pay_via_bank"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"card"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are payin only."},"children":[]}]}]}],"example":"bank_transfer"},"subtype":{"type":"string","enum":["local_transfer","swift_transfer"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The payment method subtype. Required for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bank_transfer"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pay_via_bank"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and must be omitted for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"card"},"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":"The payment rail is not an input; it is derived per quote and returned on each quote as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payment_method.rail"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"swift_transfer"}},"required":["type"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The payment method details to price. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pay_via_bank"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" only supports the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"local_transfer"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" subtype. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"card"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" takes no subtype."},"children":[]}]}]}]},"price_id":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Payin only. The platform referral price to apply. When set, the quote's fee breakdown includes a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"referral_fee"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"price_5JU9yv0lGSUP"},"split_ids":{"allOf":[{"$ref":"#/components/schemas/SplitIds"}],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Payin only. The pricing splits to apply when quoting the fee. Sending "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"split_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"resource: payout"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" returns a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A payment link or an order created from this quote inherits these splits, and must not send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"split_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of its own."},"children":[]}]}]}]}},"required":["resource","destination_currency","payment_method"]}},"components/schemas/Quote":{"id":"components/schemas/Quote","kind":"json-schema","title":"Quote","data":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"description":"The unique identifier for this quote.\n","example":"quote_3m4n5o6p7q"},"resource":{"type":"string","readOnly":true,"enum":["payout","payin"],"description":"The resource this quote prices.\n","example":"payout"},"resource_type":{"type":"string","readOnly":true,"enum":["account_funding"],"description":"The payin programme this quote is priced under. Present only when the quote was created with one.\n","example":"account_funding"},"expires_at":{"type":"string","format":"date-time","readOnly":true,"description":"The expiry timestamp for this quote in ISO 8601 format. Quotes are valid for a fixed period from creation.\n","example":"2026-06-12T08:16:50Z"},"payment_method":{"type":"object","readOnly":true,"properties":{"type":{"type":"string","enum":["bank_transfer","pay_via_bank","card"],"description":"The payment method for this quote.","example":"bank_transfer"},"subtype":{"type":"string","enum":["local_transfer","swift_transfer"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The payment method subtype for this quote. Absent on a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"card"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" quote, which has no subtype."},"children":[]}]}]}],"example":"swift_transfer"},"rail":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The derived payment rail for this quote. Present only for payout quotes. A SWIFT transfer yields a single "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"swift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" quote. A local transfer yields one quote per local rail for the destination currency whose amount limits admit the payout: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"upi"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"imps"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"neft"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for INR, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ipp"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fts"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for AED, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sepa"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for EUR, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fps"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for GBP and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"npp"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for AUD."},"children":[]}]}]}],"example":"swift"}},"description":"The payment method details for this quote.\n"},"source_currency":{"type":"string","format":"iso-4217","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The source currency code in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format."},"children":[]}]}]}],"example":"USD"},"destination_currency":{"type":"string","format":"iso-4217","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The destination currency code in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format."},"children":[]}]}]}],"example":"INR"},"fx_rate":{"type":"number","format":"float","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The mid-market exchange rate for this quote, before FX fees, as units of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"destination_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" per one unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"90.0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" means 1 USD = 90 INR. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when the two currencies are the same."},"children":[]}]}]}],"example":90},"effective_fx_rate":{"type":["number","null"],"format":"float","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The mid-market rate adjusted for the FX fee only, as units of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"destination_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" per one unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". For a payin it is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fx_rate / (1 + fx_fee / destination_amount)"},"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":"The transaction fee is not in it, so this is not the all-in cost. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when no mid-market rate is available or the amount is zero."},"children":[]}]}]}],"example":0.2700972222222222},"source_amount":{"type":"integer","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The total source amount, in the smallest unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (cents for USD). "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"10000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $100.00 when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is USD."},"children":[]}]}]}],"example":10000},"destination_amount":{"type":"integer","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The destination amount, in the smallest unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"destination_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (paise for INR, cents for USD). "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"882000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is ₹8,820.00 when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"destination_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is INR."},"children":[]}]}]}],"example":882000},"fees":{"type":"object","readOnly":true,"properties":{"txn_fee":{"type":"object","properties":{"currency":{"type":"string","format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency of the transaction fee, as an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" code."},"children":[]}]}]}],"example":"USD"},"amount":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The transaction fee, in the smallest unit of this fee's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"100"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $1.00 when that currency is USD."},"children":[]}]}]}],"example":100}},"description":"The transaction fee applied to this quote"},"fx_fee":{"type":"object","properties":{"currency":{"type":"string","format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency of the FX fee, as an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" code."},"children":[]}]}]}],"example":"USD"},"amount":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The FX fee, in the smallest unit of this fee's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"100"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $1.00 when that currency is USD."},"children":[]}]}]}],"example":100}},"description":"The foreign exchange fee applied to this quote"},"referral_fee":{"type":"object","properties":{"currency":{"type":"string","format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency of the referral fee, as an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" code."},"children":[]}]}]}],"example":"USD"},"amount":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The referral fee, in the smallest unit of this fee's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"50"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $0.50 when that currency is USD."},"children":[]}]}]}],"example":50}},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The platform referral fee. Present only on payin quotes when a referral "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"price_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" was applied."},"children":[]}]}]}]}},"description":"The fees breakdown for this quote.\n"}}}},"components/schemas/CreateLrsQuoteRequest":{"id":"components/schemas/CreateLrsQuoteRequest","kind":"json-schema","title":"CreateLrsQuoteRequest","data":{"type":"object","properties":{"resource":{"type":"string","enum":["payin","payout"],"default":"payin","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"What the quote prices."},"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":"code","inline":true,"attributes":{"content":"payin"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — an LRS remittance from a resident Indian customer. Requires "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bank_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payout"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — a withdrawal back to the customer in India. Only "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"USD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INR"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is supported, and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bank_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" must not be sent."},"children":[]}]}]}]}],"example":"payin"},"bank_code":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Code of the customer's bank, as returned by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /lrs/banks"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Required when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"resource"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payin"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and the bank must be enabled for your account. Rejected when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"resource"},"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":"."},"children":[]}]}]}],"example":"hdfc"},"source_amount":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The amount to convert, in the smallest unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (paisa for INR, cents for USD). "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"4400000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is ₹44,000.00 when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INR"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Must be a whole number; a string of digits such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"\"4400000\""},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is also accepted. Send a positive integer; an optional leading sign is accepted. A decimal or an exponent is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". On a payin quote, the amount must fall within the minimum and maximum set for the bank, otherwise the request is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and the message states the limit."},"children":[]}]}]}],"example":4400000},"source_currency":{"type":"string","format":"iso-4217","enum":["INR","USD"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Must differ from "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"target_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"INR"},"target_currency":{"type":"string","format":"iso-4217","enum":["INR","USD"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency to convert into. Must differ from "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"USD"}},"required":["source_amount","source_currency","target_currency"]}},"components/schemas/LrsQuote":{"id":"components/schemas/LrsQuote","kind":"json-schema","title":"LrsQuote","data":{"type":"object","description":"An LRS quote: the conversion, tax and exchange rate for an LRS remittance or withdrawal.\n","properties":{"id":{"type":"string","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unique identifier of the quote. Pass it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"lrs.lrs_quote_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on an LRS order."},"children":[]}]}]}],"example":"quote_6ab60de4Kx7Pq"},"from":{"type":"object","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The amount the quote converts from: your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"properties":{"amount":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Amount in the smallest unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (paisa for INR, cents for USD)."},"children":[]}]}]}],"example":4400000},"currency":{"type":"string","format":"iso-4217","example":"INR"}}},"to":{"type":"object","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The amount the quote converts to, in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"target_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"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":"code","inline":true,"attributes":{"content":"INR"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"USD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" payin quote: GST is deducted from "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"from.amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" before conversion, so"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"to.amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is the USD remitted."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"USD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INR"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" payin quote: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"to.amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is the INR equivalent of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"from.amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", plus any"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"transaction fee charged to the customer, with GST added."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Payout quote: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"to.amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is the INR the customer receives after fees and GST are deducted."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"On a payin quote, the side in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"USD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is the amount an LRS order must be created for."},"children":[]}]}]}],"properties":{"amount":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Amount in the smallest unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (paisa for INR, cents for USD). "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"51763"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $517.63 when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"USD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":51763},"currency":{"type":"string","format":"iso-4217","example":"USD"}}},"fx_rate":{"type":"string","readOnly":true,"description":"The exchange rate applied to the quote, as a decimal string in INR per 1 USD. It is expressed this way whichever direction the quote converts.\n","example":"84.85"},"bank_code":{"type":"string","readOnly":true,"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":"bank_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" the quote was created for. Present on payin quotes only."},"children":[]}]}]}],"example":"hdfc"},"total_tax":{"type":"integer","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"GST on the conversion, in paisa, whichever direction the quote converts. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"7906"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is ₹79.06."},"children":[]}]}]}],"example":7906},"expires_at":{"type":"string","format":"date-time","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When the quote expires, as an ISO 8601 date-time in UTC. Payout quotes expire 30 minutes after "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"created_at"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". For payin quotes, rely on this value rather than a fixed duration. An LRS order created from the quote expires at the same time, and an order cannot be created from an expired quote."},"children":[]}]}]}],"example":"2026-09-25T06:30:04.113Z"},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"When the quote was created, as an ISO 8601 date-time in UTC.\n","example":"2026-09-25T06:00:04.113Z"}}}},"components/schemas/LrsBank":{"id":"components/schemas/LrsBank","kind":"json-schema","title":"LrsBank","data":{"type":"object","description":"A bank your customers can remit from under LRS.\n","properties":{"bank_code":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Code of the bank. Pass it as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bank_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when you register an LRS bank account for a customer and when you create an LRS payin quote."},"children":[]}]}]}],"example":"hdfc"},"bank_name":{"type":"string","description":"Display name of the bank.\n","example":"HDFC bank"}}}},"components/schemas/MockUpdatePayoutStatusRequest":{"id":"components/schemas/MockUpdatePayoutStatusRequest","kind":"json-schema","title":"MockUpdatePayoutStatusRequest","data":{"type":"object","properties":{"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":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of the payout to update, as returned when you created it. A payout that does not exist, or belongs to another account, returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"404"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"payout_E602dMzgjpDC"},"status":{"type":"string","enum":["pending","queued","success","failed","action_required","cancelled"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The state to move the payout to. These are sandbox transition targets, not the values the payout's"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field returns:"},"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":"code","inline":true,"attributes":{"content":"pending"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — accepts the payout for processing. It then reads as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"in_progress"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". On an account with"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"payout queueing, a payout that isn't "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"queued"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" yet is queued instead. A "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"queued"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" payout moves on only"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"if your balance covers it."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"queued"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — puts the payout in the payout queue. Only on an account with payout queueing."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"success"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — pays the payout out."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"failed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — fails the payout."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"action_required"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — moves the payout to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"action_required"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cancelled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — cancels the payout."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A transition the payout's current status does not allow returns a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"success"}}}},"components/schemas/TaxLine":{"id":"components/schemas/TaxLine","kind":"json-schema","title":"TaxLine","data":{"type":"object","properties":{"amount":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The tax amount in the smallest unit of this line's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (cents for USD). "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1800"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $18.00 when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is USD."},"children":[]}]}]}],"example":1800},"currency":{"type":"string","format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency code in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format. For example, USD."},"children":[]}]}]}],"example":"USD"},"name":{"type":"string","description":"The name of the tax applied on the fee. For example, GST.\n","example":"GST"},"bps":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The tax rate in basis points. For example, 1800 represents 18%."},"children":[]}]}]}],"example":1800}}}},"components/schemas/FeeBreakdownEntry":{"id":"components/schemas/FeeBreakdownEntry","kind":"json-schema","title":"FeeBreakdownEntry","data":{"type":"object","properties":{"amount":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The fee amount in the smallest unit of this entry's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (cents for USD), aggregated across all rules for this fee bearer. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"250"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $2.50 when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is USD."},"children":[]}]}]}],"example":250},"currency":{"type":"string","format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency code in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format. For example, USD."},"children":[]}]}]}],"example":"USD"},"bearer":{"type":"string","enum":["customer","merchant"],"description":"The party bearing this fee.\n","example":"merchant"},"collection_mode":{"type":["string","null"],"enum":["immediate","deferred",null],"description":"When the fee is collected. Customer-borne fees are always collected immediately; merchant-borne fees follow the payment's collection mode.\n","example":"immediate"},"taxes":{"type":"array","items":{"$ref":"#/components/schemas/TaxLine"},"description":"Taxes applied on this fee (for example, GST). Empty when no tax applies to the underlying rules.\n"}}}},"components/schemas/Payment":{"id":"components/schemas/Payment","kind":"json-schema","title":"Payment","data":{"type":"object","x-tags":["Payment"],"properties":{"id":{"type":"string","readOnly":true,"description":"The unique identifier for the payment.\n","example":"payt_E602dMzgjpDC"},"payin_id":{"type":["string","null"],"description":"The unique identifier for the payin. This is set only for payments associated to a payin.\n","example":"plink_E602dMzgjpDC"},"payin_type":{"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 type of the payin. This is set only for payments associated to a payin."},"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":"code","inline":true,"attributes":{"content":"payment_link"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the payment was made through a payment link."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"orders"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the payment was made against an order."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"add_funds"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the payment tops up your own Glomo balance."},"children":[]}]}]}]}],"enum":["payment_link","orders","add_funds",null]},"subscription_id":{"type":["string","null"],"description":"The unique identifier for the subscription. This is set only for subscription-related payments.\n","example":"sub_68877570b5zeE"},"status":{"type":"string","readOnly":true,"enum":["in_progress","action_required","under_review","success","failed"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The status of the payment."},"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":"code","inline":true,"attributes":{"content":"in_progress"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the payment has started and has not completed yet."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"action_required"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — Glomo needs more information before the payment can complete. Respond to the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"open RFI to continue."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"under_review"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the information you submitted is being reviewed."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"success"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the payment completed. Terminal. Funds can still be held for compliance review; see"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"compliance_status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"failed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the payment did not complete. Terminal."},"children":[]}]}]}]}]},"compliance_status":{"type":["string","null"],"readOnly":true,"enum":["action_required","under_review","approved","rejected",null],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The compliance review status of the payment. Present only for payments that have been screened for"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"sanctions or transaction-monitoring holds; "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for payments that were not screened. This is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"separate from "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — a payment can be "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status: success"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" while "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"compliance_status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"action_required"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", meaning the payment itself completed but funds are held pending compliance"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"review. See the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rfi"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field for what's required when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"action_required"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"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":"code","inline":true,"attributes":{"content":"under_review"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the payment is being reviewed and its funds are held."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"action_required"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — documents are needed before the review can finish. Respond to the open RFI."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"approved"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the review passed and the funds are released."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rejected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the payment did not pass the review."},"children":[]}]}]}]}],"example":"action_required"},"rfi":{"type":"object","readOnly":true,"description":"Present only when a compliance-related Request For Information exists on this payment. Describes why the payment was flagged and what's required to resolve it.\n","properties":{"id":{"type":"string","description":"The unique identifier for the RFI.\n","example":"rfi_6a72a39b38jDD"},"reason_code_description":{"type":"string","description":"A human-readable description of why this payment was flagged for compliance review.\n","example":"The payment has been flagged for a compliance review and requires additional information before it can credited to your account."},"reason_code":{"type":"string","description":"A machine-readable code for the compliance review reason.\n","example":"COMPLIANCE_REVIEW"},"response_deadline":{"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 deadline by which the requested documents must be submitted. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when no deadline has been set."},"children":[]}]}]}],"example":"2026-08-21T10:29:00Z"},"documents_required":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Present only when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"compliance_status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"action_required"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The documents needed to resolve this RFI. Submit documents against a specific requirement using its "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rfi_doc_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" via the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/api-reference/openapi/rfi/respondrfi"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Respond to an RFI"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint, passing the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rfi.id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" as the RFI identifier."},"children":[]}]}]}],"items":{"type":"object","properties":{"rfi_doc_id":{"type":"string","description":"The unique identifier for this document requirement.\n","example":"rfidoc_6a72a39b38jDD"},"description":{"type":"string","description":"A human-readable description of what document is needed.\n","example":"Passport"},"multiple_allowed":{"type":"boolean","description":"Whether more than one document can be submitted for this requirement.\n","example":false},"max_count":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The maximum number of documents that can be submitted for this requirement, as a count of documents. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when the requirement does not set a higher limit."},"children":[]}]}]}],"example":1}}}}}},"payment_currency":{"type":"string","format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency in which the customer pays. The currency code is in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format. For example, AED."},"children":[]}]}]}],"example":"AED"},"payment_amount":{"type":"number","minimum":1,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The total amount the customer pays (includes customer-borne fees if applicable), in the smallest unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payment_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", the customer-side currency. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"374580"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is 3,745.80 AED when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payment_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is AED."},"children":[]}]}]}],"example":374580},"converted_currency":{"type":"string","format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The settlement currency after conversion. The currency code is in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format. For example, USD."},"children":[]}]}]}],"example":"USD"},"converted_amount":{"type":"number","minimum":1,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The payment amount in the smallest unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"converted_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", the merchant-side currency. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"100000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $1,000.00 when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"converted_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is USD. Always the same value as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"requested_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". For a payment against an order, payment link or subscription, it is the amount requested and excludes customer-borne fees, which are counted only in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payment_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A bank transfer that is not yet connected to an order or payment link shows the amount and currency received. Once it is connected and the amount received matches the payin's quote, it shows the merchant-side amount like any other payment."},"children":[]}]}]}],"example":100000},"requested_currency":{"type":"string","format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency that was originally requested by the merchant. The currency code is in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format. For example, USD."},"children":[]}]}]}],"example":"USD"},"requested_amount":{"type":"number","minimum":1,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The amount requested by the merchant, in the smallest unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"requested_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", the merchant-side currency. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"100000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $1,000.00 when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"requested_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is USD. Always the same value as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"converted_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". For a payment against an order, payment link or subscription, it excludes customer-borne fees, which are counted only in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payment_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A bank transfer that is not yet connected to an order or payment link shows the amount and currency received. Once it is connected and the amount received matches the payin's quote, it shows the merchant-side amount like any other payment."},"children":[]}]}]}],"example":100000},"purpose_code":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Purpose code recorded against this payment, from the fixed set of "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/payin/purpose-codes"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"payin purpose codes"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". For a payment connected to a payin this is normally the payin's purpose code. It can be empty."},"children":[]}]}]}],"example":"S0001"},"sender_name":{"type":"string","description":"The name of the sender.\n","example":"John Doe"},"notes":{"type":"object","additionalProperties":{"type":"string"},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Custom field values for this payment. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/payin/custom-fields"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Custom Fields"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":{"policy_number":"POL-001"}},"request_id":{"type":["string","null"],"readOnly":true,"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":"request_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" you sent when creating this payment; "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if you sent none. Look the payment up with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v1/payments?request_id=<your_request_id>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"your-internal-id"},"error_code":{"type":"string","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The error code for the respective error. Error code mappings can be found in the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/payin/payment#error-codes"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"product guide"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"PAYMENT_DECLINED"},"error_description":{"type":"string","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The merchant-facing error description corresponding to the error code. Operational copy for the merchant. See "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"customer_error_description"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for the copy meant for the end-customer."},"children":[]}]}]}],"example":"The payment attempt was declined. This could be due to issuer rejection, risk assessment, or restrictions on the card or account. The customer should contact their bank or try a different payment method."},"customer_error_description":{"type":["string","null"],"readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Customer-facing error copy, written for the merchant to relay to their end-customer. Derives from the same "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"error_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"error_description"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" but targets a different audience. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when there is no "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"error_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or when the error code has no customer-facing variant (some codes are merchant-only, e.g. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ACCOUNT_LOCKED"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"LOGGED_IN_ELSEWHERE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"FUNCTIONALITY_RESTRICTED"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"example":"Your payment could not be completed. Please try a different payment method or contact your bank."},"paid_at":{"type":["string","null"],"readOnly":true,"format":"date-time","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When the payment was completed, as an ISO 8601 date-time in UTC. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if the payment has not been paid."},"children":[]}]}]}],"example":"2024-12-06T11:38:37.130Z"},"fee_bearer":{"type":"string","enum":["customer","merchant","split"],"description":"The party bearing the fees for the payment.\n","example":"customer"},"fee_collection_mode":{"type":["string","null"],"enum":["immediate","deferred",null],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When merchant-borne fees are collected. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"immediate"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" deducts fees up front; "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"deferred"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" invoices them later. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when not applicable."},"children":[]}]}]}],"example":"immediate"},"created_at":{"type":"string","readOnly":true,"format":"date-time","description":"When the payment was created, as an ISO 8601 date-time in UTC.\n","example":"2024-12-06T11:38:37.130Z"},"updated_at":{"type":"string","readOnly":true,"format":"date-time","description":"When the payment was last updated, as an ISO 8601 date-time in UTC.\n","example":"2024-12-06T11:38:37.130Z"},"customer_id":{"type":"string","description":"The unique identifier for the customer.\n","example":"cust_E602sMzgjpDC"},"merchant_id":{"type":"string","description":"The unique identifier for the merchant (business) that owns the payment.\n","example":"merch_68c777fcOOMpl"},"product_name":{"type":["string","null"],"readOnly":true,"description":"The name of the product associated with the payment.\n","example":"ShieldGuard Insurance"},"product_description":{"type":["string","null"],"readOnly":true,"description":"The description of the product associated with the payment.\n","example":"Simple, monthly insurance plan that covers your basic belongings and key digital assets"},"country":{"type":"string","format":"iso-3166-1-alpha-3","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The country of the sender. Country should be sent as a "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 3166-1 alpha-3"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" code."},"children":[]}]}]}],"example":"Ind"},"fees":{"type":"object","deprecated":true,"description":[{"$$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":"Deprecated."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fee_breakdown"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" instead. The fees charged for the payment, aggregated per fee type. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fee_breakdown"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" provides a per-bearer breakdown including any applicable taxes."},"children":[]}]}]}],"properties":{"txn_fee":{"$ref":"#/components/schemas/Money","description":"The transaction fee charged for the payment.\n"},"fx_fee":{"$ref":"#/components/schemas/Money","description":"The foreign exchange fee charged for the payment.\n"},"referral_fee":{"$ref":"#/components/schemas/Money","description":"The referral fee charged for the payment.\n"}}},"fee_breakdown":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A detailed breakdown of the fees charged for the payment, grouped by fee type. Each fee type holds one entry per fee bearer, with any applicable taxes (for example, GST) nested under the entry's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"taxes"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" array."},"children":[]}]}]}],"properties":{"fx_fee":{"type":"array","items":{"$ref":"#/components/schemas/FeeBreakdownEntry"},"description":"Foreign exchange fee lines.\n"},"txn_fee":{"type":"array","items":{"$ref":"#/components/schemas/FeeBreakdownEntry"},"description":"Transaction fee lines.\n"},"referral_fee":{"type":"array","items":{"$ref":"#/components/schemas/FeeBreakdownEntry"},"description":"Referral fee lines.\n"}}},"documents":{"type":"array","items":{"$ref":"#/components/schemas/AttachedDocument"},"description":"The attached documents for the payment.\n"},"settlement_id":{"type":"string","description":"A unique identifier generated by Glomo for the settlement batch in which this payment is included. This ID can be used to track and reconcile payments against corresponding settlements.\n"},"funds_available":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Indicates whether the funds for this payment are currently available with Glomo."},"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":"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":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - Funds are available with Glomo and can be included in a payout or settlement"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"false"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - Funds are still in transit with Glomo's payment partners and are not yet available for use"},"children":[]}]}]}]}]},"payment_method":{"type":"object","description":"Specifies the method used by the customer to complete the payment.\n","properties":{"type":{"type":"string","enum":["bank_transfer","pay_via_bank","card"],"description":"The type of payment method used for the transaction.\n","example":"bank_transfer"},"details":{"type":"object","description":"Additional details specific to the payment method type. The structure varies based on the payment method type.\n","oneOf":[{"title":"Bank Transfer Details","properties":{"sender_name":{"type":"string","description":"The name of the sender as provided by the sending bank.\n","example":"Vaibhav LRS"},"sender_country":{"type":["string","null"],"description":"The ISO 3166-1 alpha-3 country code of the sender.\n","example":"IND"},"sender_account_number":{"type":"string","description":"The account number of the sender.\n","example":"5454545454"},"receiver_account_number":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The account number credited by the transfer — the virtual account assigned to you."},"children":[]}]}]}],"example":"98765432109876"},"sender_bank_name":{"type":["string","null"],"description":"The name of the sender's bank.\n","example":"JPMORGAN CHASE BANK,N.A."},"sender_bank_country":{"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 ISO 3166-1 alpha-3 country code of the sender's bank. This is the country of the bank, which can differ from "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sender_country"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"USA"},"sender_bank_address":{"type":["string","null"],"description":"The registered address of the sender's bank.\n","example":"270 Park Avenue, New York"},"swift_code":{"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 sender bank's ISO 9362 BIC. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" while the identifier is not available."},"children":[]}]}]}],"example":"CHASUS33"},"local_routing_number":{"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 sender bank's domestic routing identifier — a US ABA routing number, a UK sort code, or an Australian BSB. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" while the identifier is not available."},"children":[]}]}]}],"example":"300129"},"external_reference":{"type":["string","null"],"description":"The reference supplied by the partner bank for the incoming transfer, for reconciliation against your own records.\n","example":"GLM7A2C1"},"transfer_type":{"type":["string","null"],"enum":["swift","local",null],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The rail the funds arrived on. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"swift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for a cross-border SWIFT transfer, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"local"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for a domestic scheme such as ACH, Faster Payments or SEPA."},"children":[]}]}]}],"example":"swift"},"remittance_information":{"type":["string","null"],"description":"Additional remittance information provided with the payment.\n","example":"PaymentForLrs"}}},{"title":"Pay Via Bank Details","properties":{"sender_name":{"type":["string","null"],"description":"The name of the sender as provided by the sending bank.\n","example":"Vaibhav LRS"},"sender_country":{"type":["string","null"],"description":"The ISO 3166-1 alpha-3 country code of the sender.\n","example":"IND"},"sender_account_number":{"type":["string","null"],"description":"The account number debited.\n","example":"5454545454"},"sender_bank_name":{"type":["string","null"],"description":"The name of the sender's bank.\n","example":"HDFC Bank"},"sender_bank_country":{"type":["string","null"],"description":"The ISO 3166-1 alpha-3 country code of the sender's bank.\n","example":"IND"},"sender_bank_address":{"type":["string","null"],"description":"The registered address of the sender's bank.\n","example":"Senapati Bapat Marg, Mumbai"},"swift_code":{"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 sender bank's ISO 9362 BIC. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" while the identifier is not available."},"children":[]}]}]}],"example":"HDFCINBB"},"local_routing_number":{"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 sender bank's domestic routing identifier — a US ABA routing number, a UK sort code, or an Australian BSB. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" while the identifier is not available."},"children":[]}]}]}],"example":"300129"},"external_reference":{"type":["string","null"],"description":"The reference supplied by the partner bank, for reconciliation against your own records.\n","example":"GLM7A2C1"},"transfer_type":{"type":["string","null"],"enum":["swift","local",null],"description":"The rail used to debit the sender.\n","example":"swift"},"remittance_information":{"type":["string","null"],"description":"Additional remittance information provided with the payment.\n","example":"PaymentForLrs"}}},{"title":"Card Details","properties":{"card_network":{"type":"string","description":"The card network (e.g., Visa, Mastercard, American Express).\n","example":"Visa"},"card_type":{"type":"string","description":"The type of card (e.g., credit, debit).\n","example":"credit"},"end_digits":{"type":"string","description":"The last few digits of the card number for identification.\n","example":"1234"},"country_code":{"type":"string","description":"The country code associated with the card.\n","example":"US"},"card_holder_name":{"type":"string","description":"The name of the card holder.\n","example":"John Doe"},"card_bin":{"type":"string","description":"The IIN (also known as BIN) is the card-number prefix that identifies the network, card type and issuing country.\n","example":"400000"},"issuer_name":{"type":"string","description":"The name of the card issuing bank or financial institution.\n","example":"Chase Bank"}}}]}},"examples":[{"summary":"Bank Transfer Payment Method (SWIFT, sender bank identified by BIC)","value":{"type":"bank_transfer","details":{"sender_name":"Vaibhav LRS","sender_account_number":"5454545454","receiver_account_number":"98765432109876","sender_country":"IND","sender_bank_name":"JPMORGAN CHASE BANK,N.A.","sender_bank_country":"USA","sender_bank_address":"270 Park Avenue, New York","swift_code":"CHASUS33","local_routing_number":null,"external_reference":"GLM7A2C1","transfer_type":"swift","remittance_information":"PaymentForLrs"}}},{"summary":"Bank Transfer Payment Method (local, sender bank identified by a UK sort code)","value":{"type":"bank_transfer","details":{"sender_name":"Vaibhav LRS","sender_account_number":"5454545454","receiver_account_number":"98765432109876","sender_country":"GBR","sender_bank_name":"ICICI BANK UK PLC","sender_bank_country":"GBR","sender_bank_address":"One Thomas More Square, London","swift_code":null,"local_routing_number":"300129","external_reference":"GLM7A2C1 INVOICE 4471","transfer_type":"local"}}},{"summary":"Pay Via Bank Payment Method (LRS remittance)","value":{"type":"pay_via_bank","details":{"sender_name":"Vaibhav LRS","sender_country":"IND","sender_account_number":"5454545454","sender_bank_name":"HDFC Bank","sender_bank_country":null,"sender_bank_address":null,"swift_code":null,"local_routing_number":null,"external_reference":null,"transfer_type":"swift","remittance_information":"PaymentForLrs"}}},{"summary":"Card Payment Method","value":{"type":"card","details":{"card_network":"Visa","card_type":"credit","end_digits":"1234","country_code":"US","card_holder_name":"John Doe","card_bin":"400000","issuer_name":"Chase Bank"}}}]},"auto_debit?":{"type":["boolean","null"],"readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Indicates whether the payment was made via auto-debit. Present only for subscription payments; "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for an auto-debit payment, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"false"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for a manual subscription payment."},"children":[]}]}]}],"example":true}}}},"components/schemas/CreatePaymentRequest":{"id":"components/schemas/CreatePaymentRequest","kind":"json-schema","title":"CreatePaymentRequest","data":{"type":"object","x-internal":true,"properties":{"order_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 unique identifier for the order. Either "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"order_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"subscription_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" must be provided, but not both."},"children":[]}]}]}],"example":"order_68c00b7btsthf"},"subscription_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 unique identifier for the subscription. Either "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"order_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"subscription_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" must be provided, but not both."},"children":[]}]}]}],"example":"sub_5JU9yv0lGSUP"},"method":{"type":"string","enum":["card"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Payment method. Must be "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"card"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Required for initial payments. Not required for subsequent payments (defaults to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"card"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"example":"card"},"sequence":{"type":"string","enum":["initial","subsequent"],"default":"initial","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Payment sequence. Use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"initial"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (default) for first-time payments or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"subsequent"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for merchant-initiated payments on "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"as_presented"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" subscriptions."},"children":[]}]}]}],"example":"initial"},"card":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Card details. Required for initial payments. Not required for subsequent payments — the card from the last successful payment is reused."},"children":[]}]}]}],"properties":{"holder_name":{"type":"string","description":"The name of the card holder.\n","example":"John Doe"},"number":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The card number: 13 to 19 digits, spaces are stripped. In sandbox, use one of the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/payin/payment-methods/cards#test-card-details"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"test card numbers"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; any other number is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and the message "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Card is not a valid test card"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Each test card's outcome is listed on the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/payin/payment-methods/cards#test-card-details"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Cards page"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"4111111111111111"},"expiry_month":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The card expiry month, two digits from "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"01"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"12"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The expiry must not be in the past."},"children":[]}]}]}],"example":"09"},"expiry_year":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The card expiry year in 2-digit (YY) format. Send the last two digits of the expiry year (e.g. for 2030, send '30'); the 4-digit year ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2030"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") is also accepted. The expiry must not be in the past."},"children":[]}]}]}],"example":"30"},"cvv":{"type":"string","description":"The card CVV/CVC code, 3 or 4 digits.\n","example":"123"}},"required":["holder_name","number","expiry_month","expiry_year","cvv"]},"callback_url":{"type":"string","format":"uri","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"HTTPS URL where the customer is redirected after payment processing. Required for initial payments. Not required for subsequent payments as there is no customer redirect involved. When sent, it must be an "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"https://"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" URL: an "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"http://"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" URL returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with a message containing "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Callback url must be a valid HTTPS URL"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and a value that is not a web URL returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Callback url is not a valid URL"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"https://server.yoursite.com/payment/callback"},"request_id":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Your unique identifier for this payment, used to reject duplicates. Required for subsequent payments, optional for initial payments. On a subsequent payment, a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"request_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" already used on your account is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and the message "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Payment already exists for this request_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Retrying an initial payment is rejected first by the order or subscription state check (for example "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Order has an ongoing payment"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Order is not in a valid state for payment"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). In neither case is the existing payment returned; look it up with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v1/payment?request_id=<your_request_id>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"unique_request_id_123"},"amount":{"type":"integer","minimum":1,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Payment amount in the smallest unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", which must be the subscription's currency (cents for USD). "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1500"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $15.00 when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is USD. Read only 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":", where it is required, must be greater than 0 and cannot exceed the subscription's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"max_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Ignored on initial payments."},"children":[]}]}]}],"example":1500},"currency":{"type":"string","format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Currency code in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format, case-insensitive. Checked only on subsequent payments, where it must match the subscription's currency; otherwise the request is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Ignored on initial payments."},"children":[]}]}]}],"example":"USD"},"split_ids":{"allOf":[{"$ref":"#/components/schemas/SplitIds"}],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The pricing splits to apply to this charge. Supported on a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"subsequent"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" auto debit for an "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"as_presented"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" subscription; sending "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"split_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for a fixed-frequency subscription returns a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"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":"The splits apply to this charge only. They override the subscription's own declaration for this charge and do not modify it. Omit "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"split_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and Glomo prices the charge from the subscription's declaration."},"children":[]}]}]}]},"notes":{"$ref":"#/components/schemas/Notes"}}}},"components/schemas/CreatePaymentResponse":{"id":"components/schemas/CreatePaymentResponse","kind":"json-schema","title":"CreatePaymentResponse","data":{"type":"object","x-internal":true,"properties":{"payment_id":{"type":"string","description":"The unique identifier for the created payment.\n","example":"payt_691eeb9aV79Uk"},"status":{"type":"string","enum":["in_progress","action_required","under_review","success","failed"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The current status of the payment. Uses the same values as the payment's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field. A payment that still needs the customer to act is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"in_progress"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and carries "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"next_steps"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"in_progress"},"next_steps":{"type":"array","description":"A list of actions to be taken to complete the payment. For initial payments, this typically includes a redirect URL for 3DS/OTP authentication and a polling URL to check payment status.\n","items":{"type":"object","properties":{"action":{"type":"string","enum":["redirect","poll"],"description":"The type of action to perform.\n","example":"redirect"},"payload":{"type":"object","description":"The payload for the action. Structure varies based on the action type.\n","properties":{"url":{"type":"string","format":"uri","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The URL for the action. For "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"redirect"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", this is the URL to redirect the customer to. For "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"poll"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", this is the URL to poll for payment status updates."},"children":[]}]}]}],"example":"https://secure.glomopay.com?paymentId=payt_691eeb9aV79Uk&authToken=ey...&redirectUrl=encoded_url"},"interval_in_ms":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The recommended polling interval in milliseconds. Only present for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"poll"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" actions."},"children":[]}]}]}],"example":5000}}}}}}}}},"components/schemas/Refund":{"id":"components/schemas/Refund","kind":"json-schema","title":"Refund","data":{"type":"object","x-tags":["Refund"],"properties":{"id":{"type":"string","readOnly":true,"description":"The unique identifier for the refund.\n","example":"refund_6776d57dnbTWj"},"customer_id":{"type":"string","description":"The unique identifier of customer linked to refund.\n","example":"cust_E602dMzgjpDC"},"payment_id":{"type":"string","description":"The unique identifier of payment linked to refund.\n","example":"payt_E602dMzgjpDC"},"reason":{"type":"string","enum":["Requested By Customer","Fraudulent","Duplicate","Others","Refunded For Subscription Verification","Refunded For Subscription Card Update"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The reason for the refund. For a refund you created, this is the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"reason"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" you sent."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Glomo also refunds some payments itself, and those refunds appear in your refund list with one of"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"two further reasons that you cannot send:"},"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":"code","inline":true,"attributes":{"content":"Refunded For Subscription Verification"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the refund of a small charge used to verify the card"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"when a subscription was set up."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Refunded For Subscription Card Update"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the refund of a small charge used to verify a new card"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"when the card on a subscription was replaced."},"children":[]}]}]}]}],"example":"Requested By Customer"},"fees":{"type":"object","description":"The fees charged for the refund.\n","properties":{"fx_fees":{"$ref":"#/components/schemas/Money","description":"The foreign exchange fee charged for the refund.\n"},"txn_fees":{"$ref":"#/components/schemas/Money","description":"The transaction fee charged for the refund.\n"}}},"balance_used":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The balance deducted to process the refund, with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in the smallest unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"properties":{"currency":{"type":"string","format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency code in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format."},"children":[]}]}]}],"example":"USD"},"amount":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The amount deducted, in the smallest unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"balance_used.currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (cents for USD). "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $10.00 when that currency is USD."},"children":[]}]}]}],"example":1000}}},"documents":{"type":"array","items":{"anyOf":[{"type":"object","description":"The document attached to the refund.\n","properties":{"id":{"type":"string","readOnly":true,"description":"The unique identifier for the Document.\n","example":"doc_nYUqLpuYQ0M8"},"type":{"type":"string","description":"The type of the document.\n","example":"rfi"},"status":{"type":"string","enum":["pending","uploaded","approved","rejected"],"description":"The status of the document.\n","example":"pending"}}},{"type":"object","description":"The document required to be uploaded to respond to rfi.\n","properties":{"id":{"type":"string","readOnly":true,"description":"The unique identifier for the Document.\n","example":null},"rfi_doc_id":{"type":"string","description":"The identifier that needs to be sent when responding to rfi.\n","example":"rfidoc_nYUqLpuYQ0M8"},"type":{"type":"string","description":"The type of the document.\n","example":"rfi"},"status":{"type":"string","enum":["pending","uploaded","approved","rejected"],"description":"The status of the document.\n","example":"pending"}}}]}},"status":{"type":"string","readOnly":true,"enum":["in_progress","under_review","action_required","success","failed","cancelled"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The status of the refund."},"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":"code","inline":true,"attributes":{"content":"in_progress"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the refund has been accepted and is being sent back to the customer."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"under_review"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the refund is being reviewed by Glomo before it is processed."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"action_required"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — Glomo needs more information before the refund can proceed. Respond to the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"open RFI to continue."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"success"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the refund has been paid out. Terminal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"failed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the refund could not be completed. Terminal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cancelled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the refund was stopped before it was paid out. Terminal."},"children":[]}]}]}]}],"example":"success"},"currency":{"type":"string","format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency code in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format. For example, USD."},"children":[]}]}]}],"example":"USD"},"amount":{"type":"number","minimum":1,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The refund amount, in the smallest unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (cents for USD). "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $10.00 when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is USD. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is the payment's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payment_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (the currency the customer paid in), or its "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"converted_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when the payment has no "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payment_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", so it can differ from the currency of the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" you send when creating the refund."},"children":[]}]}]}],"example":1000},"utr":{"type":"string","readOnly":true,"description":"The Unique Transaction Reference (UTR) number associated with the refund.\n","example":"UTR123456789"},"partial_refund":{"type":"boolean","readOnly":true,"description":"Indicates whether the refund is a partial refund.\n","example":false},"request_id":{"type":["string","null"],"readOnly":true,"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":"request_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" you sent when creating this refund; "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if you sent none. Look the refund up with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v1/refunds?request_id=<your_request_id>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"your-internal-id"},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"When the refund was created, as an ISO 8601 date-time in UTC.\n","example":"2021-06-01T12:00:00Z"},"updated_at":{"type":"string","format":"date-time","readOnly":true,"description":"When the refund was last updated, as an ISO 8601 date-time in UTC.\n","example":"2021-06-01T12:00:00Z"}}}},"components/schemas/Price":{"id":"components/schemas/Price","kind":"json-schema","title":"Price","data":{"type":"object","x-tags":["Price"],"properties":{"id":{"type":"string","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier for the price. Pass this value as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"price_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when creating a payin or an order to apply this referral fee to it."},"children":[]}]}]}],"example":"price_DdWp_HUbOnlg"},"pricing_type":{"type":"string","enum":["fixed","percentage"],"description":"The type of pricing to be applied.\n","example":"fixed"},"fees_amount":{"type":"number","minimum":1,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The amount that will be deducted from your balance for this pricing. A positive integer representing the smallest currency unit. For example, if the amount is $299.00, then pass 29900 in this field. In the case of three decimal currencies, such as KWD, BHD and OMR, to represent an amount of 295.991, pass the value as 295990. And in the case of zero decimal currencies such as JPY, for amount ￥295, pass the value as 295"},"children":[]}]}]}],"example":1000},"fees_currency":{"type":"string","format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency code in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format."},"children":[]}]}]}],"example":"USD"},"bps":{"type":"number","minimum":1,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The percentage fee, in basis points: 1 basis point is 0.01%, so "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is 10%. Required when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pricing_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"percentage"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and must not be sent when it is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fixed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":1000},"set_as_default":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Set this pricing as default for the business. Overrides the previously set default if set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":true},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"When the price was created, as an ISO 8601 date-time in UTC.\n","example":"2021-06-01T12:00:00Z"},"updated_at":{"type":"string","format":"date-time","readOnly":true,"description":"When the price was last updated, as an ISO 8601 date-time in UTC.\n","example":"2021-06-01T12:00:00Z"}}}},"components/schemas/DynamicPrice":{"id":"components/schemas/DynamicPrice","kind":"json-schema","title":"DynamicPrice","data":{"type":"object","x-tags":["pricing_split"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A payin pricing rule configured by Glomo whose fee bearer is dynamic. Your business declares its own share of such a rule's fee by creating a pricing split against the rule's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and the customer bears the remainder. Until a split is declared the rule is never applied, and pricing falls back to your normal (non-dynamic) rules."},"children":[]}]}]}],"properties":{"id":{"type":"string","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the pricing rule. Pass this value as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"price_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when you create a pricing split."},"children":[]}]}]}],"example":"price_5JU9yv0lGSUP"},"fee_type":{"type":"string","readOnly":true,"enum":["transaction_fees"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The fee this rule prices. Only "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"transaction_fees"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" rules can be declared against, so only they are listed."},"children":[]}]}]}],"example":"transaction_fees"},"payment_type":{"type":"string","readOnly":true,"enum":["payin"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The direction this rule prices. Only "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payin"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" rules can be declared against, so only they are listed."},"children":[]}]}]}],"example":"payin"},"pricing_type":{"type":"string","readOnly":true,"enum":["percentage","fixed"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"How the fee is computed. A "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"percentage"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" rule charges "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bps"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of the amount. A "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fixed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" rule charges "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fees_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fees_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Declare "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bps"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" against a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"percentage"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" rule and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fixed_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" against a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fixed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" rule."},"children":[]}]}]}],"example":"percentage"},"payment_rail":{"type":["string","null"],"readOnly":true,"enum":["visa","mastercard","amex",null],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The card network this rule applies to. Set only on card rules, to price one network differently from the others; "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when the rule applies to every network, and always "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on non-card rules."},"children":[]}]}]}],"example":"visa"},"from_currency":{"type":["string","null"],"format":"iso-4217","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency the payment is collected in, in ISO 4217 format. The rule applies only to payments in this currency. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when the rule applies to every currency."},"children":[]}]}]}],"example":"USD"},"bps":{"type":["integer","null"],"readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The full fee in basis points, where 100 bps is 1%. Present on "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"percentage"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" rules and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fixed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" rules. Your declared "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bps"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" cannot exceed this value."},"children":[]}]}]}],"example":300},"fees_amount":{"type":["integer","null"],"readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The full fee in the smallest unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fees_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (cents for USD). "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"500"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $5.00 when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fees_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is USD. Present on "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fixed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" rules and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"percentage"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" rules. Your declared "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fixed_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" cannot exceed this value."},"children":[]}]}]}],"example":500},"fees_currency":{"type":["string","null"],"format":"iso-4217","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fees_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", as an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" code. Present on "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fixed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" rules and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"percentage"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" rules."},"children":[]}]}]}],"example":"USD"},"min_fee":{"type":["integer","null"],"readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The floor the rule applies to the computed fee, in the smallest unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"min_max_fee_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (cents for USD). "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"100"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $1.00 when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"min_max_fee_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is USD. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when the rule has no floor."},"children":[]}]}]}],"example":100},"max_fee":{"type":["integer","null"],"readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The cap the rule applies to the computed fee, in the smallest unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"min_max_fee_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (cents for USD). "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $20.00 when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"min_max_fee_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is USD. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when the rule has no cap."},"children":[]}]}]}],"example":2000},"min_max_fee_currency":{"type":["string","null"],"format":"iso-4217","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"min_fee"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"max_fee"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", as an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" code. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when the rule has neither."},"children":[]}]}]}],"example":"USD"},"display_label":{"type":["string","null"],"readOnly":true,"description":"The label shown to your customer at checkout for the fee this rule charges.\n","example":"Processing fee"},"effective_from":{"type":"string","format":"date","readOnly":true,"description":"The date from which this version of the rule applies, in IST.\n","example":"2026-07-01"},"payment_method":{"type":"object","readOnly":true,"description":"The payment method this rule applies to. A split declared against this rule prices only this payment method.\n","properties":{"type":{"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 payment method this rule applies to. One of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bank_transfer"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pay_via_bank"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"card"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"bank_transfer"},"subtype":{"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 payment method subtype this rule applies to, for example "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"local_transfer"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"swift_transfer"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when the rule applies to every subtype of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"swift_transfer"}}}}}},"components/schemas/PricingSplit":{"id":"components/schemas/PricingSplit","kind":"json-schema","title":"PricingSplit","data":{"type":"object","x-tags":["pricing_split"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Your declared share of a dynamic pricing rule's fee. The customer bears the remainder. Pass the split "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"split_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when you create a payment link, an order, a payin quote, a subscription or an auto debit."},"children":[]}]}]}],"properties":{"id":{"type":"string","readOnly":true,"description":"The unique identifier for the pricing split.\n","example":"psplit_7Kq2mXbTdLp9"},"price_id":{"type":"string","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the dynamic pricing rule this split was declared against. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#tag/pricing_split"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List dynamic pricing rules"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"price_5JU9yv0lGSUP"},"bps":{"type":["integer","null"],"readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Your share of the fee in basis points, where 100 bps is 1%. Present when the split was declared with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bps"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" otherwise."},"children":[]}]}]}],"example":150},"fixed_amount":{"type":["integer","null"],"readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Your share of the fee, in the smallest unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fee_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (cents for USD). "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"200"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $2.00 when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fee_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is USD. Present when the split was declared with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fixed_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" otherwise."},"children":[]}]}]}],"example":200},"min_fee":{"type":["integer","null"],"readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The floor you declared for your share, in the smallest unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fee_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (cents for USD). "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"100"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $1.00 when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fee_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is USD. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when you declared no floor."},"children":[]}]}]}],"example":100},"max_fee":{"type":["integer","null"],"readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The cap you declared for your share, in the smallest unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fee_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (cents for USD). "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $10.00 when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fee_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is USD. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when you declared no cap."},"children":[]}]}]}],"example":1000},"fee_currency":{"type":["string","null"],"format":"iso-4217","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fixed_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"min_fee"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"max_fee"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", in ISO 4217 format."},"children":[]}]}]}],"example":"USD"},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"When the pricing split was created, as an ISO 8601 date-time in UTC.\n","example":"2026-08-01T09:12:44Z"},"updated_at":{"type":"string","format":"date-time","readOnly":true,"description":"When the pricing split was last updated, as an ISO 8601 date-time in UTC.\n","example":"2026-08-01T09:12:44Z"}}}},"components/schemas/CreatePricingSplitRequest":{"id":"components/schemas/CreatePricingSplitRequest","kind":"json-schema","title":"CreatePricingSplitRequest","data":{"type":"object","title":"CreatePricingSplitRequest","additionalProperties":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Declare your share of a dynamic pricing rule's fee. The customer bears the remainder."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Provide exactly one of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bps"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fixed_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and match the rule's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pricing_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bps"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"percentage"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" rule, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fixed_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fixed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" rule. All amounts are in minor units (cents) and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bps"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is basis points, so 100 is 1%."},"children":[]}]}]}],"properties":{"price_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 dynamic pricing rule to declare against, from "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#tag/pricing_split"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List dynamic pricing rules"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The rule must belong to your business, have a dynamic fee bearer, price "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payin"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"transaction_fees"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", be currently effective, and be the latest effective version of the rule."},"children":[]}]}]}],"example":"price_5JU9yv0lGSUP"},"bps":{"type":"integer","minimum":0,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Your share of the fee in basis points, where 100 bps is 1%. Required on a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"percentage"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" rule. Cannot exceed the rule's own "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bps"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is valid and means the customer bears the whole fee. Must be a whole number sent as a JSON integer: no decimal point ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1.5"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1.0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are both rejected) and not a string ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"\"150\""},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is rejected). A negative value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"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":"Provide exactly one of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bps"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fixed_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", not both."},"children":[]}]}]}],"example":150},"fixed_amount":{"type":"integer","minimum":0,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Your share of the fee, in the smallest unit of the rule's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fees_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (cents for USD). "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"200"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $2.00 when that currency is USD. Must be a whole number sent as a JSON integer: no decimal point ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1.5"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1.0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are both rejected) and not a string ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"\"150\""},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is rejected). A negative value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Required on a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fixed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" rule, and cannot exceed the rule's own "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fees_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". If you also send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fee_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", it must match the rule's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fees_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Provide exactly one of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bps"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fixed_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", not both."},"children":[]}]}]}],"example":200},"min_fee":{"type":"integer","minimum":0,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The floor to apply to your share, in the smallest unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fee_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (cents for USD). "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"100"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $1.00 when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fee_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is USD. Must be a whole number sent as a JSON integer: no decimal point ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1.5"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1.0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are both rejected) and not a string ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"\"150\""},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is rejected). A negative value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Supported only on a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"percentage"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" rule, and only together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fee_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Must be less than or equal to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"max_fee"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":100},"max_fee":{"type":"integer","minimum":0,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The cap to apply to your share, in the smallest unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fee_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (cents for USD). "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $10.00 when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fee_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is USD. Must be a whole number sent as a JSON integer: no decimal point ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1.5"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1.0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are both rejected) and not a string ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"\"150\""},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is rejected). A negative value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Supported only on a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"percentage"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" rule, and only together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fee_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":1000},"fee_currency":{"type":"string","format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fixed_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"min_fee"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"max_fee"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", in ISO 4217 format. Required when you declare "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"min_fee"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"max_fee"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". On a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fixed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" rule it must equal the rule's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fees_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; omit it and Glomo derives it from the rule."},"children":[]}]}]}],"example":"USD"}},"required":["price_id"]}},"components/schemas/Amount":{"id":"components/schemas/Amount","kind":"json-schema","title":"Amount","data":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The amount in the smallest currency unit. For example, if the amount is $299.00, then 29900 is passed in  this field. In the case of three decimal currencies, such as KWD, BHD and OMR, to represent an amount of 295.991, pass the value as 295990. And in the case of zero decimal currencies such as JPY, for amount ￥295, pass the value as 295."},"children":[]}]}]}],"example":1000}},"components/schemas/Currency":{"id":"components/schemas/Currency","kind":"json-schema","title":"Currency","data":{"type":"string","format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency code in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format."},"children":[]}]}]}],"example":"USD"}},"components/schemas/IntervalType":{"id":"components/schemas/IntervalType","kind":"json-schema","title":"IntervalType","data":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Used in combination with interval_count to define the billing cycle frequency."},"children":[]}]}]}],"enum":["month","year","as_presented"]}},"components/schemas/IntervalCount":{"id":"components/schemas/IntervalCount","kind":"json-schema","title":"IntervalCount","data":{"type":["integer","null"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Number of intervals between a billing cycle, used in combination with interval_type."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Valid combinations:"},"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":"Monthly: interval_type='month', interval_count=1"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Quarterly: interval_type='month', interval_count=3"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Half-yearly: interval_type='month', interval_count=6"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Yearly: interval_type='year', interval_count=1"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"As Presented: interval_type='as_presented', interval_count=null"},"children":[]}]}]}]}],"enum":[1,3,6,null]}},"components/schemas/Subscription":{"id":"components/schemas/Subscription","kind":"json-schema","title":"Subscription","data":{"x-tags":["Subscription"],"type":"object","description":"Subscription resource represents a recurring billing agreement for a customer","properties":{"id":{"type":"string","description":"Unique identifier for the subscription.","example":"sub_5JU9yv0lGSUP"},"customer_id":{"type":"string","description":"Unique identifier of the customer associated with this subscription.","example":"cust_5JU9yv0lGSUP"},"product_name":{"type":"string","description":"Name of the product being subscribed to.","example":"ShieldGuard Insurance"},"product_description":{"type":"string","description":"Description of the product.","example":"Flexible, monthly insurance for belongings, travel, and digital assets, easy to manage"},"plan_name":{"type":"string","description":"Name of the subscription plan.","example":"ShieldGuard Lite"},"plan_description":{"type":"string","description":"Description of the subscription plan.","example":"Simple, monthly insurance plan that covers your basic belongings and key digital assets"},"reference_number":{"type":"string","description":"optional identifier to be sent for reconciliations\n","example":"R0001"},"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 subscription."},"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":"code","inline":true,"attributes":{"content":"created"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the subscription exists and is waiting for the customer to authorise it."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"authorized"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the customer has authorised the subscription and it has not become "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"active"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" yet."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"active"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the subscription is charging on its schedule."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"paused"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — you paused the subscription. Resume it to continue charging."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"halted"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — charging stopped automatically; "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"halt_reason"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" says why. It returns to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"active"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" after"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"its next successful payment, for example once the customer updates the card. The resume endpoint"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"applies only to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"paused"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" subscriptions."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"action_required"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — Glomo needs more information before the subscription can proceed. Respond to"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the open RFI to continue."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"under_review"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the information you submitted is being reviewed. The subscription becomes"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"active"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if the review passes and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"failed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if it does not."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"completed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — every billing cycle has been charged. Terminal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cancelled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the subscription was cancelled. Terminal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expired"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the customer did not authorise the subscription in time. Terminal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"failed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the subscription could not be set up, or did not pass review. Terminal."},"children":[]}]}]}]}],"enum":["created","authorized","active","paused","halted","action_required","under_review","completed","cancelled","expired","failed"],"example":"active"},"amount":{"$ref":"#/components/schemas/Amount"},"currency":{"$ref":"#/components/schemas/Currency"},"interval_type":{"$ref":"#/components/schemas/IntervalType"},"interval_count":{"$ref":"#/components/schemas/IntervalCount"},"billing_cycles":{"type":["integer","null"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Total number of billing cycles for the subscription. Each cycle lasts "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"interval_count"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" units of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"interval_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", so 12 cycles with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"interval_count"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" 1 and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"interval_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"month"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" span 12 months. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"as_presented"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" subscriptions."},"children":[]}]}]}],"example":12},"max_amount":{"type":["integer","null"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Maximum allowed amount per payment, in the smallest unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (cents for USD). "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"5000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $50.00 when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is USD. Present only for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"as_presented"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" subscriptions, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for regular subscriptions."},"children":[]}]}]}],"example":5000},"start_date":{"type":"string","format":"date","description":"Start date of the subscription in UTC timezone and ISO 8601 format (YYYY-MM-DD).","example":"2025-01-01"},"end_date":{"type":["string","null"],"format":"date","description":"The date on which the subscription ends in UTC timezone and ISO 8601 format (YYYY-MM-DD).","example":"2025-12-01"},"expires_at":{"type":"string","format":"date","description":"Expiration date for the subscription payment link in UTC timezone and ISO 8601 format (YYYY-MM-DD).","example":"2025-01-07"},"next_payment_date":{"type":["string","null"],"format":"date","description":"Date of the next scheduled payment in UTC timezone and ISO 8601 format (YYYY-MM-DD).","example":"2025-02-01"},"subscription_link_url":{"type":"string","format":"uri","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"URL for the subscription payment page. Your customer can use this URL to make the first payment and activate the subscription. The path is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/subscription-links/{id}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; in sandbox the URL ends with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"?sandbox=true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The host depends on your account, so share the URL exactly as returned rather than building it yourself."},"children":[]}]}]}],"example":"https://your-dashboard-host.example/subscription-links/sub_5JU9yv0lGSUP"},"cancelled_at":{"type":["string","null"],"format":"date","description":"Date when the subscription was cancelled in UTC timezone and ISO 8601 format (YYYY-MM-DD). This field is null unless the subscription status is 'cancelled'.","example":"2025-01-15"},"halt_reason":{"type":["object","null"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Present only when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"halted"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Describes why the subscription was halted. Absent for all other statuses."},"children":[]}]}]}],"properties":{"code":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-readable halt reason code."},"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":"code","inline":true,"attributes":{"content":"MAX_RETRIES_REACHED"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — every retry of a failed charge was used up without a successful payment."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"CARD_EXPIRED"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the card saved on the subscription has expired."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"MIGRATION_INCOMPLETE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the Visa card was not re-registered with Glomo's new card-processing"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"setup within the migration window."},"children":[]}]}]}]}],"enum":["MAX_RETRIES_REACHED","CARD_EXPIRED","MIGRATION_INCOMPLETE"],"example":"MAX_RETRIES_REACHED"},"description":{"type":"string","description":"Human-readable explanation of the halt reason.","example":"The maximum number of auto-debit retry attempts was reached without a successful payment."}},"required":["code","description"]},"notes":{"$ref":"#/components/schemas/Notes"},"payment_method":{"type":["object","null"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The active payment method on the subscription, derived from the most recent successful payment. Returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if no successful payment has been made yet (e.g. a newly created subscription or one where the first payment attempt failed)."},"children":[]}]}]}],"properties":{"type":{"type":"string","enum":["card"],"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. Currently only "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"card"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is supported for subscriptions. Additional types (e.g. UPI, wallets) will be added as subscription support is extended."},"children":[]}]}]}],"example":"card"},"details":{"type":"object","description":"Details specific to the payment method type.\n","properties":{"card_network":{"type":"string","description":"The card network (e.g., Visa, Mastercard, American Express).\n","example":"Visa"},"card_type":{"type":"string","description":"The type of card (e.g., credit, debit).\n","example":"credit"},"end_digits":{"type":"string","description":"The last four digits of the card number.\n","example":"4242"},"country_code":{"type":"string","description":"The country code associated with the card.\n","example":"IN"},"card_holder_name":{"type":"string","description":"The name of the cardholder.\n","example":"John Doe"},"card_bin":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The IIN (also known as BIN) — the card-number prefix that identifies the network, card type, and issuing country."},"children":[]}]}]}],"example":"424242"},"issuer_name":{"type":"string","description":"The name of the card issuing bank or financial institution.\n","example":"HDFC Bank"}}}},"example":{"type":"card","details":{"card_network":"Visa","card_type":"credit","end_digits":"4242","country_code":"IN","card_holder_name":"John Doe","card_bin":"424242","issuer_name":"HDFC Bank"}}}},"required":["id","customer_id","product_name","product_description","status","amount","currency","interval_type","start_date","expires_at","subscription_link_url"]}},"components/schemas/CreateSubscriptionRequest":{"id":"components/schemas/CreateSubscriptionRequest","kind":"json-schema","title":"CreateSubscriptionRequest","data":{"type":"object","description":"Request payload for creating a new subscription","properties":{"customer_id":{"type":"string","description":"Unique identifier of the customer associated with this subscription.","example":"cust_5JU9yv0lGSUP"},"product_name":{"type":"string","maxLength":128,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Name of the product being subscribed to. Up to 128 characters, using only letters "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"A"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"–"},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"a"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"–"},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", digits, whitespace, hyphens, underscores, periods, commas, parentheses and ampersands. Accented letters and any other symbol are rejected. A value that breaks either rule returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with a message such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Product name contains invalid characters…"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Product name is too long (maximum is 128 characters)"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"ShieldGuard Insurance"},"product_description":{"type":"string","maxLength":512,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description of the product. Up to 512 characters. Allows the same characters as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"product_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", plus exclamation marks, colons, single quotes and asterisks; accented letters and any other symbol are rejected. A value that breaks either rule returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"Flexible monthly insurance for belongings travel and digital assets easy to manage"},"plan_name":{"type":"string","maxLength":128,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Name of the subscription plan. Optional. A non-blank value follows the same rules as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"product_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": up to 128 characters, and the same allowed characters."},"children":[]}]}]}],"example":"ShieldGuard Lite"},"plan_description":{"type":"string","maxLength":512,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description of the subscription plan. Optional. A non-blank value follows the same rules as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"product_description"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": up to 512 characters, and the same allowed characters."},"children":[]}]}]}],"example":"Simple, monthly insurance plan that covers your basic belongings and key digital assets"},"amount":{"$ref":"#/components/schemas/Amount"},"currency":{"$ref":"#/components/schemas/Currency"},"interval_type":{"$ref":"#/components/schemas/IntervalType"},"interval_count":{"$ref":"#/components/schemas/IntervalCount"},"billing_cycles":{"type":"integer","minimum":2,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Total number of billing cycles for the subscription. Required for regular subscriptions, must not be provided for 'as_presented' subscriptions."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A subscription can have a lifetime of 30 years."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Maximum billing cycles therefore depend on interval:"},"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":"Monthly (interval_type='month', interval_count=1): max 360 cycles"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Quarterly (interval_type='month', interval_count=3): max 120 cycles"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Half-yearly (interval_type='month', interval_count=6): max 60 cycles"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Yearly (interval_type='year', interval_count=1): max 30 cycles"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Send an integer of at least "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" as a JSON number; a string such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"\"12\""},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is rejected. A value below"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or above the interval's maximum returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":12},"max_amount":{"type":"integer","minimum":1,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Maximum allowed amount per payment for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"as_presented"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" subscriptions, in the smallest unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (cents for USD). "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"5000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $50.00 when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is USD. A positive integer. Required when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"interval_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"as_presented"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and must not be provided for regular subscriptions."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Subsequent payments on the subscription cannot exceed this amount."},"children":[]}]}]}],"example":5000},"start_date":{"type":"string","format":"date","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Start date of the subscription in UTC timezone and ISO 8601 format (YYYY-MM-DD). Must be today or in the future."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Required for regular subscriptions, must not be provided for 'as_presented' subscriptions."},"children":[]}]}]}],"example":"2025-01-01"},"expires_at":{"type":"string","format":"date","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Expiration date for the subscription payment link in UTC timezone and ISO 8601 format (YYYY-MM-DD). Must be today (UTC) or later, and at most 1 calendar month after today (UTC). An earlier date returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with the message "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Validation failed: Expires at must be today or in the future"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and a later one returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Validation failed: Expires at cannot be more than 1 months from today"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". It is not compared with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"start_date"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"2026-10-15","x-glomo-relative-example":"P7D"},"notify_customer":{"type":"boolean","description":"Whether to send notification e-mails to customers for subscription lifecycle changes.","example":true},"notes":{"$ref":"#/components/schemas/Notes"},"reference_number":{"type":"string","description":"optional identifier to be sent for reconciliations\n","example":"R0001"},"starts_with_first_payment":{"type":"boolean","description":"Whether the subscription payment schedule should get synchronized with the first payment.","example":true},"split_ids":{"allOf":[{"$ref":"#/components/schemas/SplitIds"}],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supported only when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"interval_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"as_presented"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Sending "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"split_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on a fixed-frequency subscription returns a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", because a fixed-frequency plan auto debits without you and so has no point at which to pass a split or replace one that goes stale."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The declaration applies to the first payment, and to every subsequent auto debit that does not pass "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"split_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of its own. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#tag/Payment"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create a payment"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for the auto debit override."},"children":[]}]}]}]}},"required":["customer_id","product_name","product_description","amount","currency","interval_type","expires_at","notify_customer","starts_with_first_payment"]}},"components/schemas/CreateSubscriptionResponse":{"id":"components/schemas/CreateSubscriptionResponse","kind":"json-schema","title":"CreateSubscriptionResponse","data":{"x-tags":["Subscription"],"type":"object","description":"Subscription resource represents a recurring billing agreement for a customer","properties":{"id":{"type":"string","description":"Unique identifier for the subscription.","example":"sub_5JU9yv0lGSUP"},"customer_id":{"type":"string","description":"Unique identifier of the customer associated with this subscription.","example":"cust_5JU9yv0lGSUP"},"product_name":{"type":"string","description":"Name of the product being subscribed to.","example":"ShieldGuard Insurance"},"product_description":{"type":"string","description":"Description of the product.","example":"Flexible, monthly insurance for belongings, travel, and digital assets, easy to manage"},"plan_name":{"type":"string","description":"Name of the subscription plan.","example":"ShieldGuard Lite"},"plan_description":{"type":"string","description":"Description of the subscription plan.","example":"Simple, monthly insurance plan that covers your basic belongings and key digital assets"},"reference_number":{"type":"string","description":"optional identifier to be sent for reconciliations\n","example":"R0001"},"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 subscription."},"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":"code","inline":true,"attributes":{"content":"created"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the subscription exists and is waiting for the customer to authorise it."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"authorized"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the customer has authorised the subscription and it has not become "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"active"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" yet."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"active"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the subscription is charging on its schedule."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"paused"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — you paused the subscription. Resume it to continue charging."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"halted"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — charging stopped automatically; "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"halt_reason"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" says why. It returns to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"active"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" after"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"its next successful payment, for example once the customer updates the card. The resume endpoint"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"applies only to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"paused"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" subscriptions."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"action_required"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — Glomo needs more information before the subscription can proceed. Respond to"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the open RFI to continue."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"under_review"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the information you submitted is being reviewed. The subscription becomes"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"active"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if the review passes and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"failed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if it does not."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"completed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — every billing cycle has been charged. Terminal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cancelled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the subscription was cancelled. Terminal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expired"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the customer did not authorise the subscription in time. Terminal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"failed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the subscription could not be set up, or did not pass review. Terminal."},"children":[]}]}]}]}],"enum":["created","authorized","active","paused","halted","action_required","under_review","completed","cancelled","expired","failed"],"example":"active"},"amount":{"$ref":"#/components/schemas/Amount"},"currency":{"$ref":"#/components/schemas/Currency"},"interval_type":{"$ref":"#/components/schemas/IntervalType"},"interval_count":{"$ref":"#/components/schemas/IntervalCount"},"billing_cycles":{"type":["integer","null"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Total number of billing cycles for the subscription. Each cycle lasts "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"interval_count"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" units of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"interval_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", so 12 cycles with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"interval_count"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" 1 and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"interval_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"month"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" span 12 months. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"as_presented"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" subscriptions."},"children":[]}]}]}],"example":12},"max_amount":{"type":["integer","null"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Maximum allowed amount per payment, in the smallest unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (cents for USD). "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"5000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $50.00 when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is USD. Present only for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"as_presented"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" subscriptions, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for regular subscriptions."},"children":[]}]}]}],"example":5000},"start_date":{"type":"string","format":"date","description":"Start date of the subscription in UTC timezone and ISO 8601 format (YYYY-MM-DD).","example":"2025-01-01"},"end_date":{"type":["string","null"],"format":"date","description":"The date on which the subscription ends in UTC timezone and ISO 8601 format (YYYY-MM-DD).","example":"2025-12-01"},"expires_at":{"type":"string","format":"date","description":"Expiration date for the subscription payment link in UTC timezone and ISO 8601 format (YYYY-MM-DD).","example":"2025-01-07"},"next_payment_date":{"type":["string","null"],"format":"date","description":"Date of the next scheduled payment in UTC timezone and ISO 8601 format (YYYY-MM-DD).","example":"2025-02-01"},"subscription_link_url":{"type":"string","format":"uri","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"URL for the subscription payment page. Your customer can use this URL to make the first payment and activate the subscription. The path is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/subscription-links/{id}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; in sandbox the URL ends with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"?sandbox=true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The host depends on your account, so share the URL exactly as returned rather than building it yourself."},"children":[]}]}]}],"example":"https://your-dashboard-host.example/subscription-links/sub_5JU9yv0lGSUP"},"cancelled_at":{"type":["string","null"],"format":"date","description":"Date when the subscription was cancelled in UTC timezone and ISO 8601 format (YYYY-MM-DD). This field is null unless the subscription status is 'cancelled'.","example":"2025-01-15"},"notes":{"$ref":"#/components/schemas/Notes"}},"required":["id","customer_id","product_name","product_description","status","amount","currency","interval_type","start_date","expires_at","subscription_link_url"]}},"components/schemas/UpdateSubscriptionNextPaymentDate":{"id":"components/schemas/UpdateSubscriptionNextPaymentDate","kind":"json-schema","title":"UpdateSubscriptionNextPaymentDate","data":{"type":"object","properties":{"next_payment_date":{"type":"string","description":"The next payment date in ISO 8601 format.\n","example":"2025-11-19"}}}},"components/schemas/Settlement":{"id":"components/schemas/Settlement","kind":"json-schema","title":"Settlement","data":{"type":"object","x-tags":["Settlement"],"properties":{"id":{"type":"string","readOnly":true,"description":"The unique identifier for the settlement.\n","example":"setl_6878e266jt1P3"},"status":{"type":"string","description":"The status of the settlement.\n","example":"success"},"payment_method":{"type":"string","description":"The payment method used for the settlement.\n","example":"swift_transfer"},"amount":{"type":"number","minimum":1,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The amount of the settlement, in the smallest unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (paise for INR, cents for USD). "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $10.00 when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is USD."},"children":[]}]}]}],"example":1000},"currency":{"type":"string","format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency in which the settlement is made. The currency code is in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format. For example, USD."},"children":[]}]}]}],"example":"USD"},"fees":{"type":"object","description":"The fees associated with the settlement.\n","properties":{"fx_fee":{"type":"object","description":"The foreign-exchange fee charged for the settlement in cents.\n","properties":{"amount":{"type":"number","minimum":0,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The foreign exchange fee, in the smallest unit of this fee's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"10"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $0.10 when that currency is USD."},"children":[]}]}]}],"example":10},"currency":{"type":"string","format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency code in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format. For example, USD."},"children":[]}]}]}],"example":"USD"}}},"txn_fee":{"type":"object","description":"The transaction fee charged for the settlement in cents.\n","properties":{"amount":{"type":"number","minimum":0,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The transaction fee, in the smallest unit of this fee's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"10"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $0.10 when that currency is USD."},"children":[]}]}]}],"example":10},"currency":{"type":"string","format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency code in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format. For example, USD."},"children":[]}]}]}],"example":"USD"}}}}},"utr":{"type":"string","description":"The Unique Transaction Reference (UTR) for the settlement.\n","example":"1568176960vxp0rj"},"created_at":{"type":"string","readOnly":true,"format":"date-time","description":"When the settlement was created, as an ISO 8601 date-time in UTC.\n","example":"2024-12-06T11:38:37.130Z"},"updated_at":{"type":"string","readOnly":true,"format":"date-time","description":"When the settlement was last updated, as an ISO 8601 date-time in UTC.\n","example":"2024-12-06T11:38:37.130Z"}}}},"components/schemas/CreateSettlementRequest":{"id":"components/schemas/CreateSettlementRequest","kind":"json-schema","title":"CreateSettlementRequest","data":{"type":"object","x-internal":true,"required":["amount","balance_currency"],"properties":{"amount":{"type":"number","minimum":1,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The amount to settle, in the smallest unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"balance_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (paise for INR, cents for USD). "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $10.00 when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"balance_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is USD. A fractional value is truncated to a whole number."},"children":[]}]}]}],"example":1000},"balance_currency":{"type":"string","format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The balance you want to settle from, as an upper-case "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" code such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"USD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The amount is deducted from this balance. It must match the currency of an active withdrawal account on your account, and the match is exact: a lower-case code, or a currency with no active withdrawal account, returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"404"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Withdrawal account not found"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"USD"}}}},"components/schemas/Transaction":{"id":"components/schemas/Transaction","kind":"json-schema","title":"Transaction","data":{"type":"object","x-tags":["Transaction"],"properties":{"id":{"type":"string","readOnly":true,"description":"The unique identifier for the transaction.\n","example":"txn_687f1f8ePcIYg"},"source_id":{"type":"string","description":"The unique identifier of the source for the transaction.\n","example":"payt_687f1f833Hdgx"},"source_type":{"type":"string","description":"The type of the source for the transaction.\n","example":"payment"},"transaction_type":{"type":"string","enum":["credit","debit"],"description":"The direction of the transaction. A credit adds to your balance. A debit takes from it.\n","example":"credit"},"credit":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The credit details for the transaction, with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in the smallest unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"properties":{"amount":{"type":"number","minimum":0,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The amount credited, in the smallest unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (cents for USD). "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $10.00 when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is USD."},"children":[]}]}]}],"example":1000},"currency":{"type":"string","format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency code in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format. For example, USD."},"children":[]}]}]}],"example":"USD"}}},"debit":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The debit details for the transaction, with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in the smallest unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"properties":{"amount":{"type":"number","minimum":0,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The amount debited, in the smallest unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (cents for USD). "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $10.00 when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is USD."},"children":[]}]}]}],"example":0},"currency":{"type":"string","format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency code in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format. For example, USD."},"children":[]}]}]}],"example":"USD"}}},"fees":{"type":"object","description":"The fees associated with the transaction.\n","properties":{"fx_fee":{"type":"object","description":"The foreign-exchange fee charged for the transaction in cents.\n","properties":{"amount":{"type":"number","minimum":0,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The foreign exchange fee, in the smallest unit of this fee's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (cents for USD). "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"10"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $0.10 when that currency is USD."},"children":[]}]}]}],"example":10},"currency":{"type":"string","format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency code in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format. For example, USD."},"children":[]}]}]}],"example":"USD"}}},"txn_fee":{"type":"object","description":"The transaction fee charged for the transaction in cents.\n","properties":{"amount":{"type":"number","minimum":0,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The transaction fee, in the smallest unit of this fee's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (cents for USD). "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"10"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $0.10 when that currency is USD."},"children":[]}]}]}],"example":10},"currency":{"type":"string","format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency code in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format. For example, USD."},"children":[]}]}]}],"example":"USD"}}}}},"settled_amount":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The details of the amount settled in this transaction, with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in the smallest unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"properties":{"amount":{"type":"number","minimum":1,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The amount settled, in the smallest unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (cents for USD). "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"980"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $9.80 when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is USD."},"children":[]}]}]}],"example":980},"currency":{"type":"string","format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency code in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format. For example, USD."},"children":[]}]}]}],"example":"USD"}}},"processed_at":{"type":"string","readOnly":true,"format":"date-time","description":"When the transaction was processed, as an ISO 8601 date-time in UTC.\n","example":"2024-12-06T11:38:37.130Z"},"created_at":{"type":"string","readOnly":true,"format":"date-time","description":"When the transaction was created, as an ISO 8601 date-time in UTC.\n","example":"2024-12-06T11:38:37.130Z"},"updated_at":{"type":"string","readOnly":true,"format":"date-time","description":"When the transaction was last updated, as an ISO 8601 date-time in UTC.\n","example":"2024-12-06T11:38:37.130Z"}}}},"components/schemas/VirtualAccount":{"id":"components/schemas/VirtualAccount","kind":"json-schema","title":"VirtualAccount","data":{"type":"object","x-tags":["virtual_account"],"properties":{"account_id":{"type":"string","readOnly":true,"description":"The unique identifier for the virtual account.\n","example":"va_6943ae9eFO3GW"},"currency":{"$ref":"#/components/schemas/Currency","description":"The currency of the virtual account in ISO 4217 format.\n","example":"USD"},"name":{"type":"string","readOnly":true,"description":"The name associated with the virtual account, typically the business name.\n","example":"test response"},"status":{"type":"string","enum":["active","inactive","disabled"],"readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The current status of the virtual account."},"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":"code","inline":true,"attributes":{"content":"active"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the account can receive funds."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"inactive"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the account exists but cannot receive funds yet."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"disabled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the account has been closed and does not receive funds."},"children":[]}]}]}]}],"example":"active"},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"When the virtual account was created, as an ISO 8601 date-time in UTC.\n","example":"2025-08-19T07:00:00Z"},"updated_at":{"type":"string","format":"date-time","readOnly":true,"description":"When the virtual account was last updated, as an ISO 8601 date-time in UTC.\n","example":"2025-08-19T07:00:00Z"},"disabled_at":{"type":["string","null"],"format":"date-time","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When the virtual account was disabled, as an ISO 8601 date-time in UTC. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if the account has not been disabled."},"children":[]}]}]}],"example":null},"merchant_id":{"type":"string","readOnly":true,"description":"The unique identifier for the merchant associated with the virtual account.\n","example":"merch_694bb0289P4Cz"},"account_number":{"type":"string","readOnly":true,"description":"The unique account number for the virtual account, formatted according to the country's banking standards. Applicable for AED, GBP, AUD, and USD accounts.\n","example":"AE580863912382801669068"},"iban":{"type":"string","readOnly":true,"description":"The International Bank Account Number (IBAN) for the virtual account. Applicable for EUR accounts.\n","example":"DK2089000025417759"},"sort_code":{"type":"string","readOnly":true,"description":"The sort code for the virtual account. Applicable for GBP accounts.\n","example":"608382"},"bsb_number":{"type":"string","readOnly":true,"description":"The Bank State Branch (BSB) number for the virtual account. Applicable for AUD accounts.\n","example":"252000"},"routing_number":{"type":"string","readOnly":true,"description":"The routing number for the virtual account. Applicable for USD accounts.\n","example":"026009593"},"payment_rails":{"type":"string","readOnly":true,"description":"The payment rail type for the virtual account. Applicable for USD accounts. Possible values are 'ach' for ACH transfers and 'wire' for Fedwire transfers.\n","enum":["ach","wire"],"example":"ach"}},"required":["account_id","currency","name","status","created_at","updated_at","merchant_id"]}},"components/schemas/CreateMerchantRequestBase":{"id":"components/schemas/CreateMerchantRequestBase","kind":"json-schema","title":"CreateMerchantRequestBase","data":{"type":"object","x-internal":true,"properties":{"name":{"type":"string","description":"Name of the merchant business","example":"Child Business Name"},"address_line1":{"type":"string","description":"Primary address line","example":"456 Commerce Street"},"address_line2":{"type":"string","description":"Secondary address line (optional)","example":"Suite 101"},"city":{"type":"string","description":"City name","example":"Mumbai"},"state":{"type":"string","description":"State or province","example":"Maharashtra"},"pincode":{"type":"string","description":"Postal/ZIP code","example":"400001"},"registration_number":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Registration number of the merchant. For a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"business"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", the company registration number. For an "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"individual"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", the PAN (Permanent Account Number), for example "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ABCDE1234F"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"REG123456"},"registration_country":{"type":"string","description":"Country where the business is registered (ISO 3166-1 alpha-3)","example":"IND"},"category":{"type":"string","description":"Merchant business category","enum":["Agricultural Services","Contracted Services","Transportation Services","Telecommunications","Utilities","Retail and Goods","Financial Services","Business Services","Professional Services","Government Services"],"example":"Agricultural Services"},"sub_category":{"type":"string","description":"Merchant business sub-category (must be paired with correct category, check examples)","enum":["Veterinary Services","Agricultural Cooperatives","Horticultural and Landscaping Services","General Contractors—Residential and Commercial","Air Conditioning Heating and Plumbing Contractors","Electrical Contractors","Insulation Masonry Plastering Stonework and Tile Setting Contractors","Carpentry Contractors","Roofing and Siding Sheet Metal Work Contractors","Concrete Work Contractors","Contractors Special Trade—not elsewhere classified","Miscellaneous Publishing and Printing","Typesetting Plate Making and Related Services","Sanitation Polishing and Specialty Cleaning Preparations","Railroads—Freight","Transportation—Suburban and Local Commuter Passenger including Ferries","Passenger Railways","Ambulance Services","Limousines and Taxicabs","Bus Lines","Motor Freight Carriers Trucking—Local/Long Distance Moving and Storage Companies Local Delivery","Courier Services—Air and Ground Freight Forwarders","Public Warehousing—Farm Products Refrigerated Goods Household Goods Storage","Cruise Lines","Boat Leases and Boat Rentals","Marinas Marine Service/Supplies","Air Carriers Airlines—Not Elsewhere Classified","Airports Airport Terminals Flying Fields","Travel Agencies and Tour Operators","Bridge and Road Fees Tolls","Transportation Services—not elsewhere classified","Telecommunication Equipment Including Telephone Sales","Key-entry Telecom Merchant providing single local and long-distance phone calls using a central access number in a non-face-to-face environment using key entry","Telecommunication Services including but not limited to prepaid phone services and recurring phone services","Computer Network/Information Services","Telegraph Services","Money Transfer","Cable Satellite and Other Pay Television and Radio Services","Utilities—Electric Gas Heating Oil Sanitary Water","Motor Vehicle Supplies and New Parts","Office and Commercial Furniture","Construction Materials—not elsewhere classified","Office Photographic Photocopy and Microfilm Equipment","Computers Computer Peripheral Equipment Software","Commercial Equipment—not elsewhere classified","Dental/Laboratory/Medical/Ophthalmic Hospital Equipment and Supplies","Metal Service Centers and Offices","Electrical Parts and Equipment","Hardware Equipment and Supplies","Plumbing and Heating Equipment","Industrial Supplies—not elsewhere classified","Precious Stones and Metals Watches and Jewelry","Durable Goods—not elsewhere classified","Stationery Office Supplies Printing and Writing Paper","Drugs Drug Proprietors and Druggists Sundries","Piece Goods Notions and Other Dry Goods","Men's Women's and Children's Uniforms and Commercial Clothing","Commercial Footwear","Chemicals and Allied Products—not elsewhere classified","Petroleum and Petroleum Products","Books Periodicals and Newspapers","Florists Supplies Nursery Stock and Flowers","Paints Varnishes and Supplies","Nondurable Goods—not elsewhere classified","Home Supply Warehouse Stores","Building Materials Lumber Stores","Glass Paint Wallpaper Stores","Hardware Stores","Lawn and Garden Supply Stores","Mobile Home Dealers","Wholesale Clubs","Duty Free Stores","Discount Stores","Department Stores","Variety Stores","Miscellaneous General Merchandise Stores","Grocery Stores Supermarkets","Freezer Locker Meat Provisioners","Candy Nut Confectionery Stores","Dairy Products Stores","Bakeries","Miscellaneous Food Stores—Convenience Stores Markets Specialty Stores","Automobile and Truck Dealers—Sales Service Repairs Parts and Leasing","Automobile and Truck Dealers—(Used Only)—Sales","Auto Store Home Supply Stores","Automotive Tire Stores","Automotive Parts Accessories Stores","Service Stations (with or without Ancillary Services)","Fuel Dispenser Automated","Boat Dealers","Camper Dealers Recreational and Utility Trailers","Motorcycle Shops and Dealers","Motor Home Dealers","Snowmobile Dealers","Miscellaneous Automotive Aircraft and Farm Equipment Dealers—not elsewhere classified","Men's and Boys' Clothing and Accessories Stores","Women's Ready to Wear Stores","Women's Accessory and Specialty Stores","Children's and Infants' Wear Stores","Family Clothing Stores","Sports Apparel Riding Apparel Stores","Shoe Stores","Furriers and Fur Shops","Men's and Women's Clothing Stores","Alterations Mending Seamstresses Tailors","Wig and Toupee Shops","Accessory and Apparel Stores—Miscellaneous","Equipment Furniture and Home Furnishings Stores (except Appliances)","Floor Covering Stores","Drapery Upholstery and Window Coverings Stores","Fireplace Fireplace Screens and Accessories Stores","Miscellaneous House Furnishing Specialty Shops","Household Appliance Stores","Electronic Sales","Music Stores—Musical Instruments Pianos Sheet Music","Computer Software Stores","Record Shops","Caterers","Eating Places Restaurants","Bars Cocktail Lounges Discotheques Nightclubs and Taverns—Drinking Places (Alcoholic Beverages)","Fast Food Restaurants","Digital Goods—Audiovisual Media Including Books Movies and Music","Digital Goods—Games","Digital Goods—Software Applications (Excluding Games)","Digital Goods—Multi-Category","Drug Stores Pharmacies","Package Stores Beer Wine and Liquor","Second Hand Stores Used Merchandise Stores","Antique Shops—Sales Repairs and Restoration Services","Pawn Shops","Salvage and Wrecking Yards","Antique Reproduction Stores","Bicycle Shops—Sales and Service","Sporting Goods Stores","Book Stores","Office School Supply and Stationery Stores","Clock Jewelry Watch and Silverware Store","Game Toy and Hobby Shops","Camera and Photographic Supply Stores","Card Gift Novelty and Souvenir Shops","Leather Goods and Luggage Stores","Fabric Needlework Piece Goods and Sewing Stores","Crystal and Glassware Stores","Direct Marketing—Insurance Services","Direct Marketing—Travel-Related Arrangement Services","Door-to-Door Sales","Direct Marketing—Catalog Merchants","Direct Marketing—Combination Catalog and Retail Merchants","Direct Marketing—Outbound Telemarketing Merchants","Direct Marketing—Inbound Telemarketing Merchants","Direct Marketing—Continuity/Subscription Merchants","Direct Marketing—Other Direct Marketers—not elsewhere classified","Artist Supply Stores Craft Shops","Art Dealers and Galleries","Stamp and Coin Stores—Philatelic and Numismatic Supplies","Religious Goods Stores","Hearing Aids—Sales Service Supply Stores","Orthopedic Goods—Artificial Limb Stores","Cosmetic Stores","Typewriter Stores—Rentals Sales Service","Fuel Dealers—Coal Fuel Oil Liquefied Petroleum Wood","Florists","Cigar Stores and Stands","News Dealers and Newsstands","Pet Shops—Pet Food and Supplies","Swimming Pools—Sales and Supplies","Electric Razor Stores—Sales and Service","Tent and Awning Shops","Miscellaneous and Specialty Retail Stores","Manual Cash Disbursements—Customer Financial Institution","Automated Cash Disbursements—Customer Financial Institution","Merchandise and Services—Customer Financial Institution","Quasi Cash—Customer Financial Institution","Quasi Cash—Merchant","Securities—Brokers/Dealers","Insurance Sales Underwriting and Premiums","Real Estate Agents and Managers—Rentals","Payment Transaction—Customer Financial Institution","Payment Transaction—Merchant","MoneySend Intracountry","MoneySend Intercountry","MoneySend Funding","POI Funding Transactions (Excluding MoneySend)","Lodging—Hotels Motels Resorts—not elsewhere classified","Timeshares","Recreational and Sporting Camps","Campgrounds and Trailer Parks","Cleaning Garment and Laundry Services","Laundry Services—Family and Commercial","Dry Cleaners","Carpet and Upholstery Cleaning","Photographic Studios","Barber and Beauty Shops","Hat Cleaning Shops Shoe Repair Shops Shoe Shine Parlors","Funeral Service and Crematories","Dating Services","Tax Preparation Service","Debt Marriage Personal—Counseling Service","Buying/Shopping Clubs Services","Clothing Rental—Costumes Uniforms and Formal Wear","Massage Parlors","Health and Beauty Spas","Other Services—not elsewhere classified","Advertising Services","Consumer Credit Reporting Agencies","Commercial Art Graphics Photography","Quick Copy Reproduction and Blueprinting Services","Stenographic and Secretarial Support Services","Exterminating and Disinfecting Services","Cleaning and Maintenance Janitorial Services","Employment Agencies Temporary Help Services","Computer Programming Data Processing and Integrated Systems Design Services","Information Retrieval Services","Computer Maintenance Repair and Services—not elsewhere classified","Consulting Management and Public Relations Services","Detective Agencies Protective Agencies Security Services including Armored Cars Guard Dogs","Equipment Rental and Leasing Services Furniture Rental Tool Rental","Photo Developing Photofinishing Laboratories","Business Services—not elsewhere classified","Automobile Rental Agency—not elsewhere classified","Truck Rental","Motor Home and Recreational Vehicle Rental","Automobile Parking Lots and Garages","Automotive Body Repair Shops","Tire Retreading and Repair Shops","Automotive Paint Shops","Automotive Service Shops","Car Washes","Towing Services","Electronic Repair Shops","Air Conditioning and Refrigeration Repair Shops","Appliance Repair Shops Electrical and Small","Clock Jewelry and Watch Repair Shops","Furniture—Reupholstery and Repair Refinishing","Welding Repair","Miscellaneous Repair Shops and Related Services","Government Owned Lottery (U.S. Region Only)","Internet Gambling (U.S. Region Only)","Government Licensed Horse/Dog Racing (U.S. Region Only)","Motion Picture and Video Tape Production and Distribution","Motion Picture Theaters","Video Entertainment Rental Stores","Dance Halls Schools and Studios","Theatrical Producers (except Motion Pictures) Ticket Agencies","Bands Orchestras and Miscellaneous Entertainers—not elsewhere classified","Pool and Billiard Establishments","Bowling Alleys","Athletic Fields Commercial Sports Professional Sports Clubs Sports Promoters","Tourist Attractions and Exhibits","Golf Courses Public","Video Amusement Game Supplies","Video Game Arcades/Establishments","Gambling Transactions","Amusement Parks Carnivals Circuses Fortune Tellers","Clubs—Country Clubs Membership (Athletic Recreation Sports) Private Golf Courses","Aquariums Dolphinariums Zoos and Seaquariums","Recreation Services—not elsewhere classified","Doctors—not elsewhere classified","Dentists Orthodontists","Osteopathic Physicians","Chiropractors","Optometrists Ophthalmologists","Opticians Optical Goods and Eyeglasses","Chiropodists Podiatrists","Nursing and Personal Care Facilities","Hospitals","Dental and Medical Laboratories","Health Practitioners Medical Services—not elsewhere classified","Attorneys Legal Services","Schools Elementary and Secondary","Colleges Universities Professional Schools and Junior Colleges","Schools Correspondence","Schools Business and Secretarial","Schools Trade and Vocational","Schools and Educational Services—not elsewhere classified","Child Care Services","Organizations Charitable and Social Service","Associations—Civic Social and Fraternal","Organizations Political","Organizations Religious","Automobile Associations","Organizations Membership—not elsewhere classified","Testing Laboratories (Non-Medical)","Architectural Engineering and Surveying Services","Accounting Auditing and Bookkeeping Services","Professional Services—not elsewhere classified","Court Costs including Alimony and Child Support","Fines","Bail and Bond Payments","Tax Payments","Government Services—not elsewhere classified","Postal Services—Government Only","Intra-Government Purchases—Government Only","Government-owned Lottery (Specific Countries)"],"example":"Veterinary Services"},"operation_countries":{"type":"array","description":"List of countries where the merchant operates","items":{"type":"string","description":"Country code (ISO 3166-1 alpha-3)"},"example":["IND","USA"]}},"required":["name","address_line1","city","state","pincode","registration_number","registration_country","entity_type","category","sub_category","operation_countries"]}},"components/schemas/CreateIndividualMerchantRequest":{"id":"components/schemas/CreateIndividualMerchantRequest","kind":"json-schema","title":"CreateIndividualMerchantRequest","data":{"x-internal":true,"allOf":[{"$ref":"#/components/schemas/CreateMerchantRequestBase"},{"type":"object","properties":{"entity_type":{"type":"string","description":"Type of entity","enum":["individual"],"example":"individual"},"date_of_birth":{"type":"string","format":"date","description":"Date of birth. Format YYYY-MM-DD","example":"2001-08-04"},"gender":{"type":"string","description":"Gender","enum":["male","female","undefined"],"example":"male"},"passport":{"type":"object","description":"Passport identification","properties":{"number":{"type":"string","description":"Passport number","example":"P1234567"},"expiry_date":{"type":"string","format":"date","description":"Passport expiry date. Must be a future date. Format YYYY-MM-DD","example":"2030-06-01"},"country_of_issuance":{"type":"string","description":"Country that issued the passport (ISO 3166-1 alpha-3)","example":"IND"}},"required":["number","expiry_date","country_of_issuance"]}},"required":["entity_type","date_of_birth","gender","passport"]}]}},"components/schemas/CreateBusinessMerchantRequest":{"id":"components/schemas/CreateBusinessMerchantRequest","kind":"json-schema","title":"CreateBusinessMerchantRequest","data":{"x-internal":true,"allOf":[{"$ref":"#/components/schemas/CreateMerchantRequestBase"},{"type":"object","properties":{"entity_type":{"type":"string","description":"Type of entity","enum":["business"],"example":"business"},"registration_date":{"type":"string","format":"date","description":"Business registration/incorporation date. Must be a past date. Format YYYY-MM-DD","example":"2020-06-01"},"dba_name":{"type":"string","description":"Trading (doing-business-as) name, if it differs from the registered name","example":"Acme Retail"},"business_type":{"type":"string","description":"Legal type of the registered entity","enum":["corporation","foreign_entity","foundation","government_entity","huf","llp","non_profit_organization","one_person_company","partnership","private_limited","public_limited","society","sole_proprietorship","trust","unincorporated_association"],"example":"private_limited"},"registration_document_id":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ID of a document you previously uploaded via "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/api-reference/openapi/document/createdocument"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create a document"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", used as the merchant's certificate of incorporation"},"children":[]}]}]}],"example":"doc_nYUqLpuYQ0M8"},"website":{"type":"string","description":"Public website of the merchant","example":"https://acme.example.com"},"annual_turnover":{"type":"string","description":"Annual business turnover band, in USD","enum":["below_100k","100k_to_1m","1m_to_5m","above_5m"],"example":"1m_to_5m"},"ubos":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Ultimate beneficial owners of the merchant. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ownership_percentage"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" across all entries must not sum above 100."},"children":[]}]}]}],"items":{"type":"object","properties":{"name":{"type":"string","description":"Full name of the individual, or legal name of the company","example":"Jane Doe"},"type":{"type":"string","description":"Whether this owner is a natural person or a legal entity","enum":["individual","company"],"example":"individual"},"ownership_percentage":{"type":"number","description":"Share of the merchant held by this owner. Greater than 0 and at most 100.","exclusiveMinimum":0,"maximum":100,"example":60},"country":{"type":"string","description":"Nationality of the individual, or country of incorporation of the company (ISO 3166-1 alpha-3)","example":"IND"}},"required":["name","type","ownership_percentage","country"]},"example":[{"name":"Jane Doe","type":"individual","ownership_percentage":60,"country":"IND"},{"name":"Doe Holdings Pte Ltd","type":"company","ownership_percentage":40,"country":"SGP"}]},"settlement_account":{"type":"object","description":"Bank account the merchant's funds are settled to","properties":{"account_holder_name":{"type":"string","description":"Name on the bank account","example":"Acme Trading Private Limited"},"account_number":{"type":"string","description":"Bank account number, or IBAN where the bank uses one","example":"123456789"},"bank_name":{"type":"string","description":"Name of the bank that holds the account","example":"JPMorgan Chase Bank"},"swift_code":{"type":"string","description":"SWIFT/BIC code of the bank","example":"CHASUS33"},"currency":{"type":"string","format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Currency of the account, in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format"},"children":[]}]}]}],"enum":["USD","EUR","GBP","AED","SGD","AUD","INR"],"example":"USD"},"bank_address":{"type":"object","description":"Address of the bank branch that holds the account","properties":{"address_line1":{"type":"string","description":"Primary address line","example":"270 Park Avenue"},"address_line2":{"type":"string","description":"Secondary address line"},"city":{"type":"string","description":"City name","example":"New York"},"administrative_area":{"type":"string","description":"State, province or region","example":"NY"},"postal_code":{"type":"string","description":"Postal/ZIP code","example":"10017"},"country_code":{"type":"string","description":"Country of the bank branch (ISO 3166-1 alpha-3)","example":"USA"}},"required":["address_line1","city","administrative_area","country_code"]}},"required":["account_holder_name","account_number","bank_name","swift_code","currency","bank_address"]}},"required":["entity_type","registration_date","dba_name","business_type","registration_document_id","website","annual_turnover","ubos"]}]}},"components/schemas/CreateMerchantRequest":{"id":"components/schemas/CreateMerchantRequest","kind":"json-schema","title":"CreateMerchantRequest","data":{"x-internal":true,"oneOf":[{"$ref":"#/components/schemas/CreateIndividualMerchantRequest","x-title":"individual"},{"$ref":"#/components/schemas/CreateBusinessMerchantRequest","x-title":"business"}],"discriminator":{"propertyName":"entity_type","mapping":{"individual":"#/components/schemas/CreateIndividualMerchantRequest","business":"#/components/schemas/CreateBusinessMerchantRequest"}}}},"components/schemas/Merchant":{"id":"components/schemas/Merchant","kind":"json-schema","title":"Merchant","data":{"type":"object","x-tags":["platform"],"properties":{"owner_merchant_id":{"type":"string","description":"The ID of the platform/owner merchant","example":"merch_68511919RVuf6"},"merchant_id":{"type":"string","description":"Unique identifier for the merchant","example":"merch_68c777fcOOMpl"},"status":{"type":"string","enum":["created","action_required","pending","success","failed","offboarded"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Current onboarding status of the merchant."},"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":"code","inline":true,"attributes":{"content":"created"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the merchant has been submitted and screening has not finished."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"action_required"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — screening flagged the merchant and Glomo is reviewing it before onboarding"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"can continue."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pending"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — screening passed and the merchant's KYC or KYB review is in progress."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"success"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the merchant is onboarded and can transact."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"failed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — onboarding was rejected. Terminal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"offboarded"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — a previously onboarded merchant has been removed. Its API keys stop working and it"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"can no longer transact. Terminal."},"children":[]}]}]}]}],"example":"success"},"name":{"type":"string","description":"Name of the merchant","example":"John Doe"},"category":{"type":"string","description":"Business category","example":"Agricultural Services"},"entity_type":{"type":"string","enum":["individual","business"],"description":"Type of merchant entity","example":"individual"},"sub_category":{"type":"string","description":"Business sub-category (must be paired with correct category)","example":"Veterinary Services"},"gender":{"type":"string","enum":["male","female","undefined"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Gender (only required for individual entity_type)"},"children":[]}]}]}],"example":"male"},"date_of_birth":{"type":"string","format":"date","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Date of birth, as a calendar date in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format with no time or time zone. Present only when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"entity_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"individual"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"2001-08-04"},"registration_number":{"type":"string","description":"Business registration number or individual ID","example":"REG123456"},"registration_country":{"type":"string","description":"Country where the merchant is registered (ISO 3166-1 alpha-3)","example":"IND"},"address":{"type":"object","description":"Merchant address","properties":{"address_line1":{"type":"string","description":"Primary address line","example":"123 Main St"},"address_line2":{"type":"string","description":"Secondary address line (optional)","example":""},"city":{"type":"string","description":"City name","example":"Bangalore"},"state":{"type":"string","description":"State or province","example":"Karnataka"},"pincode":{"type":"string","description":"Postal/ZIP code","example":"560060"},"country":{"type":"string","description":"Country code (ISO 3166-1 alpha-3)","example":"IND"}},"required":["address_line1","city","state","pincode","country"]},"operation_countries":{"type":"array","description":"List of countries where the merchant operates","items":{"type":"string","description":"Country code (ISO 3166-1 alpha-3)"},"example":["IND"]},"created_at":{"type":"string","format":"date-time","description":"When the merchant was created, as an ISO 8601 date-time in UTC.\n","example":"2025-10-07T06:11:47Z"},"updated_at":{"type":"string","format":"date-time","description":"When the merchant was last updated, as an ISO 8601 date-time in UTC.\n","example":"2025-10-07T06:11:47Z"},"jwt_token":{"type":"string","description":"JWT token for the merchant","example":"child_merchant_JWT"},"public_key":{"type":"string","description":"public key for the merchant","example":"live_6889e287VfqrPVPg"}},"required":["owner_merchant_id","merchant_id","status","name","registration_number","registration_country","address","operation_countries","created_at","updated_at","jwt_token"]}},"components/schemas/MerchantCreateResponse":{"id":"components/schemas/MerchantCreateResponse","kind":"json-schema","title":"MerchantCreateResponse","data":{"type":"object","properties":{"message":{"type":"string","description":"Success message","example":"Merchant created successfully!"},"data":{"$ref":"#/components/schemas/Merchant"}}}},"components/schemas/MerchantKybReviewResponse":{"id":"components/schemas/MerchantKybReviewResponse","kind":"json-schema","title":"MerchantKybReviewResponse","data":{"type":"object","properties":{"message":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Review-pending message. The merchant is created in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"created"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" status and stays there until the KYB review completes."},"children":[]}]}]}],"example":"Merchant created and submitted for review. You will be notified once it is approved."},"data":{"type":"object","properties":{"owner_merchant_id":{"type":"string","description":"The ID of the platform/owner merchant","example":"merch_68511919RVuf6"},"merchant_id":{"type":"string","description":"Unique identifier for the merchant","example":"merch_68c777fcOOMpl"},"status":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Status of the merchant onboarding. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"created"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" while the KYB review is pending."},"children":[]}]}]}],"enum":["created"],"example":"created"},"name":{"type":"string","description":"Name of the merchant","example":"John Doe"},"category":{"type":"string","description":"Business category","example":"Agricultural Services"},"entity_type":{"type":"string","enum":["individual","business"],"description":"Type of merchant entity","example":"individual"},"sub_category":{"type":"string","description":"Business sub-category (must be paired with correct category)","example":"Veterinary Services"},"gender":{"type":"string","enum":["male","female","undefined"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Gender (only required for individual entity_type)"},"children":[]}]}]}],"example":"male"},"date_of_birth":{"type":"string","format":"date","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Date of birth, as a calendar date in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format with no time or time zone. Present only when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"entity_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"individual"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"2001-08-04"},"registration_number":{"type":"string","description":"Business registration number or individual ID","example":"REG123456"},"registration_country":{"type":"string","description":"Country where the merchant is registered (ISO 3166-1 alpha-3)","example":"IND"},"address":{"type":"object","description":"Merchant address","properties":{"address_line1":{"type":"string","description":"Primary address line","example":"123 Main St"},"address_line2":{"type":"string","description":"Secondary address line (optional)","example":""},"city":{"type":"string","description":"City name","example":"Bangalore"},"state":{"type":"string","description":"State or province","example":"Karnataka"},"pincode":{"type":"string","description":"Postal/ZIP code","example":"560060"},"country":{"type":"string","description":"Country code (ISO 3166-1 alpha-3)","example":"IND"}},"required":["address_line1","city","state","pincode","country"]},"operation_countries":{"type":"array","description":"List of countries where the merchant operates","items":{"type":"string","description":"Country code (ISO 3166-1 alpha-3)"},"example":["IND"]},"created_at":{"type":"string","format":"date-time","description":"When the merchant was created, as an ISO 8601 date-time in UTC.\n","example":"2025-10-07T06:11:47Z"},"updated_at":{"type":"string","format":"date-time","description":"When the merchant was last updated, as an ISO 8601 date-time in UTC.\n","example":"2025-10-07T06:11:47Z"}},"required":["owner_merchant_id","merchant_id","status","name","registration_number","registration_country","address","operation_countries","created_at","updated_at"]}}}},"components/schemas/UpdateMerchantRequest":{"id":"components/schemas/UpdateMerchantRequest","kind":"json-schema","title":"UpdateMerchantRequest","data":{"x-internal":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Fields to update on an existing merchant. Currently supports "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"passport"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"individual merchants and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"registration_date"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for business merchants; more"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"fields may be supported in future. The applicable field is determined by the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"merchant's entity type, set at onboarding, rather than by the request body. A"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"field that does not apply to the merchant's entity type is ignored."},"children":[]}]}]}],"oneOf":[{"x-title":"individual","type":"object","properties":{"passport":{"type":"object","description":"Passport identification (individual merchants)","properties":{"number":{"type":"string","description":"Passport number","example":"P1234567"},"expiry_date":{"type":"string","format":"date","description":"Passport expiry date. Must be a future date. Format YYYY-MM-DD","example":"2030-06-01"},"country_of_issuance":{"type":"string","description":"Country that issued the passport (ISO 3166-1 alpha-3)","example":"IND"}},"required":["number","expiry_date","country_of_issuance"]}},"required":["passport"]},{"x-title":"business","type":"object","properties":{"registration_date":{"type":"string","format":"date","description":"Business registration/incorporation date. Must be a past date. Format YYYY-MM-DD","example":"2020-06-01"}},"required":["registration_date"]}]}},"components/schemas/CreateInternalTransferRequest":{"id":"components/schemas/CreateInternalTransferRequest","kind":"json-schema","title":"CreateInternalTransferRequest","data":{"type":"object","required":["amount","currency","reference","from_merchant_id","to_merchant_id"],"properties":{"amount":{"type":"integer","minimum":1,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The amount to transfer, in the smallest unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (cents for USD). "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"10000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $100.00 when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is USD. A positive integer, sent as a JSON number."},"children":[]}]}]}],"example":10000},"currency":{"type":"string","format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency in which the transfer is made. The currency code is in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format, case-insensitive."},"children":[]}]}]}],"example":"AED"},"reference":{"type":"string","maxLength":100,"description":"A reference identifier for the transfer. Maximum length is 100 characters.\n","example":"sample-reference"},"from_merchant_id":{"type":"string","description":"The unique identifier of the merchant account from which funds will be transferred.\n","example":"merch_68cc1216xPrdU"},"to_merchant_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 unique identifier of the merchant account to which funds will be transferred. Must be different from "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"from_merchant_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"merch_68cc0571y5S4h"}}}},"components/schemas/InternalTransfer":{"id":"components/schemas/InternalTransfer","kind":"json-schema","title":"InternalTransfer","data":{"type":"object","x-tags":["internal_transfer"],"properties":{"id":{"type":"string","readOnly":true,"description":"The unique identifier for the internal transfer.\n","example":"inttransfer_68f1f9126GDCB"},"from_merchant_id":{"type":"string","description":"The unique identifier of the merchant account from which funds were transferred.\n","example":"merch_68cc1216xPrdU"},"to_merchant_id":{"type":"string","description":"The unique identifier of the merchant account to which funds were transferred.\n","example":"merch_68cc0571y5S4h"},"owner_merchant_id":{"type":"string","description":"The unique identifier of the merchant account that owns/initiated this transfer.\n","example":"merch_68cc0571y5S4h"},"transfer_amount":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The amount transferred, in the smallest unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"transfer_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (cents for USD). "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $10.00 when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"transfer_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is USD."},"children":[]}]}]}],"example":1000},"transfer_currency":{"type":"string","format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency in which the transfer was made. The currency code is in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format."},"children":[]}]}]}],"example":"AED"},"reference":{"type":"string","description":"The reference identifier provided for the transfer.\n","example":"123"},"fees":{"type":"object","description":"The fees associated with the internal transfer.\n","properties":{"txn_fee":{"$ref":"#/components/schemas/Money","description":"The transaction fee charged for the internal transfer.\n"},"fx_fee":{"$ref":"#/components/schemas/Money","description":"The foreign exchange fee charged for the internal transfer.\n"}},"example":{"txn_fee":{"currency":"AED","amount":0},"fx_fee":{"currency":"AED","amount":0}}},"error_code":{"type":["string","null"],"readOnly":true,"description":"The error code if the internal transfer failed, null otherwise.\n","example":null},"error_description":{"type":["string","null"],"readOnly":true,"description":"The error description if the internal transfer failed, null otherwise.\n","example":null},"created_at":{"type":"string","readOnly":true,"format":"date-time","description":"When the internal transfer was created, as an ISO 8601 date-time in UTC.\n","example":"2025-10-17T08:06:42Z"},"updated_at":{"type":"string","readOnly":true,"format":"date-time","description":"When the internal transfer was last updated, as an ISO 8601 date-time in UTC.\n","example":"2025-10-17T08:06:42Z"}}}},"components/schemas/KycDocument":{"id":"components/schemas/KycDocument","kind":"json-schema","title":"KycDocument","data":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"description":"The unique identifier for the KYC document record.\n","example":"kycdoc_69b3f97ef0bmk"},"document_id":{"type":["string","null"],"readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The identifier of the uploaded document file. This is populated once the customer has uploaded the document (i.e. when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"captured"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). Use this value with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /api/v1/document/{document_id}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to retrieve the full document details including the preview URL."},"children":[]}]}]}],"example":"doc_69b3f9b4MJgKZ"},"type":{"type":"string","readOnly":true,"description":"The type of KYC document.\n","example":"pan_card","enum":["pan_card","aadhaar","photograph","passport","driving_license","selfie_proof","signature","contribution_agreement","photo_on_aadhaar","applicant_esign","bank_statement","vkyc","digilocker_zip","other"]},"status":{"type":"string","readOnly":true,"description":"The capture status of this KYC document.\n","example":"captured","enum":["not_captured","captured"]},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"When the KYC document record was created, as an ISO 8601 date-time in UTC.\n","example":"2026-03-13T11:48:14.458Z"},"uploaded_at":{"type":["string","null"],"format":"date-time","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When the document file was uploaded, as an ISO 8601 date-time in UTC. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if the document has not yet been captured."},"children":[]}]}]}],"example":"2026-03-13T11:49:08.093Z"}}}},"components/schemas/KycLinkDetail":{"id":"components/schemas/KycLinkDetail","kind":"json-schema","title":"KycLinkDetail","data":{"type":"object","x-tags":["KycLink"],"properties":{"id":{"type":"string","readOnly":true,"description":"The unique identifier for the KYC link.\n","example":"kyc_69b3f97eSThQY"},"status":{"type":"string","readOnly":true,"enum":["initiated","in_progress","submitted","action_required","under_review","completed","failed","expired","rejected"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The current status of the KYC link."},"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":"code","inline":true,"attributes":{"content":"initiated"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the link has been created and the customer has not started."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"in_progress"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the customer has started the verification."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"submitted"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the customer has finished and the verification result is pending."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"action_required"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — more information is needed from the customer."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"under_review"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the information provided is being reviewed."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"completed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the customer has been verified. Terminal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"failed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the verification could not be completed. Terminal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expired"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the link expired before the customer finished. Terminal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rejected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the verification was rejected on review. Terminal."},"children":[]}]}]}]}],"example":"completed"},"link_url":{"type":"string","readOnly":true,"description":"The URL to share with the customer to complete the KYC verification.\n","example":"https://app.glomopay.com/kyc-links/kyc_69b3f97eSThQY"},"expires_at":{"type":"string","format":"date-time","readOnly":true,"description":"When the KYC link expires, as an ISO 8601 date-time in UTC.\n","example":"2026-06-11T11:48:14.361Z"},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"When the KYC link was created, as an ISO 8601 date-time in UTC.\n","example":"2026-03-13T11:48:14.363Z"},"customer_id":{"type":["string","null"],"readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique identifier of the customer associated with this KYC link. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if the KYC link was created with an email address only (no existing customer)."},"children":[]}]}]}],"example":"cust_abc123XYZ"},"tracker":{"type":"array","readOnly":true,"description":"A chronological list of status events for the KYC verification process.\n","items":{"type":"object","properties":{"created_at":{"type":"string","format":"date-time","description":"When the tracker event happened, as an ISO 8601 date-time in UTC.\n","example":"2026-03-13T12:00:00.000Z"},"text":{"type":"string","description":"Human-readable description of the tracker event.\n","example":"KYC verification completed"}}}},"documents":{"type":"array","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The list of KYC documents associated with this KYC link. Each document has a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"document_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field that can be used with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /api/v1/document/{document_id}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to retrieve full document details (e.g. preview URL, file name) once the document has been captured."},"children":[]}]}]}],"items":{"$ref":"#/components/schemas/KycDocument"}}}}},"components/schemas/PaymentSession":{"id":"components/schemas/PaymentSession","kind":"json-schema","title":"PaymentSession","data":{"type":"object","properties":{"id":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unique identifier for the payment session, prefixed with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"psess_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"psess_6819d8046mpKt"},"status":{"type":"string","enum":["active","completed","failed","expired"],"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 payment session."},"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":"code","inline":true,"attributes":{"content":"active"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the customer can go through the session."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"completed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the customer finished every step. Terminal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"failed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the session ended without finishing. Terminal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expired"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the session passed "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_at"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" before it finished. Terminal."},"children":[]}]}]}]}],"example":"active"},"session_type":{"type":"string","enum":["kyc_lrs","kyc_lrs_folio","kyc_nri_individual_verification","kyc_nri_joint_verification","kyc_inbound_folio"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The workflow type configured for this session, which determines the pre-steps and/or"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"post-steps in the payment journey. The value is configured per business by Glomo; you do not"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"choose it per request."},"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":"code","inline":true,"attributes":{"content":"kyc_lrs"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — KYC, then an LRS remittance checkout."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"kyc_lrs_folio"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — mutual fund investment from India under LRS: folio and scheme selection, KYC,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"then an LRS remittance checkout."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"kyc_nri_individual_verification"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — onboarding of an individual NRI investor, ending when KYC"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(including video KYC) completes."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"kyc_nri_joint_verification"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — NRI investor verification that collects folio and scheme selection"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"before KYC."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"kyc_inbound_folio"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — mutual fund investment by an NRI investor: folio and scheme selection, NRI"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"KYC, folio creation, then an inbound checkout."},"children":[]}]}]}]}],"example":"kyc_lrs"},"token":{"type":"string","description":"Short-lived JWT token to be passed to the Glomo Web SDK to launch the session UI for the customer.\n","example":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."},"expires_at":{"type":"string","format":"date-time","description":"ISO 8601 timestamp when the session expires.","example":"2026-05-07T10:30:00Z"}}}},"components/schemas/RfiListItem":{"id":"components/schemas/RfiListItem","kind":"json-schema","title":"RfiListItem","data":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"description":"The unique identifier for the RFI.\n","example":"rfi_6a7c5018ZGuKP"},"business_id":{"type":"string","readOnly":true,"description":"The unique identifier of the business the RFI belongs to.\n","example":"merch_685bb99eFhPGA"},"entity_type":{"type":"string","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The type of the underlying resource the RFI was raised against, for example "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Payment"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Payin"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Payout"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Refund"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Order"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Subscription"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Chargeback"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"Payment"},"entity_id":{"type":"string","readOnly":true,"description":"The unique identifier of the underlying resource the RFI was raised against.\n","example":"payt_6a7c50089mMiB"},"status":{"type":"string","readOnly":true,"enum":["action_required","under_review","approved","rejected","superseded","expired","cancelled"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The current status of the RFI. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"action_required"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" means documents are still owed — respond using "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/api-reference/openapi/rfi/respondrfi"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Respond to an RFI"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"under_review"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" means documents have been submitted and are pending a decision; Glomo can ask for more, which moves the RFI back to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"action_required"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The final decision ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"approved"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rejected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") is communicated via the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/platform/webhooks/rfi"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rfi"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" webhook"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"superseded"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" means the RFI was closed without a decision and needs no further response. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expired"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" means the response deadline passed before documents were submitted. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cancelled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" means Glomo withdrew the request while documents were still owed; no response is needed. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"approved"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rejected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"superseded"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expired"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cancelled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are terminal."},"children":[]}]}]}],"example":"approved"},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"When the RFI was created, as an ISO 8601 date-time in UTC.\n","example":"2026-08-12T10:51:04.747Z"},"updated_at":{"type":"string","format":"date-time","readOnly":true,"description":"When the RFI was last updated, as an ISO 8601 date-time in UTC.\n","example":"2026-08-13T06:42:00.878Z"}}}},"components/schemas/RfiDetail":{"id":"components/schemas/RfiDetail","kind":"json-schema","title":"RfiDetail","data":{"allOf":[{"$ref":"#/components/schemas/RfiListItem"},{"type":"object","properties":{"documents_required":{"type":"array","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The documents needed to resolve this RFI. Submit documents against a specific requirement using its "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rfi_doc_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" via the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/api-reference/openapi/rfi/respondrfi"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Respond to an RFI"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint. Empty when the RFI does not require documents."},"children":[]}]}]}],"items":{"type":"object","properties":{"rfi_doc_id":{"type":"string","readOnly":true,"description":"The unique identifier for this document requirement.\n","example":"rfidoc_6a72a39b38jDD"},"description":{"type":"string","readOnly":true,"description":"A human-readable description of what document is needed.\n","example":"Last 3 months bank statement"},"multiple_allowed":{"type":"boolean","readOnly":true,"description":"Whether more than one document can be submitted for this requirement.\n","example":true},"max_count":{"type":"integer","readOnly":true,"description":"The maximum number of documents that can be submitted for this requirement.\n","example":3}}}},"fields_required":{"type":"array","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The structured values needed to resolve this RFI, alongside any documents. Submit them as the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fields"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" object via the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/api-reference/openapi/rfi/respondrfi"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Respond to an RFI"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint, keyed by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Empty when the RFI does not ask for any values."},"children":[]}]}]}],"items":{"type":"object","properties":{"name":{"type":"string","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The key to send this value under in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fields"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" object."},"children":[]}]}]}],"example":"invoice_number"},"type":{"type":"string","readOnly":true,"enum":["string","integer","date","enum","address"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The expected type. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"integer"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" values are in minor units, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"date"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" values are strings in the format given by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"format"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"address"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" values are objects matching "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"schema"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"string"},"required":{"type":"boolean","readOnly":true,"description":"Whether the value must be supplied.\n","example":true},"format":{"type":"string","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Present on "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"date"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" fields. The format the value must be sent in."},"children":[]}]}]}],"example":"YYYY-MM-DD"},"allowed_values":{"type":"array","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Present on "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"enum"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" fields. The values this field accepts."},"children":[]}]}]}],"items":{"type":"object","properties":{"key":{"type":"string","example":"services"},"label":{"type":"string","example":"Services"}}}},"schema":{"type":"array","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Present on "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"address"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" fields. The keys the address object must contain."},"children":[]}]}]}],"items":{"type":"object","properties":{"name":{"type":"string","example":"address_line1"},"type":{"type":"string","example":"string"},"required":{"type":"boolean","example":true}}}}}}},"instructions":{"type":"string","readOnly":true,"description":"Human-readable guidance on what is required to resolve the RFI. Falls back to a generic message when no specific instructions were set.\n","example":"Upload your latest bank statement"},"review_comments":{"type":["string","null"],"readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Comments left by the reviewer, for example why a previous submission was rejected. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when there are none."},"children":[]}]}]}],"example":"Please re-upload a clearer copy."},"uploader_comments":{"type":["string","null"],"readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The note recorded against the RFI when documents were last submitted. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when there are none."},"children":[]}]}]}],"example":"Uploaded the statement."}}}]}},"components/schemas/Rfi":{"id":"components/schemas/Rfi","kind":"json-schema","title":"Rfi","data":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"description":"The unique identifier for the RFI.\n","example":"rfi_6a72a39b38jDD"},"status":{"type":"string","readOnly":true,"enum":["information_required","submitted","approved","rejected","superseded","expired","cancelled"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The current status of the RFI. A successful response transitions the RFI from"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"information_required"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"submitted"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The final decision ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"approved"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rejected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"communicated via the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/platform/webhooks/rfi"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rfi"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" webhook"},"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":"This response uses different names for two statuses than the RFI list and detail endpoints:"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"information_required"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" here is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"action_required"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" there, and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"submitted"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" here is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"under_review"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"there."},"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":"code","inline":true,"attributes":{"content":"information_required"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — documents are still owed."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"submitted"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — documents have been submitted and are awaiting a decision. Glomo can ask for more,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"which moves the RFI back to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"information_required"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"approved"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the RFI was accepted. Terminal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rejected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the RFI was declined. Terminal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"superseded"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the RFI was closed without a decision and needs no further response. Terminal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expired"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the response deadline passed before documents were submitted. Terminal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cancelled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — Glomo withdrew the request while documents were still owed; no response is needed."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Terminal."},"children":[]}]}]}]}],"example":"submitted"}}}},"schema_0":{"kind":"json-schema","data":{"type":"object","required":["expire_after_in_seconds"],"properties":{"expire_after_in_seconds":{"type":"integer","minimum":0,"maximum":604800,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Duration (in seconds) for which the previous key remains valid after rotation. Must be an integer between 0 and 604800 (7 days), sent as a JSON number. A value outside that range, or a string such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"\"3600\""},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Use this window to update all integrations before the old key is revoked."},"children":[]}]}]}],"example":3600}}},"id":"schema_0"},"schema_1":{"kind":"json-schema","data":{"type":"object","properties":{"secret_key":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The newly generated secret API key. Store it securely — it will not be shown again."},"children":[]}]}]}],"example":"<NEW_JWT>"},"previous_key_expires_at":{"type":"string","format":"date-time","description":"ISO 8601 timestamp (UTC) at which the previous key will be revoked.","example":"2026-05-13T12:10:57Z"}}},"id":"schema_1"},"schema_2":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","enum":["Bad Request"]},"message":{"type":"string"}}},"id":"schema_2"},"schema_3":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","enum":["Unauthorized"]},"message":{"type":"string"}}},"id":"schema_3"},"schema_4":{"kind":"json-schema","data":{"oneOf":[{"type":"object","properties":{"source_currency":{"type":"string","format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency code in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format. Supported currencies: USD, EUR, GBP, AED, SGD and AUD. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"target_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" must differ, or the request returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"USD"},"target_currency":{"type":"string","format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency code in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format. Supported currencies: USD, EUR, GBP, AED, SGD and AUD. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"target_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" must differ, or the request returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"EUR"},"source_amount":{"type":"number","minimum":1,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The amount you want to convert. A positive integer representing the smallest currency unit.  For example, if the amount is $299.00, then pass 29900 in this field.  In the case of three decimal currencies, such as KWD, BHD and OMR, to represent an amount of 295.991, pass the value as 295990.  And in the case of zero decimal currencies such as JPY, for amount ￥295, pass the value as 295. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Only one of `source_amount` or `target_amount` can be sent."},"children":[]}]}]}],"example":1000}},"required":["source_currency","target_currency","source_amount"],"additionalProperties":false},{"type":"object","properties":{"source_currency":{"type":"string","format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency code in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format. Supported currencies: USD, EUR, GBP, AED, SGD and AUD. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"target_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" must differ, or the request returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"USD"},"target_currency":{"type":"string","format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency code in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format. Supported currencies: USD, EUR, GBP, AED, SGD and AUD. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"target_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" must differ, or the request returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"EUR"},"target_amount":{"type":"number","minimum":1,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The amount you want to receive. A positive integer representing the smallest currency unit.  For example, if the amount is $299.00, then pass 29900 in this field.  In the case of three decimal currencies, such as KWD, BHD and OMR, to represent an amount of 295.991, pass the value as 295990.  And in the case of zero decimal currencies such as JPY, for amount ￥295, pass the value as 295. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Only one of `source_amount` or `target_amount` can be sent."},"children":[]}]}]}],"example":1000}},"required":["source_currency","target_currency","target_amount"],"additionalProperties":false}]},"id":"schema_4"},"schema_5":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","enum":["Bad Request"]},"message":{"type":"string","description":"Error message.\n","example":"You can only send source_amount or target_amount, not both."}}},"id":"schema_5"},"schema_6":{"kind":"json-schema","data":{"type":"string","format":"iso-4217"},"id":"schema_6"},"schema_7":{"kind":"json-schema","data":{"type":"string"},"id":"schema_7"},"schema_8":{"kind":"json-schema","data":{"type":"integer","default":20},"id":"schema_8"},"schema_9":{"kind":"json-schema","data":{"type":"integer","default":1},"id":"schema_9"},"schema_10":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/BalanceConversion"}},"page_meta":{"$ref":"#/components/schemas/PageMeta"}}},"id":"schema_10"},"schema_11":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","enum":["Bad Request"]},"message":{"type":"string","description":"Error message indicating which parameter was invalid"}}},"id":"schema_11"},"schema_12":{"kind":"json-schema","data":{"type":"object","properties":{"source_currency":{"type":"string","description":"Source currency code.","example":"USD"},"target_currency":{"type":"string","description":"Target currency code.","example":"EUR"},"mid_market_rate":{"type":"number","format":"float","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Mid-market exchange rate, as units of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"target_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" per one unit of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0.859401"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" USD and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"target_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" EUR means 1 USD = 0.859401 EUR. FX fees are charged on top of this rate. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when the two currencies are the same."},"children":[]}]}]}],"example":0.859401},"expires_at":{"type":"string","format":"date-time","description":"ISO 8601 UTC timestamp indicating when this cached rate expires. A fresh rate is fetched from the provider after expiry.\n","example":"2026-05-05T08:39:18Z"}}},"id":"schema_12"},"schema_13":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","enum":["Bad Request"]},"message":{"type":"string","description":"Error message indicating validation failure.\n","example":"is not a valid currency"}}},"id":"schema_13"},"schema_14":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Unauthorized"},"message":{"type":"string","example":"Missing token"}}},"id":"schema_14"},"schema_15":{"kind":"json-schema","data":{"oneOf":[{"$ref":"#/components/schemas/PaymentLink","required":["amount","currency","customer_id","purpose_code","expires_at"]},{"$ref":"#/components/schemas/CreatePaymentLinkWithQuoteRequest","required":["quote_id","customer_id","purpose_code"]}]},"id":"schema_15"},"schema_16":{"kind":"json-schema","data":{"type":"string","enum":["active","action_required","under_review","paid","failed","cancelled","expired"]},"id":"schema_16"},"schema_17":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PaymentLinkResponse"}},"page_meta":{"$ref":"#/components/schemas/PageMeta"}}},"id":"schema_17"},"schema_18":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string","description":"Error message.\n","example":"Invalid customer_id"}}},"id":"schema_18"},"schema_19":{"kind":"json-schema","data":{"type":"string","example":"plink_678a4c88hpAjf"},"id":"schema_19"},"schema_20":{"kind":"json-schema","data":{"type":"object","properties":{"reminder_frequency":{"type":"number","description":"The frequency at which you want to remind customers, valid values  are 1 (remind every day), 2 (remind every alternate day), 7  (remind every week), 14 (remind every alternate week).\n","example":1},"expires_at":{"type":"string","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 new expiry for the payin. Send an ISO 8601 date-time with a UTC offset or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DDThh:mm:ssZ"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). A value without an offset is read as UTC, and a date without a time is read as 00:00 UTC on that day. Must be later than the time of the request and at most 6 calendar months after the payin was created. A past value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with the message "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Validation failed: Expires at must be in the future"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A value more than 6 months from now returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Validation failed: Expires at cannot be more than 6 months from now"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and one within that but more than 6 months after creation returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Validation failed: Expiry date must be in the future and within 6 months"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Send at least one of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_at"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"reminder_frequency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"2026-12-15T12:00:00Z","x-glomo-relative-example":"P14D"}},"additionalProperties":false},"id":"schema_20"},"schema_21":{"kind":"json-schema","data":{"type":"object","properties":{"documents":{"type":"array","description":"Array of documents to be submitted for RFI requirements","items":{"type":"object","properties":{"id":{"type":"string","description":"The unique identifier of the document being uploaded for this RFI requirement\n","example":"doc_67fc2f42468Bw"},"rfi_doc_id":{"type":"string","description":"The unique identifier of the RFI document being submitted\n","example":"rfidoc_68c8dffedhMHD"}},"required":["id","rfi_doc_id"],"additionalProperties":false}}},"required":["documents"],"additionalProperties":false},"id":"schema_21"},"schema_22":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","enum":["Bad Request"]},"message":{"type":"string","description":"Error message.\n","example":"Invalid rfi_doc_id or payment link not in action_required status"}}},"id":"schema_22"},"schema_23":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string","description":"Error message.\n","example":"Payment link is not under review."}}},"id":"schema_23"},"schema_24":{"kind":"json-schema","data":{"oneOf":[{"$ref":"#/components/schemas/Orders","required":["amount","currency","customer_id"]},{"$ref":"#/components/schemas/CreateOrderWithQuoteRequest","required":["quote_id","customer_id"]}]},"id":"schema_24"},"schema_25":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","enum":["Bad Request"]},"message":{"type":"string","description":"Error message.\n","example":"Currency not supported"}}},"id":"schema_25"},"schema_26":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","enum":["Unprocessable Entity"]},"message":{"type":"string","description":"A customer-safe description of the decline.\n","example":"The order amount is above the limit for this programme"},"code":{"type":"string","enum":["quote_not_found","quote_not_owned","quote_expired","quote_resource_type_missing","beneficiary_missing","order_amount_above_cap","order_cap_unavailable","payment_method_unavailable"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Why the order was declined."},"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":"code","inline":true,"attributes":{"content":"quote_not_found"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - no quote with that id."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"quote_not_owned"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - the quote belongs to another business."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"quote_expired"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - the quote lapsed. Create a new one."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"quote_resource_type_missing"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - the quote did not declare "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"account_funding"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"beneficiary_missing"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - no "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"beneficiary_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" named, or it does not resolve."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"order_amount_above_cap"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - above the configured cap for that currency."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"order_cap_unavailable"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - no cap is configured for that currency. Not the same as"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the amount being too large."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payment_method_unavailable"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - your account has no active card payment method."},"children":[]}]}]}]}],"example":"order_amount_above_cap"}}},"id":"schema_26"},"schema_27":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/OrderResponse"}},"page_meta":{"$ref":"#/components/schemas/PageMeta"}}},"id":"schema_27"},"schema_28":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","enum":["Bad Request"]},"message":{"type":"string","description":"Error message.\n","example":"Invalid rfi_doc_id or order not in action_required status"}}},"id":"schema_28"},"schema_29":{"kind":"json-schema","data":{"type":"string","enum":["individual","business"]},"id":"schema_29"},"schema_30":{"kind":"json-schema","data":{"type":"string","format":"email"},"id":"schema_30"},"schema_31":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Customer"}},"page_meta":{"$ref":"#/components/schemas/PageMeta"}}},"id":"schema_31"},"schema_32":{"kind":"json-schema","data":{"type":"object","minProperties":1,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"At least one of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"email"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"phone"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" must be provided."},"children":[]}]}]}],"properties":{"email":{"type":"string","format":"email","description":"The new email address of the customer.\n","example":"customer@gmail.com"},"phone":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The new phone number of the customer, with country code. Validated against the customer's stored country using the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://github.com/daddyz/phonelib?tab=readme-ov-file"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"phonelib"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" library."},"children":[]}]}]}],"example":"+91-9023456789"},"address":{"type":"string","description":[{"$$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":"Account funding only."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Send with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"city"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"state"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"country"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pincode"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Replaces the stored address."},"children":[]}]}]}],"example":"Villa 12, Jumeirah Beach Road"},"city":{"type":"string","example":"Dubai"},"state":{"type":"string","example":"Dubai"},"country":{"type":"string","format":"iso-3166-1-alpha-3","example":"ARE"},"pincode":{"type":"string","example":"682001"},"kyc":{"type":"object","description":[{"$$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":"Account funding only."},"children":[]}]}]}]}],"properties":{"last_kyc_date":{"type":"string","format":"date","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When you last completed KYC on this customer, as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Cannot be in the future or earlier than the date already on file; the same date again changes nothing. Only for a customer created with a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"kyc"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" block."},"children":[]}]}]}],"example":"2026-10-01"}}}}},"id":"schema_32"},"schema_33":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","enum":["Bad Request"]},"message":{"type":"string","description":"Error message indicating what was invalid"}}},"id":"schema_33"},"schema_34":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/CustomerBankAccount"}},"id":"schema_34"},"schema_35":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","enum":["Bad Request"]},"message":{"type":"string","description":"Error message.\n","example":"order_id or subscription_id is required"}}},"id":"schema_35"},"schema_36":{"kind":"json-schema","data":{"type":"string","enum":["success","failed","action_required","in_progress"]},"id":"schema_36"},"schema_37":{"kind":"json-schema","data":{"type":"string","enum":["under_review","action_required","approved","rejected"]},"id":"schema_37"},"schema_38":{"kind":"json-schema","data":{"type":"string","enum":["payment_link","orders","add_funds"]},"id":"schema_38"},"schema_39":{"kind":"json-schema","data":{"type":"string","format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency in which the payment is made. The currency code is in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format, case-insensitive. For example, USD."},"children":[]}]}]}]},"id":"schema_39"},"schema_40":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Payment"}},"page_meta":{"$ref":"#/components/schemas/PageMeta"}}},"id":"schema_40"},"schema_41":{"kind":"json-schema","data":{"type":"object"},"id":"schema_41"},"schema_42":{"kind":"json-schema","data":{"type":"object","required":["transfer_type"],"properties":{"payin_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 order ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"order_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") or payment link ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"plink_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") that the customer pays. Optional."},"children":[]}]}]}],"example":"order_678a4c88hpAjf"},"amount":{"type":"integer","minimum":1,"maximum":2147483647,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Amount in the smallest unit of the currency. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"10000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is 100.00 USD. Required without a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payin_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"With a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payin_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", it defaults to the payin's quoted amount. In sandbox, exactly "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"6623"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" forces a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"sanctions-screening hit on a matched payment."},"children":[]}]}]}],"example":10000},"currency":{"type":"string","format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency code in ISO 4217 format. Required without a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payin_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Not allowed with a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payin_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"USD"},"payment_method":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Optional. Only "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"BankTransfer"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is accepted."},"children":[]}]}]}],"enum":["BankTransfer"],"example":"BankTransfer"},"transfer_type":{"type":"string","enum":["local","swift"],"description":"The rail of the transfer.","example":"local"},"sender":{"type":"object","description":"The sender of the transfer. Optional, and so is every field. Without a value, a field takes the\npayin customer's detail where one exists, otherwise the placeholder below.\n","properties":{"name":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Defaults to the payin's customer name, or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"mock sender"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"John Doe"},"account_number":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Account number or IBAN. Defaults to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"123456789012"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"AE070331234567890123456"},"country":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 3166-1 alpha-3 code. Defaults to the payin's customer country, or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"USA"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"ARE"},"address":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Defaults to the payin's customer address, or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Mock address for payment"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"Office 12, Business Bay, Dubai"},"bic":{"type":"string","description":"BIC or local bank code. Defaults to a test BIC for the sender's country.","example":"EBILAEADXXX"},"external_reference":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The reference on the transfer. With a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payin_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", it defaults to the payin's payment reference"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GLM"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and the last 5 characters of the payin ID). Without a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payin_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", there is no default."},"children":[]}]}]}],"example":"Invoice 1042 GLMHPAJF"}}}}},"id":"schema_42"},"schema_43":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"No active local virtual account for this payment"}}},"id":"schema_43"},"schema_44":{"kind":"json-schema","data":{"type":"string","pattern":"^payt_[a-zA-Z0-9]+$"},"id":"schema_44"},"schema_45":{"kind":"json-schema","data":{"type":"object","properties":{"payment_id":{"type":"string","description":"The unique identifier for the payment.\n","example":"payt_6aad0bc0cZtlS"},"payment_amount":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The amount that the customer sent, in minor units. For example, 10000 is 100.00 AED. The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payment_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field gives the currency."},"children":[]}]}]}],"example":10000},"payment_currency":{"type":"string","format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency that the customer sent, in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format."},"children":[]}]}]}],"example":"AED"},"eligible_payins":{"type":"array","description":"The payins that this payment can connect to. The endpoint returns a maximum of 10 payins, the newest first. The array is empty when no open payin matches the amount and the currency of the payment.\n","items":{"type":"object","properties":{"payin_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 unique identifier for the payin. A payment link starts with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"plink_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". An order starts with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"order_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". An add-funds request starts with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"addfunds_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Send this value as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payin_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/api-reference/openapi/payment/connectpayin"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Connect a payin"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"plink_6aad0ec19b3bT"},"payin_status":{"type":"string","enum":["pending"],"description":"The status of the payin. The endpoint returns only the payins that can still receive a payment.\n","example":"pending"},"payin_type":{"type":"string","enum":["payment_link","orders","add_funds"],"description":"The type of the payin.\n","example":"payment_link"},"amount":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The amount that the payin expects, in minor units. For example, 2723 is $27.23. The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field gives the currency."},"children":[]}]}]}],"example":2723},"currency":{"type":"string","format":"iso-4217","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The currency of the payin, in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_4217"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 4217"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format."},"children":[]}]}]}],"example":"USD"},"customer_id":{"type":"string","description":"The unique identifier for the customer of this payin.\n","example":"cust_69eb2cf0FYSDF"},"invoice_number":{"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 invoice number of the payin. The value is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when the payin has no invoice number."},"children":[]}]}]}],"example":"R0001"},"reference_number":{"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 reference number of the payin. The value is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when the payin has no reference number."},"children":[]}]}]}],"example":"RG12FF590"},"created_at":{"type":"string","format":"date-time","description":"The creation timestamp of the payin, in UTC.\n","example":"2026-09-18T10:38:19.237Z"}}}}}},"id":"schema_45"},"schema_46":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","enum":["Bad Request"]},"message":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Error message."},"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":"Possible messages:"},"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":"code","inline":true,"attributes":{"content":"Id must start with 'payt_' and contain only alphanumeric characters"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" path parameter is not valid."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Payment is not in correct state to link a payin"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - the payment is not in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"action_required"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" state."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Payment already belongs to a payin that is not in pending state"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - the payin that the payment points at is no longer pending."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Only applicable for bank transfers"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payment_method.type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of the payment is not "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bank_transfer"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The merchant description of an "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"error_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" that you cannot resolve by a connect, such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"SANCTION_HIT"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"TXM_HOLD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". An example is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"This payment requires additional verification. Please contact support for assistance."},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Contact support for these payments."},"children":[]}]}]}]}],"example":"Payment is not in correct state to link a payin"}}},"id":"schema_46"},"schema_47":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","enum":["Not Found"]},"message":{"type":"string","enum":["Payment not found"]}}},"id":"schema_47"},"schema_48":{"kind":"json-schema","data":{"type":"object","properties":{"payin_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 unique identifier of the payin to connect. Take this value from the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"eligible_payins"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" list. A payment link starts with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"plink_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". An order starts with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"order_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". An add-funds request starts with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"addfunds_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The payin must be a payin of your business. Its status must be "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pending"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"plink_6aad0ec19b3bT"}},"required":["payin_id"],"additionalProperties":false},"id":"schema_48"},"schema_49":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","enum":["Bad Request"]},"message":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Error message."},"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":"Possible messages:"},"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":"code","inline":true,"attributes":{"content":"Id must start with 'payt_' and contain only alphanumeric characters"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" path parameter is not valid."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Payment is not in correct state to link a payin"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - the payment is not in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"action_required"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" state."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Payment already belongs to a payin that is not in pending state"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - the payin that the payment points at is no longer pending."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"The payin to be linked to the given payment is in an invalid state"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - the payin is not "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pending"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". It can be expired or cancelled."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The merchant description of an "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"error_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" that you cannot resolve by a connect, such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"SANCTION_HIT"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"TXM_HOLD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". An example is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"This payment requires additional verification. Please contact support for assistance."},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Contact support for these payments."},"children":[]}]}]}]}],"example":"The payin to be linked to the given payment is in an invalid state"}}},"id":"schema_49"},"schema_50":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","enum":["Not Found"]},"message":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Error message."},"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":"Possible messages:"},"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":"code","inline":true,"attributes":{"content":"Payment not found"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Payin not found"},"children":[]}]}]}]}],"example":"Payin not found"}}},"id":"schema_50"},"schema_51":{"kind":"json-schema","data":{"type":"string","description":"The unique identifier for the payment.","example":"payt_E602dMzgjpDC"},"id":"schema_51"},"schema_52":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Payment"},"message":{"type":"string","description":"Success message","example":"Payment funds available status updated successfully"}}},"id":"schema_52"},"schema_53":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The specific validation error message indicating why the mock funds available operation failed."},"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":"Possible Error Messages:"},"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":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Payment Status Error:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Payment must be in success status"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","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":"Settlement Error:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Payment must not have direct settlement enabled"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","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":"Transaction Error:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"No transaction found for payment"},"children":[]}]}]}]}],"example":"Payment must be in success status"}}},"id":"schema_53"},"schema_54":{"kind":"json-schema","data":{"type":"object","properties":{"reason":{"type":"string","enum":["Requested By Customer","Duplicate","Fraudulent","Others"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The reason for the refund. Send one of the listed values exactly as written: the match is case-sensitive and includes the spaces, so "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Requested By Customer"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is accepted and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"requested_by_customer"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Requested by customer"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is rejected with a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},"payment_id":{"type":"string","description":"The unique identifier of payment linked to refund.\n","example":"payt_E602dMzgjpDC"},"document_id":{"type":"string","description":"The id of document that is uploaded for refund.\n","example":"doc_E602dMd2adDC"},"document_url":{"type":"string","description":"The url of document that is uploaded for refund.\n","example":"https://www.example.com/documents/invoice.pdf"},"file_name":{"type":"string","description":"The name of document that is uploaded for refund.\n","example":"invoice"},"amount":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The amount to refund, in the smallest unit of the payment's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"converted_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", the merchant-side currency (cents for USD), or the currency received for a bank transfer not yet matched to a payin. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $10.00 when that currency is USD. Required for partial refunds. If not provided, the full payment amount will be refunded. If partial refunds are not enabled on your account, an amount below the payment's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"converted_amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and the message "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Partial refunds are not enabled for this business"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and an amount equal to or greater than it refunds the full payment. The refund returns its own "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in the refund's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", which can differ from this one."},"children":[]}]}]}],"example":1000},"request_id":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Your unique identifier for this refund, used to reject duplicates. If a refund with the same "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"request_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" already exists on your account, the request is rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and the message "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Refund already exists for this request_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", unless the payment first fails another refund check (for example, it's already fully refunded). The existing refund is not returned. Look it up with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v1/refunds?request_id=<your_request_id>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"unique_refund_request_id_123"}},"required":["payment_id","reason"]},"id":"schema_54"},"schema_55":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string","description":"Error message.\n","example":"Refund is already in progress."}}},"id":"schema_55"},"schema_56":{"kind":"json-schema","data":{"type":"string","enum":["in_progress","under_review","action_required","success","failed","cancelled"]},"id":"schema_56"},"schema_57":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Refund"}},"page_meta":{"$ref":"#/components/schemas/PageMeta"}}},"id":"schema_57"},"schema_58":{"kind":"json-schema","data":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The status to move the refund to."},"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":"code","inline":true,"attributes":{"content":"success"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — completes a refund that is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"in_progress"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"failed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — fails a refund that has not yet reached a terminal status."},"children":[]}]}]}]}],"example":"success"}}},"id":"schema_58"},"schema_59":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string","description":"Error message.\n","example":"Refund cannot be marked success."}}},"id":"schema_59"},"schema_60":{"kind":"json-schema","data":{"allOf":[{"$ref":"#/components/schemas/Price"},{"type":"object","oneOf":[{"properties":{"pricing_type":{"enum":["fixed"]},"fees_currency":{"type":"string"},"fees_amount":{"type":"number"}},"required":["pricing_type","fees_currency","fees_amount"]},{"properties":{"pricing_type":{"enum":["percentage"]},"bps":{"type":"number"}},"required":["pricing_type","bps"]}]}]},"id":"schema_60"},"schema_61":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Price"}},"page_meta":{"$ref":"#/components/schemas/PageMeta"}}},"id":"schema_61"},"schema_62":{"kind":"json-schema","data":{"allOf":[{"$ref":"#/components/schemas/Price"},{"example":{"bps":null}}]},"id":"schema_62"},"schema_63":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/DynamicPrice"}},"page_meta":{"$ref":"#/components/schemas/PageMeta"}}},"id":"schema_63"},"schema_64":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","enum":["Bad Request"]},"message":{"type":"string","description":"Error message.\n","example":"per_page must be an integer"}}},"id":"schema_64"},"schema_65":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Unauthorized"},"message":{"type":"string","example":"Invalid or missing authentication token"}}},"id":"schema_65"},"schema_66":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","enum":["Bad Request"]},"message":{"type":"string","description":"Error message.\n","example":"price_id not found"}}},"id":"schema_66"},"schema_67":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PricingSplit"}},"page_meta":{"$ref":"#/components/schemas/PageMeta"}}},"id":"schema_67"},"schema_68":{"kind":"json-schema","data":{"type":"object","properties":{"customer_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 unique identifier of an existing customer ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cust_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" prefix). Mutually exclusive with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"email"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"cust_abc123XYZ"},"email":{"type":"string","format":"email","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Email address to pre-populate customer details in the session flow. Mutually exclusive with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"customer_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"john.doe@example.com"},"kyc":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"KYC prefill (v1) — identity details used to prefill the KYC step. Equivalent to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"data.kyc"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (v2, recommended); provide one shape or the other, not both. Only accepted when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"customer_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"email"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is also provided at the top level."},"children":[]}]}]}],"properties":{"pan":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Indian Permanent Account Number. Format: 10 characters, e.g. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ABCPE1234F"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"ABCPE1234F"},"phone":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Customer phone number, validated against "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"country"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Must be supplied together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"country"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — phone without country is rejected."},"children":[]}]}]}],"example":"9876543210"},"country":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 3166-1 alpha-3 country code used to validate "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"phone"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (e.g. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"IND"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"USA"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GBR"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"example":"IND"},"dob":{"type":"string","format":"date","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Date of birth in ISO 8601 format ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"example":"1990-05-12"}}},"data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Optional container for prefill data. Include only the groups relevant to your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"session_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; unknown groups are ignored. When present it must be a JSON object; an array, string, number or boolean returns a 400 error."},"children":[]}]}]}],"properties":{"kyc":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"KYC prefill (v2, recommended) — identity details used to prefill the KYC step. Same fields as the top-level "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"kyc"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (v1); the two shapes cannot be combined."},"children":[]}]}]}],"properties":{"pan":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Indian Permanent Account Number. Format: 10 characters, e.g. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ABCPE1234F"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"ABCPE1234F"},"phone":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Customer phone number, validated against "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"country"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Must be supplied together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"country"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — phone without country is rejected."},"children":[]}]}]}],"example":"9876543210"},"country":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 3166-1 alpha-3 country code used to validate "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"phone"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (e.g. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"IND"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"USA"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GBR"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"example":"IND"},"dob":{"type":"string","format":"date","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Date of birth in ISO 8601 format ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"example":"1990-05-12"}}},"scheme":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Investment scheme details used to prefill the scheme plan and amount step. Include "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"scheme_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to open the session for a named scheme."},"children":[]}]}]}],"properties":{"scheme_code":{"type":"string","description":"Code of the AMC scheme the session is for. Case-insensitive. Required for a distributor.\n","example":"SCH001"},"plan":{"type":"string","enum":["regular","direct"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"AMC scheme plan. Ignored for a distributor. With "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"scheme_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", it must match the scheme's plan."},"children":[]}]}]}],"example":"regular"},"amount":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Investment amount in the smallest currency unit (e.g. cents for USD, so "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"500000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is $5,000.00). Must be a positive integer and supplied together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Send a multiple of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"100"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (whole dollars): the checkout form accepts only whole-dollar amounts, so a prefill with cents, such as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"500050"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", is shown to the customer as invalid until they change it."},"children":[]}]}]}],"example":500000},"currency":{"type":"string","enum":["USD"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Currency of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Only "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"USD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is supported. Supplied together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"amount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"USD"},"distributor_arn":{"type":"string","description":"AMC distributor ARN. Must start with your configured distributor-code prefix, if one is set for your business. Ignored for a distributor.\n","example":"ARN12345"}}}}}}},"id":"schema_68"},"schema_69":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"customer_id or email is required when pan, phone, or dob is supplied"}}},"id":"schema_69"},"schema_70":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Payment session is not enabled for this business"}}},"id":"schema_70"},"schema_71":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"Scheme not found"}}},"id":"schema_71"},"schema_72":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Conflict"},"message":{"type":"string","example":"PAN is already registered with a different email"}}},"id":"schema_72"},"schema_73":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Unprocessable Entity"},"message":{"type":"string","example":"Scheme is not available for distribution"}}},"id":"schema_73"},"schema_74":{"kind":"json-schema","data":{"type":"object","required":["scheme_code"],"properties":{"scheme_code":{"type":"string","description":"The scheme to sell. Must be a scheme the fund has enabled for the distributor. Matching ignores case and surrounding spaces.\n","example":"SCH001"},"amount":{"type":"integer","description":"Optional amount to prefill, in cents of USD. Must be a positive integer within the scheme's fresh-purchase limits. The investor can change it. There is no currency field: schemes are in USD.\n","example":500000},"distributor_arn":{"type":"string","description":"Optional. For a distributor, it must match its ARN for the fund, with or without the fund's prefix; left out, the ARN from the relationship is used. For a fund creating its own link, an ARN with the fund's prefix, saved as an editable prefill.\n","example":"ARN-123456"}}},"id":"schema_74"},"schema_75":{"kind":"json-schema","data":{"type":"object","properties":{"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 link id ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"shl_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" prefix). Also the last part of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"url"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"shl_q6af9kKWKaXV4LH8XNVliBrc"},"link_type":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"What the link opens. Always "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payment_session"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"payment_session"},"url":{"type":"string","description":"The URL to share, on the fund's checkout domain.","example":"https://pay.example-fund.com/shared-link/shl_q6af9kKWKaXV4LH8XNVliBrc"},"status":{"type":"string","enum":["active","disabled","unavailable"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"active"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when the link can be opened. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"unavailable"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when the relationship or the scheme no longer allows it. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"disabled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when the link was disabled."},"children":[]}]}]}],"example":"active"},"details":{"type":"object","description":"What the link sells. Product and distributor details only.","properties":{"fund_name":{"type":"string","example":"Example Fund"},"scheme_code":{"type":"string","example":"SCH001"},"scheme_name":{"type":"string","example":"Example Global Equity Fund"},"plan":{"type":"string","example":"regular"},"distributor_name":{"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 distributor's name. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on a fund's own link."},"children":[]}]}]}],"example":"Example Distributor"},"distributor_arn":{"type":["string","null"],"example":"ARN-123456"},"amount":{"type":["integer","null"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The prefilled amount in cents of USD, or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":500000}}},"openings_count":{"type":"integer","description":"How many payment sessions the link has started.","example":0},"created_at":{"type":"string","format":"date-time","example":"2026-10-09T10:30:00Z"}}},"id":"schema_75"},"schema_76":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Feature not enabled"}}},"id":"schema_76"},"schema_77":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"No active relationship with this fund"}}},"id":"schema_77"},"schema_78":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Unprocessable Entity"},"message":{"type":"string","example":"distributor_arn does not match the registered ARN"}}},"id":"schema_78"},"schema_79":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Bank account already exists"}}},"id":"schema_79"},"schema_80":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/LrsCustomerBankAccount"}},"id":"schema_80"},"schema_81":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Customer does not exist"}}},"id":"schema_81"},"schema_82":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"Bank account not found"}}},"id":"schema_82"},"schema_83":{"kind":"json-schema","data":{"type":"object","properties":{"bank_customer_id":{"type":"string","description":"The customer's identifier at their bank. Required for banks that use one. For those banks it must contain only digits, with a length inside the range the bank accepts. For other banks it is optional; omitting it clears the value.\n","example":"12345678"}}},"id":"schema_83"},"schema_84":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Bank customer id can't be blank"}}},"id":"schema_84"},"schema_85":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Validation failed: Bank code can't be blank"}}},"id":"schema_85"},"schema_86":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Unprocessable Entity"},"message":{"type":"string","example":"No active exchange rate found"}}},"id":"schema_86"},"schema_87":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"Quote not found"}}},"id":"schema_87"},"schema_88":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/LrsBank"}},"id":"schema_88"},"schema_89":{"kind":"json-schema","data":{"type":"string","enum":["created","authorized","active","paused","halted","action_required","under_review","completed","cancelled","expired","failed"]},"id":"schema_89"},"schema_90":{"kind":"json-schema","data":{"type":"string","format":"date"},"id":"schema_90"},"schema_91":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Subscription"}},"page_meta":{"$ref":"#/components/schemas/PageMeta"}}},"id":"schema_91"},"schema_92":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","enum":["Bad Request"]},"message":{"type":"string","description":"Error message indicating why the request failed"}}},"id":"schema_92"},"schema_93":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","enum":["Bad Request"]},"message":{"type":"string","description":"Error message describing the validation failure","example":"Customer not found"}}},"id":"schema_93"},"schema_94":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","enum":["Not Found"]},"message":{"type":"string","example":"Subscription not found"}}},"id":"schema_94"},"schema_95":{"kind":"json-schema","data":{"allOf":[{"$ref":"#/components/schemas/Subscription"},{"type":"object","properties":{"status":{"example":"paused"},"next_payment_date":{"example":null}}}]},"id":"schema_95"},"schema_96":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","enum":["Bad Request"]},"message":{"type":"string","example":"Subscription cannot be paused from current state: cancelled"}}},"id":"schema_96"},"schema_97":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","enum":["Bad Request"]},"message":{"type":"string","example":"Subscription cannot be resumed from current state: active"}}},"id":"schema_97"},"schema_98":{"kind":"json-schema","data":{"allOf":[{"$ref":"#/components/schemas/Subscription"},{"type":"object","properties":{"status":{"example":"cancelled"},"next_payment_date":{"example":null}}}]},"id":"schema_98"},"schema_99":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","enum":["Bad Request"]},"message":{"type":"string","example":"Subscription cannot be cancelled from current state: completed"}}},"id":"schema_99"},"schema_100":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","enum":["Bad Request"]},"message":{"type":"string","example":"New payment date cannot exceed the current next_payment_date by more than 28 days. Difference: 30 days"}}},"id":"schema_100"},"schema_101":{"kind":"json-schema","data":{"type":"object","properties":{"quotes":{"type":"array","items":{"$ref":"#/components/schemas/Quote"}}}},"id":"schema_101"},"schema_102":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Either source_amount or destination_amount must be provided, not both"}}},"id":"schema_102"},"schema_103":{"kind":"json-schema","data":{"oneOf":[{"$ref":"#/components/schemas/CreatePayoutWithoutQuoteRequest","required":["purpose_code","beneficiary_id","source_currency","destination_currency"]},{"$ref":"#/components/schemas/CreatePayoutWithQuoteRequest","required":["quote_id","beneficiary_id","purpose_code"]}]},"id":"schema_103"},"schema_104":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Conflict"},"message":{"type":"string","example":"Record already exists"}}},"id":"schema_104"},"schema_105":{"kind":"json-schema","data":{"type":"string","enum":["pending_approval","queued","in_progress","success","failed","action_required","cancelled"]},"id":"schema_105"},"schema_106":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Payout"}},"page_meta":{"$ref":"#/components/schemas/PageMeta"}}},"id":"schema_106"},"schema_107":{"kind":"json-schema","data":{"type":"string","example":"payout_DdWpHUbOnlg"},"id":"schema_107"},"schema_108":{"kind":"json-schema","data":{"allOf":[{"$ref":"#/components/schemas/Payout"},{"type":"object","properties":{"status":{"type":"string","description":"The status of the payout.\n","example":"cancelled"}}}]},"id":"schema_108"},"schema_109":{"kind":"json-schema","data":{"allOf":[{"$ref":"#/components/schemas/MockUpdatePayoutStatusRequest","required":["id","status"]}]},"id":"schema_109"},"schema_110":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","description":"Error message indicating which fields failed validation"}}},"id":"schema_110"},"schema_111":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Conflict"},"message":{"type":"string","example":"A beneficiary with this account number already exists"}}},"id":"schema_111"},"schema_112":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Unprocessable Entity"},"message":{"type":"string","description":"Error message indicating the business logic error"}}},"id":"schema_112"},"schema_113":{"kind":"json-schema","data":{"type":"string","enum":["pending","active","rejected"]},"id":"schema_113"},"schema_114":{"kind":"json-schema","data":{"type":"integer"},"id":"schema_114"},"schema_115":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/BeneficiaryV2"}},"page_meta":{"type":"object","properties":{"current":{"type":"integer","example":1},"previous":{"type":["integer","null"],"example":null},"next":{"type":["integer","null"],"example":2},"per_page":{"type":"integer","example":20},"pages":{"type":"integer","example":3},"count":{"type":"integer","example":50}}}}},"id":"schema_115"},"schema_116":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Status is not included in the list"}}},"id":"schema_116"},"schema_117":{"kind":"json-schema","data":{"type":"object","required":["review_action"],"properties":{"review_action":{"type":"string","enum":["approve","reject"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The review action to perform on a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pending"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" beneficiary. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"approve"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" moves it to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"active"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"reject"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" moves it to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rejected"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A beneficiary that is not "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pending"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" returns a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"422"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"approve"}}},"id":"schema_117"},"schema_118":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string","example":"Beneficiary status updated successfully"}}},"id":"schema_118"},"schema_119":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Review action is not included in the list"}}},"id":"schema_119"},"schema_120":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Invalid beneficiary status update"}}},"id":"schema_120"},"schema_121":{"kind":"json-schema","data":{"oneOf":[{"$ref":"#/components/schemas/BankAccount","required":["country","holder_name","account_number","bic_primary","bic_secondary"]},{"type":"object","title":"BankAccountReference","properties":{"id":{"type":"string","description":"The ID of an already saved beneficiary bank account","example":"bene_5JU9yv0lGSUP"}},"required":["id"]}]},"id":"schema_121"},"schema_122":{"kind":"json-schema","data":{"type":"string","format":"iso-3166-1-alpha-3","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The country where the customer is located. Country should be sent as a "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 3166-1 alpha-3"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" code, case-insensitive."},"children":[]}]}]}],"example":"Ind"},"id":"schema_122"},"schema_123":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/BankAccountValidation"}},"page_meta":{"$ref":"#/components/schemas/PageMeta"}}},"id":"schema_123"},"schema_124":{"kind":"json-schema","data":{"type":"object","properties":{"document_name":{"type":"string","description":"The name of the document\n","example":"invoice"},"file":{"type":"string","format":"binary","description":"The file to be uploaded. This should be sent as a binary in the multipart/form-data request.\n"}},"required":["file","document_name"]},"id":"schema_124"},"schema_125":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Document"}},"page_meta":{"$ref":"#/components/schemas/PageMeta"}}},"id":"schema_125"},"schema_126":{"kind":"json-schema","data":{"type":"string","example":"doc_12345"},"id":"schema_126"},"schema_127":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Validation failed: Id must start with 'doc_' and contain only alphanumeric characters"}}},"id":"schema_127"},"schema_128":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"Document not found"}}},"id":"schema_128"},"schema_129":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Invalid request data"}}},"id":"schema_129"},"schema_130":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","enum":["Bad Request"]},"message":{"type":"string","description":"Error message indicating which parameter was invalid","example":"Validation failed: Currency is not supported"}}},"id":"schema_130"},"schema_131":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","enum":["Forbidden"]},"message":{"type":"string","example":"Settlements API is only available for businesses with manual settlement mode"}}},"id":"schema_131"},"schema_132":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","enum":["Not Found"]},"message":{"type":"string","example":"Withdrawal account not found"}}},"id":"schema_132"},"schema_133":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Settlement"}},"page_meta":{"$ref":"#/components/schemas/PageMeta"}}},"id":"schema_133"},"schema_134":{"kind":"json-schema","data":{"type":"object","properties":{"status":{"type":"string","description":"Confirms that the settlement run was queued.","enum":["accepted"]},"withdrawal_account_id":{"type":"string","description":"The settlement account that the run pays into.","example":"accwith_E602dMzgjpDC"}}},"id":"schema_134"},"schema_135":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Transaction"}},"page_meta":{"$ref":"#/components/schemas/PageMeta"}}},"id":"schema_135"},"schema_136":{"kind":"json-schema","data":{"$ref":"#/components/schemas/Currency"},"id":"schema_136"},"schema_137":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/VirtualAccount"}},"page_meta":{"$ref":"#/components/schemas/PageMeta"}}},"id":"schema_137"},"schema_138":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","enum":["Bad Request"]},"message":{"type":"string","description":"Error message indicating which parameter was invalid","example":"Missing Required parameters"}}},"id":"schema_138"},"schema_139":{"kind":"json-schema","data":{"type":"string","enum":["local","swift"]},"id":"schema_139"},"schema_140":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string","example":"Virtual account closed successfully"}}},"id":"schema_140"},"schema_141":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Active account not found"}}},"id":"schema_141"},"schema_142":{"kind":"json-schema","data":{"type":"object","properties":{"payment_type":{"type":"string","enum":["local","swift"],"description":"The type of payments this virtual account will accept. 'local' for domestic payments within the same country, 'swift' for cross-border payments.\n","example":"local"},"currency":{"$ref":"#/components/schemas/Currency","description":"The currency for the virtual account in ISO 4217 format.\n","example":"AED"}},"required":["payment_type","currency"]},"id":"schema_142"},"schema_143":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string","example":"Virtual account creation request is accepted."},"data":{"type":"object","properties":{"merchant_id":{"type":"string","example":"merch_694bb0289P4Cz"},"status":{"type":"string","enum":["pending"],"example":"pending"}}}}},"id":"schema_143"},"schema_144":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","enum":["Duplicate record"]},"message":{"type":"string","description":"Virtual Account already exists","example":"Virtual Account already exists"}}},"id":"schema_144"},"schema_145":{"kind":"json-schema","data":{"type":"string","example":"merch_68c777fcOOMpl"},"id":"schema_145"},"schema_146":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Invalid merchant ID format"}}},"id":"schema_146"},"schema_147":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"unauthorized"},"message":{"type":"string","example":"Invalid or missing authentication token"}}},"id":"schema_147"},"schema_148":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"Merchant with the specified ID was not found"}}},"id":"schema_148"},"schema_149":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Passport is required for individual entity type"}}},"id":"schema_149"},"schema_150":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Merchant not found"},"message":{"type":"string","example":"Merchant not found for id: merch_68c777fcOOMpl"}}},"id":"schema_150"},"schema_151":{"kind":"json-schema","data":{"type":"object","properties":{"target_status":{"type":"string","enum":["success"],"description":"The target status to update the merchant to","example":"success"},"merchant_id":{"type":"string","description":"The merchant for which the status is to be updated","example":"merch_68511919RVuf6"}},"required":["target_status","merchant_id"]},"id":"schema_151"},"schema_152":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Invalid merchant status update"}}},"id":"schema_152"},"schema_153":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Unauthorized"},"message":{"type":"string","example":"Unauthorized"}}},"id":"schema_153"},"schema_154":{"kind":"json-schema","data":{"type":"string","enum":["initiated","in_progress","submitted","action_required","under_review","completed","failed","expired","rejected"]},"id":"schema_154"},"schema_155":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/KycLinkDetail"}},"page_meta":{"$ref":"#/components/schemas/PageMeta"}}},"id":"schema_155"},"schema_156":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","description":"Error message indicating why the request failed."}}},"id":"schema_156"},"schema_157":{"kind":"json-schema","data":{"type":"object","properties":{"customer_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 unique identifier of an existing customer ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cust_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" prefix). Mutually exclusive with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"email"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"cust_abc123XYZ"},"email":{"type":"string","format":"email","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Email address to associate the KYC link with. Mutually exclusive with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"customer_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"john.doe@example.com"},"expire_in_days":{"type":"integer","description":"Number of days until the link expires. Must be greater than 0. Defaults to the platform setting if omitted.\n","example":90},"send_email":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Whether to send the KYC link to the customer via email. Defaults to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — omitting this field will trigger an email to the customer."},"children":[]}]}]}],"default":true,"example":true}}},"id":"schema_157"},"schema_158":{"kind":"json-schema","data":{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier of the KYC link.","example":"kyc_69b3f97eSThQY"},"status":{"type":"string","description":"Current status of the KYC link.","example":"initiated"},"link_url":{"type":"string","format":"uri","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The shareable URL to send to the customer to complete KYC. Share it as returned rather than building it yourself: in sandbox it ends with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"?sandbox=true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"https://app.glomopay.com/kyc-links/kyc_69b3f97eSThQY"},"expires_at":{"type":"string","format":"date-time","description":"When the link expires, as an ISO 8601 date-time in UTC.\n","example":"2026-06-11T11:48:14.361Z"},"created_at":{"type":"string","format":"date-time","description":"When the link was created, as an ISO 8601 date-time in UTC.\n","example":"2026-03-13T11:48:14.363Z"},"customer_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 unique identifier of the customer associated with this KYC link. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if no existing customer is associated — e.g. when created with only an email address, or without "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"customer_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"email"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"cust_abc123XYZ"}}},"id":"schema_158"},"schema_159":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","description":"Error message describing the validation failure.","example":"customer_id and email are mutually exclusive"}}},"id":"schema_159"},"schema_160":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"KYC link with given id does not exist"}}},"id":"schema_160"},"schema_161":{"kind":"json-schema","data":{"type":"object","required":["email","pan","scheme_no"],"properties":{"email":{"type":"string","format":"email","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The investor's email address. Surrounding whitespace is removed and the address is lower-cased before it is checked. The part before "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"@"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" can be at most 64 characters, with no leading, trailing or consecutive dots; the domain must contain a dot and end in a top-level domain of 2–63 letters; and the whole address can be at most 254 characters. An invalid address returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"investor@example.com"},"pan":{"type":"string","pattern":"^[A-Z]{3}P[A-Z][0-9]{4}[A-Z]$","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The investor's PAN: five letters, four digits and a final letter, where the fourth letter must be "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"P"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Surrounding whitespace is removed before the check. An invalid PAN returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"ABCPD1234E"},"scheme_no":{"type":"string","example":"HGEMR"}}},"id":"schema_161"},"schema_162":{"kind":"json-schema","data":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The investor portal URL to send the investor to. The journey details travel encrypted in the URL fragment ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"#payload=…"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"), so pass the URL on unchanged."},"children":[]}]}]}],"example":"https://investor-portal.glomopay.com#payload=..."}}},"id":"schema_162"},"schema_163":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Scheme not found"}}},"id":"schema_163"},"schema_164":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Unauthorized"},"message":{"type":"string","example":"Access restricted to platform businesses only"}}},"id":"schema_164"},"schema_165":{"kind":"json-schema","data":{"type":"string","enum":["action_required","under_review","approved","rejected","superseded","expired","cancelled"]},"id":"schema_165"},"schema_166":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/RfiListItem"}},"page_meta":{"$ref":"#/components/schemas/PageMeta"}}},"id":"schema_166"},"schema_167":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","enum":["Bad Request"]},"message":{"type":"string","description":"Error message.\n","example":"Validation failed: Status not_a_real_status is not a valid status"}}},"id":"schema_167"},"schema_168":{"kind":"json-schema","data":{"type":"object","properties":{"documents":{"type":"array","minItems":1,"description":"The documents being submitted in response to the RFI. At least one document is required.\n","items":{"type":"object","properties":{"rfi_doc_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 identifier of the RFI document requirement this document satisfies, taken from the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"documents_required"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" list on the underlying resource's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rfi"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" object. Starts with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rfidoc_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"rfidoc_6a7c5018sI3ht"},"doc_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 identifier of a single uploaded document, returned by the Create a Document endpoint. Provide either "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"doc_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"doc_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Starts with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"doc_"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"doc_6a79c6c4SbTxf"},"doc_ids":{"type":"array","items":{"type":"string"},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The identifiers of multiple uploaded documents satisfying this requirement. Provide either "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"doc_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"doc_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":["doc_6a79c6c4SbTxf"]}},"required":["rfi_doc_id"],"additionalProperties":false}},"fields":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The structured values requested by the RFI, keyed by the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of each entry in its "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fields_required"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" list."},"children":[]}]}]}],"additionalProperties":true,"example":{"invoice_number":"INV-2091","invoice_date":"2026-08-20","invoice_amount":1250000,"invoice_currency":"INR","customer_name":"Rohan Textiles Pvt Ltd","customer_address":{"address_line1":"14 Mint Street","city":"Chennai","administrative_area":"Tamil Nadu","postal_code":"600001","country_code":"IND"}}},"uploader_comments":{"type":"string","description":"An optional note recorded against the RFI alongside the submitted documents.\n","example":"Passport attached for review"}},"additionalProperties":false},"id":"schema_168"},"schema_169":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","enum":["Bad Request"]},"message":{"type":"string","description":"Error message.\n","example":"must provide doc_id or doc_ids"}}},"id":"schema_169"},"schema_170":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","enum":["Unprocessable Entity"]},"message":{"type":"string","description":"Error message.\n","example":"RFI information has already been submitted"}}},"id":"schema_170"}},"exampleStore":{"paths/~1api-keys~1rotate/post/responses/400/content/application~1json/examples/non_integer":{"value":{"error":"Bad Request","message":"Validation failed: Expire after in seconds must be an integer"},"key":"non_integer","summary":"Non-integer value passed","id":"paths/~1api-keys~1rotate/post/responses/400/content/application~1json/examples/non_integer"},"paths/~1api-keys~1rotate/post/responses/400/content/application~1json/examples/out_of_range":{"value":{"error":"Bad Request","message":"Validation failed: Expire after in seconds must be between 0 and 604800"},"key":"out_of_range","summary":"Value outside allowed range (0–604800)","id":"paths/~1api-keys~1rotate/post/responses/400/content/application~1json/examples/out_of_range"},"paths/~1api-keys~1rotate/post/responses/401/content/application~1json/example":{"value":{"error":"Unauthorized","message":"Missing token"},"id":"paths/~1api-keys~1rotate/post/responses/401/content/application~1json/example"},"paths/~1balance_conversions/post/requestBody/content/application~1json/examples/convert_source_amount":{"value":{"source_currency":"USD","target_currency":"EUR","source_amount":10000},"key":"convert_source_amount","summary":"Convert a fixed amount of USD into EUR","id":"paths/~1balance_conversions/post/requestBody/content/application~1json/examples/convert_source_amount"},"paths/~1balance_conversions/post/requestBody/content/application~1json/examples/receive_target_amount":{"value":{"source_currency":"USD","target_currency":"EUR","target_amount":10000},"key":"receive_target_amount","summary":"Receive a fixed amount of EUR, paid for in USD","id":"paths/~1balance_conversions/post/requestBody/content/application~1json/examples/receive_target_amount"},"paths/~1fx-rate/get/responses/400/content/application~1json/examples/missing_currency":{"value":{"error":"Bad Request","message":"can't be blank"},"key":"missing_currency","summary":"Missing currency parameter","id":"paths/~1fx-rate/get/responses/400/content/application~1json/examples/missing_currency"},"paths/~1fx-rate/get/responses/400/content/application~1json/examples/invalid_currency":{"value":{"error":"Bad Request","message":"is not a valid currency"},"key":"invalid_currency","summary":"Invalid ISO currency code","id":"paths/~1fx-rate/get/responses/400/content/application~1json/examples/invalid_currency"},"paths/~1fx-rate/get/responses/400/content/application~1json/examples/non_string_currency":{"value":{"error":"Bad Request","message":"must be a string"},"key":"non_string_currency","summary":"Non-string currency parameter","id":"paths/~1fx-rate/get/responses/400/content/application~1json/examples/non_string_currency"},"paths/~1payin/post/responses/400/content/application~1json/examples/amount_conflict":{"value":{"error":"Bad Request","message":"You can only send source_amount or target_amount, not both."},"key":"amount_conflict","summary":"Both amounts specified","id":"paths/~1payin/post/responses/400/content/application~1json/examples/amount_conflict"},"paths/~1payin/post/responses/400/content/application~1json/examples/quote_not_found":{"value":{"error":"Bad Request","message":"quote_id not found"},"key":"quote_not_found","summary":"quote_id not found","id":"paths/~1payin/post/responses/400/content/application~1json/examples/quote_not_found"},"paths/~1payin/post/responses/400/content/application~1json/examples/quote_not_payin":{"value":{"error":"Bad Request","message":"quote_id is not a payin quote"},"key":"quote_not_payin","summary":"quote_id is not a payin quote","id":"paths/~1payin/post/responses/400/content/application~1json/examples/quote_not_payin"},"paths/~1payin/post/responses/400/content/application~1json/examples/quote_expired":{"value":{"error":"Bad Request","message":"quote_id has expired"},"key":"quote_expired","summary":"quote_id has expired","id":"paths/~1payin/post/responses/400/content/application~1json/examples/quote_expired"},"paths/~1payin/post/responses/400/content/application~1json/examples/quote_already_used":{"value":{"error":"Bad Request","message":"quote_id has already been used"},"key":"quote_already_used","summary":"quote_id has already been used","id":"paths/~1payin/post/responses/400/content/application~1json/examples/quote_already_used"},"paths/~1payin/post/responses/400/content/application~1json/examples/locked_field_amount":{"value":{"error":"Bad Request","message":"amount cannot be specified when quote_id is present"},"key":"locked_field_amount","summary":"Locked field sent with quote_id","id":"paths/~1payin/post/responses/400/content/application~1json/examples/locked_field_amount"},"paths/~1payin/post/responses/400/content/application~1json/examples/locked_field_split_ids":{"value":{"error":"Bad Request","message":"Validation failed: Split ids cannot be specified when quote_id is present"},"key":"locked_field_split_ids","summary":"split_ids sent with quote_id","id":"paths/~1payin/post/responses/400/content/application~1json/examples/locked_field_split_ids"},"paths/~1payin/post/responses/400/content/application~1json/examples/split_ids_unresolved":{"value":{"error":"Bad Request","message":"Validation failed: Split ids are invalid or no longer point at a dynamic rule: psplit_7Kq2mXbTdLp9"},"key":"split_ids_unresolved","summary":"A split id does not resolve to a live dynamic rule","id":"paths/~1payin/post/responses/400/content/application~1json/examples/split_ids_unresolved"},"paths/~1payin/post/responses/400/content/application~1json/examples/split_ids_incomplete":{"value":{"error":"Bad Request","message":"Validation failed: Split ids must be declared for every dynamic rule on the dimension, missing rules: price_Kd82nvQ1TzAe"},"key":"split_ids_incomplete","summary":"Another dynamic rule on the same dimension is not declared","id":"paths/~1payin/post/responses/400/content/application~1json/examples/split_ids_incomplete"},"paths/~1payin/post/responses/400/content/application~1json/examples/split_ids_method_not_enabled":{"value":{"error":"Bad Request","message":"Validation failed: Split ids are not valid for any enabled payment method: bank_transfer"},"key":"split_ids_method_not_enabled","summary":"A declared payment method is not enabled for your business","id":"paths/~1payin/post/responses/400/content/application~1json/examples/split_ids_method_not_enabled"},"paths/~1payin/post/responses/400/content/application~1json/examples/split_ids_required":{"value":{"error":"Bad Request","message":"Validation failed: Split ids are required when dynamic fee splits are enforced"},"key":"split_ids_required","summary":"split_ids omitted on an account where a declaration is required","id":"paths/~1payin/post/responses/400/content/application~1json/examples/split_ids_required"},"paths/~1orders/post/responses/400/content/application~1json/examples/currency_not_supported":{"value":{"error":"Bad Request","message":"Currency not supported"},"key":"currency_not_supported","summary":"Currency not supported","id":"paths/~1orders/post/responses/400/content/application~1json/examples/currency_not_supported"},"paths/~1orders/post/responses/400/content/application~1json/examples/duplicate_request_id":{"value":{"error":"Bad Request","message":"Order already exists for this request_id"},"key":"duplicate_request_id","summary":"Duplicate request_id","id":"paths/~1orders/post/responses/400/content/application~1json/examples/duplicate_request_id"},"paths/~1orders/post/responses/400/content/application~1json/examples/quote_not_found":{"value":{"error":"Bad Request","message":"quote_id not found"},"key":"quote_not_found","summary":"quote_id not found","id":"paths/~1orders/post/responses/400/content/application~1json/examples/quote_not_found"},"paths/~1orders/post/responses/400/content/application~1json/examples/quote_not_payin":{"value":{"error":"Bad Request","message":"quote_id is not a payin quote"},"key":"quote_not_payin","summary":"quote_id is not a payin quote","id":"paths/~1orders/post/responses/400/content/application~1json/examples/quote_not_payin"},"paths/~1orders/post/responses/400/content/application~1json/examples/quote_expired":{"value":{"error":"Bad Request","message":"quote_id has expired"},"key":"quote_expired","summary":"quote_id has expired","id":"paths/~1orders/post/responses/400/content/application~1json/examples/quote_expired"},"paths/~1orders/post/responses/400/content/application~1json/examples/quote_already_used":{"value":{"error":"Bad Request","message":"quote_id has already been used"},"key":"quote_already_used","summary":"quote_id has already been used","id":"paths/~1orders/post/responses/400/content/application~1json/examples/quote_already_used"},"paths/~1orders/post/responses/400/content/application~1json/examples/locked_field_amount":{"value":{"error":"Bad Request","message":"amount cannot be specified when quote_id is present"},"key":"locked_field_amount","summary":"Locked field sent with quote_id","id":"paths/~1orders/post/responses/400/content/application~1json/examples/locked_field_amount"},"paths/~1orders/post/responses/400/content/application~1json/examples/locked_field_split_ids":{"value":{"error":"Bad Request","message":"Validation failed: Split ids cannot be specified when quote_id is present"},"key":"locked_field_split_ids","summary":"split_ids sent with quote_id","id":"paths/~1orders/post/responses/400/content/application~1json/examples/locked_field_split_ids"},"paths/~1orders/post/responses/400/content/application~1json/examples/split_ids_unresolved":{"value":{"error":"Bad Request","message":"Validation failed: Split ids are invalid or no longer point at a dynamic rule: psplit_7Kq2mXbTdLp9"},"key":"split_ids_unresolved","summary":"A split id does not resolve to a live dynamic rule","id":"paths/~1orders/post/responses/400/content/application~1json/examples/split_ids_unresolved"},"paths/~1orders/post/responses/400/content/application~1json/examples/split_ids_incomplete":{"value":{"error":"Bad Request","message":"Validation failed: Split ids must be declared for every dynamic rule on the dimension, missing rules: price_Kd82nvQ1TzAe"},"key":"split_ids_incomplete","summary":"Another dynamic rule on the same dimension is not declared","id":"paths/~1orders/post/responses/400/content/application~1json/examples/split_ids_incomplete"},"paths/~1orders/post/responses/400/content/application~1json/examples/split_ids_method_not_enabled":{"value":{"error":"Bad Request","message":"Validation failed: Split ids are not valid for any enabled payment method: bank_transfer"},"key":"split_ids_method_not_enabled","summary":"A declared payment method is not enabled for your business","id":"paths/~1orders/post/responses/400/content/application~1json/examples/split_ids_method_not_enabled"},"paths/~1orders/post/responses/400/content/application~1json/examples/split_ids_required":{"value":{"error":"Bad Request","message":"Validation failed: Split ids are required when dynamic fee splits are enforced"},"key":"split_ids_required","summary":"split_ids omitted on an account where a declaration is required","id":"paths/~1orders/post/responses/400/content/application~1json/examples/split_ids_required"},"paths/~1orders/post/responses/422/content/application~1json/examples/order_amount_above_cap":{"value":{"error":"Unprocessable Entity","message":"The order amount is above the limit for this programme","code":"order_amount_above_cap"},"key":"order_amount_above_cap","summary":"Above the configured cap","id":"paths/~1orders/post/responses/422/content/application~1json/examples/order_amount_above_cap"},"paths/~1orders/post/responses/422/content/application~1json/examples/order_cap_unavailable":{"value":{"error":"Unprocessable Entity","message":"This order cannot be accepted at this time","code":"order_cap_unavailable"},"key":"order_cap_unavailable","summary":"No cap configured for the destination currency","id":"paths/~1orders/post/responses/422/content/application~1json/examples/order_cap_unavailable"},"paths/~1orders/post/responses/422/content/application~1json/examples/beneficiary_missing":{"value":{"error":"Unprocessable Entity","message":"Beneficiary not found","code":"beneficiary_missing"},"key":"beneficiary_missing","summary":"beneficiary_id missing or unresolvable","id":"paths/~1orders/post/responses/422/content/application~1json/examples/beneficiary_missing"},"paths/~1orders/post/responses/422/content/application~1json/examples/quote_resource_type_missing":{"value":{"error":"Unprocessable Entity","message":"This quote cannot be used for an account funding order","code":"quote_resource_type_missing"},"key":"quote_resource_type_missing","summary":"The quote was not created for account funding","id":"paths/~1orders/post/responses/422/content/application~1json/examples/quote_resource_type_missing"},"paths/~1payment/post/requestBody/content/application~1json/examples/initial_payment":{"value":{"order_id":"order_68c00b7btsthf","method":"card","sequence":"initial","card":{"holder_name":"John Doe","number":"4111111111111111","expiry_month":"09","expiry_year":"30","cvv":"123"},"callback_url":"https://server.yoursite.com/payment/callback","notes":{"internal_ref":"ref_12345"}},"key":"initial_payment","summary":"Initial payment with card details","id":"paths/~1payment/post/requestBody/content/application~1json/examples/initial_payment"},"paths/~1payment/post/requestBody/content/application~1json/examples/subsequent_payment":{"value":{"subscription_id":"sub_5JU9yv0lGSUP","sequence":"subsequent","request_id":"unique_request_id_123","amount":1500,"currency":"USD"},"key":"subsequent_payment","summary":"Subsequent payment for as_presented subscription","id":"paths/~1payment/post/requestBody/content/application~1json/examples/subsequent_payment"},"paths/~1payment/post/requestBody/content/application~1json/examples/subsequent_payment_with_splits":{"value":{"subscription_id":"sub_5JU9yv0lGSUP","sequence":"subsequent","request_id":"unique_request_id_124","amount":1500,"currency":"USD","split_ids":["psplit_Q3vTn8LcRb2W"]},"key":"subsequent_payment_with_splits","summary":"Subsequent payment overriding the subscription's fee split for this charge","id":"paths/~1payment/post/requestBody/content/application~1json/examples/subsequent_payment_with_splits"},"paths/~1payment/post/responses/201/content/application~1json/example":{"value":{"payment_id":"payt_691eeb9aV79Uk","status":"pending","next_steps":[{"action":"redirect","payload":{"url":"https://secure.glomopay.com?paymentId=payt_691eeb9aV79Uk&authToken=ey...&redirectUrl=encoded_url"}},{"action":"poll","payload":{"url":"https://api.glomopay.com/api/v1/payment/payt_691eeb9aV79Uk","interval_in_ms":5000}}]},"id":"paths/~1payment/post/responses/201/content/application~1json/example"},"paths/~1payment/post/responses/400/content/application~1json/examples/missing_order_or_subscription":{"value":{"error":"Bad Request","message":"order_id or subscription_id is required"},"key":"missing_order_or_subscription","summary":"Missing order_id or subscription_id","id":"paths/~1payment/post/responses/400/content/application~1json/examples/missing_order_or_subscription"},"paths/~1payment/post/responses/400/content/application~1json/examples/duplicate_request_id":{"value":{"error":"Bad Request","message":"Payment already exists for this request_id"},"key":"duplicate_request_id","summary":"Duplicate request_id","id":"paths/~1payment/post/responses/400/content/application~1json/examples/duplicate_request_id"},"paths/~1payment/post/responses/400/content/application~1json/examples/split_ids_on_fixed_frequency":{"value":{"error":"Bad Request","message":"split_ids are only supported for as_presented subscriptions"},"key":"split_ids_on_fixed_frequency","summary":"split_ids sent for a fixed-frequency subscription","id":"paths/~1payment/post/responses/400/content/application~1json/examples/split_ids_on_fixed_frequency"},"paths/~1payment/post/responses/400/content/application~1json/examples/subscription_declaration_stale":{"value":{"error":"Bad Request","message":"Declared fee splits on the subscription no longer point at a live dynamic rule: psplit_7Kq2mXbTdLp9. Pass a valid split_id to override."},"key":"subscription_declaration_stale","summary":"The subscription's own declaration no longer resolves and no override was passed","id":"paths/~1payment/post/responses/400/content/application~1json/examples/subscription_declaration_stale"},"paths/~1payment/post/responses/400/content/application~1json/examples/split_ids_unresolved":{"value":{"error":"Bad Request","message":"Validation failed: Split ids are invalid or no longer point at a dynamic rule: psplit_7Kq2mXbTdLp9"},"key":"split_ids_unresolved","summary":"A split id does not resolve to a live dynamic rule","id":"paths/~1payment/post/responses/400/content/application~1json/examples/split_ids_unresolved"},"paths/~1payment~1mock/post/requestBody/content/application~1json/examples/matched_transfer":{"value":{"payin_id":"order_678a4c88hpAjf","transfer_type":"local"},"key":"matched_transfer","summary":"Mock success for a payin","id":"paths/~1payment~1mock/post/requestBody/content/application~1json/examples/matched_transfer"},"paths/~1payment~1mock/post/requestBody/content/application~1json/examples/amount_mismatch":{"value":{"payin_id":"order_678a4c88hpAjf","transfer_type":"local","amount":12000},"key":"amount_mismatch","summary":"Amount mismatch","id":"paths/~1payment~1mock/post/requestBody/content/application~1json/examples/amount_mismatch"},"paths/~1payment~1mock/post/requestBody/content/application~1json/examples/unmatched_transfer":{"value":{"amount":10000,"currency":"USD","transfer_type":"local"},"key":"unmatched_transfer","summary":"Payin not found","id":"paths/~1payment~1mock/post/requestBody/content/application~1json/examples/unmatched_transfer"},"paths/~1payment~1mock/post/requestBody/content/application~1json/examples/sanctions_hit":{"value":{"payin_id":"order_68f1c1d0sQ4nK","transfer_type":"local"},"key":"sanctions_hit","summary":"Sanctions hit (payin quoted at 6623)","id":"paths/~1payment~1mock/post/requestBody/content/application~1json/examples/sanctions_hit"},"paths/~1payment~1mock/post/responses/201/content/application~1json/examples/matched_transfer":{"value":{"id":"payt_68f1c2a4mK7tQ","compliance_status":null,"payin_id":"order_678a4c88hpAjf","payin_type":"orders","customer_id":"cust_E602dMzgjpDC","merchant_id":"merch_68c777fcOOMpl","subscription_id":null,"product_name":null,"product_description":null,"status":"success","payment_amount":10000,"payment_currency":"AED","converted_amount":10000,"converted_currency":"AED","requested_amount":10000,"requested_currency":"AED","purpose_code":"P1401","sender_name":"John Doe","paid_at":"2026-10-14T06:30:00Z","country":"ARE","fees":{"txn_fee":{"currency":"AED","amount":0},"fx_fee":{"currency":"AED","amount":0},"referral_fee":{"currency":"AED","amount":0}},"documents":[],"payment_method":{"type":"bank_transfer","details":{"sender_name":"John Doe","sender_account_number":"123456789012","receiver_account_number":"AE070331234567890123456","sender_country":"ARE","sender_bank_name":null,"sender_bank_country":null,"sender_bank_address":null,"swift_code":"XKQPAE4T","local_routing_number":null,"external_reference":"GLMHPAJF","transfer_type":"local"}},"fee_bearer":"merchant","fee_collection_mode":null,"settlement_id":null,"error_code":null,"error_description":null,"customer_error_description":null,"fee_breakdown":{"fx_fee":[],"txn_fee":[],"referral_fee":[]},"created_at":"2026-10-14T06:30:00Z","updated_at":"2026-10-14T06:30:00Z","funds_available":true,"payer_relationship":null,"nre_nro_declaration":null,"notes":{},"batch_id":null,"request_id":null,"credited_to_beneficiary":false},"key":"matched_transfer","summary":"Mock success for a payin","id":"paths/~1payment~1mock/post/responses/201/content/application~1json/examples/matched_transfer"},"paths/~1payment~1mock/post/responses/201/content/application~1json/examples/amount_mismatch":{"value":{"id":"payt_68f1c2b9pR2wX","compliance_status":null,"payin_id":"order_678a4c88hpAjf","payin_type":"orders","customer_id":"cust_E602dMzgjpDC","merchant_id":"merch_68c777fcOOMpl","subscription_id":null,"product_name":null,"product_description":null,"status":"action_required","payment_amount":12000,"payment_currency":"AED","converted_amount":12000,"converted_currency":"AED","requested_amount":12000,"requested_currency":"AED","purpose_code":"P1401","sender_name":"John Doe","paid_at":null,"country":"ARE","fees":{"txn_fee":{"currency":"AED","amount":0},"fx_fee":{"currency":"AED","amount":0},"referral_fee":{"currency":"AED","amount":0}},"documents":[],"payment_method":{"type":"bank_transfer","details":{"sender_name":"John Doe","sender_account_number":"123456789012","receiver_account_number":"AE070331234567890123456","sender_country":"ARE","sender_bank_name":null,"sender_bank_country":null,"sender_bank_address":null,"swift_code":"XKQPAE4T","local_routing_number":null,"external_reference":"GLMHPAJF","transfer_type":"local"}},"fee_bearer":"merchant","fee_collection_mode":null,"settlement_id":null,"error_code":"PAYIN_AMOUNT_MISMATCH","error_description":"The received payment amount does not match the order or payment link amount. Please create a new order or payment link for the exact received amount.","customer_error_description":"The payment amount does not match the expected amount. Please contact the merchant for assistance.","fee_breakdown":{"fx_fee":[],"txn_fee":[],"referral_fee":[]},"created_at":"2026-10-14T06:30:00Z","updated_at":"2026-10-14T06:30:00Z","funds_available":false,"payer_relationship":null,"nre_nro_declaration":null,"notes":{},"batch_id":null,"request_id":null,"credited_to_beneficiary":false},"key":"amount_mismatch","summary":"Amount mismatch","id":"paths/~1payment~1mock/post/responses/201/content/application~1json/examples/amount_mismatch"},"paths/~1payment~1mock/post/responses/201/content/application~1json/examples/unmatched_transfer":{"value":{"id":"payt_68f1c2c3hN5vB","compliance_status":null,"payin_id":null,"payin_type":null,"customer_id":null,"merchant_id":"merch_68c777fcOOMpl","subscription_id":null,"product_name":null,"product_description":null,"status":"action_required","payment_amount":10000,"payment_currency":"USD","converted_amount":10000,"converted_currency":"USD","requested_amount":10000,"requested_currency":"USD","purpose_code":null,"sender_name":"mock sender","paid_at":null,"country":"USA","fees":{"txn_fee":{"currency":"USD","amount":0},"fx_fee":{"currency":"USD","amount":0},"referral_fee":{"currency":"USD","amount":0}},"documents":[],"payment_method":{"type":"bank_transfer","details":{"sender_name":"mock sender","sender_account_number":"123456789012","receiver_account_number":"AE070331234567890123456","sender_country":"USA","sender_bank_name":null,"sender_bank_country":null,"sender_bank_address":null,"swift_code":"MQZTUS7K","local_routing_number":null,"external_reference":null,"transfer_type":"local"}},"fee_bearer":"merchant","fee_collection_mode":null,"settlement_id":null,"error_code":"PAYIN_NOT_FOUND","error_description":"The incoming payment could not be automatically matched to an existing order or payment link. Please match it manually or create a new order for the received amount.","customer_error_description":"Your payment could not be matched to an existing order. Please contact the merchant for assistance.","fee_breakdown":{"fx_fee":[],"txn_fee":[],"referral_fee":[]},"created_at":"2026-10-14T06:30:00Z","updated_at":"2026-10-14T06:30:00Z","funds_available":false,"payer_relationship":null,"nre_nro_declaration":null,"notes":{},"batch_id":null,"request_id":null,"credited_to_beneficiary":false},"key":"unmatched_transfer","summary":"Payin not found","id":"paths/~1payment~1mock/post/responses/201/content/application~1json/examples/unmatched_transfer"},"paths/~1payment~1mock/post/responses/201/content/application~1json/examples/sanctions_hit":{"value":{"id":"payt_68f1c2d8tE6yM","compliance_status":null,"payin_id":"order_68f1c1d0sQ4nK","payin_type":"orders","customer_id":"cust_E602dMzgjpDC","merchant_id":"merch_68c777fcOOMpl","subscription_id":null,"product_name":null,"product_description":null,"status":"action_required","payment_amount":6623,"payment_currency":"AED","converted_amount":6623,"converted_currency":"AED","requested_amount":6623,"requested_currency":"AED","purpose_code":"P1401","sender_name":"John Doe","paid_at":null,"country":"ARE","fees":{"txn_fee":{"currency":"AED","amount":0},"fx_fee":{"currency":"AED","amount":0},"referral_fee":{"currency":"AED","amount":0}},"documents":[],"payment_method":{"type":"bank_transfer","details":{"sender_name":"John Doe","sender_account_number":"123456789012","receiver_account_number":"AE070331234567890123456","sender_country":"ARE","sender_bank_name":null,"sender_bank_country":null,"sender_bank_address":null,"swift_code":"XKQPAE4T","local_routing_number":null,"external_reference":"GLMSQ4NK","transfer_type":"local"}},"fee_bearer":"merchant","fee_collection_mode":null,"settlement_id":null,"error_code":"SANCTION_HIT","error_description":"This payment requires additional verification. Please contact support for assistance.","customer_error_description":"This payment requires additional verification. Please contact support for assistance.","fee_breakdown":{"fx_fee":[],"txn_fee":[],"referral_fee":[]},"created_at":"2026-10-14T06:30:00Z","updated_at":"2026-10-14T06:30:00Z","funds_available":false,"payer_relationship":null,"nre_nro_declaration":null,"notes":{},"batch_id":null,"request_id":null,"credited_to_beneficiary":false},"key":"sanctions_hit","summary":"Sanctions hit","id":"paths/~1payment~1mock/post/responses/201/content/application~1json/examples/sanctions_hit"},"paths/~1payment~1mock/post/responses/400/content/application~1json/examples/currency_with_payin":{"value":{"error":"Bad Request","message":"Validation failed: Currency can't be sent when payin_id is given"},"key":"currency_with_payin","summary":"currency sent with payin_id","id":"paths/~1payment~1mock/post/responses/400/content/application~1json/examples/currency_with_payin"},"paths/~1payment~1mock/post/responses/400/content/application~1json/examples/no_virtual_account":{"value":{"error":"Bad Request","message":"No active local virtual account for this payment"},"key":"no_virtual_account","summary":"No virtual account for the transfer","id":"paths/~1payment~1mock/post/responses/400/content/application~1json/examples/no_virtual_account"},"paths/~1payment~1{id}~1eligible-payins/get/responses/200/content/application~1json/examples/eligible":{"value":{"payment_id":"payt_6aad0bc0cZtlS","payment_amount":10000,"payment_currency":"AED","eligible_payins":[{"payin_id":"plink_6aad0ec19b3bT","payin_status":"pending","payin_type":"payment_link","amount":2723,"currency":"USD","customer_id":"cust_69eb2cf0FYSDF","invoice_number":"R0001","reference_number":"RG12FF590","created_at":"2026-09-18T10:38:19.237Z"}]},"key":"eligible","summary":"One eligible payin","id":"paths/~1payment~1{id}~1eligible-payins/get/responses/200/content/application~1json/examples/eligible"},"paths/~1payment~1{id}~1eligible-payins/get/responses/200/content/application~1json/examples/none":{"value":{"payment_id":"payt_6aad0bc0cZtlS","payment_amount":10000,"payment_currency":"AED","eligible_payins":[]},"key":"none","summary":"No eligible payin","id":"paths/~1payment~1{id}~1eligible-payins/get/responses/200/content/application~1json/examples/none"},"paths/~1payment~1{id}~1connect-payin/post/responses/200/content/application~1json/example":{"value":{"id":"payt_6aad0bc0cZtlS","payin_id":"plink_6aad0ec19b3bT","payin_type":"payment_link","status":"success","payment_currency":"AED","payment_amount":10000,"converted_currency":"USD","converted_amount":2723,"sender_name":"John Doe","paid_at":"2026-09-18T10:41:02.118Z","created_at":"2026-09-18T10:38:19.237Z","updated_at":"2026-09-18T10:41:02.118Z","customer_id":"cust_69eb2cf0FYSDF","merchant_id":"merch_68c777fcOOMpl","fee_bearer":"merchant","payment_method":{"type":"bank_transfer","details":{"sender_name":"John Doe","sender_account_number":"5454545454","receiver_account_number":"98765432109876","sender_country":"ARE","sender_bank_name":"EMIRATES NBD BANK PJSC","sender_bank_country":"ARE","swift_code":"EBILAEAD","local_routing_number":null,"external_reference":"GLM7A2C1","transfer_type":"swift"}}},"id":"paths/~1payment~1{id}~1connect-payin/post/responses/200/content/application~1json/example"},"paths/~1refunds/post/responses/400/content/application~1json/examples/refund_in_progress":{"value":{"message":"Refund is already in progress."},"key":"refund_in_progress","summary":"Refund already in progress","id":"paths/~1refunds/post/responses/400/content/application~1json/examples/refund_in_progress"},"paths/~1refunds/post/responses/400/content/application~1json/examples/duplicate_request_id":{"value":{"error":"Bad Request","message":"Refund already exists for this request_id"},"key":"duplicate_request_id","summary":"Duplicate request_id","id":"paths/~1refunds/post/responses/400/content/application~1json/examples/duplicate_request_id"},"paths/~1prices~1dynamic/get/responses/200/content/application~1json/example":{"value":{"data":[{"id":"price_5JU9yv0lGSUP","fee_type":"transaction_fees","payment_type":"payin","pricing_type":"percentage","payment_rail":"swift","from_currency":"USD","bps":300,"fees_amount":null,"fees_currency":null,"min_fee":100,"max_fee":2000,"min_max_fee_currency":"USD","display_label":"Processing fee","effective_from":"2026-07-01","payment_method":{"type":"bank_transfer","subtype":"swift_transfer"}},{"id":"price_Kd82nvQ1TzAe","fee_type":"transaction_fees","payment_type":"payin","pricing_type":"fixed","payment_rail":"card","from_currency":"USD","bps":null,"fees_amount":500,"fees_currency":"USD","min_fee":null,"max_fee":null,"min_max_fee_currency":null,"display_label":"Card processing fee","effective_from":"2026-07-15","payment_method":{"type":"card","subtype":null}}],"page_meta":{"current":1,"previous":null,"next":null,"per_page":20,"pages":1,"count":2}},"id":"paths/~1prices~1dynamic/get/responses/200/content/application~1json/example"},"paths/~1prices~1dynamic-splits/post/requestBody/content/application~1json/examples/percentage_split":{"value":{"price_id":"price_5JU9yv0lGSUP","bps":150},"key":"percentage_split","summary":"Declare a share of a percentage rule","id":"paths/~1prices~1dynamic-splits/post/requestBody/content/application~1json/examples/percentage_split"},"paths/~1prices~1dynamic-splits/post/requestBody/content/application~1json/examples/percentage_split_with_bounds":{"value":{"price_id":"price_5JU9yv0lGSUP","bps":150,"min_fee":100,"max_fee":1000,"fee_currency":"USD"},"key":"percentage_split_with_bounds","summary":"Declare a share of a percentage rule with a floor and a cap","id":"paths/~1prices~1dynamic-splits/post/requestBody/content/application~1json/examples/percentage_split_with_bounds"},"paths/~1prices~1dynamic-splits/post/requestBody/content/application~1json/examples/fixed_split":{"value":{"price_id":"price_Kd82nvQ1TzAe","fixed_amount":200,"fee_currency":"USD"},"key":"fixed_split","summary":"Declare a share of a fixed rule","id":"paths/~1prices~1dynamic-splits/post/requestBody/content/application~1json/examples/fixed_split"},"paths/~1prices~1dynamic-splits/post/requestBody/content/application~1json/examples/customer_bears_whole_fee":{"value":{"price_id":"price_5JU9yv0lGSUP","bps":0},"key":"customer_bears_whole_fee","summary":"Declare a zero share, so the customer bears the whole fee","id":"paths/~1prices~1dynamic-splits/post/requestBody/content/application~1json/examples/customer_bears_whole_fee"},"paths/~1prices~1dynamic-splits/post/responses/201/content/application~1json/example":{"value":{"id":"psplit_7Kq2mXbTdLp9","price_id":"price_5JU9yv0lGSUP","bps":150,"fixed_amount":null,"min_fee":100,"max_fee":1000,"fee_currency":"USD","created_at":"2026-08-01T09:12:44Z","updated_at":"2026-08-01T09:12:44Z"},"id":"paths/~1prices~1dynamic-splits/post/responses/201/content/application~1json/example"},"paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/price_id_missing":{"value":{"error":"Bad Request","message":"Price id can't be blank"},"key":"price_id_missing","summary":"price_id omitted","id":"paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/price_id_missing"},"paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/price_id_not_found":{"value":{"error":"Bad Request","message":"price_id not found"},"key":"price_id_not_found","summary":"price_id does not exist or belongs to another business","id":"paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/price_id_not_found"},"paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/not_dynamic":{"value":{"error":"Bad Request","message":"price_id is not a dynamic-bearer rule"},"key":"not_dynamic","summary":"The rule's fee bearer is not dynamic","id":"paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/not_dynamic"},"paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/not_payin":{"value":{"error":"Bad Request","message":"dynamic splits are only supported for payin"},"key":"not_payin","summary":"The rule does not price a payin","id":"paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/not_payin"},"paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/not_transaction_fees":{"value":{"error":"Bad Request","message":"dynamic splits are only supported for transaction_fees"},"key":"not_transaction_fees","summary":"The rule does not price transaction fees","id":"paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/not_transaction_fees"},"paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/not_effective_yet":{"value":{"error":"Bad Request","message":"price_id is not effective yet"},"key":"not_effective_yet","summary":"The rule version is not effective yet","id":"paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/not_effective_yet"},"paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/superseded":{"value":{"error":"Bad Request","message":"price_id has been superseded by a newer version of the rule"},"key":"superseded","summary":"A newer version of the rule is effective","id":"paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/superseded"},"paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/neither_or_both":{"value":{"error":"Bad Request","message":"exactly one of bps or fixed_amount must be provided"},"key":"neither_or_both","summary":"Neither bps nor fixed_amount, or both","id":"paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/neither_or_both"},"paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/bps_required":{"value":{"error":"Bad Request","message":"bps is required for a percentage-priced rule"},"key":"bps_required","summary":"fixed_amount declared against a percentage rule","id":"paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/bps_required"},"paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/bps_exceeds_rule":{"value":{"error":"Bad Request","message":"bps cannot exceed the rule's total of 300"},"key":"bps_exceeds_rule","summary":"Declared bps exceeds the rule's own bps","id":"paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/bps_exceeds_rule"},"paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/fixed_amount_required":{"value":{"error":"Bad Request","message":"fixed_amount is required for a fixed-priced rule"},"key":"fixed_amount_required","summary":"bps declared against a fixed rule","id":"paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/fixed_amount_required"},"paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/fixed_amount_exceeds_rule":{"value":{"error":"Bad Request","message":"fixed_amount cannot exceed the rule's total"},"key":"fixed_amount_exceeds_rule","summary":"Declared fixed_amount exceeds the rule's own fees_amount","id":"paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/fixed_amount_exceeds_rule"},"paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/fee_currency_mismatch":{"value":{"error":"Bad Request","message":"fee_currency must be USD to match the rule"},"key":"fee_currency_mismatch","summary":"fee_currency does not match a fixed rule's currency","id":"paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/fee_currency_mismatch"},"paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/bounds_on_fixed_rule":{"value":{"error":"Bad Request","message":"min_fee and max_fee are not supported for a fixed-priced rule"},"key":"bounds_on_fixed_rule","summary":"min_fee or max_fee declared against a fixed rule","id":"paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/bounds_on_fixed_rule"},"paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/bound_without_currency":{"value":{"error":"Bad Request","message":"fee_currency is required when a bound is declared"},"key":"bound_without_currency","summary":"min_fee or max_fee declared without fee_currency","id":"paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/bound_without_currency"},"paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/min_fee_above_max_fee":{"value":{"error":"Bad Request","message":"min_fee must be less than or equal to max_fee"},"key":"min_fee_above_max_fee","summary":"min_fee greater than max_fee","id":"paths/~1prices~1dynamic-splits/post/responses/400/content/application~1json/examples/min_fee_above_max_fee"},"paths/~1prices~1dynamic-splits/get/responses/200/content/application~1json/example":{"value":{"data":[{"id":"psplit_7Kq2mXbTdLp9","price_id":"price_5JU9yv0lGSUP","bps":150,"fixed_amount":null,"min_fee":100,"max_fee":1000,"fee_currency":"USD","created_at":"2026-08-01T09:12:44Z","updated_at":"2026-08-01T09:12:44Z"},{"id":"psplit_Q3vTn8LcRb2W","price_id":"price_Kd82nvQ1TzAe","bps":null,"fixed_amount":200,"min_fee":null,"max_fee":null,"fee_currency":"USD","created_at":"2026-08-02T11:04:09Z","updated_at":"2026-08-02T11:04:09Z"}],"page_meta":{"current":1,"previous":null,"next":null,"per_page":20,"pages":1,"count":2}},"id":"paths/~1prices~1dynamic-splits/get/responses/200/content/application~1json/example"},"paths/~1payment-sessions/post/requestBody/content/application~1json/examples/anonymous":{"value":{},"key":"anonymous","summary":"Anonymous session","id":"paths/~1payment-sessions/post/requestBody/content/application~1json/examples/anonymous"},"paths/~1payment-sessions/post/requestBody/content/application~1json/examples/with_email":{"value":{"email":"john.doe@example.com"},"key":"with_email","summary":"With customer email","id":"paths/~1payment-sessions/post/requestBody/content/application~1json/examples/with_email"},"paths/~1payment-sessions/post/requestBody/content/application~1json/examples/with_customer_id":{"value":{"customer_id":"cust_abc123XYZ"},"key":"with_customer_id","summary":"With existing customer ID","id":"paths/~1payment-sessions/post/requestBody/content/application~1json/examples/with_customer_id"},"paths/~1payment-sessions/post/requestBody/content/application~1json/examples/with_kyc_prefill_v1":{"value":{"email":"john.doe@example.com","kyc":{"pan":"ABCPE1234F","phone":"9876543210","country":"IND","dob":"1990-05-12"}},"key":"with_kyc_prefill_v1","summary":"Prefill KYC — top-level kyc object (v1)","id":"paths/~1payment-sessions/post/requestBody/content/application~1json/examples/with_kyc_prefill_v1"},"paths/~1payment-sessions/post/requestBody/content/application~1json/examples/with_kyc_prefill_v2":{"value":{"email":"john.doe@example.com","data":{"kyc":{"pan":"ABCPE1234F","phone":"9876543210","country":"IND","dob":"1990-05-12"}}},"key":"with_kyc_prefill_v2","summary":"Prefill KYC — nested under data (v2, recommended)","id":"paths/~1payment-sessions/post/requestBody/content/application~1json/examples/with_kyc_prefill_v2"},"paths/~1payment-sessions/post/requestBody/content/application~1json/examples/with_scheme_prefill":{"value":{"email":"john.doe@example.com","data":{"scheme":{"plan":"regular","amount":500000,"currency":"USD","distributor_arn":"ARN12345"}}},"key":"with_scheme_prefill","summary":"Prefill scheme plan and amount","id":"paths/~1payment-sessions/post/requestBody/content/application~1json/examples/with_scheme_prefill"},"paths/~1payment-sessions/post/requestBody/content/application~1json/examples/with_scheme_code":{"value":{"email":"john.doe@example.com","data":{"scheme":{"scheme_code":"SCH001","amount":500000,"currency":"USD"},"kyc":{"pan":"ABCPE1234F"}}},"key":"with_scheme_code","summary":"Session for a named scheme (scheme_code)","id":"paths/~1payment-sessions/post/requestBody/content/application~1json/examples/with_scheme_code"},"paths/~1payment-sessions/post/responses/201/content/application~1json/example":{"value":{"id":"psess_6819d8046mpKt","status":"active","session_type":"kyc_lrs","token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...","expires_at":"2026-05-07T10:30:00Z"},"id":"paths/~1payment-sessions/post/responses/201/content/application~1json/example"},"paths/~1distributor-links/post/requestBody/content/application~1json/example":{"value":{"scheme_code":"SCH001","amount":500000},"id":"paths/~1distributor-links/post/requestBody/content/application~1json/example"},"paths/~1distributor-links/post/responses/201/content/application~1json/example":{"value":{"id":"shl_q6af9kKWKaXV4LH8XNVliBrc","link_type":"payment_session","url":"https://pay.example-fund.com/shared-link/shl_q6af9kKWKaXV4LH8XNVliBrc","status":"active","details":{"fund_name":"Example Fund","scheme_code":"SCH001","scheme_name":"Example Global Equity Fund","plan":"regular","distributor_name":"Example Distributor","distributor_arn":"ARN-123456","amount":500000},"openings_count":0,"created_at":"2026-10-09T10:30:00Z"},"id":"paths/~1distributor-links/post/responses/201/content/application~1json/example"},"paths/~1customer~1{id}~1bank_account/post/requestBody/content/application~1json/example":{"value":{"bank_code":"hdfc","account_number":"12345678901234","bank_customer_id":"12345678"},"id":"paths/~1customer~1{id}~1bank_account/post/requestBody/content/application~1json/example"},"paths/~1customer~1{id}~1bank_account/post/responses/201/content/application~1json/example":{"value":{"id":"acclrs_68468c03g9xt7","bank_code":"hdfc","account_number":"12345678901234","bank_customer_id":"12345678"},"id":"paths/~1customer~1{id}~1bank_account/post/responses/201/content/application~1json/example"},"paths/~1customer~1{id}~1bank_account/post/responses/400/content/application~1json/examples/account_number_missing":{"value":{"error":"Bad Request","message":"Validation failed: Account number can't be blank"},"key":"account_number_missing","summary":"account_number missing","id":"paths/~1customer~1{id}~1bank_account/post/responses/400/content/application~1json/examples/account_number_missing"},"paths/~1customer~1{id}~1bank_account/post/responses/400/content/application~1json/examples/bank_code_not_valid":{"value":{"error":"Bad Request","message":"Validation failed: Bank code HDFC is not a valid bank code"},"key":"bank_code_not_valid","summary":"bank_code is not a supported bank","id":"paths/~1customer~1{id}~1bank_account/post/responses/400/content/application~1json/examples/bank_code_not_valid"},"paths/~1customer~1{id}~1bank_account/post/responses/400/content/application~1json/examples/bank_code_not_enabled":{"value":{"error":"Bad Request","message":"Validation failed: Bank code axis is not enabled for your business"},"key":"bank_code_not_enabled","summary":"Bank not enabled for your account","id":"paths/~1customer~1{id}~1bank_account/post/responses/400/content/application~1json/examples/bank_code_not_enabled"},"paths/~1customer~1{id}~1bank_account/post/responses/400/content/application~1json/examples/bank_customer_id_not_digits":{"value":{"error":"Bad Request","message":"Validation failed: Bank customer ID must contain only digits"},"key":"bank_customer_id_not_digits","summary":"bank_customer_id contains a non-digit","id":"paths/~1customer~1{id}~1bank_account/post/responses/400/content/application~1json/examples/bank_customer_id_not_digits"},"paths/~1customer~1{id}~1bank_account/post/responses/400/content/application~1json/examples/customer_not_found":{"value":{"error":"Bad Request","message":"Customer does not exist"},"key":"customer_not_found","summary":"Customer does not exist on your account","id":"paths/~1customer~1{id}~1bank_account/post/responses/400/content/application~1json/examples/customer_not_found"},"paths/~1customer~1{id}~1bank_account/post/responses/400/content/application~1json/examples/duplicate_account":{"value":{"error":"Bad Request","message":"Bank account already exists"},"key":"duplicate_account","summary":"Account already registered at the same bank","id":"paths/~1customer~1{id}~1bank_account/post/responses/400/content/application~1json/examples/duplicate_account"},"paths/~1customer~1{id}~1bank_account/get/responses/200/content/application~1json/example":{"value":[{"id":"acclrs_68468c03g9xt7","bank_code":"hdfc","account_number":"12345678901234","bank_customer_id":"12345678"}],"id":"paths/~1customer~1{id}~1bank_account/get/responses/200/content/application~1json/example"},"paths/~1customer~1{id}~1bank_account~1{bank_account_id}/get/responses/200/content/application~1json/example":{"value":{"id":"acclrs_68468c03g9xt7","bank_code":"hdfc","account_number":"12345678901234","bank_customer_id":"12345678"},"id":"paths/~1customer~1{id}~1bank_account~1{bank_account_id}/get/responses/200/content/application~1json/example"},"paths/~1customer~1{id}~1bank_account~1{bank_account_id}/patch/requestBody/content/application~1json/example":{"value":{"bank_customer_id":"12345678"},"id":"paths/~1customer~1{id}~1bank_account~1{bank_account_id}/patch/requestBody/content/application~1json/example"},"paths/~1customer~1{id}~1bank_account~1{bank_account_id}/patch/responses/200/content/application~1json/example":{"value":{"id":"acclrs_68468c03g9xt7","bank_code":"hdfc","account_number":"12345678901234","bank_customer_id":"12345678"},"id":"paths/~1customer~1{id}~1bank_account~1{bank_account_id}/patch/responses/200/content/application~1json/example"},"paths/~1customer~1{id}~1bank_account~1{bank_account_id}/patch/responses/400/content/application~1json/examples/customer_not_found":{"value":{"error":"Bad Request","message":"Customer does not exist"},"key":"customer_not_found","summary":"Customer does not exist on your account","id":"paths/~1customer~1{id}~1bank_account~1{bank_account_id}/patch/responses/400/content/application~1json/examples/customer_not_found"},"paths/~1customer~1{id}~1bank_account~1{bank_account_id}/patch/responses/400/content/application~1json/examples/bank_customer_id_missing":{"value":{"error":"Bad Request","message":"Bank customer id can't be blank"},"key":"bank_customer_id_missing","summary":"bank_customer_id missing for a bank that uses one","id":"paths/~1customer~1{id}~1bank_account~1{bank_account_id}/patch/responses/400/content/application~1json/examples/bank_customer_id_missing"},"paths/~1customer~1{id}~1bank_account~1{bank_account_id}/patch/responses/400/content/application~1json/examples/bank_customer_id_not_digits":{"value":{"error":"Bad Request","message":"Bank Customer ID must contain only digits"},"key":"bank_customer_id_not_digits","summary":"bank_customer_id contains a non-digit","id":"paths/~1customer~1{id}~1bank_account~1{bank_account_id}/patch/responses/400/content/application~1json/examples/bank_customer_id_not_digits"},"paths/~1lrs~1quotes/post/requestBody/content/application~1json/examples/payin_inr_to_usd":{"value":{"bank_code":"hdfc","source_amount":4400000,"source_currency":"INR","target_currency":"USD"},"key":"payin_inr_to_usd","summary":"Payin quote from INR to USD","id":"paths/~1lrs~1quotes/post/requestBody/content/application~1json/examples/payin_inr_to_usd"},"paths/~1lrs~1quotes/post/requestBody/content/application~1json/examples/payout_usd_to_inr":{"value":{"resource":"payout","source_amount":1000000,"source_currency":"USD","target_currency":"INR"},"key":"payout_usd_to_inr","summary":"Payout quote from USD to INR","id":"paths/~1lrs~1quotes/post/requestBody/content/application~1json/examples/payout_usd_to_inr"},"paths/~1lrs~1quotes/post/responses/201/content/application~1json/examples/payin_inr_to_usd":{"value":{"id":"quote_6ab60de4Kx7Pq","from":{"amount":4400000,"currency":"INR"},"to":{"amount":51763,"currency":"USD"},"fx_rate":"84.85","bank_code":"hdfc","total_tax":7906,"expires_at":"2026-09-25T06:30:04.113Z","created_at":"2026-09-25T06:00:04.113Z"},"key":"payin_inr_to_usd","summary":"Payin quote from INR to USD","id":"paths/~1lrs~1quotes/post/responses/201/content/application~1json/examples/payin_inr_to_usd"},"paths/~1lrs~1quotes/post/responses/201/content/application~1json/examples/payout_usd_to_inr":{"value":{"id":"quote_6ab4e690Rt3Vm","from":{"amount":1000000,"currency":"USD"},"to":{"amount":93953000,"currency":"INR"},"fx_rate":"94.0","total_tax":47000,"expires_at":"2026-09-24T09:30:00.412Z","created_at":"2026-09-24T09:00:00.412Z"},"key":"payout_usd_to_inr","summary":"Payout quote from USD to INR","id":"paths/~1lrs~1quotes/post/responses/201/content/application~1json/examples/payout_usd_to_inr"},"paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/bank_code_missing":{"value":{"error":"Bad Request","message":"Validation failed: Bank code can't be blank"},"key":"bank_code_missing","summary":"bank_code missing on a payin quote","id":"paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/bank_code_missing"},"paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/bank_code_not_enabled":{"value":{"error":"Bad Request","message":"Validation failed: Bank code icici is not enabled for your business"},"key":"bank_code_not_enabled","summary":"Bank not enabled for your account","id":"paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/bank_code_not_enabled"},"paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/currency_not_supported":{"value":{"error":"Bad Request","message":"Validation failed: Source currency is not supported"},"key":"currency_not_supported","summary":"Currency other than INR or USD","id":"paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/currency_not_supported"},"paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/same_currency":{"value":{"error":"Bad Request","message":"Validation failed: source_currency and target_currency cannot be the same"},"key":"same_currency","summary":"source_currency equals target_currency","id":"paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/same_currency"},"paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/amount_not_integer":{"value":{"error":"Bad Request","message":"Validation failed: Source amount must be an integer"},"key":"amount_not_integer","summary":"source_amount is not a whole number","id":"paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/amount_not_integer"},"paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/below_minimum":{"value":{"error":"Bad Request","message":"Amount 100.00 INR is below minimum limit. (Minimum limit is 10.00 USD)"},"key":"below_minimum","summary":"Amount below the bank's minimum","id":"paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/below_minimum"},"paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/above_maximum":{"value":{"error":"Bad Request","message":"Amount 5,000,000.00 INR exceeds maximum limit. (Maximum limit is 50,000.00 USD)"},"key":"above_maximum","summary":"Amount above the bank's maximum","id":"paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/above_maximum"},"paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/bank_code_on_payout":{"value":{"error":"Bad Request","message":"Validation failed: Bank code is not supported for payout quotes"},"key":"bank_code_on_payout","summary":"bank_code sent on a payout quote","id":"paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/bank_code_on_payout"},"paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/payout_corridor":{"value":{"error":"Bad Request","message":"Validation failed: payout quotes are only supported from USD to INR"},"key":"payout_corridor","summary":"Payout quote other than USD to INR","id":"paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/payout_corridor"},"paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/payout_no_options":{"value":{"error":"Bad Request","message":"No available options for this amount"},"key":"payout_no_options","summary":"Payout amount outside the range a payout can be sent for","id":"paths/~1lrs~1quotes/post/responses/400/content/application~1json/examples/payout_no_options"},"paths/~1lrs~1quotes~1{id}/get/responses/200/content/application~1json/example":{"value":{"id":"quote_6ab60de4Kx7Pq","from":{"amount":4400000,"currency":"INR"},"to":{"amount":51763,"currency":"USD"},"fx_rate":"84.85","bank_code":"hdfc","total_tax":7906,"expires_at":"2026-09-25T06:30:04.113Z","created_at":"2026-09-25T06:00:04.113Z"},"id":"paths/~1lrs~1quotes~1{id}/get/responses/200/content/application~1json/example"},"paths/~1lrs~1banks/get/responses/200/content/application~1json/example":{"value":[{"bank_code":"hdfc","bank_name":"HDFC bank"},{"bank_code":"axis","bank_name":"Axis bank"}],"id":"paths/~1lrs~1banks/get/responses/200/content/application~1json/example"},"paths/~1subscriptions/post/requestBody/content/application~1json/examples/monthly_subscription":{"value":{"customer_id":"cust_5JU9yv0lGSUP","product_name":"ShieldGuard Insurance","product_description":"Flexible monthly insurance for belongings travel and digital assets easy to manage","plan_name":"ShieldGuard Lite","plan_description":"Simple, monthly insurance plan that covers your basic belongings and key digital assets","amount":1000,"currency":"USD","interval_type":"month","interval_count":1,"billing_cycles":12,"start_date":"2025-01-01","expires_at":"2026-10-15","notify_customer":true,"starts_with_first_payment":true},"key":"monthly_subscription","summary":"Standard monthly subscription","id":"paths/~1subscriptions/post/requestBody/content/application~1json/examples/monthly_subscription"},"paths/~1subscriptions/post/requestBody/content/application~1json/examples/as_presented_subscription":{"value":{"customer_id":"cust_5JU9yv0lGSUP","product_name":"ShieldGuard Insurance","product_description":"Flexible insurance for belongings easy to manage","plan_name":"ShieldGuard Lite","plan_description":"Subscription with flexible billing intervals","amount":1000,"max_amount":5000,"currency":"USD","interval_type":"as_presented","expires_at":"2026-10-15","notify_customer":true,"starts_with_first_payment":true},"key":"as_presented_subscription","summary":"Subscription with as_presented interval (flexible billing, merchant-initiated subsequent payments)","id":"paths/~1subscriptions/post/requestBody/content/application~1json/examples/as_presented_subscription"},"paths/~1subscriptions/post/requestBody/content/application~1json/examples/as_presented_subscription_with_splits":{"value":{"customer_id":"cust_5JU9yv0lGSUP","product_name":"ShieldGuard Insurance","product_description":"Flexible insurance for belongings easy to manage","plan_name":"ShieldGuard Lite","plan_description":"Subscription with flexible billing intervals","amount":1000,"max_amount":5000,"currency":"USD","interval_type":"as_presented","expires_at":"2026-10-15","notify_customer":true,"starts_with_first_payment":true,"split_ids":["psplit_7Kq2mXbTdLp9"]},"key":"as_presented_subscription_with_splits","summary":"as_presented subscription priced from a declared dynamic fee split","id":"paths/~1subscriptions/post/requestBody/content/application~1json/examples/as_presented_subscription_with_splits"},"paths/~1subscriptions/post/responses/400/content/application~1json/examples/customer_not_found":{"value":{"error":"Bad Request","message":"Customer not found"},"key":"customer_not_found","summary":"Customer not found","id":"paths/~1subscriptions/post/responses/400/content/application~1json/examples/customer_not_found"},"paths/~1subscriptions/post/responses/400/content/application~1json/examples/split_ids_on_fixed_frequency":{"value":{"error":"Bad Request","message":"Validation failed: Split ids are only supported for as_presented subscriptions"},"key":"split_ids_on_fixed_frequency","summary":"split_ids sent on a fixed-frequency subscription","id":"paths/~1subscriptions/post/responses/400/content/application~1json/examples/split_ids_on_fixed_frequency"},"paths/~1subscriptions/post/responses/400/content/application~1json/examples/split_ids_unresolved":{"value":{"error":"Bad Request","message":"Validation failed: Split ids are invalid or no longer point at a dynamic rule: psplit_7Kq2mXbTdLp9"},"key":"split_ids_unresolved","summary":"A split id does not resolve to a live dynamic rule","id":"paths/~1subscriptions/post/responses/400/content/application~1json/examples/split_ids_unresolved"},"paths/~1subscriptions/post/responses/400/content/application~1json/examples/split_ids_incomplete":{"value":{"error":"Bad Request","message":"Validation failed: Split ids must be declared for every dynamic rule on the dimension, missing rules: price_Kd82nvQ1TzAe"},"key":"split_ids_incomplete","summary":"Another dynamic rule on the same dimension is not declared","id":"paths/~1subscriptions/post/responses/400/content/application~1json/examples/split_ids_incomplete"},"paths/~1quotes/post/requestBody/content/application~1json/examples/payout_source_amount":{"value":{"resource":"payout","source_currency":"USD","destination_currency":"INR","source_amount":10000,"payment_method":{"type":"bank_transfer","subtype":"swift_transfer"}},"key":"payout_source_amount","summary":"Payout quote using source_amount","id":"paths/~1quotes/post/requestBody/content/application~1json/examples/payout_source_amount"},"paths/~1quotes/post/requestBody/content/application~1json/examples/payout_destination_amount":{"value":{"resource":"payout","source_currency":"USD","destination_currency":"INR","destination_amount":882000,"payment_method":{"type":"bank_transfer","subtype":"local_transfer"}},"key":"payout_destination_amount","summary":"Payout quote using destination_amount","id":"paths/~1quotes/post/requestBody/content/application~1json/examples/payout_destination_amount"},"paths/~1quotes/post/requestBody/content/application~1json/examples/payin_quote":{"value":{"resource":"payin","source_currency":"USD","destination_currency":"INR","source_amount":10000,"payment_method":{"type":"bank_transfer","subtype":"swift_transfer"},"price_id":"price_5JU9yv0lGSUP"},"key":"payin_quote","summary":"Payin quote with referral price","id":"paths/~1quotes/post/requestBody/content/application~1json/examples/payin_quote"},"paths/~1quotes/post/requestBody/content/application~1json/examples/payin_quote_with_splits":{"value":{"resource":"payin","source_currency":"USD","destination_currency":"INR","source_amount":10000,"payment_method":{"type":"bank_transfer","subtype":"swift_transfer"},"split_ids":["psplit_7Kq2mXbTdLp9"]},"key":"payin_quote_with_splits","summary":"Payin quote priced from a declared dynamic fee split","id":"paths/~1quotes/post/requestBody/content/application~1json/examples/payin_quote_with_splits"},"paths/~1quotes/post/requestBody/content/application~1json/examples/account_funding_quote":{"value":{"resource":"payin","resource_type":"account_funding","source_currency":"AED","destination_currency":"USD","destination_amount":100000,"payment_method":{"type":"card"}},"key":"account_funding_quote","summary":"Account funding quote paid by card","id":"paths/~1quotes/post/requestBody/content/application~1json/examples/account_funding_quote"},"paths/~1quotes/post/responses/400/content/application~1json/examples/both_amounts":{"value":{"error":"Bad Request","message":"Either source_amount or destination_amount must be provided, not both"},"key":"both_amounts","summary":"Both amounts specified","id":"paths/~1quotes/post/responses/400/content/application~1json/examples/both_amounts"},"paths/~1quotes/post/responses/400/content/application~1json/examples/missing_payment_method":{"value":{"error":"Bad Request","message":"payment_method is required"},"key":"missing_payment_method","summary":"payment_method object missing","id":"paths/~1quotes/post/responses/400/content/application~1json/examples/missing_payment_method"},"paths/~1quotes/post/responses/400/content/application~1json/examples/missing_type":{"value":{"error":"Bad Request","message":"payment_method.type is required"},"key":"missing_type","summary":"payment_method.type missing","id":"paths/~1quotes/post/responses/400/content/application~1json/examples/missing_type"},"paths/~1quotes/post/responses/400/content/application~1json/examples/missing_subtype":{"value":{"error":"Bad Request","message":"payment_method.subtype is required"},"key":"missing_subtype","summary":"payment_method.subtype missing on a method that requires one","id":"paths/~1quotes/post/responses/400/content/application~1json/examples/missing_subtype"},"paths/~1quotes/post/responses/400/content/application~1json/examples/subtype_on_card":{"value":{"error":"Bad Request","message":"payment_method.subtype is not supported for card"},"key":"subtype_on_card","summary":"A subtype sent with card, which takes none","id":"paths/~1quotes/post/responses/400/content/application~1json/examples/subtype_on_card"},"paths/~1quotes/post/responses/400/content/application~1json/examples/unsupported_payment_method":{"value":{"error":"Bad Request","message":"'wallet' is not a supported payment method"},"key":"unsupported_payment_method","summary":"Unsupported payment method","id":"paths/~1quotes/post/responses/400/content/application~1json/examples/unsupported_payment_method"},"paths/~1quotes/post/responses/400/content/application~1json/examples/card_on_payout_quote":{"value":{"error":"Bad Request","message":"card is only supported for payin quotes"},"key":"card_on_payout_quote","summary":"A payin-only method sent on a payout quote","id":"paths/~1quotes/post/responses/400/content/application~1json/examples/card_on_payout_quote"},"paths/~1quotes/post/responses/400/content/application~1json/examples/resource_type_required":{"value":{"error":"Bad Request","message":"Validation failed: resource_type_required"},"key":"resource_type_required","summary":"Card payin quote without resource_type","id":"paths/~1quotes/post/responses/400/content/application~1json/examples/resource_type_required"},"paths/~1quotes/post/responses/400/content/application~1json/examples/resource_type_on_payout":{"value":{"error":"Bad Request","message":"resource_type is only valid for payin quotes"},"key":"resource_type_on_payout","summary":"resource_type sent on a payout quote","id":"paths/~1quotes/post/responses/400/content/application~1json/examples/resource_type_on_payout"},"paths/~1quotes/post/responses/400/content/application~1json/examples/unsupported_subtype":{"value":{"error":"Bad Request","message":"'instant_transfer' is not a supported subtype"},"key":"unsupported_subtype","summary":"Unsupported subtype","id":"paths/~1quotes/post/responses/400/content/application~1json/examples/unsupported_subtype"},"paths/~1quotes/post/responses/400/content/application~1json/examples/local_transfer_non_inr":{"value":{"error":"Bad Request","message":"local_transfer is only supported for INR destination"},"key":"local_transfer_non_inr","summary":"local_transfer to a non-INR destination","id":"paths/~1quotes/post/responses/400/content/application~1json/examples/local_transfer_non_inr"},"paths/~1quotes/post/responses/400/content/application~1json/examples/pay_via_bank_subtype":{"value":{"error":"Bad Request","message":"pay_via_bank only supports the local_transfer subtype"},"key":"pay_via_bank_subtype","summary":"pay_via_bank with an unsupported subtype","id":"paths/~1quotes/post/responses/400/content/application~1json/examples/pay_via_bank_subtype"},"paths/~1quotes/post/responses/400/content/application~1json/examples/split_ids_on_payout_quote":{"value":{"error":"Bad Request","message":"Validation failed: split_ids is only valid for payin quotes"},"key":"split_ids_on_payout_quote","summary":"split_ids sent on a payout quote","id":"paths/~1quotes/post/responses/400/content/application~1json/examples/split_ids_on_payout_quote"},"paths/~1quotes/post/responses/400/content/application~1json/examples/split_ids_unresolved":{"value":{"error":"Bad Request","message":"Validation failed: Split ids are invalid or no longer point at a dynamic rule: psplit_7Kq2mXbTdLp9"},"key":"split_ids_unresolved","summary":"A split id does not resolve to a live dynamic rule","id":"paths/~1quotes/post/responses/400/content/application~1json/examples/split_ids_unresolved"},"paths/~1quotes/post/responses/400/content/application~1json/examples/split_ids_incomplete":{"value":{"error":"Bad Request","message":"Validation failed: Split ids must be declared for every dynamic rule on the dimension, missing rules: price_Kd82nvQ1TzAe"},"key":"split_ids_incomplete","summary":"Another dynamic rule on the same dimension is not declared","id":"paths/~1quotes/post/responses/400/content/application~1json/examples/split_ids_incomplete"},"paths/~1payouts/post/requestBody/content/application~1json/examples/payout_without_quote":{"value":{"purpose_code":"S0802","beneficiary_id":"bene_a1b2c3d4e5","source_currency":"USD","destination_currency":"INR","source_amount":100000,"payment_rail":"neft","invoice_number":"INV-2026-001","request_id":"req-7f3a9c20","documents":["doc_11aa22bb33"],"notes":{"internal_ref":"batch-42"}},"key":"payout_without_quote","summary":"Payout without quote (no quote_id)","id":"paths/~1payouts/post/requestBody/content/application~1json/examples/payout_without_quote"},"paths/~1payouts/post/requestBody/content/application~1json/examples/payout_with_quote":{"value":{"quote_id":"quote_3m4n5o6p7q","beneficiary_id":"bene_a1b2c3d4e5","purpose_code":"S0802","invoice_number":"INV-2026-001","request_id":"req-7f3a9c20","documents":["doc_11aa22bb33"],"notes":{"internal_ref":"batch-42"}},"key":"payout_with_quote","summary":"Payout with quote (quote_id present)","id":"paths/~1payouts/post/requestBody/content/application~1json/examples/payout_with_quote"},"paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_usd":{"value":{"category":"payout","beneficiary":{"name":"John Doe","type":"individual","address":{"address_line1":"456 Main Street","city":"Los Angeles","state":"CA","country_code":"USA","postal_code":"90001"}},"bank_account":{"account_number":"1234567890","swift_code":"CITIUS33","currency":"USD"},"notes":{"invoice_ref":"INV-2026-002"}},"key":"payout_usd","summary":"Payout Beneficiary — USD (SWIFT)","id":"paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_usd"},"paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_eur":{"value":{"category":"payout","beneficiary":{"name":"ACME GmbH","type":"business","address":{"address_line1":"Friedrichstrasse 12","city":"Berlin","state":"Berlin","country_code":"DEU","postal_code":"10117"}},"bank_account":{"account_number":"DE89370400440532013000","currency":"EUR"}},"key":"payout_eur","summary":"Payout Beneficiary — EUR (SEPA, IBAN only)","id":"paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_eur"},"paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_gbp":{"value":{"category":"payout","beneficiary":{"name":"Jane Smith","type":"individual","address":{"address_line1":"24 Cheapside","city":"London","state":"England","country_code":"GBR","postal_code":"EC2V 6DN"}},"bank_account":{"account_number":"31926819","local_routing_number":"601613","currency":"GBP"}},"key":"payout_gbp","summary":"Payout Beneficiary — GBP (Faster Payments, sort code)","id":"paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_gbp"},"paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_aed":{"value":{"category":"payout","beneficiary":{"name":"ACME Trading LLC","type":"business","address":{"address_line1":"Sheikh Zayed Road","city":"Dubai","state":"Dubai","country_code":"ARE","postal_code":"00000"}},"bank_account":{"account_number":"AE070331234567890123456","currency":"AED"}},"key":"payout_aed","summary":"Payout Beneficiary — AED (IBAN only)","id":"paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_aed"},"paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_aud":{"value":{"category":"payout","beneficiary":{"name":"ACME Pty Ltd","type":"business","address":{"address_line1":"100 Collins Street","city":"Melbourne","state":"VIC","country_code":"AUS","postal_code":"3000"}},"bank_account":{"account_number":"123456789","local_routing_number":"062000","currency":"AUD"}},"key":"payout_aud","summary":"Payout Beneficiary — AUD (NPP, BSB)","id":"paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_aud"},"paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_inr":{"value":{"category":"payout","beneficiary":{"name":"Rahul Sharma","type":"individual","address":{"address_line1":"12 MG Road","city":"Bengaluru","state":"Karnataka","country_code":"IND","postal_code":"560001"}},"bank_account":{"account_number":"9876543210","local_routing_number":"KKBK0000261","currency":"INR"}},"key":"payout_inr","summary":"Payout Beneficiary — INR (IFSC)","id":"paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_inr"},"paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_upi_beneficiary":{"value":{"category":"payout","beneficiary":{"name":"Rahul Sharma","type":"individual","address":{"address_line1":"12 MG Road","city":"Bengaluru","state":"Karnataka","country_code":"IND","postal_code":"560001"}},"upi_account":{"upi_id":"1111111111@ybl"},"notes":{"invoice_ref":"INV-2026-003"}},"key":"payout_upi_beneficiary","summary":"Payout Beneficiary — INR (UPI)","id":"paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/payout_upi_beneficiary"},"paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/lrs_beneficiary":{"value":{"category":"lrs","beneficiary":{"name":"ACME Corporation","type":"business","email":"finance@acme.com","phone":"+1-555-123-4567","nickname":"ACME Primary Account","address":{"address_line1":"123 Business Park","address_line2":"Suite 100","city":"New York","state":"NY","country_code":"USA","postal_code":"10001"}},"bank_account":{"account_number":"1234567890","name":"Citibank NA","swift_code":"CITIUS33","local_routing_number":"021000089","currency":"USD","address":{"address_line1":"388 Greenwich Street","city":"New York","state":"NY","country_code":"USA","postal_code":"10013"},"intermediate_bank":{"name":"JPMorgan Chase Bank","country":"USA","swift_code":"CHASUS33","account_number":"123456789"}},"notes":{"invoice_ref":"INV-2026-001","project":"Alpha"}},"key":"lrs_beneficiary","summary":"LRS Beneficiary with all fields","id":"paths/~1v2~1beneficiaries/post/requestBody/content/application~1json/examples/lrs_beneficiary"},"paths/~1v2~1beneficiaries/post/responses/201/content/application~1json/example":{"value":{"id":"bene_5JU9yv0lGSUP","name":"ACME Corporation","type":"business","category":"lrs","status":"pending","email":"finance@acme.com","phone":"+1-555-123-4567","nickname":"ACME Primary Account","upi_account":null,"created_at":"2025-01-15T10:00:00Z","updated_at":"2025-01-15T10:00:00Z","address":{"address_line1":"123 Business Park","address_line2":"Suite 100","city":"New York","state":"NY","country_code":"USA","postal_code":"10001"},"bank_account":{"account_number":"1234567890","name":"Citibank NA","swift_code":"CITIUS33","local_routing_number":"021000089","currency":"USD","address":{"address_line1":"388 Greenwich Street","address_line2":"","city":"New York","state":"NY","country_code":"USA","postal_code":"10013"},"intermediate_bank":{"name":"JPMorgan Chase Bank","country":"USA","swift_code":"CHASUS33","account_number":"123456789"}},"notes":{"invoice_ref":"INV-2026-001","project":"Alpha"}},"id":"paths/~1v2~1beneficiaries/post/responses/201/content/application~1json/example"},"paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/missing_category":{"value":{"error":"Bad Request","message":"Category can't be blank, Category must be one of: lrs, payout"},"key":"missing_category","summary":"Missing category field","id":"paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/missing_category"},"paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/invalid_category":{"value":{"error":"Bad Request","message":"Category must be one of: lrs, payout"},"key":"invalid_category","summary":"Invalid category value","id":"paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/invalid_category"},"paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/missing_beneficiary_name":{"value":{"error":"Bad Request","message":"Beneficiary name can't be blank"},"key":"missing_beneficiary_name","summary":"Missing beneficiary name","id":"paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/missing_beneficiary_name"},"paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/invalid_swift_code":{"value":{"error":"Bad Request","message":"Swift code must be 8 to 11 characters long"},"key":"invalid_swift_code","summary":"Invalid SWIFT code format","id":"paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/invalid_swift_code"},"paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/lrs_invalid_swift_length":{"value":{"error":"Bad Request","message":"Swift code must be 8 characters long"},"key":"lrs_invalid_swift_length","summary":"LRS SWIFT code must be 8 characters","id":"paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/lrs_invalid_swift_length"},"paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/lrs_missing_routing_number":{"value":{"error":"Bad Request","message":"Local routing number can't be blank"},"key":"lrs_missing_routing_number","summary":"LRS requires local routing number","id":"paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/lrs_missing_routing_number"},"paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/unresolved_bank_details":{"value":{"error":"Bad Request","message":"Could not resolve bank details from the swift_code/local_routing_number provided. Send bank_account.name and bank_account.address, or correct the identifier."},"key":"unresolved_bank_details","summary":"Bank details omitted and could not be resolved","id":"paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/unresolved_bank_details"},"paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/missing_address":{"value":{"error":"Bad Request","message":"Beneficiary address is required"},"key":"missing_address","summary":"Missing beneficiary address","id":"paths/~1v2~1beneficiaries/post/responses/400/content/application~1json/examples/missing_address"},"paths/~1v2~1beneficiaries/post/responses/422/content/application~1json/examples/duplicate_account":{"value":{"error":"Unprocessable Entity","message":"Validation failed: Business already had this Account Number, Account Type and Transfer Method"},"key":"duplicate_account","summary":"Duplicate bank account","id":"paths/~1v2~1beneficiaries/post/responses/422/content/application~1json/examples/duplicate_account"},"paths/~1v2~1beneficiaries/get/responses/200/content/application~1json/example":{"value":{"data":[{"id":"bene_6989dfef8dP9z","name":"ACME Corporation","category":"payout","email":"finance@acme.com","phone":"+14155551234","nickname":"ACME Primary Account","status":"active","type":"business","created_at":"2026-02-09T11:03:25Z","updated_at":"2026-02-09T11:14:36Z","address":{"address_line1":"123 Business Park","address_line2":"Suite 100","city":"New York","state":"NY","country_code":"USA","postal_code":"10001"},"bank_account":{"account_number":"1234567890123","name":"Citibank NA","swift_code":"CITIUS33","local_routing_number":"021000089","currency":"USD","address":{"address_line1":"388 Greenwich Street","address_line2":"","city":"New York","state":"NY","country_code":"USA","postal_code":"10013"},"intermediate_bank":{"name":"JPMorgan Chase Bank","country":"USA","swift_code":"CHASUS33","account_number":"123456789"}},"upi_account":null,"notes":{"invoice_ref":"INV-2026-001","project":"Alpha"}}],"page_meta":{"current":1,"previous":null,"next":null,"per_page":20,"pages":1,"count":10}},"id":"paths/~1v2~1beneficiaries/get/responses/200/content/application~1json/example"},"paths/~1v2~1beneficiaries/get/responses/400/content/application~1json/example":{"value":{"error":"Bad Request","message":"Status is not included in the list"},"id":"paths/~1v2~1beneficiaries/get/responses/400/content/application~1json/example"},"paths/~1v2~1beneficiaries~1{id}/get/responses/200/content/application~1json/example":{"value":{"id":"bene_698c0615XZocZ","name":"ACME Corporation","type":"business","category":"lrs","status":"active","email":"finance@acme.com","phone":"+1-555-123-4567","nickname":"ACME Primary Account","documents":["doc_68e7980auYRAs"],"address":{"address_line1":"123 Business Park","address_line2":"Suite 100","city":"New York","state":"NY","country_code":"USA","postal_code":"10001"},"bank_account":{"account_number":"1234567890","name":"Citibank NA","swift_code":"CITIUS33","local_routing_number":"021000089","currency":"USD","address":{"address_line1":"388 Greenwich Street","city":"New York","state":"NY","country_code":"USA","postal_code":"10013"},"intermediate_bank":{"name":"JPMorgan Chase Bank","country":"USA","swift_code":"CHASUS33","account_number":"123456789"}},"created_at":"2025-01-15T10:00:00Z","updated_at":"2025-01-15T10:00:00Z","notes":{"invoice_ref":"INV-2026-001","project":"Alpha"}},"id":"paths/~1v2~1beneficiaries~1{id}/get/responses/200/content/application~1json/example"},"paths/~1v2~1beneficiaries~1{id}~1mock-review/patch/requestBody/content/application~1json/example":{"value":{"review_action":"approve"},"id":"paths/~1v2~1beneficiaries~1{id}~1mock-review/patch/requestBody/content/application~1json/example"},"paths/~1v2~1beneficiaries~1{id}~1mock-review/patch/responses/200/content/application~1json/example":{"value":{"message":"Beneficiary status updated successfully"},"id":"paths/~1v2~1beneficiaries~1{id}~1mock-review/patch/responses/200/content/application~1json/example"},"paths/~1v2~1beneficiaries~1{id}~1mock-review/patch/responses/400/content/application~1json/example":{"value":{"error":"Bad Request","message":"Review action is not included in the list"},"id":"paths/~1v2~1beneficiaries~1{id}~1mock-review/patch/responses/400/content/application~1json/example"},"paths/~1v2~1beneficiaries~1{id}~1mock-review/patch/responses/422/content/application~1json/example":{"value":{"error":"Invalid beneficiary status update"},"id":"paths/~1v2~1beneficiaries~1{id}~1mock-review/patch/responses/422/content/application~1json/example"},"paths/~1v2~1virtual-accounts/post/responses/202/content/application~1json/example":{"value":{"message":"Virtual account creation request is accepted.","data":{"merchant_id":"merch_694bb0289P4Cz","status":"pending"}},"id":"paths/~1v2~1virtual-accounts/post/responses/202/content/application~1json/example"},"paths/~1platform~1merchants/post/requestBody/content/application~1json/examples/individual":{"value":{"name":"John Doe","address_line1":"456 Commerce Street","address_line2":"Suite 101","city":"Mumbai","state":"Maharashtra","pincode":"400001","registration_number":"ABCDE1234F","registration_country":"IND","entity_type":"individual","category":"Agricultural Services","sub_category":"Veterinary Services","operation_countries":["IND"],"date_of_birth":"2001-08-04","gender":"male","passport":{"number":"P1234567","expiry_date":"2030-06-01","country_of_issuance":"IND"}},"key":"individual","summary":"Individual merchant","id":"paths/~1platform~1merchants/post/requestBody/content/application~1json/examples/individual"},"paths/~1platform~1merchants/post/requestBody/content/application~1json/examples/business":{"value":{"name":"Acme Trading Private Limited","dba_name":"Acme Retail","address_line1":"456 Commerce Street","address_line2":"Suite 101","city":"Mumbai","state":"Maharashtra","pincode":"400001","registration_number":"REG123456","registration_country":"IND","entity_type":"business","business_type":"private_limited","category":"Agricultural Services","sub_category":"Veterinary Services","operation_countries":["IND"],"registration_date":"2020-06-01","website":"https://acme.example.com","annual_turnover":"1m_to_5m","registration_document_id":"doc_nYUqLpuYQ0M8","ubos":[{"name":"Jane Doe","type":"individual","ownership_percentage":60,"country":"IND"},{"name":"Doe Holdings Pte Ltd","type":"company","ownership_percentage":40,"country":"SGP"}],"settlement_account":{"account_holder_name":"Acme Trading Private Limited","account_number":"123456789","bank_name":"JPMorgan Chase Bank","swift_code":"CHASUS33","currency":"USD","bank_address":{"address_line1":"270 Park Avenue","city":"New York","administrative_area":"NY","postal_code":"10017","country_code":"USA"}}},"key":"business","summary":"Business merchant","id":"paths/~1platform~1merchants/post/requestBody/content/application~1json/examples/business"},"paths/~1platform~1merchants~1{merchant_id}/patch/requestBody/content/application~1json/examples/individual":{"value":{"passport":{"number":"P1234567","expiry_date":"2030-06-01","country_of_issuance":"IND"}},"key":"individual","summary":"Individual merchant (attach passport)","id":"paths/~1platform~1merchants~1{merchant_id}/patch/requestBody/content/application~1json/examples/individual"},"paths/~1platform~1merchants~1{merchant_id}/patch/requestBody/content/application~1json/examples/business":{"value":{"registration_date":"2020-06-01"},"key":"business","summary":"Business merchant (attach registration_date)","id":"paths/~1platform~1merchants~1{merchant_id}/patch/requestBody/content/application~1json/examples/business"},"paths/~1kyc-links/post/requestBody/content/application~1json/example":{"value":{"email":"john.doe@example.com","expire_in_days":90,"send_email":true},"id":"paths/~1kyc-links/post/requestBody/content/application~1json/example"},"paths/~1kyc-links/post/responses/201/content/application~1json/example":{"value":{"id":"kyc_69b3f97eSThQY","status":"initiated","link_url":"https://app.glomopay.com/kyc-links/kyc_69b3f97eSThQY","expires_at":"2026-06-11T11:48:14.361Z","created_at":"2026-03-13T11:48:14.363Z","customer_id":"cust_abc123XYZ"},"id":"paths/~1kyc-links/post/responses/201/content/application~1json/example"},"paths/~1kyc-links~1{id}/get/responses/200/content/application~1json/example":{"value":{"id":"kyc_69b3f97eSThQY","status":"completed","link_url":"https://app.glomopay.com/kyc-links/kyc_69b3f97eSThQY","expires_at":"2026-06-11T11:48:14.361Z","created_at":"2026-03-13T11:48:14.363Z","customer_id":"cust_abc123XYZ","tracker":[{"created_at":"2026-03-13T12:00:00.000Z","text":"KYC verification completed"}],"documents":[{"id":"kycdoc_abc111","document_id":null,"type":"aadhaar","status":"not_captured","created_at":"2026-03-13T11:48:14.458Z","uploaded_at":null},{"id":"kycdoc_abc222","document_id":"doc_69b3f9b4MJgKZ","type":"pan_card","status":"captured","created_at":"2026-03-13T11:48:14.458Z","uploaded_at":"2026-03-13T11:49:08.093Z"}]},"id":"paths/~1kyc-links~1{id}/get/responses/200/content/application~1json/example"},"paths/~1investor-journey/post/requestBody/content/application~1json/example":{"value":{"email":"investor@example.com","pan":"ABCPD1234E","scheme_no":"HGEMR"},"id":"paths/~1investor-journey/post/requestBody/content/application~1json/example"},"paths/~1investor-journey/post/responses/200/content/application~1json/example":{"value":{"url":"https://investor-portal.glomopay.com#payload=..."},"id":"paths/~1investor-journey/post/responses/200/content/application~1json/example"},"paths/~1investor-journey/post/responses/400/content/application~1json/examples/validation_failed":{"value":{"error":"Bad Request","message":"Validation failed: Pan is not a valid PAN number"},"key":"validation_failed","summary":"Invalid PAN or email","id":"paths/~1investor-journey/post/responses/400/content/application~1json/examples/validation_failed"},"paths/~1investor-journey/post/responses/400/content/application~1json/examples/scheme_not_found":{"value":{"error":"Bad Request","message":"Scheme not found"},"key":"scheme_not_found","summary":"Unknown or unowned scheme","id":"paths/~1investor-journey/post/responses/400/content/application~1json/examples/scheme_not_found"},"paths/~1investor-journey/post/responses/401/content/application~1json/examples/missing_token":{"value":{"error":"Unauthorized","message":"Missing token"},"key":"missing_token","summary":"Missing JWT","id":"paths/~1investor-journey/post/responses/401/content/application~1json/examples/missing_token"},"paths/~1investor-journey/post/responses/401/content/application~1json/examples/not_platform":{"value":{"error":"Unauthorized","message":"Access restricted to platform businesses only"},"key":"not_platform","summary":"Non-platform merchant token","id":"paths/~1investor-journey/post/responses/401/content/application~1json/examples/not_platform"}},"securitySchemeStore":{"JWT":{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your secret token to access the API. If you don't have one, please contact support."}},"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"logo":{"imageUrl":"https://redocly.github.io/openapi-template/logo.png","href":""},"specType":"openapi"},"options":{"mockServer":{"url":"/_mock/api-reference/openapi","position":"off","description":"Mock server"},"disableRouter":true,"downloadUrls":[{"url":"/_bundle/api-reference/openapi.json?download"},{"url":"/_bundle/api-reference/openapi.yaml?download"}],"excludeFromSearch":false,"replayFeatures":{"graphql":false},"specType":"openapi","markdocOptions":{"tags":{},"nodes":{},"components":{}},"metadata":{"title":"API specification for Glomo","description":"The Glomo API follows REST architecture, utilizing resource-oriented URLs for clarity. It handles form-encoded request bodies, delivers responses in JSON format, and operates with standard HTTP methods, authentication, and response codes.\n\nYou can download the complete API collection by using the download options on the right.\n\nThe machine-readable description is also published at a stable URL, bundled into a single self-contained document with every `$ref` resolved:\n\n- [https://docs.glomo.one/openapi.yaml](https://docs.glomo.one/openapi.yaml)\n- [https://docs.glomo.one/openapi.json](https://docs.glomo.one/openapi.json)\n\nPoint an API client or an AI coding agent at either URL to generate calls directly from the contract.\n"}},"baseSlug":"/api-reference/openapi","routesMapping":{}}