{"items":[{"type":"link","label":"API specification for Glomo","link":"/api-documentation/apis/openapi","routeSlug":"/api-documentation/apis/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-documentation/apis/openapi.json?download"},{"kind":"download","label":"openapi.yaml","url":"/_bundle/api-documentation/apis/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":"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."}],"sectionId":"/api-documentation/apis/openapi"}],"sectionId":"/api-documentation/apis/openapi"}]}]}},{"type":"separator","label":"Authentication","content":null},{"type":"group","label":"API Key","link":"/api-documentation/apis/openapi/api_key","routeSlug":"/api-documentation/apis/openapi/api_key","items":[{"label":"Rotate API key","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-documentation/apis/openapi/api_key/rotateapikey","routeSlug":"/api-documentation/apis/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_161"}},"schemaId":"schema_161","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_161"}},"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_161","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_161"}},"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_162"}},"schemaId":"schema_162"},{"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_163","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_163","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_164","exampleIds":["paths/~1api-keys~1rotate/post/responses/401/content/application~1json/example"]}},"schemaId":"schema_164","exampleIds":["paths/~1api-keys~1rotate/post/responses/401/content/application~1json/example"]}],"pointer":"/paths/~1api-keys~1rotate/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_162","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_162"}}},{"code":"400","schemaId":"schema_163","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_163","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_164","exampleIds":["paths/~1api-keys~1rotate/post/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_164","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-documentation/apis/openapi/balance","routeSlug":"/api-documentation/apis/openapi/balance","items":[{"label":"Retrieve balances","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-documentation/apis/openapi/balance/getbalance","routeSlug":"/api-documentation/apis/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","headerTitle":"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"},{"type":"link","label":"AllBalances","link":"/api-documentation/apis/openapi/balance/allbalances","routeSlug":"/api-documentation/apis/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":[]}]}]}},{"type":"link","label":"Balance","link":"/api-documentation/apis/openapi/balance/balance","routeSlug":"/api-documentation/apis/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":[]}]}]}}],"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":"AllBalances","link":"/balance/allbalances","deprecated":false},{"title":"Balance","link":"/balance/balance","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-documentation/apis/openapi/balance_conversions","routeSlug":"/api-documentation/apis/openapi/balance_conversions","items":[{"label":"Convert balances","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-documentation/apis/openapi/balance_conversions/createbalanceconversion","routeSlug":"/api-documentation/apis/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_165"}},"schemaId":"schema_165","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_165"}},"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_165","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_165"}},"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/BalanceConversion"}},"schemaId":"components/schemas/BalanceConversion"},{"code":"400","description":"Bad request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_166"}},"schemaId":"schema_166"}],"pointer":"/paths/~1balance_conversions/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/BalanceConversion","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BalanceConversion"}}},{"code":"400","schemaId":"schema_166","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_166"}}}],"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-documentation/apis/openapi/balance_conversions/getbalanceconversions","routeSlug":"/api-documentation/apis/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_167","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 and GBP."},"children":[]}]}]}],"example":"USD"},{"name":"target_currency","in":"query","schemaId":"schema_167","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 and GBP."},"children":[]}]}]}],"example":"USD"},{"name":"before","in":"query","schemaId":"schema_168","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"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 in UTC to filter resources created before this time. Use this to avoid "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Page drift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" issue. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"./pagination#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_168","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"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 in UTC to filter resources created after this time. Use this to avoid "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Page drift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" issue. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"./pagination#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_169","description":"Number of resources per page. Should be between 1 and 100."},{"name":"page","in":"query","schemaId":"schema_170","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_167"},{"name":"target_currency","in":"query","example":"USD","schemaId":"schema_167"},{"name":"before","in":"query","example":"2025-02-18T12:03:44Z","schemaId":"schema_168"},{"name":"after","in":"query","example":"2025-01-18T12:03:44Z","schemaId":"schema_168"},{"name":"per_page","in":"query","schemaId":"schema_169"},{"name":"page","in":"query","schemaId":"schema_170"}],"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_171"}},"schemaId":"schema_171"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_172"}},"schemaId":"schema_172"}],"pointer":"/paths/~1balance_conversions/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_171","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_171"}}},{"code":"400","schemaId":"schema_172","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_172"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/balance_conversions/getbalanceconversions"}],"panels":[]}]},"httpPath":"/balance_conversions"},{"type":"link","label":"BalanceConversion","link":"/api-documentation/apis/openapi/balance_conversions/balanceconversion","routeSlug":"/api-documentation/apis/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":[]}]}]}}],"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-documentation/apis/openapi/fx_rate","routeSlug":"/api-documentation/apis/openapi/fx_rate","items":[{"label":"Get Mid-Market Rate","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-documentation/apis/openapi/fx_rate/getmidmarketrate","routeSlug":"/api-documentation/apis/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_167","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_167","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_167"},{"name":"target_currency","in":"query","required":true,"example":"EUR","schemaId":"schema_167"}],"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_173"}},"schemaId":"schema_173"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_174","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_174","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_175"}},"schemaId":"schema_175"}],"pointer":"/paths/~1fx-rate/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_173","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_173"}}},{"code":"400","schemaId":"schema_174","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_174","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_175","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_175"}}}],"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-documentation/apis/openapi/payment_link","routeSlug":"/api-documentation/apis/openapi/payment_link","items":[{"label":"Create a new Payment Link","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-documentation/apis/openapi/payment_link/createpayin","routeSlug":"/api-documentation/apis/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":"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":"/api-documentation/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_176"}},"schemaId":"schema_176","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_176"}},"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_176","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_176"}},"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_166","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_166","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","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/PaymentLinkResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaymentLinkResponse"}}},{"code":"400","schemaId":"schema_166","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_166","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-documentation/apis/openapi/payment_link/getpayins","routeSlug":"/api-documentation/apis/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_177","description":"Payment links of customer to filter"},{"name":"status","in":"query","schemaId":"schema_178","description":"Status of payment link to filter"},{"name":"before","in":"query","schemaId":"schema_168","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"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 in UTC to filter resources created before this time. Use this to avoid "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Page drift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" issue. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"./pagination#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_168","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"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 in UTC to filter resources created after this time. Use this to avoid "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Page drift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" issue. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"./pagination#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_169","description":"Number of resources per page. Should be between 1 and 100."},{"name":"page","in":"query","schemaId":"schema_170","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_177"},{"name":"status","in":"query","schemaId":"schema_178"},{"name":"before","in":"query","example":"2025-02-18T12:03:44Z","schemaId":"schema_168"},{"name":"after","in":"query","example":"2025-01-18T12:03:44Z","schemaId":"schema_168"},{"name":"per_page","in":"query","schemaId":"schema_169"},{"name":"page","in":"query","schemaId":"schema_170"}],"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_179"}},"schemaId":"schema_179"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_180"}},"schemaId":"schema_180"}],"pointer":"/paths/~1payin/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_179","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_179"}}},{"code":"400","schemaId":"schema_180","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_180"}}}],"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-documentation/apis/openapi/payment_link/getpayinbyid","routeSlug":"/api-documentation/apis/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_177","description":"The ID of the payin","required":true,"example":"payin_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":"payin_678a4c88hpAjf","schemaId":"schema_177"}],"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","headerTitle":"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-documentation/apis/openapi/payment_link/updatepayin","routeSlug":"/api-documentation/apis/openapi/payment_link/updatepayin","metadata":{"seo":{"title":"Update an existing payment link","description":"Update an existing payment link"}},"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":"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_181","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_182"}},"schemaId":"schema_182","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":"e092be15-e614-4401-8cea-7ca3df7da987","schemaId":"schema_181"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_182"}},"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_182","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_182"}},"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","headerTitle":"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-documentation/apis/openapi/payment_link/cancelpayin","routeSlug":"/api-documentation/apis/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_177","description":"The ID of the payment link to cancel","required":true,"example":"e092be15-e614-4401-8cea-7ca3df7da987"}],"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":"e092be15-e614-4401-8cea-7ca3df7da987","schemaId":"schema_177"}],"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","headerTitle":"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-documentation/apis/openapi/payment_link/updatepayinrfi","routeSlug":"/api-documentation/apis/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_177","description":"The ID of the payment link to update RFI for","required":true,"example":"payin_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_183"}},"schemaId":"schema_183","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":"payin_678a4c88hpAjf","schemaId":"schema_177"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_183"}},"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_183","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_183"}},"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_184"}},"schemaId":"schema_184"},{"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","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PaymentLinkResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaymentLinkResponse"}}},{"code":"400","schemaId":"schema_184","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_184"}}},{"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-documentation/apis/openapi/payment_link/mockreviewpaymentlink","routeSlug":"/api-documentation/apis/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_177","description":"The ID of the payment link to review","required":true,"example":"payin_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":"payin_E602dMzgjpDC","schemaId":"schema_177"}],"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_185"}},"schemaId":"schema_185"},{"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","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PaymentLink","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PaymentLink"}}},{"code":"400","schemaId":"schema_185","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_185"}}},{"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"},{"type":"link","label":"PaymentLink","link":"/api-documentation/apis/openapi/payment_link/paymentlink","routeSlug":"/api-documentation/apis/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":[]}]}]}}],"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-documentation/apis/openapi/orders","routeSlug":"/api-documentation/apis/openapi/orders","items":[{"label":"Create a new order","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-documentation/apis/openapi/orders/createorder","routeSlug":"/api-documentation/apis/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":"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":"/api-documentation/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_186"}},"schemaId":"schema_186","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_186"}},"responseCodes":["201","400"],"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_186","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_186"}},"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_187","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_187","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"]}],"pointer":"/paths/~1orders/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/OrderResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/OrderResponse"}}},{"code":"400","schemaId":"schema_187","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_187","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"]}}}],"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-documentation/apis/openapi/orders/getorders","routeSlug":"/api-documentation/apis/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_177","description":"Orders of customer to filter"},{"name":"status","in":"query","schemaId":"schema_188","description":"Status of order to filter"},{"name":"request_id","in":"query","schemaId":"schema_177","description":"Filter orders by the merchant-provided idempotency key.","example":"unique_order_request_id_123"},{"name":"before","in":"query","schemaId":"schema_168","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"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 in UTC to filter resources created before this time. Use this to avoid "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Page drift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" issue. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"./pagination#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_168","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"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 in UTC to filter resources created after this time. Use this to avoid "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Page drift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" issue. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"./pagination#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_169","description":"Number of resources per page. Should be between 1 and 100."},{"name":"page","in":"query","schemaId":"schema_170","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_177"},{"name":"status","in":"query","schemaId":"schema_188"},{"name":"request_id","in":"query","example":"unique_order_request_id_123","schemaId":"schema_177"},{"name":"before","in":"query","example":"2025-02-18T12:03:44Z","schemaId":"schema_168"},{"name":"after","in":"query","example":"2025-01-18T12:03:44Z","schemaId":"schema_168"},{"name":"per_page","in":"query","schemaId":"schema_169"},{"name":"page","in":"query","schemaId":"schema_170"}],"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_189"}},"schemaId":"schema_189"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_180"}},"schemaId":"schema_180"}],"pointer":"/paths/~1orders/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_189","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_189"}}},{"code":"400","schemaId":"schema_180","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_180"}}}],"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-documentation/apis/openapi/orders/getorderbyid","routeSlug":"/api-documentation/apis/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_177","description":"The ID of the order","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_177"}],"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","headerTitle":"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-documentation/apis/openapi/orders/updateorderrfi","routeSlug":"/api-documentation/apis/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_177","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_183"}},"schemaId":"schema_183","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_177"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_183"}},"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_183","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_183"}},"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_190"}},"schemaId":"schema_190"},{"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","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/OrderResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/OrderResponse"}}},{"code":"400","schemaId":"schema_190","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_190"}}},{"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"},{"type":"link","label":"Orders","link":"/api-documentation/apis/openapi/orders/orders","routeSlug":"/api-documentation/apis/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":[]}]}]}}],"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-documentation/apis/openapi/customer","routeSlug":"/api-documentation/apis/openapi/customer","items":[{"label":"Create a new customer","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-documentation/apis/openapi/customer/createcustomer","routeSlug":"/api-documentation/apis/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":"/api-documentation/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":[]}]}]}]},{"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","headerTitle":"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-documentation/apis/openapi/customer/getcustomers","routeSlug":"/api-documentation/apis/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_191","description":"Type of customer to filter"},{"name":"email_address","in":"query","schemaId":"schema_192","description":"Filter customers by email address"},{"name":"tax_identification_number","in":"query","schemaId":"schema_177","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":"Applicable only to the LRS (Liberalised Remittance Scheme / resident-India remittance) flow."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Filter customers by PAN (tax identification number). 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_168","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"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 in UTC to filter resources created before this time. Use this to avoid "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Page drift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" issue. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"./pagination#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_168","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"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 in UTC to filter resources created after this time. Use this to avoid "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Page drift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" issue. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"./pagination#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_169","description":"Number of resources per page. Should be between 1 and 100."},{"name":"page","in":"query","schemaId":"schema_170","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_191"},{"name":"email_address","in":"query","schemaId":"schema_192"},{"name":"tax_identification_number","in":"query","schemaId":"schema_177"},{"name":"before","in":"query","example":"2025-02-18T12:03:44Z","schemaId":"schema_168"},{"name":"after","in":"query","example":"2025-01-18T12:03:44Z","schemaId":"schema_168"},{"name":"per_page","in":"query","schemaId":"schema_169"},{"name":"page","in":"query","schemaId":"schema_170"}],"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_193"}},"schemaId":"schema_193"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_172"}},"schemaId":"schema_172"}],"pointer":"/paths/~1customer/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_193","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_193"}}},{"code":"400","schemaId":"schema_172","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_172"}}}],"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-documentation/apis/openapi/customer/getcustomerbyid","routeSlug":"/api-documentation/apis/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_177","description":"The ID of the customer","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_177"}],"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","headerTitle":"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-documentation/apis/openapi/customer/updatecustomer","routeSlug":"/api-documentation/apis/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."}},"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":"/api-documentation/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":[]}]}]}]},{"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_177","description":"The ID of the customer","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_194"}},"schemaId":"schema_194","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_177"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_194"}},"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_194","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_194"}},"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_195"}},"schemaId":"schema_195"},{"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","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/Customer","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Customer"}}},{"code":"400","schemaId":"schema_195","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_195"}}},{"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-documentation/apis/openapi/customer/createcustomerbankaccount","routeSlug":"/api-documentation/apis/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":"Registers the bank account a customer sends money from.\n\nA 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.\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_177","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_177"}],"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","headerTitle":"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-documentation/apis/openapi/customer/getcustomerbankaccounts","routeSlug":"/api-documentation/apis/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_177","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_177"}],"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_196"}},"schemaId":"schema_196"},{"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","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_196","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_196"}}},{"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"},{"type":"link","label":"Customer","link":"/api-documentation/apis/openapi/customer/customer","routeSlug":"/api-documentation/apis/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":[]}]}]}}],"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-documentation/apis/openapi/payment","routeSlug":"/api-documentation/apis/openapi/payment","items":[{"label":"Create a payment","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-documentation/apis/openapi/payment/createpayment","routeSlug":"/api-documentation/apis/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_197","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_197","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","headerTitle":"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_197","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_197","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-documentation/apis/openapi/payment/getpayments","routeSlug":"/api-documentation/apis/openapi/payment/getpayments","metadata":{"seo":{"title":"List all payments","description":"List all payments"}},"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":"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_177","description":"The unique identifier for the customer.","example":"cust_E602sMzgjpDC"},{"name":"status","in":"query","schemaId":"schema_198","description":"Status of payin to filter","example":"success"},{"name":"compliance_status","in":"query","schemaId":"schema_199","description":"Filters payments by the outcome of their compliance review.","example":"approved"},{"name":"payin_id","in":"query","schemaId":"schema_177","description":"The unique identifier for the payin.","example":"payin_E602dMzgjpDC"},{"name":"payment_type","in":"query","schemaId":"schema_200","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_177","description":"The unique identifier for the subscription.","example":"sub_68877570b5zeE"},{"name":"currency","in":"query","schemaId":"schema_201","example":"USD"},{"name":"request_id","in":"query","schemaId":"schema_177","description":"Filter payments by the merchant-provided idempotency key.","example":"unique_request_id_123"},{"name":"before","in":"query","schemaId":"schema_168","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"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 in UTC to filter resources created before this time. Use this to avoid "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Page drift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" issue. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"./pagination#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_168","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"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 in UTC to filter resources created after this time. Use this to avoid "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Page drift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" issue. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"./pagination#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_169","description":"Number of resources per page. Should be between 1 and 100."},{"name":"page","in":"query","schemaId":"schema_170","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_177"},{"name":"status","in":"query","example":"success","schemaId":"schema_198"},{"name":"compliance_status","in":"query","example":"approved","schemaId":"schema_199"},{"name":"payin_id","in":"query","example":"payin_E602dMzgjpDC","schemaId":"schema_177"},{"name":"payment_type","in":"query","example":"add_funds","schemaId":"schema_200"},{"name":"subscription_id","in":"query","example":"sub_68877570b5zeE","schemaId":"schema_177"},{"name":"currency","in":"query","example":"USD","schemaId":"schema_201"},{"name":"request_id","in":"query","example":"unique_request_id_123","schemaId":"schema_177"},{"name":"before","in":"query","example":"2025-02-18T12:03:44Z","schemaId":"schema_168"},{"name":"after","in":"query","example":"2025-01-18T12:03:44Z","schemaId":"schema_168"},{"name":"per_page","in":"query","schemaId":"schema_169"},{"name":"page","in":"query","schemaId":"schema_170"}],"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_202"}},"schemaId":"schema_202"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_203"}},"schemaId":"schema_203"}],"pointer":"/paths/~1payment/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_202","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_202"}}},{"code":"400","schemaId":"schema_203","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_203"}}}],"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-documentation/apis/openapi/payment/createmockpayment","routeSlug":"/api-documentation/apis/openapi/payment/createmockpayment","metadata":{"seo":{"title":"Create a mock payment","description":"This API is only available in sandbox mode. Creates a mock payment of specified amount for any given Payment link."}},"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":"This API is only available in sandbox mode. Creates a mock payment of specified amount for any given 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":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_204"}},"schemaId":"schema_204","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_204"}},"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_204","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_204"}},"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"}},"schemaId":"components/schemas/Payment"},{"code":"400","description":"Bad request"}],"pointer":"/paths/~1payment~1mock/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/Payment","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Payment"}}},{"code":"400"}],"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-documentation/apis/openapi/payment/getpaymentbyid","routeSlug":"/api-documentation/apis/openapi/payment/getpaymentbyid","metadata":{"seo":{"title":"Retrieve a payment\n","description":"Retrieve a payment\n"}},"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":"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_177","description":"The unique identifier for the payment.","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_177"}],"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","headerTitle":"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":"Mock funds available","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-documentation/apis/openapi/payment/mockupdatepaymentfundsavailable","routeSlug":"/api-documentation/apis/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_205","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_205"}],"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_206"}},"schemaId":"schema_206"},{"code":"400","description":"Bad Request - Payment validation failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_207"}},"schemaId":"schema_207"},{"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","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_206","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_206"}}},{"code":"400","schemaId":"schema_207","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_207"}}},{"code":"401"},{"code":"404"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/payment/mockupdatepaymentfundsavailable"}],"panels":[]}]},"httpPath":"/payment/{id}/mock-funds-available"},{"type":"link","label":"Payment","link":"/api-documentation/apis/openapi/payment/payment","routeSlug":"/api-documentation/apis/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":[]}]}]}}],"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}/mock-funds-available","summary":"Mock funds available","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/payment/mockupdatepaymentfundsavailable","deprecated":false}]}]}]}]}},{"type":"group","label":"Refund","link":"/api-documentation/apis/openapi/refund","routeSlug":"/api-documentation/apis/openapi/refund","items":[{"label":"Create refund for a payment","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-documentation/apis/openapi/refund/createrefund","routeSlug":"/api-documentation/apis/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_208"}},"schemaId":"schema_208","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_208"}},"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_208","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_208"}},"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_209","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_209","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","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/Refund","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Refund"}}},{"code":"400","schemaId":"schema_209","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_209","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-documentation/apis/openapi/refund/getrefunds","routeSlug":"/api-documentation/apis/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_177","description":"Refunds of customer to filter"},{"name":"payment_method","in":"query","schemaId":"schema_177","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_177","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_177","description":"Filter refunds by the merchant-provided idempotency key.","example":"unique_refund_request_id_123"},{"name":"status","in":"query","schemaId":"schema_210","description":"Refund status to filter"},{"name":"before","in":"query","schemaId":"schema_168","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"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 in UTC to filter resources created before this time. Use this to avoid "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Page drift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" issue. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"./pagination#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_168","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"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 in UTC to filter resources created after this time. Use this to avoid "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Page drift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" issue. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"./pagination#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_169","description":"Number of resources per page. Should be between 1 and 100."},{"name":"page","in":"query","schemaId":"schema_170","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_177"},{"name":"payment_method","in":"query","schemaId":"schema_177"},{"name":"payment_id","in":"query","schemaId":"schema_177"},{"name":"request_id","in":"query","example":"unique_refund_request_id_123","schemaId":"schema_177"},{"name":"status","in":"query","schemaId":"schema_210"},{"name":"before","in":"query","example":"2025-02-18T12:03:44Z","schemaId":"schema_168"},{"name":"after","in":"query","example":"2025-01-18T12:03:44Z","schemaId":"schema_168"},{"name":"per_page","in":"query","schemaId":"schema_169"},{"name":"page","in":"query","schemaId":"schema_170"}],"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_211"}},"schemaId":"schema_211"},{"code":"401","description":"Unauthorized"}],"pointer":"/paths/~1refunds/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_211","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_211"}}},{"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-documentation/apis/openapi/refund/getrefundbyid","routeSlug":"/api-documentation/apis/openapi/refund/getrefundbyid","metadata":{"seo":{"title":"Retrieve a refund\n","description":"Retrieve a refund\n"}},"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":"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_177","description":"The unique identifier for the payout.","required":true,"example":"pout_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":"pout_E602dMzgjpDC","schemaId":"schema_177"}],"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","headerTitle":"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-documentation/apis/openapi/refund/mockupdaterefund","routeSlug":"/api-documentation/apis/openapi/refund/mockupdaterefund","metadata":{"seo":{"title":"Mock update a refund","description":"Mark an in_progress refund as successful"}},"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":"Mark an in_progress refund as successful"},"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_177","description":"The ID of the refund","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_212"}},"schemaId":"schema_212","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_177"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_212"}},"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_212","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_212"}},"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_213"}},"schemaId":"schema_213"},{"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","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/Refund","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Refund"}}},{"code":"400","schemaId":"schema_213","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_213"}}},{"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"},{"type":"link","label":"Refund","link":"/api-documentation/apis/openapi/refund/refund","routeSlug":"/api-documentation/apis/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":[]}]}]}}],"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-documentation/apis/openapi/price","routeSlug":"/api-documentation/apis/openapi/price","items":[{"label":"Create a new price","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-documentation/apis/openapi/price/createprice","routeSlug":"/api-documentation/apis/openapi/price/createprice","metadata":{"seo":{"title":"Create a new price","description":"Create a new price"}},"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":"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_214"}},"schemaId":"schema_214","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_214"}},"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_214","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_214"}},"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_203"}},"schemaId":"schema_203"}],"pointer":"/paths/~1prices/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/Price","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Price"}}},{"code":"400","schemaId":"schema_203","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_203"}}}],"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-documentation/apis/openapi/price/getprices","routeSlug":"/api-documentation/apis/openapi/price/getprices","metadata":{"seo":{"title":"List all prices","description":"List all prices"}},"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":"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_168","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"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 in UTC to filter resources created before this time. Use this to avoid "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Page drift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" issue. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"./pagination#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_168","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"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 in UTC to filter resources created after this time. Use this to avoid "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Page drift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" issue. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"./pagination#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_169","description":"Number of resources per page. Should be between 1 and 100."},{"name":"page","in":"query","schemaId":"schema_170","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_168"},{"name":"after","in":"query","example":"2025-01-18T12:03:44Z","schemaId":"schema_168"},{"name":"per_page","in":"query","schemaId":"schema_169"},{"name":"page","in":"query","schemaId":"schema_170"}],"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_215"}},"schemaId":"schema_215"},{"code":"400","description":"Bad request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_203"}},"schemaId":"schema_203"}],"pointer":"/paths/~1prices/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_215","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_215"}}},{"code":"400","schemaId":"schema_203","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_203"}}}],"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-documentation/apis/openapi/price/getpricebyid","routeSlug":"/api-documentation/apis/openapi/price/getpricebyid","metadata":{"seo":{"title":"Retrieve a price\n","description":"Retrieve a price\n"}},"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":"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_177","description":"The unique identifier for the payout.","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_177"}],"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_216"}},"schemaId":"schema_216"},{"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","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_216","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_216"}}},{"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}"},{"type":"link","label":"Price","link":"/api-documentation/apis/openapi/price/price","routeSlug":"/api-documentation/apis/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":[]}]}]}}],"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-documentation/apis/openapi/pricing_split","routeSlug":"/api-documentation/apis/openapi/pricing_split","items":[{"label":"List dynamic pricing rules","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-documentation/apis/openapi/pricing_split/getdynamicprices","routeSlug":"/api-documentation/apis/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_169","description":"Number of resources per page. Should be between 1 and 100."},{"name":"page","in":"query","schemaId":"schema_170","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_169"},{"name":"page","in":"query","schemaId":"schema_170"}],"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_217","exampleIds":["paths/~1prices~1dynamic/get/responses/200/content/application~1json/example"]}},"schemaId":"schema_217","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_218"}},"schemaId":"schema_218"},{"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_219"}},"schemaId":"schema_219"}],"pointer":"/paths/~1prices~1dynamic/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_217","exampleIds":["paths/~1prices~1dynamic/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_217","exampleIds":["paths/~1prices~1dynamic/get/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_218","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_218"}}},{"code":"401","schemaId":"schema_219","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_219"}}}],"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-documentation/apis/openapi/pricing_split/createpricingsplit","routeSlug":"/api-documentation/apis/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_220","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_220","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_219"}},"schemaId":"schema_219"}],"pointer":"/paths/~1prices~1dynamic-splits/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"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_220","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_220","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_219","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_219"}}}],"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-documentation/apis/openapi/pricing_split/getpricingsplits","routeSlug":"/api-documentation/apis/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_177","description":"Return only the splits declared against this dynamic pricing rule.","example":"price_5JU9yv0lGSUP"},{"name":"per_page","in":"query","schemaId":"schema_169","description":"Number of resources per page. Should be between 1 and 100."},{"name":"page","in":"query","schemaId":"schema_170","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_177"},{"name":"per_page","in":"query","schemaId":"schema_169"},{"name":"page","in":"query","schemaId":"schema_170"}],"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_221","exampleIds":["paths/~1prices~1dynamic-splits/get/responses/200/content/application~1json/example"]}},"schemaId":"schema_221","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_218"}},"schemaId":"schema_218"},{"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_219"}},"schemaId":"schema_219"}],"pointer":"/paths/~1prices~1dynamic-splits/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_221","exampleIds":["paths/~1prices~1dynamic-splits/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_221","exampleIds":["paths/~1prices~1dynamic-splits/get/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_218","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_218"}}},{"code":"401","schemaId":"schema_219","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_219"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/pricing_split/getpricingsplits"}],"panels":[]}]},"httpPath":"/prices/dynamic-splits"},{"type":"link","label":"DynamicPrice","link":"/api-documentation/apis/openapi/pricing_split/dynamicprice","routeSlug":"/api-documentation/apis/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-documentation/apis/openapi/pricing_split/pricingsplit","routeSlug":"/api-documentation/apis/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":[]}]}]}}],"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-documentation/apis/openapi/payment_session","routeSlug":"/api-documentation/apis/openapi/payment_session","items":[{"label":"Create a payment session","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-documentation/apis/openapi/payment_session/createpaymentsession","routeSlug":"/api-documentation/apis/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":"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_222","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"]}},"schemaId":"schema_222","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"],"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_222","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"]}},"responseCodes":["201","400","401","403","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_222","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"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_222","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"]}},"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, mutually exclusive fields provided, prefill fields supplied without an identifier, or 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":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_223"}},"schemaId":"schema_223"},{"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_219"}},"schemaId":"schema_219"},{"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."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_224"}},"schemaId":"schema_224"},{"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 — 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":"."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_225"}},"schemaId":"schema_225"}],"pointer":"/paths/~1payment-sessions/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"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_223","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_223"}}},{"code":"401","schemaId":"schema_219","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_219"}}},{"code":"403","schemaId":"schema_224","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_224"}}},{"code":"422","schemaId":"schema_225","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_225"}}}],"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":"separator","label":"Subscription","content":null},{"type":"group","label":"Subscription","link":"/api-documentation/apis/openapi/subscription","routeSlug":"/api-documentation/apis/openapi/subscription","items":[{"label":"List subscriptions","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-documentation/apis/openapi/subscription/getsubscriptions","routeSlug":"/api-documentation/apis/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_226","description":"Filter subscriptions by status.","example":"active"},{"name":"customer_id","in":"query","schemaId":"schema_177","description":"Filter subscriptions by customer ID.","example":"cust_5JU9yv0lGSUP"},{"name":"start_date","in":"query","schemaId":"schema_227","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_227","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_168","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"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 in UTC to filter resources created before this time. Use this to avoid "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Page drift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" issue. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"./pagination#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_168","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"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 in UTC to filter resources created after this time. Use this to avoid "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Page drift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" issue. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"./pagination#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_169","description":"Number of resources per page. Should be between 1 and 100."},{"name":"page","in":"query","schemaId":"schema_170","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_226"},{"name":"customer_id","in":"query","example":"cust_5JU9yv0lGSUP","schemaId":"schema_177"},{"name":"start_date","in":"query","example":"2024-01-01","schemaId":"schema_227"},{"name":"end_date","in":"query","example":"2024-12-31","schemaId":"schema_227"},{"name":"before","in":"query","example":"2025-02-18T12:03:44Z","schemaId":"schema_168"},{"name":"after","in":"query","example":"2025-01-18T12:03:44Z","schemaId":"schema_168"},{"name":"per_page","in":"query","schemaId":"schema_169"},{"name":"page","in":"query","schemaId":"schema_170"}],"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_228"}},"schemaId":"schema_228"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_229"}},"schemaId":"schema_229"}],"pointer":"/paths/~1subscriptions/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_228","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_228"}}},{"code":"400","schemaId":"schema_229","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_229"}}}],"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-documentation/apis/openapi/subscription/createsubscription","routeSlug":"/api-documentation/apis/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_230","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_230","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","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/CreateSubscriptionResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CreateSubscriptionResponse"}}},{"code":"400","schemaId":"schema_230","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_230","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-documentation/apis/openapi/subscription/getsubscriptionbyid","routeSlug":"/api-documentation/apis/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_177","description":"Unique identifier of the subscription","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_177"}],"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_231"}},"schemaId":"schema_231"}],"pointer":"/paths/~1subscriptions~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/Subscription","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Subscription"}}},{"code":"404","schemaId":"schema_231","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_231"}}}],"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-documentation/apis/openapi/subscription/pausesubscription","routeSlug":"/api-documentation/apis/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_177","description":"Unique identifier of the subscription to pause","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_177"}],"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_232"}},"schemaId":"schema_232"},{"code":"400","description":"Bad Request - subscription cannot be paused from current state","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_233"}},"schemaId":"schema_233"},{"code":"404","description":"Subscription not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_231"}},"schemaId":"schema_231"}],"pointer":"/paths/~1subscriptions~1{id}~1pause/patch/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_232","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_232"}}},{"code":"400","schemaId":"schema_233","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_233"}}},{"code":"404","schemaId":"schema_231","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_231"}}}],"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-documentation/apis/openapi/subscription/resumesubscription","routeSlug":"/api-documentation/apis/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_177","description":"Unique identifier of the subscription to resume","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_177"}],"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_234"}},"schemaId":"schema_234"},{"code":"404","description":"Subscription not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_231"}},"schemaId":"schema_231"}],"pointer":"/paths/~1subscriptions~1{id}~1resume/patch/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/Subscription","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Subscription"}}},{"code":"400","schemaId":"schema_234","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_234"}}},{"code":"404","schemaId":"schema_231","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_231"}}}],"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-documentation/apis/openapi/subscription/cancelsubscription","routeSlug":"/api-documentation/apis/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_177","description":"Unique identifier of the subscription to cancel","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_177"}],"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_235"}},"schemaId":"schema_235"},{"code":"400","description":"Bad Request - subscription cannot be cancelled from current state","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_236"}},"schemaId":"schema_236"},{"code":"404","description":"Subscription not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_231"}},"schemaId":"schema_231"}],"pointer":"/paths/~1subscriptions~1{id}~1cancel/patch/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_235","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_235"}}},{"code":"400","schemaId":"schema_236","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_236"}}},{"code":"404","schemaId":"schema_231","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_231"}}}],"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-documentation/apis/openapi/subscription/updatenextpaymentdate","routeSlug":"/api-documentation/apis/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_177","description":"Unique identifier of the subscription to update next payment date","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_177"}],"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_237"}},"schemaId":"schema_237"},{"code":"404","description":"Subscription not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_231"}},"schemaId":"schema_231"}],"pointer":"/paths/~1subscriptions~1{id}~1next-payment-date/patch/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/Subscription","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Subscription"}}},{"code":"400","schemaId":"schema_237","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_237"}}},{"code":"404","schemaId":"schema_231","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_231"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/subscription/updatenextpaymentdate"}],"panels":[]}]},"httpPath":"/subscriptions/{id}/next-payment-date"},{"type":"link","label":"CreateSubscriptionResponse","link":"/api-documentation/apis/openapi/subscription/createsubscriptionresponse","routeSlug":"/api-documentation/apis/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":[]}]}]}},{"type":"link","label":"Subscription","link":"/api-documentation/apis/openapi/subscription/subscription","routeSlug":"/api-documentation/apis/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":[]}]}]}}],"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":"CreateSubscriptionResponse","link":"/subscription/createsubscriptionresponse","deprecated":false},{"title":"Subscription","link":"/subscription/subscription","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-documentation/apis/openapi/quote","routeSlug":"/api-documentation/apis/openapi/quote","items":[{"label":"Create quotes","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-documentation/apis/openapi/quote/createquote","routeSlug":"/api-documentation/apis/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":[]}]}]}]},{"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"]}},"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"],"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"]}},"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"],"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"]}},"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_238"}},"schemaId":"schema_238"},{"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":", "},"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_239","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/unsupported_payment_method","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_239","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/unsupported_payment_method","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_219"}},"schemaId":"schema_219"}],"pointer":"/paths/~1quotes/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"schema_238","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_238"}}},{"code":"400","schemaId":"schema_239","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/unsupported_payment_method","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_239","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/unsupported_payment_method","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_219","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_219"}}}],"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-documentation/apis/openapi/payout","routeSlug":"/api-documentation/apis/openapi/payout","items":[{"label":"Create a new payout","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-documentation/apis/openapi/payout/createpayout","routeSlug":"/api-documentation/apis/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":[]}]}]}]},{"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_240","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_240","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_240","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_240","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_240","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":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_203"}},"schemaId":"schema_203"},{"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"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_241"}},"schemaId":"schema_241"}],"pointer":"/paths/~1payouts/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/Payout","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Payout"}}},{"code":"400","schemaId":"schema_203","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_203"}}},{"code":"409","schemaId":"schema_241","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_241"}}}],"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-documentation/apis/openapi/payout/getpayouts","routeSlug":"/api-documentation/apis/openapi/payout/getpayouts","metadata":{"seo":{"title":"List all payouts","description":"List all payouts"}},"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":"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_177","description":"The unique identifier of the beneficiary","example":"bene_5JU9yv0lGSUP"},{"name":"request_id","in":"query","schemaId":"schema_177","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_242","description":"Status of payout to filter"},{"name":"before","in":"query","schemaId":"schema_168","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"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 in UTC to filter resources created before this time. Use this to avoid "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Page drift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" issue. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"./pagination#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_168","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"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 in UTC to filter resources created after this time. Use this to avoid "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Page drift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" issue. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"./pagination#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_169","description":"Number of resources per page. Should be between 1 and 100."},{"name":"page","in":"query","schemaId":"schema_170","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_177"},{"name":"request_id","in":"query","example":"your-internal-id","schemaId":"schema_177"},{"name":"status","in":"query","schemaId":"schema_242"},{"name":"before","in":"query","example":"2025-02-18T12:03:44Z","schemaId":"schema_168"},{"name":"after","in":"query","example":"2025-01-18T12:03:44Z","schemaId":"schema_168"},{"name":"per_page","in":"query","schemaId":"schema_169"},{"name":"page","in":"query","schemaId":"schema_170"}],"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_243"}},"schemaId":"schema_243"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_203"}},"schemaId":"schema_203"}],"pointer":"/paths/~1payouts/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_243","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_243"}}},{"code":"400","schemaId":"schema_203","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_203"}}}],"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-documentation/apis/openapi/payout/getpayoutbyid","routeSlug":"/api-documentation/apis/openapi/payout/getpayoutbyid","metadata":{"seo":{"title":"Retrieve a payout\n","description":"Retrieve a payout\n"}},"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":"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_177","description":"The unique identifier for the payout.","required":true,"example":"pout_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":"pout_E602dMzgjpDC","schemaId":"schema_177"}],"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","headerTitle":"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-documentation/apis/openapi/payout/cancelpayout","routeSlug":"/api-documentation/apis/openapi/payout/cancelpayout","metadata":{"seo":{"title":"Cancel a payout","description":"Cancel a payout"}},"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":"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_244","description":"The unique identifier of the payout to cancel.","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":"pout_DdWp_HUbOnlg","schemaId":"schema_244"}],"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_245"}},"schemaId":"schema_245"},{"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","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_245","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_245"}}},{"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":"Update RFI for Payout","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-documentation/apis/openapi/payout/updaterfipayout","routeSlug":"/api-documentation/apis/openapi/payout/updaterfipayout","metadata":{"seo":{"title":"Update RFI for Payout","description":"Update RFI for Payout"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateRfiPayout","name":"Update RFI for Payout","isWebhook":false,"pointer":"/paths/~1payouts~1{id}~1update_rfi/patch","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update RFI for Payout","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"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_246","required":true}],"pointer":"/paths/~1payouts~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_247"}},"schemaId":"schema_247","pointer":"/paths/~1payouts~1{id}~1update_rfi/patch/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/payouts/{id}/update_rfi","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"payout_E602dMzgjpDC","schemaId":"schema_246"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_247"}},"responseCodes":["200","400","401"],"pointer":"/payouts/{id}/update_rfi","href":"payout/updaterfipayout","openApiOperationId":"updateRfiPayout","summary":"Update RFI for Payout"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"schemaId":"schema_247","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_247"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Document attached successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Payout"}},"schemaId":"components/schemas/Payout"},{"code":"400","description":"Bad Request"},{"code":"401","description":"Unauthorized"}],"pointer":"/paths/~1payouts~1{id}~1update_rfi/patch/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/Payout","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Payout"}}},{"code":"400"},{"code":"401"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/payout/updaterfipayout"}],"panels":[]}]},"httpPath":"/payouts/{id}/update_rfi"},{"label":"Mock update a payout status","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-documentation/apis/openapi/payout/mockupdatepayoutstatus","routeSlug":"/api-documentation/apis/openapi/payout/mockupdatepayoutstatus","metadata":{"seo":{"title":"Mock update a payout status","description":"Mock update a payout status"}},"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":"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_248"}},"schemaId":"schema_248","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_248"}},"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_248","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_248"}},"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_203"}},"schemaId":"schema_203"}],"pointer":"/paths/~1payouts~1mock/patch/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/Payout","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Payout"}}},{"code":"400","schemaId":"schema_203","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_203"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/payout/mockupdatepayoutstatus"}],"panels":[]}]},"httpPath":"/payouts/mock"},{"type":"link","label":"Payout","link":"/api-documentation/apis/openapi/payout/payout","routeSlug":"/api-documentation/apis/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":[]}]}]}}],"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/{id}/update_rfi","summary":"Update RFI for Payout","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/payout/updaterfipayout","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","link":"/api-documentation/apis/openapi/beneficiary","routeSlug":"/api-documentation/apis/openapi/beneficiary","items":[{"label":"List all Beneficiaries","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-documentation/apis/openapi/beneficiary/getbeneficiaries","routeSlug":"/api-documentation/apis/openapi/beneficiary/getbeneficiaries","metadata":{"seo":{"title":"List all Beneficiaries","description":"Returns a list of your beneficiaries. The beneficiaries are returned sorted by creation date, with the most recent beneficiary appearing first."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getBeneficiaries","name":"List all Beneficiaries","isWebhook":false,"pointer":"/paths/~1beneficiaries/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List all Beneficiaries","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 beneficiaries. The beneficiaries 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":"beneficiary_type","in":"query","schemaId":"schema_191","description":"Type of beneficiary to filter"},{"name":"country","in":"query","schemaId":"schema_249","description":"The ISO 3166-1 alpha-3 code of the country to filter validations"},{"name":"before","in":"query","schemaId":"schema_168","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"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 in UTC to filter resources created before this time. Use this to avoid "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Page drift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" issue. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"./pagination#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_168","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"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 in UTC to filter resources created after this time. Use this to avoid "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Page drift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" issue. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"./pagination#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_169","description":"Number of resources per page. Should be between 1 and 100."},{"name":"page","in":"query","schemaId":"schema_170","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/~1beneficiaries/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/beneficiaries","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"beneficiary_type","in":"query","schemaId":"schema_191"},{"name":"country","in":"query","example":"IND","schemaId":"schema_249"},{"name":"before","in":"query","example":"2025-02-18T12:03:44Z","schemaId":"schema_168"},{"name":"after","in":"query","example":"2025-01-18T12:03:44Z","schemaId":"schema_168"},{"name":"per_page","in":"query","schemaId":"schema_169"},{"name":"page","in":"query","schemaId":"schema_170"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","400"],"pointer":"/beneficiaries","href":"beneficiary/getbeneficiaries","openApiOperationId":"getBeneficiaries","summary":"List all Beneficiaries"},"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 beneficiaries matching the filters","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_250"}},"schemaId":"schema_250"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_172"}},"schemaId":"schema_172"}],"pointer":"/paths/~1beneficiaries/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_250","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_250"}}},{"code":"400","schemaId":"schema_172","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_172"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/beneficiary/getbeneficiaries"}],"panels":[]}]},"httpPath":"/beneficiaries"},{"label":"Retrieve a beneficiary","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-documentation/apis/openapi/beneficiary/getbeneficiarybyid","routeSlug":"/api-documentation/apis/openapi/beneficiary/getbeneficiarybyid","metadata":{"seo":{"title":"Retrieve a beneficiary","description":"Retrieves details of a beneficiary."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getBeneficiaryById","name":"Retrieve a beneficiary","isWebhook":false,"pointer":"/paths/~1beneficiaries~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve a beneficiary","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 beneficiary.\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_177","description":"The ID of the beneficiary","required":true}],"pointer":"/paths/~1beneficiaries~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/beneficiaries/{id}","servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_177"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"responseCodes":["200","404"],"pointer":"/beneficiaries/{id}","href":"beneficiary/getbeneficiarybyid","openApiOperationId":"getBeneficiaryById","summary":"Retrieve a beneficiary"},"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":"Beneficiary details","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Beneficiary"}},"schemaId":"components/schemas/Beneficiary"},{"code":"404","description":"Beneficiary not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}},"schemaId":"components/schemas/EntityNotFound"}],"pointer":"/paths/~1beneficiaries~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/Beneficiary","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Beneficiary"}}},{"code":"404","schemaId":"components/schemas/EntityNotFound","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/beneficiary/getbeneficiarybyid"}],"panels":[]}]},"httpPath":"/beneficiaries/{id}"},{"label":"Create a Beneficiary","deprecated":true,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-documentation/apis/openapi/beneficiary/createbeneficiary","routeSlug":"/api-documentation/apis/openapi/beneficiary/createbeneficiary","metadata":{"seo":{"title":"Create a Beneficiary","description":"Creates a beneficiary with information such as name, contact, address, and banking information."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createBeneficiary","name":"Create a Beneficiary","deprecated":true,"isWebhook":false,"pointer":"/paths/~1beneficiaries/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a Beneficiary","isWebhook":false,"deprecated":true,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Creates a beneficiary with information such as name, contact, address, and banking 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/Beneficiary"}},"schemaId":"components/schemas/Beneficiary","pointer":"/paths/~1beneficiaries/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/beneficiaries","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/Beneficiary"}},"responseCodes":["201","400"],"pointer":"/beneficiaries","href":"beneficiary/createbeneficiary","openApiOperationId":"createBeneficiary","summary":"Create a Beneficiary"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.glomopay.com/api/v1","description":"Production server"}],"schemaId":"components/schemas/Beneficiary","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/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/Beneficiary"}},"schemaId":"components/schemas/Beneficiary"},{"code":"400","description":"Bad request"}],"pointer":"/paths/~1beneficiaries/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/Beneficiary","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Beneficiary"}}},{"code":"400"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/beneficiary/createbeneficiary"}],"panels":[]}]},"httpPath":"/beneficiaries"},{"type":"link","label":"Beneficiary","link":"/api-documentation/apis/openapi/beneficiary/beneficiary","routeSlug":"/api-documentation/apis/openapi/beneficiary/beneficiary","httpVerb":"schema","content":{"contentType":"item","itemVariant":"schema","meta":{"name":"Beneficiary"},"seo":{"title":"Beneficiary"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Beneficiary","showPageActions":true}],"panels":[]},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"schemaDefinition","attributes":{"showWriteOnly":true,"schemaRef":"#/components/schemas/Beneficiary"},"children":[]}]}]}}],"content":{"contentType":"group","meta":{"name":"Beneficiary"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Beneficiary","showPageActions":true},{"nodeType":"markdoc","content":"This resource represents a payee of a payout initiated by your business. The beneficiary can be an individual or a business to whom you will send funds."}],"panels":[{"children":[{"kind":"group-items","title":"Schemas","titleTranslationKey":"schemas","items":[{"title":"Beneficiary","link":"/beneficiary/beneficiary","deprecated":false}]},{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/beneficiaries","summary":"List all Beneficiaries","prefix":{"name":"get","color":"get"},"badges":[],"link":"/beneficiary/getbeneficiaries","deprecated":false},{"title":"/beneficiaries/{id}","summary":"Retrieve a beneficiary","prefix":{"name":"get","color":"get"},"badges":[],"link":"/beneficiary/getbeneficiarybyid","deprecated":false},{"title":"/beneficiaries","summary":"Create a Beneficiary","prefix":{"name":"post","color":"http-deprecated"},"badges":[],"link":"/beneficiary/createbeneficiary","deprecated":true}]}]}]}]}},{"type":"group","label":"Beneficiary V2","link":"/api-documentation/apis/openapi/beneficiary_v2","routeSlug":"/api-documentation/apis/openapi/beneficiary_v2","items":[{"label":"Create a Beneficiary","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-documentation/apis/openapi/beneficiary_v2/createbeneficiaryv2","routeSlug":"/api-documentation/apis/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","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_251","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_251","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":"422","description":"Unprocessable Entity - Business logic errors (e.g., duplicate bank account)","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_252","exampleIds":["paths/~1v2~1beneficiaries/post/responses/422/content/application~1json/examples/duplicate_account"]}},"schemaId":"schema_252","exampleIds":["paths/~1v2~1beneficiaries/post/responses/422/content/application~1json/examples/duplicate_account"]}],"pointer":"/paths/~1v2~1beneficiaries/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"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_251","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_251","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":"422","schemaId":"schema_252","exampleIds":["paths/~1v2~1beneficiaries/post/responses/422/content/application~1json/examples/duplicate_account"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_252","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-documentation/apis/openapi/beneficiary_v2/listbeneficiariesv2","routeSlug":"/api-documentation/apis/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_253","description":"Filter beneficiaries by status.","example":"active"},{"name":"page","in":"query","schemaId":"schema_254","description":"Page number for pagination.","example":1},{"name":"per_page","in":"query","schemaId":"schema_254","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_253"},{"name":"page","in":"query","required":false,"example":1,"schemaId":"schema_254"},{"name":"per_page","in":"query","required":false,"example":20,"schemaId":"schema_254"}],"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_255","exampleIds":["paths/~1v2~1beneficiaries/get/responses/200/content/application~1json/example"]}},"schemaId":"schema_255","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_256","exampleIds":["paths/~1v2~1beneficiaries/get/responses/400/content/application~1json/example"]}},"schemaId":"schema_256","exampleIds":["paths/~1v2~1beneficiaries/get/responses/400/content/application~1json/example"]}],"pointer":"/paths/~1v2~1beneficiaries/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_255","exampleIds":["paths/~1v2~1beneficiaries/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_255","exampleIds":["paths/~1v2~1beneficiaries/get/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_256","exampleIds":["paths/~1v2~1beneficiaries/get/responses/400/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_256","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-documentation/apis/openapi/beneficiary_v2/getbeneficiarybyidv2","routeSlug":"/api-documentation/apis/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_177","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_177"}],"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","headerTitle":"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-documentation/apis/openapi/beneficiary_v2/mockreviewbeneficiaryv2","routeSlug":"/api-documentation/apis/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_177","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_257","exampleIds":["paths/~1v2~1beneficiaries~1{id}~1mock-review/patch/requestBody/content/application~1json/example"]}},"schemaId":"schema_257","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_177"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_257","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_257","exampleIds":["paths/~1v2~1beneficiaries~1{id}~1mock-review/patch/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_257","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_258","exampleIds":["paths/~1v2~1beneficiaries~1{id}~1mock-review/patch/responses/200/content/application~1json/example"]}},"schemaId":"schema_258","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_259","exampleIds":["paths/~1v2~1beneficiaries~1{id}~1mock-review/patch/responses/400/content/application~1json/example"]}},"schemaId":"schema_259","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_260","exampleIds":["paths/~1v2~1beneficiaries~1{id}~1mock-review/patch/responses/422/content/application~1json/example"]}},"schemaId":"schema_260","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","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_258","exampleIds":["paths/~1v2~1beneficiaries~1{id}~1mock-review/patch/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_258","exampleIds":["paths/~1v2~1beneficiaries~1{id}~1mock-review/patch/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_259","exampleIds":["paths/~1v2~1beneficiaries~1{id}~1mock-review/patch/responses/400/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_259","exampleIds":["paths/~1v2~1beneficiaries~1{id}~1mock-review/patch/responses/400/content/application~1json/example"]}}},{"code":"422","schemaId":"schema_260","exampleIds":["paths/~1v2~1beneficiaries~1{id}~1mock-review/patch/responses/422/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_260","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"},{"type":"link","label":"BeneficiaryV2","link":"/api-documentation/apis/openapi/beneficiary_v2/beneficiaryv2","routeSlug":"/api-documentation/apis/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":[]}]}]}}],"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-documentation/apis/openapi/bank_account_validation","routeSlug":"/api-documentation/apis/openapi/bank_account_validation","items":[{"label":"Validate any bank account","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-documentation/apis/openapi/bank_account_validation/validatebankaccount","routeSlug":"/api-documentation/apis/openapi/bank_account_validation/validatebankaccount","metadata":{"seo":{"title":"Validate any bank account","description":"Validate any bank account"}},"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":"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_261"}},"schemaId":"schema_261","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_261"}},"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_261","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_261"}},"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","headerTitle":"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-documentation/apis/openapi/bank_account_validation/getbankaccountvalidations","routeSlug":"/api-documentation/apis/openapi/bank_account_validation/getbankaccountvalidations","metadata":{"seo":{"title":"List all bank account validations","description":"List all bank account validations"}},"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":"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_177","description":"The ID of the beneficiary bank account to filter validations","example":"bene_5JU9yv0lGSUP"},{"name":"country","in":"query","schemaId":"schema_262","description":"The ISO 3166-1 alpha-3 code of the country to filter validations"},{"name":"before","in":"query","schemaId":"schema_168","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"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 in UTC to filter resources created before this time. Use this to avoid "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Page drift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" issue. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"./pagination#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_168","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"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 in UTC to filter resources created after this time. Use this to avoid "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Page drift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" issue. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"./pagination#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_169","description":"Number of resources per page. Should be between 1 and 100."},{"name":"page","in":"query","schemaId":"schema_170","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_177"},{"name":"country","in":"query","example":"Ind","schemaId":"schema_262"},{"name":"before","in":"query","example":"2025-02-18T12:03:44Z","schemaId":"schema_168"},{"name":"after","in":"query","example":"2025-01-18T12:03:44Z","schemaId":"schema_168"},{"name":"per_page","in":"query","schemaId":"schema_169"},{"name":"page","in":"query","schemaId":"schema_170"}],"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_263"}},"schemaId":"schema_263"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_172"}},"schemaId":"schema_172"}],"pointer":"/paths/~1bank_account_validation/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_263","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_263"}}},{"code":"400","schemaId":"schema_172","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_172"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/bank_account_validation/getbankaccountvalidations"}],"panels":[]}]},"httpPath":"/bank_account_validation"},{"type":"link","label":"BankAccountValidation","link":"/api-documentation/apis/openapi/bank_account_validation/bankaccountvalidation","routeSlug":"/api-documentation/apis/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":[]}]}]}}],"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-documentation/apis/openapi/document","routeSlug":"/api-documentation/apis/openapi/document","items":[{"label":"Create a new document","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-documentation/apis/openapi/document/createdocument","routeSlug":"/api-documentation/apis/openapi/document/createdocument","metadata":{"seo":{"title":"Create a new document","description":"Create a new document"}},"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":"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_264"}},"schemaId":"schema_264","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_264"}},"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_264","mediaTypes":["multipart/form-data"],"mediaTypeSchemas":{"multipart/form-data":{"schemaId":"schema_264"}},"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","headerTitle":"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-documentation/apis/openapi/document/getdocuments","routeSlug":"/api-documentation/apis/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_168","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"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 in UTC to filter resources created before this time. Use this to avoid "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Page drift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" issue. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"./pagination#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_168","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"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 in UTC to filter resources created after this time. Use this to avoid "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Page drift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" issue. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"./pagination#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_169","description":"Number of resources per page. Should be between 1 and 100."},{"name":"page","in":"query","schemaId":"schema_170","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_168"},{"name":"after","in":"query","example":"2025-01-18T12:03:44Z","schemaId":"schema_168"},{"name":"per_page","in":"query","schemaId":"schema_169"},{"name":"page","in":"query","schemaId":"schema_170"}],"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_265"}},"schemaId":"schema_265"},{"code":"400","description":"Bad request"}],"pointer":"/paths/~1document/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_265","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_265"}}},{"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-documentation/apis/openapi/document/getdocumentbyid","routeSlug":"/api-documentation/apis/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_266","description":"ID of the document to retrieve","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_266"}],"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_267"}},"schemaId":"schema_267"},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_219"}},"schemaId":"schema_219"},{"code":"404","description":"Document not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_268"}},"schemaId":"schema_268"}],"pointer":"/paths/~1document~1{document_id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/Document","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Document"}}},{"code":"400","schemaId":"schema_267","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_267"}}},{"code":"401","schemaId":"schema_219","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_219"}}},{"code":"404","schemaId":"schema_268","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_268"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/document/getdocumentbyid"}],"panels":[]}]},"httpPath":"/document/{document_id}"},{"type":"link","label":"Document","link":"/api-documentation/apis/openapi/document/document","routeSlug":"/api-documentation/apis/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":[]}]}]}}],"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-documentation/apis/openapi/internal_transfer","routeSlug":"/api-documentation/apis/openapi/internal_transfer","items":[{"label":"Create an internal transfer","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-documentation/apis/openapi/internal_transfer/createinternaltransfer","routeSlug":"/api-documentation/apis/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_269"}},"schemaId":"schema_269"},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_219"}},"schemaId":"schema_219"}],"pointer":"/paths/~1internal-transfer/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/InternalTransfer","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/InternalTransfer"}}},{"code":"400","schemaId":"schema_269","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_269"}}},{"code":"401","schemaId":"schema_219","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_219"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/internal_transfer/createinternaltransfer"}],"panels":[]}]},"httpPath":"/internal-transfer"},{"type":"link","label":"InternalTransfer","link":"/api-documentation/apis/openapi/internal_transfer/internaltransfer","routeSlug":"/api-documentation/apis/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":[]}]}]}}],"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-documentation/apis/openapi/settlement","routeSlug":"/api-documentation/apis/openapi/settlement","items":[{"label":"Create a new settlement","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-documentation/apis/openapi/settlement/createsettlement","routeSlug":"/api-documentation/apis/openapi/settlement/createsettlement","metadata":{"seo":{"title":"Create a new settlement","description":"Create a new settlement"}},"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":"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_270"}},"schemaId":"schema_270"},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_271"}},"schemaId":"schema_271"},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_272"}},"schemaId":"schema_272"}],"pointer":"/paths/~1settlements/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/Settlement","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Settlement"}}},{"code":"400","schemaId":"schema_270","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_270"}}},{"code":"403","schemaId":"schema_271","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_271"}}},{"code":"404","schemaId":"schema_272","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_272"}}}],"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-documentation/apis/openapi/settlement/getsettlements","routeSlug":"/api-documentation/apis/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_168","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"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 in UTC to filter resources created before this time. Use this to avoid "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Page drift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" issue. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"./pagination#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_168","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"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 in UTC to filter resources created after this time. Use this to avoid "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Page drift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" issue. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"./pagination#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_169","description":"Number of resources per page. Should be between 1 and 100."},{"name":"page","in":"query","schemaId":"schema_170","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_168"},{"name":"after","in":"query","example":"2025-01-18T12:03:44Z","schemaId":"schema_168"},{"name":"per_page","in":"query","schemaId":"schema_169"},{"name":"page","in":"query","schemaId":"schema_170"}],"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_273"}},"schemaId":"schema_273"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_172"}},"schemaId":"schema_172"}],"pointer":"/paths/~1settlements/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_273","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_273"}}},{"code":"400","schemaId":"schema_172","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_172"}}}],"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-documentation/apis/openapi/settlement/triggermocksettlement","routeSlug":"/api-documentation/apis/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_274"}},"schemaId":"schema_274"},{"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","headerTitle":"Response","responseCodes":[{"code":"202","schemaId":"schema_274","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_274"}}},{"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-documentation/apis/openapi/settlement/getsettlementbyid","routeSlug":"/api-documentation/apis/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_177","description":"The unique identifier of the settlement","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_177"}],"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_172"}},"schemaId":"schema_172"},{"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","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/Settlement","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Settlement"}}},{"code":"400","schemaId":"schema_172","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_172"}}},{"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-documentation/apis/openapi/settlement/gettransactionslinkedtosettlement","routeSlug":"/api-documentation/apis/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_177","description":"The unique identifier of the settlement","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_168","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"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 in UTC to filter resources created before this time. Use this to avoid "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Page drift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" issue. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"./pagination#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_168","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"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 in UTC to filter resources created after this time. Use this to avoid "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Page drift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" issue. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"./pagination#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_169","description":"Number of resources per page. Should be between 1 and 100."},{"name":"page","in":"query","schemaId":"schema_170","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_177"}],"query":[{"name":"before","in":"query","example":"2025-02-18T12:03:44Z","schemaId":"schema_168"},{"name":"after","in":"query","example":"2025-01-18T12:03:44Z","schemaId":"schema_168"},{"name":"per_page","in":"query","schemaId":"schema_169"},{"name":"page","in":"query","schemaId":"schema_170"}],"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_275"}},"schemaId":"schema_275"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_172"}},"schemaId":"schema_172"},{"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","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_275","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_275"}}},{"code":"400","schemaId":"schema_172","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_172"}}},{"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"},{"type":"link","label":"Settlement","link":"/api-documentation/apis/openapi/settlement/settlement","routeSlug":"/api-documentation/apis/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":[]}]}]}}],"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-documentation/apis/openapi/virtual_account","routeSlug":"/api-documentation/apis/openapi/virtual_account","items":[{"label":"List all Virtual Accounts","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-documentation/apis/openapi/virtual_account/getvirtualaccounts","routeSlug":"/api-documentation/apis/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_276","description":"Filter virtual accounts by currency"},{"name":"before","in":"query","schemaId":"schema_168","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"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 in UTC to filter resources created before this time. Use this to avoid "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Page drift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" issue. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"./pagination#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_168","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"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 in UTC to filter resources created after this time. Use this to avoid "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Page drift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" issue. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"./pagination#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_169","description":"Number of resources per page. Should be between 1 and 100."},{"name":"page","in":"query","schemaId":"schema_170","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_168"},{"name":"after","in":"query","example":"2025-01-18T12:03:44Z","schemaId":"schema_168"},{"name":"per_page","in":"query","schemaId":"schema_169"},{"name":"page","in":"query","schemaId":"schema_170"}],"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_277"}},"schemaId":"schema_277"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_278"}},"schemaId":"schema_278"},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_219"}},"schemaId":"schema_219"}],"pointer":"/paths/~1virtual-accounts/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_277","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_277"}}},{"code":"400","schemaId":"schema_278","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_278"}}},{"code":"401","schemaId":"schema_219","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_219"}}}],"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-documentation/apis/openapi/virtual_account/closevirtualaccount","routeSlug":"/api-documentation/apis/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_279","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_276","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_279"},{"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_280"}},"schemaId":"schema_280"},{"code":"400","description":"Bad request - Active account not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_281"}},"schemaId":"schema_281"},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_219"}},"schemaId":"schema_219"}],"pointer":"/paths/~1virtual-accounts/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_280","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_280"}}},{"code":"400","schemaId":"schema_281","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_281"}}},{"code":"401","schemaId":"schema_219","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_219"}}}],"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-documentation/apis/openapi/virtual_account/createvirtualaccountv2","routeSlug":"/api-documentation/apis/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/glomo-webhooks#virtual-account-webhooks"},"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_282"}},"schemaId":"schema_282","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_282"}},"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_282","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_282"}},"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_283","exampleIds":["paths/~1v2~1virtual-accounts/post/responses/202/content/application~1json/example"]}},"schemaId":"schema_283","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_278"}},"schemaId":"schema_278"},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_219"}},"schemaId":"schema_219"},{"code":"409","description":"Conflict - Record already exists","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_284"}},"schemaId":"schema_284"}],"pointer":"/paths/~1v2~1virtual-accounts/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"202","schemaId":"schema_283","exampleIds":["paths/~1v2~1virtual-accounts/post/responses/202/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_283","exampleIds":["paths/~1v2~1virtual-accounts/post/responses/202/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_278","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_278"}}},{"code":"401","schemaId":"schema_219","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_219"}}},{"code":"409","schemaId":"schema_284","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_284"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/virtual_account/createvirtualaccountv2"}],"panels":[]}]},"httpPath":"/v2/virtual-accounts"},{"type":"link","label":"VirtualAccount","link":"/api-documentation/apis/openapi/virtual_account/virtualaccount","routeSlug":"/api-documentation/apis/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":[]}]}]}}],"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-documentation/apis/openapi/platform","routeSlug":"/api-documentation/apis/openapi/platform","items":[{"label":"Onboard a merchant","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-documentation/apis/openapi/platform/onboardmerchant","routeSlug":"/api-documentation/apis/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 but is in pending state. This can happen if we require more information.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_285"}},"schemaId":"schema_285"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_269"}},"schemaId":"schema_269"},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_219"}},"schemaId":"schema_219"}],"pointer":"/paths/~1platform~1merchants/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/MerchantCreateResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/MerchantCreateResponse"}}},{"code":"202","schemaId":"schema_285","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_285"}}},{"code":"400","schemaId":"schema_269","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_269"}}},{"code":"401","schemaId":"schema_219","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_219"}}}],"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-documentation/apis/openapi/platform/getmerchant","routeSlug":"/api-documentation/apis/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_286","description":"Unique identifier of the merchant","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_286"}],"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_287"}},"schemaId":"schema_287"},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_288"}},"schemaId":"schema_288"},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_289"}},"schemaId":"schema_289"}],"pointer":"/paths/~1platform~1merchants~1{merchant_id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/Merchant","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Merchant"}}},{"code":"400","schemaId":"schema_287","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_287"}}},{"code":"401","schemaId":"schema_288","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_288"}}},{"code":"404","schemaId":"schema_289","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_289"}}}],"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-documentation/apis/openapi/platform/updatemerchant","routeSlug":"/api-documentation/apis/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_286","description":"Unique identifier of the merchant","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_286"}],"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_290"}},"schemaId":"schema_290"},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_288"}},"schemaId":"schema_288"},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_291"}},"schemaId":"schema_291"}],"pointer":"/paths/~1platform~1merchants~1{merchant_id}/patch/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/Merchant","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Merchant"}}},{"code":"400","schemaId":"schema_290","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_290"}}},{"code":"401","schemaId":"schema_288","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_288"}}},{"code":"404","schemaId":"schema_291","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_291"}}}],"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-documentation/apis/openapi/platform/updatemerchantstatus","routeSlug":"/api-documentation/apis/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_292"}},"schemaId":"schema_292","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_292"}},"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_292","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_292"}},"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_293"}},"schemaId":"schema_293"},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_294"}},"schemaId":"schema_294"}],"pointer":"/paths/~1platform~1merchants~1status-update/patch/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/Merchant","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Merchant"}}},{"code":"400","schemaId":"schema_293","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_293"}}},{"code":"401","schemaId":"schema_294","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_294"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/platform/updatemerchantstatus"}],"panels":[]}]},"httpPath":"/platform/merchants/status-update"},{"type":"link","label":"Merchant","link":"/api-documentation/apis/openapi/platform/merchant","routeSlug":"/api-documentation/apis/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":[]}]}]}}],"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-documentation/apis/openapi/kyclink","routeSlug":"/api-documentation/apis/openapi/kyclink","items":[{"label":"List KYC links","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-documentation/apis/openapi/kyclink/listkyclinks","routeSlug":"/api-documentation/apis/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_295","description":"Filter KYC links by status.","example":"completed"},{"name":"before","in":"query","schemaId":"schema_168","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"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 in UTC to filter resources created before this time. Use this to avoid "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Page drift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" issue. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"./pagination#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_168","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"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 in UTC to filter resources created after this time. Use this to avoid "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Page drift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" issue. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"./pagination#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_169","description":"Number of resources per page. Should be between 1 and 100."},{"name":"page","in":"query","schemaId":"schema_170","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_295"},{"name":"before","in":"query","example":"2025-02-18T12:03:44Z","schemaId":"schema_168"},{"name":"after","in":"query","example":"2025-01-18T12:03:44Z","schemaId":"schema_168"},{"name":"per_page","in":"query","schemaId":"schema_169"},{"name":"page","in":"query","schemaId":"schema_170"}],"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_296"}},"schemaId":"schema_296"},{"code":"400","description":"Bad request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_297"}},"schemaId":"schema_297"},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_219"}},"schemaId":"schema_219"}],"pointer":"/paths/~1kyc-links/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_296","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_296"}}},{"code":"400","schemaId":"schema_297","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_297"}}},{"code":"401","schemaId":"schema_219","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_219"}}}],"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-documentation/apis/openapi/kyclink/createkyclink","routeSlug":"/api-documentation/apis/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_298","exampleIds":["paths/~1kyc-links/post/requestBody/content/application~1json/example"]}},"schemaId":"schema_298","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_298","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_298","exampleIds":["paths/~1kyc-links/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_298","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_299","exampleIds":["paths/~1kyc-links/post/responses/201/content/application~1json/example"]}},"schemaId":"schema_299","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_300"}},"schemaId":"schema_300"},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_219"}},"schemaId":"schema_219"}],"pointer":"/paths/~1kyc-links/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"schema_299","exampleIds":["paths/~1kyc-links/post/responses/201/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_299","exampleIds":["paths/~1kyc-links/post/responses/201/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_300","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_300"}}},{"code":"401","schemaId":"schema_219","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_219"}}}],"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-documentation/apis/openapi/kyclink/getkyclinkbyid","routeSlug":"/api-documentation/apis/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_177","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_177"}],"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_219"}},"schemaId":"schema_219"},{"code":"404","description":"KYC link not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_301"}},"schemaId":"schema_301"}],"pointer":"/paths/~1kyc-links~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"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_219","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_219"}}},{"code":"404","schemaId":"schema_301","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_301"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/kyclink/getkyclinkbyid"}],"panels":[]}]},"httpPath":"/kyc-links/{id}"},{"type":"link","label":"KycLinkDetail","link":"/api-documentation/apis/openapi/kyclink/kyclinkdetail","routeSlug":"/api-documentation/apis/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":[]}]}]}}],"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-documentation/apis/openapi/investor_journey","routeSlug":"/api-documentation/apis/openapi/investor_journey","items":[{"label":"Create investor journey","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-documentation/apis/openapi/investor_journey/createinvestorjourney","routeSlug":"/api-documentation/apis/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_302","exampleIds":["paths/~1investor-journey/post/requestBody/content/application~1json/example"]}},"schemaId":"schema_302","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_302","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_302","exampleIds":["paths/~1investor-journey/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_302","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_303","exampleIds":["paths/~1investor-journey/post/responses/200/content/application~1json/example"]}},"schemaId":"schema_303","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_304","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_304","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_305","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_305","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","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_303","exampleIds":["paths/~1investor-journey/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_303","exampleIds":["paths/~1investor-journey/post/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_304","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_304","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_305","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_305","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-documentation/apis/openapi/rfi","routeSlug":"/api-documentation/apis/openapi/rfi","items":[{"label":"List RFIs","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/api-documentation/apis/openapi/rfi/getrfis","routeSlug":"/api-documentation/apis/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_306","description":"Filter RFIs by status.","example":"approved"},{"name":"search","in":"query","schemaId":"schema_177","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_168","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"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 in UTC to filter resources created before this time. Use this to avoid "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Page drift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" issue. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"./pagination#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_168","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"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 in UTC to filter resources created after this time. Use this to avoid "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Page drift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" issue. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"./pagination#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_169","description":"Number of resources per page. Should be between 1 and 100."},{"name":"page","in":"query","schemaId":"schema_170","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_306"},{"name":"search","in":"query","example":"rfi_6a7c5018ZGuKP","schemaId":"schema_177"},{"name":"before","in":"query","example":"2025-02-18T12:03:44Z","schemaId":"schema_168"},{"name":"after","in":"query","example":"2025-01-18T12:03:44Z","schemaId":"schema_168"},{"name":"per_page","in":"query","schemaId":"schema_169"},{"name":"page","in":"query","schemaId":"schema_170"}],"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_307"}},"schemaId":"schema_307"},{"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_308"}},"schemaId":"schema_308"},{"code":"401","description":"Unauthorized"}],"pointer":"/paths/~1rfis/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_307","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_307"}}},{"code":"400","schemaId":"schema_308","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_308"}}},{"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-documentation/apis/openapi/rfi/getrfi","routeSlug":"/api-documentation/apis/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-documentation/apis/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_177","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_177"}],"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","headerTitle":"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-documentation/apis/openapi/rfi/respondrfi","routeSlug":"/api-documentation/apis/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)."}},"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)."},"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":"../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 webhook."},"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_177","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_309"}},"schemaId":"schema_309","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_177"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"JWT","type":"http","scheme":"bearer","bearerFormat":"JWT"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_309"}},"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_309","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_309"}},"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":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bad request. Causes include a missing or empty "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"documents"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" array, a document that supplies neither "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"doc_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" nor "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"doc_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", an identifier with the wrong prefix, an "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rfi_doc_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" that does not match a requirement on the RFI, or a referenced document that is not in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"uploaded"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" state."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_310"}},"schemaId":"schema_310"},{"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, or expired — and cannot be responded to."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_311"}},"schemaId":"schema_311"}],"pointer":"/paths/~1rfis~1{id}~1respond/patch/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/Rfi","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Rfi"}}},{"code":"400","schemaId":"schema_310","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_310"}}},{"code":"401"},{"code":"403"},{"code":"404","schemaId":"components/schemas/EntityNotFound","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EntityNotFound"}}},{"code":"422","schemaId":"schema_311","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_311"}}}],"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."},"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":"The available balance for all currencies.\n","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":"The pending balance for all currencies.\n","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":"The amount owed to Glomo, for all currencies. 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.\n","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":"The Funded Balance, broken down by state. This key is present only for merchants on the Funded Balance model; it is absent for all other merchants.\n","type":"object","properties":{"available":{"description":"The available balance, by currency, that can be drawn for debits.\n","type":"array","items":{"$ref":"#/components/schemas/Balance"}},"pending":{"description":"The pending balance, by currency, awaiting maturity to available.\n","type":"array","items":{"$ref":"#/components/schemas/Balance"}},"deficit":{"description":"The amount, by currency, owed to Glomo. 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.\n","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":"The the conversion rate used for the currency(ies) for a given transaction.\n","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","format":"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":["success","failed","pending"],"description":"The status of the balance conversion.\n","example":"success"},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"The date and time the balance conversion was created.\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":{"$ref":"#/components/schemas/Money","description":"The fee charged for the bank account validation process.\n"}}}},"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, case-insensitive","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"},"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/Beneficiary":{"id":"components/schemas/Beneficiary","kind":"json-schema","title":"Beneficiary","data":{"type":"object","x-tags":["Beneficiary"],"properties":{"id":{"type":"string","readOnly":true,"description":"The unique identifier for the beneficiary.\n","example":"bene_5JU9yv0lGSUP"},"holder_name":{"type":"string","description":"The name of the beneficiary.\n","example":"Test Arts & Crafts Pvt Ltd"},"account_number":{"type":"string","description":"The account number of the beneficiary.\n","example":"1234567890"},"bank_name":{"type":"string","description":"The name of the bank where the account is held.\n","example":"Yes Bank"},"beneficiary_type":{"type":"string","enum":["individual","business"],"description":"The type of beneficiary\n"},"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"},"email":{"type":"string","format":"email","description":"The email address of the beneficiary.\n","example":"prabhat+beneficiaryArt@glomopay.com"},"address_line1":{"type":"string","description":"The street address of the beneficiary.\n","example":"123 Main St"},"address_line2":{"type":"string","description":"The second line of street address of the beneficiary.\n","example":"Near Apts"},"city":{"type":"string","description":"The city where the beneficiary is located.\n","example":"Anytown"},"state":{"type":"string","description":"The state where the beneficiary 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 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":"Ind"},"pincode":{"type":"string","description":"The postal code of the beneficiary's address.\n","example":"560048"},"nickname":{"type":"string","description":"A nickname for the beneficiary.\n","example":"Test Beneficiary"},"intermediate_bank_name":{"type":"string","description":"The name of the intermediate bank, if any.\n","example":"Intermediate Bank"},"intermediate_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, if any. 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"},"intermediate_bank_swift_code":{"type":"string","description":"The SWIFT code of the intermediate bank, if any.\n","example":"INTBANKSWIFT"},"created_at":{"type":"string","format":"timestamp","readOnly":true,"description":"Timestamp representing when the beneficiary was created\n","example":"2021-06-01T12:00:00Z"},"updated_at":{"type":"string","format":"timestamp","readOnly":true,"description":"Timestamp representing when the beneficiary was last updated\n","example":"2021-06-01T12:00:00Z"}}}},"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/Notes":{"id":"components/schemas/Notes","kind":"json-schema","title":"Notes","data":{"type":["object","null"],"additionalProperties":{"type":"string"},"description":"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. If your business has custom field rules configured (e.g. enum constraints), values are validated against those rules. Each key appears as a separate column in CSV report exports, with corresponding values populating the rows.\n","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":"The current review status of the beneficiary.\n","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":[]}]}]}]}],"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":"The name of the beneficiary. This is a required field.\n","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","postal_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. All fields except address_line2 are required."},"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 (required).","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":"../../../../product-guide/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":"../../../../product-guide/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":"../../../../product-guide/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","postal_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, all fields except address_line2 are required."},"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 (required).","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/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":"The name of the customer.\n","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","description":"The date of birth of the customer\n","example":"2003-11-29"},"nationality":{"type":"string","description":"The nationality of the customer\n","example":"IND"},"tax_identification_number":{"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":"Applicable only to the LRS (Liberalised Remittance Scheme / resident-India remittance) flow."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" The customer's PAN (tax identification number), populated only for customers onboarded under LRS and absent otherwise. 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"},"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":"/api-documentation/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":"timestamp","readOnly":true,"description":"Timestamp representing when the customer was created\n","example":"2021-06-01T12:00:00Z"},"updated_at":{"type":"string","format":"timestamp","readOnly":true,"description":"Timestamp representing when the customer was last updated\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/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":"timestamp","readOnly":true,"description":"Timestamp representing when the document was created\n","example":"2021-06-01T12:00:00Z"},"updated_at":{"type":"string","format":"timestamp","readOnly":true,"description":"Timestamp representing when the document was last updated\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/Orders":{"id":"components/schemas/Orders","kind":"json-schema","title":"Orders","data":{"type":"object","x-tags":["Orders"],"properties":{"id":{"type":"string","format":"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","paid","failed","action_required","under_review","expired"],"description":"The status of the Order.\n","example":"active"},"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 and GBP."},"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":"Purpose code for why you want to receive this payment\n","example":"P1401"},"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":"The amount in cents for which invoice was generated. It can be more  than the amount requested in this order\n","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"}},"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.\n","example":["card"]},"created_at":{"type":"string","format":"timestamp","readOnly":true,"description":"Timestamp representing when the order was created\n","example":"2021-06-01T12:00:00Z"},"updated_at":{"type":"string","format":"timestamp","readOnly":true,"description":"Timestamp representing when the order was last updated\n","example":"2021-06-01T12:00:00Z"},"request_id":{"type":"string","description":"Optional idempotency key.\n","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","format":"string","readOnly":true,"description":"The unique identifier for the order.\n","example":"order_678a4c88hpAjf"},"status":{"type":"string","readOnly":true,"enum":["active","paid","failed","action_required","under_review","expired"],"description":"The status of the Order.\n","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"}]},"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":"timestamp","readOnly":true,"description":"Timestamp representing when the order was created\n","example":"2021-06-01T12:00:00Z"},"updated_at":{"type":"string","format":"timestamp","readOnly":true,"description":"Timestamp representing when the order was last updated\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"},"purpose_code":{"type":"string","description":"Purpose code for why you want to receive this payment.\n","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":"The amount in cents for which invoice was generated. It can be more than the amount requested in this order.\n","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":"Optional idempotency key.\n","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","format":"string","readOnly":true,"description":"The unique identifier for the payment link.\n","example":"payin_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","paid","failed","action_required","cancelled","partially_paid","under_review","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":[]}]}]}],"example":"success"},"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.\n","example":["card"]},"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 and GBP."},"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":"Purpose code for why you want to receive this payment\n","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":"timestamp","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Date when the payment_link will expire. Expiry can not be less than or equal  to current date and can be upto 6 months in future."},"children":[]}]}]}],"example":"2025-02-15T00:00:00.000Z"},"last_reminder_sent_at":{"type":"string","format":"timestamp","readOnly":true,"description":"Last time when the customer was reminded to complete the payment by  visiting the link\n","example":"2024-09-13T06:32:34.340Z"},"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 in cents for which invoice was generated. It can be more  than the amount requested in this payment_link"},"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":"timestamp","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Timestamp representing when the payment_link was created"},"children":[]}]}]}],"example":"2021-06-01T12:00:00Z"},"updated_at":{"type":"string","format":"timestamp","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Timestamp representing when the payment_link was last updated"},"children":[]}]}]}],"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","format":"string","readOnly":true,"description":"The unique identifier for the payment link.\n","example":"payin_678a4c88hpAjf"},"status":{"type":"string","readOnly":true,"enum":["active","paid","failed","action_required","cancelled","partially_paid","under_review","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":[]}]}]}],"example":"success"},"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","format":"timestamp","readOnly":true,"description":"Last time when the customer was reminded to complete the payment by visiting the link\n","example":"2024-09-13T06:32:34.340Z"},"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":"timestamp","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Timestamp representing when the payment_link was created"},"children":[]}]}]}],"example":"2021-06-01T12:00:00Z"},"updated_at":{"type":"string","format":"timestamp","readOnly":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Timestamp representing when the payment_link was last updated"},"children":[]}]}]}],"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":"Purpose code for why you want to receive this payment.\n","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 in cents for which invoice was generated. It can be more than the amount requested in this payment_link."},"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","format":"uuid","readOnly":true,"description":"The unique identifier for the payin.\n","example":"payout_DdWp_HUbOnlg"},"status":{"type":"string","readOnly":true,"enum":["pending_approval","in_progress","action_required","success","failed","cancelled"],"description":"The status of the payout.\n","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, expressed in the smallest unit of the specified currency (e.g., cents for USD, paisa for INR)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For example, 1000 represents $10.00 in USD. The actual currency is determined by the currency field. Note: \"cents\" is used generically to denote"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the minimal currency unit, not necessarily 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, also specified in the smallest unit of the selected currency. For example, 1000 equates to $10.00 in USD. The currency field determines which currency is used. As with destination_amount, \"cents\" is a placeholder for the minimal unit, not specifically 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","format":"uuid","description":"The unique identifier for the beneficiary.\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":"Purpose code for why you want to receive this payment\n","example":"S0017"},"mid_market_rate":{"type":"object","readOnly":true,"properties":{"currency":{"type":["string","null"],"format":"iso-4217","description":"The destination currency code","example":"USD"},"rate":{"type":["number","null"],"format":"float","description":"The conversion rate factor","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","format":"iso-4217","description":"The currency code for the FX fee","example":"USD"},"amount":{"type":"number","description":"The amount of the FX fee","example":200}},"description":"The foreign exchange fees applied to the payout"},"txn_fee":{"type":"object","properties":{"currency":{"type":"string","format":"iso-4217","description":"The currency code for the transaction fee","example":"USD"},"amount":{"type":"number","description":"The amount of the transaction fee","example":100}},"description":"The transaction fees applied to the payout"}},"description":"The fees applied to this payout\n"},"created_at":{"type":"string","format":"timestamp","readOnly":true,"description":"Timestamp representing when the payout was created\n","example":"2021-06-01T12:00:00Z"},"updated_at":{"type":"string","format":"timestamp","readOnly":true,"description":"Timestamp representing when the payout was last updated\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 client-provided unique identifier for this payout request. Can be used to look up the payout via "},"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",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":"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":"The invoice reference provided when the payout was created.\n","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","PAYOUT_REJECTED","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":"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":"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":[]}]}]}]},"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":"Purpose code for this payout.\n","example":"PYR002"},"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":"The currency from which the amount is deducted from your source balance.\n","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 the source currency (e.g. 1000 equates to $10.00 in USD)."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","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 the destination currency (e.g. cents for USD, paisa for INR)."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","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","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":"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":"An optional invoice reference for this payout.\n","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":"A unique client-generated identifier for this payout request. 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 for your business, the API returns a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"409 Conflict"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" response. Use this to safely retry payout creation without risk of creating duplicates. You can look up the existing payout using "},"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":"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":"Purpose code for this payout.\n","example":"PYR002"},"invoice_number":{"type":"string","maxLength":50,"description":"An optional invoice reference for this payout.\n","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":"A unique client-generated identifier for this payout request. 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 for your business, the API returns a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"409 Conflict"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" response. Use this to safely retry payout creation without risk of creating duplicates. You can look up the existing payout using "},"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":"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"},"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 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","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"},"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 the source currency (e.g., cents for USD, paisa for INR)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For example, 10000 represents $100.00 in USD."},"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":"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 the destination currency."},"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":"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"],"description":"The payment method. Card is not supported for quotes.\n","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. 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","subtype"],"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":[]}]}]}]},"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"},"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"],"description":"The payment method for this quote.","example":"bank_transfer"},"subtype":{"type":"string","enum":["local_transfer","swift_transfer"],"description":"The payment method subtype for this quote.","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. Local transfers to INR yield one quote per rail ("},"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":"); SWIFT transfers yield a single "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"swift"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" quote."},"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":"The exchange rate applied for this quote.\n","example":90},"source_amount":{"type":"integer","readOnly":true,"description":"The total source amount in the smallest unit of the source currency.\n","example":10000},"destination_amount":{"type":"integer","readOnly":true,"description":"The destination amount in the smallest unit of the destination currency.\n","example":882000},"fees":{"type":"object","readOnly":true,"properties":{"txn_fee":{"type":"object","properties":{"currency":{"type":"string","format":"iso-4217","description":"The currency code for the transaction fee","example":"USD"},"amount":{"type":"integer","description":"The transaction fee in the smallest unit of the currency","example":100}},"description":"The transaction fee applied to this quote"},"fx_fee":{"type":"object","properties":{"currency":{"type":"string","format":"iso-4217","description":"The currency code for the FX fee","example":"USD"},"amount":{"type":"integer","description":"The FX fee in the smallest unit of the currency","example":100}},"description":"The foreign exchange fee applied to this quote"},"referral_fee":{"type":"object","properties":{"currency":{"type":"string","format":"iso-4217","description":"The currency code for the referral fee","example":"USD"},"amount":{"type":"integer","description":"The referral fee in the smallest unit of the currency","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/MockUpdatePayoutStatusRequest":{"id":"components/schemas/MockUpdatePayoutStatusRequest","kind":"json-schema","title":"MockUpdatePayoutStatusRequest","data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The unique identifier for the payout.\n","example":"payout_E602dMzgjpDC"},"status":{"type":"string","enum":["pending","success","failed","action_required","cancelled"],"description":"The status of the payout.\n","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 currency unit (cents). For example, 1800 cents is $18.00."},"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 currency unit (cents), aggregated across all rules for this fee bearer. For example, 250 cents is $2.50."},"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"],"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":"payin_E602dMzgjpDC"},"payin_type":{"type":["string","null"],"description":"The type of the payin. This is set only for payments associated to a payin.\n","enum":["payment_link","orders","add_funds"]},"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":["success","failed","action_required","in_progress","under_review"],"description":"The status of the payment.\n"},"compliance_status":{"type":["string","null"],"readOnly":true,"enum":["action_required","under_review","approved","rejected"],"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 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 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":"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 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":[]}]}]}],"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-documentation/apis/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":"The maximum number of documents that can be submitted for this requirement.\n","example":1}}}}}},"payment_currency":{"type":"string","format":"iso-4217, case-insensitive","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 in cents (includes customer-borne fees if applicable). For example, 374580 cents is 3,745.80 AED. The currency is determined by the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payment_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field."},"children":[]}]}]}],"example":374580},"converted_currency":{"type":"string","format":"iso-4217, case-insensitive","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 final amount after currency conversion in cents (includes all fees). For example, 102000 cents is $1,020.00. The currency is determined by the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"converted_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field."},"children":[]}]}]}],"example":102000},"requested_currency":{"type":"string","format":"iso-4217, case-insensitive","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 originally requested by the merchant in cents, excluding customer-borne fees. For example, 100000 cents is $1,000.00. The currency is determined by the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"requested_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field."},"children":[]}]}]}],"example":100000},"purpose_code":{"type":"string","description":"The purpose code of the payment. This should match the purpose code of the payin.\n","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":"../../../../product-guide/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"}},"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":"../../../../product-guide/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":"The timestamp at which the payment was completed. "},"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"],"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":"The creation timestamp of the payment.\n","example":"2024-12-06T11:38:37.130Z"},"updated_at":{"type":"string","readOnly":true,"format":"date-time","description":"The last update timestamp of the payment.\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, case-insensitive","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":"The card number.\n","example":"4111111111111111"},"expiry_month":{"type":"string","description":"The card expiry month (MM format).\n","example":"09"},"expiry_year":{"type":"string","description":"The card expiry year in 2-digit (YY) format. Send the last two digits of the expiry year (e.g. for 2030, send '30').\n","example":"30"},"cvv":{"type":"string","description":"The card CVV/CVC code.\n","example":"123"}},"required":["holder_name","number","expiry_month","expiry_year","cvv"]},"callback_url":{"type":"string","format":"uri","description":"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.\n","example":"https://server.yoursite.com/payment/callback"},"request_id":{"type":"string","description":"Idempotency key. Required for subsequent payments, optional for initial payments.\n","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 minor units (cents). Required for subsequent subscription payments. 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":"."},"children":[]}]}]}],"example":1500},"currency":{"type":"string","format":"iso-4217, case-insensitive","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. Must match the subscription's currency for subsequent 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":["pending","success","failed","action_required","in_progress","under_review"],"description":"The current status of the payment.\n","example":"pending"},"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","format":"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","description":"The reason for the refund.\n","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":"The balance deducted to process the refund.\n","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":"The amount deducted in cents.\n","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":["success","failed","action_required","pending","under_review"],"description":"The status of the refund.\n","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 amount you want to receive in cents. For example, 1000 cents is $10.00.  The currency is determined by the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Cents"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is a general  term for the smallest unit of currency in any currency. It does not  necessarily mean USD cents."},"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},"created_at":{"type":"string","format":"timestamp","readOnly":true,"description":"Timestamp representing when the refund was created\n","example":"2021-06-01T12:00:00Z"},"updated_at":{"type":"string","format":"timestamp","readOnly":true,"description":"Timestamp representing when the refund was last updated\n","example":"2021-06-01T12:00:00Z"},"request_id":{"type":"string","readOnly":true,"description":"Optional idempotency key.\n","example":false}}}},"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":"The unique identifier for the payin.\n","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":"Basis points for the pricing.\n","example":1000},"set_as_default":{"type":"boolean","description":"Set this pricing as default for the business. Overrides the previously set default if set to 'true'.\n","example":"true"},"created_at":{"type":"string","format":"timestamp","readOnly":true,"description":"Timestamp representing when the payin was created\n","example":"2021-06-01T12:00:00Z"},"updated_at":{"type":"string","format":"timestamp","readOnly":true,"description":"Timestamp representing when the payin was last updated\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,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The payment rail this rule applies to. "},"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 rail."},"children":[]}]}]}],"example":"swift"},"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 minor units of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fees_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". 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":". 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 minor units of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"min_max_fee_currency"},"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 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 minor units of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"min_max_fee_currency"},"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 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":". "},"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 minor units of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fee_currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". 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 minor units of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fee_currency"},"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 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 minor units of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fee_currency"},"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 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":"Timestamp representing when the pricing split was created.\n","example":"2026-08-01T09:12:44Z"},"updated_at":{"type":"string","format":"date-time","readOnly":true,"description":"Timestamp representing when the pricing split was last updated.\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."},"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 minor units of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fee_currency"},"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. 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":"."},"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":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 minor units of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fee_currency"},"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 minor units of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fee_currency"},"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":"Current status of the subscription.","enum":["created","active","paused","expired","failed","halted","cancelled","completed","authorized"],"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. Null for 'as_presented' 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. Present only for 'as_presented' subscriptions, null 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":"URL for the subscription payment page. Your customer can use this URL to make the first payment and activate the subscription.","example":"https://checkout.glomopay.com/subscription/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":"Machine-readable halt reason code.","enum":["MAX_RETRIES_REACHED","CARD_EXPIRED"],"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":"Name of the product being subscribed to.","example":"ShieldGuard Insurance"},"product_description":{"type":"string","maxLength":512,"description":"Description of the product.","example":"Flexible monthly insurance for belongings travel and digital assets easy to manage"},"plan_name":{"type":"string","maxLength":128,"description":"Name of the subscription plan.","example":"ShieldGuard Lite"},"plan_description":{"type":"string","maxLength":512,"description":"Description of the subscription plan.","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":[]}]}]}]}],"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 'as_presented' subscriptions. Required when interval_type is 'as_presented', 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 >= start_date and cannot be more than 30 days from start_date."},"children":[]}]}]}],"example":"2025-01-07"},"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":"Current status of the subscription.","enum":["created","active","paused","expired","failed","halted","cancelled","completed","authorized"],"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. Null for 'as_presented' 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. Present only for 'as_presented' subscriptions, null 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":"URL for the subscription payment page. Your customer can use this URL to make the first payment and activate the subscription.","example":"https://checkout.glomopay.com/subscription/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 cents. For example, 1000 cents is $10.00. The currency is determined by the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field."},"children":[]}]}]}],"example":1000},"currency":{"type":"string","format":"iso-4217, case-insensitive","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 amount of the foreign exchange fee in cents. For example, 1000 cents is $10.00."},"children":[]}]}]}],"example":10},"currency":{"type":"string","format":"iso-4217, case-insensitive","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 amount of the transaction fee in cents. For example, 1000 cents is $10.00."},"children":[]}]}]}],"example":10},"currency":{"type":"string","format":"iso-4217, case-insensitive","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":"The creation timestamp of the settlement.\n","example":"2024-12-06T11:38:37.130Z"},"updated_at":{"type":"string","readOnly":true,"format":"date-time","description":"The last update timestamp of the settlement.\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":"."},"children":[]}]}]}],"example":1000},"balance_currency":{"type":"string","format":"iso-4217","description":"The balance which you want use to make the settlement. This is the currency in which the amount will be deducted from your balance.\n","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"},"credit":{"type":"object","description":"The credit details for the transaction.\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 amount credited in cents. For example, 1000 cents is $10.00."},"children":[]}]}]}],"example":1000},"currency":{"type":"string","format":"iso-4217, case-insensitive","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":"The debit details for the transaction.\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 amount debited in cents. For example, 1000 cents is $10.00."},"children":[]}]}]}],"example":0},"currency":{"type":"string","format":"iso-4217, case-insensitive","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 amount of the foreign exchange fee in cents. For example, 1000 cents is $10.00."},"children":[]}]}]}],"example":10},"currency":{"type":"string","format":"iso-4217, case-insensitive","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 amount of the transaction fee in cents. For example, 1000 cents is $10.00."},"children":[]}]}]}],"example":10},"currency":{"type":"string","format":"iso-4217, case-insensitive","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":"The details of the amount settled in this transaction.\n","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 cents. For example, 1000 cents is $10.00."},"children":[]}]}]}],"example":980},"currency":{"type":"string","format":"iso-4217, case-insensitive","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":"The timestamp when the transaction was processed.\n","example":"2024-12-06T11:38:37.130Z"},"created_at":{"type":"string","readOnly":true,"format":"date-time","description":"The creation timestamp of the transaction.\n","example":"2024-12-06T11:38:37.130Z"},"updated_at":{"type":"string","readOnly":true,"format":"date-time","description":"The last update timestamp of the transaction.\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":"The current status of the virtual account.\n","example":"active"},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"The date and time when the virtual account was created.\n","example":"2025-08-19T07:00:00Z"},"updated_at":{"type":"string","format":"date-time","readOnly":true,"description":"The date and time when the virtual account was last updated.\n","example":"2025-08-19T07:00:00Z"},"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":"Business registration number","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"}},"required":["entity_type","registration_date"]}]}},"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":["success","action_required","pending","failed","offboarded"],"description":"Current merchant status","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 (only required for individual entity_type)"},"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":"Timestamp when the merchant was created","example":"2025-10-07T06:11:47Z"},"updated_at":{"type":"string","format":"date-time","description":"Timestamp when the merchant was last updated","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/MerchantSanctionScreeningResponse":{"id":"components/schemas/MerchantSanctionScreeningResponse","kind":"json-schema","title":"action_required","data":{"title":"action_required","type":"object","properties":{"message":{"type":"string","description":"pending state message","example":"Additional action is required to activate the merchant."},"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","enum":["success","action_required","pending","failed"],"description":"Status of the merchant onboarding","example":"action_required "},"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 (only required for individual entity_type)"},"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":"Timestamp when the merchant was created","example":"2025-10-07T06:11:47Z"},"updated_at":{"type":"string","format":"date-time","description":"Timestamp when the merchant was last updated","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/MerchantKYCVerificationResponse":{"id":"components/schemas/MerchantKYCVerificationResponse","kind":"json-schema","title":"pending","data":{"title":"pending","type":"object","properties":{"message":{"type":"string","description":"pending state message","example":"Additional KYC verification is needed to activate the merchant."},"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","enum":["success","action_required","pending","failed"],"description":"Status of the merchant onboarding","example":"pending"},"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 (only required for individual entity_type)"},"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":"Timestamp when the merchant was created","example":"2025-10-07T06:11:47Z"},"updated_at":{"type":"string","format":"date-time","description":"Timestamp when the merchant was last updated","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 cents. For example, 10000 cents is 100.00. The currency is determined by the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currency"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field."},"children":[]}]}]}],"example":10000},"currency":{"type":"string","format":"iso-4217, case-insensitive","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. Currently only AED is supported for internal transfers."},"children":[]}]}]}],"enum":["AED"],"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":"The amount transferred in cents. For example, 1000 cents is 10.00.\n","example":1000},"transfer_currency":{"type":"string","format":"iso-4217, case-insensitive","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":"The creation timestamp of the internal transfer.\n","example":"2025-10-17T08:06:42Z"},"updated_at":{"type":"string","readOnly":true,"format":"date-time","description":"The last update timestamp of the internal transfer.\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","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":"Timestamp representing when the KYC document record was created.\n","example":"2026-03-13T11:48:14.458Z"},"uploaded_at":{"type":["string","null"],"format":"date-time","readOnly":true,"description":"Timestamp representing when the document file was uploaded. Null if the document has not yet been captured.\n","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,"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. Possible values: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"initiated"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"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":"completed"},"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":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"under_review"},"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":[]}]}]}],"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":"Timestamp representing when the KYC link expires.\n","example":"2026-06-11T11:48:14.361Z"},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"Timestamp representing when the KYC link was created.\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":"Timestamp of the tracker event.\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","description":"Current status of the payment session.","example":"active"},"session_type":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The workflow type configured for this session, which determines the pre-steps and/or post-steps in the payment journey. The value is configured per business. For example, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"kyc_lrs"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" adds KYC verification before the LRS remittance 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"],"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-documentation/apis/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. 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 webhook."},"children":[]}]}]}],"example":"approved"},"created_at":{"type":"string","format":"timestamp","readOnly":true,"description":"Timestamp representing when the RFI was created.\n","example":"2026-08-12T10:51:04.747Z"},"updated_at":{"type":"string","format":"timestamp","readOnly":true,"description":"Timestamp representing when the RFI was last updated.\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-documentation/apis/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}}}},"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"],"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":"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 communicated via webhook."},"children":[]}]}]}],"example":"submitted"}}}},"schema_161":{"kind":"json-schema","data":{"type":"object","required":["expire_after_in_seconds"],"properties":{"expire_after_in_seconds":{"type":"integer","minimum":0,"maximum":604800,"description":"Duration (in seconds) for which the previous key remains valid after rotation. Must be an integer between 0 and 604800 (7 days). Use this window to update all integrations before the old key is revoked.\n","example":3600}}},"id":"schema_161"},"schema_162":{"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_162"},"schema_163":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","enum":["Bad Request"]},"message":{"type":"string"}}},"id":"schema_163"},"schema_164":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","enum":["Unauthorized"]},"message":{"type":"string"}}},"id":"schema_164"},"schema_165":{"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 and GBP."},"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 and GBP."},"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 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 and GBP."},"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 and GBP."},"children":[]}]}]}],"example":"USD"},"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_165"},"schema_166":{"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_166"},"schema_167":{"kind":"json-schema","data":{"type":"string","format":"iso-4217"},"id":"schema_167"},"schema_168":{"kind":"json-schema","data":{"type":"string","format":"timestamp"},"id":"schema_168"},"schema_169":{"kind":"json-schema","data":{"type":"integer","default":20},"id":"schema_169"},"schema_170":{"kind":"json-schema","data":{"type":"integer","default":1},"id":"schema_170"},"schema_171":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/BalanceConversion"}},"page_meta":{"$ref":"#/components/schemas/PageMeta"}}},"id":"schema_171"},"schema_172":{"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_172"},"schema_173":{"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":"Mid-market exchange rate. FX fees are charged on top of this rate.\n","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_173"},"schema_174":{"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_174"},"schema_175":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Unauthorized"},"message":{"type":"string","example":"Missing token"}}},"id":"schema_175"},"schema_176":{"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_176"},"schema_177":{"kind":"json-schema","data":{"type":"string"},"id":"schema_177"},"schema_178":{"kind":"json-schema","data":{"type":"string","enum":["active","paid","failed","action_required","cancelled","partially_paid","under_review","expired"]},"id":"schema_178"},"schema_179":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PaymentLinkResponse"}},"page_meta":{"$ref":"#/components/schemas/PageMeta"}}},"id":"schema_179"},"schema_180":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string","description":"Error message.\n","example":"Invalid customer_id"}}},"id":"schema_180"},"schema_181":{"kind":"json-schema","data":{"type":"string","example":"e092be15-e614-4401-8cea-7ca3df7da987"},"id":"schema_181"},"schema_182":{"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":"timestamp","description":"The new expiry date for the payin. Expiry cannot be less than or  equal to the current date and can be up to 6 months in the future.\n","example":"2025-02-15T00:00:00.000Z"}},"additionalProperties":false},"id":"schema_182"},"schema_183":{"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_183"},"schema_184":{"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_184"},"schema_185":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string","description":"Error message.\n","example":"Payment link is not under review."}}},"id":"schema_185"},"schema_186":{"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_186"},"schema_187":{"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_187"},"schema_188":{"kind":"json-schema","data":{"type":"string","enum":["active","paid","failed","action_required","under_review","expired"]},"id":"schema_188"},"schema_189":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/OrderResponse"}},"page_meta":{"$ref":"#/components/schemas/PageMeta"}}},"id":"schema_189"},"schema_190":{"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_190"},"schema_191":{"kind":"json-schema","data":{"type":"string","enum":["individual","business"]},"id":"schema_191"},"schema_192":{"kind":"json-schema","data":{"type":"string","format":"email"},"id":"schema_192"},"schema_193":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Customer"}},"page_meta":{"$ref":"#/components/schemas/PageMeta"}}},"id":"schema_193"},"schema_194":{"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"}}},"id":"schema_194"},"schema_195":{"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_195"},"schema_196":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/CustomerBankAccount"}},"id":"schema_196"},"schema_197":{"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_197"},"schema_198":{"kind":"json-schema","data":{"type":"string","enum":["success","failed","action_required","in_progress"]},"id":"schema_198"},"schema_199":{"kind":"json-schema","data":{"type":"string","enum":["under_review","action_required","approved","rejected"]},"id":"schema_199"},"schema_200":{"kind":"json-schema","data":{"type":"string","enum":["payment_link","orders","add_funds"]},"id":"schema_200"},"schema_201":{"kind":"json-schema","data":{"type":"string","format":"iso-4217, case-insensitive","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. For example, USD."},"children":[]}]}]}]},"id":"schema_201"},"schema_202":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Payment"}},"page_meta":{"$ref":"#/components/schemas/PageMeta"}}},"id":"schema_202"},"schema_203":{"kind":"json-schema","data":{"type":"object"},"id":"schema_203"},"schema_204":{"kind":"json-schema","data":{"type":"object","properties":{"amount":{"type":"integer","minimum":100,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Amount in minor units (cents), minimum 100."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Reserved sandbox test amount: use exactly "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"6623"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (in any currency) to force a sanctions-screening hit. The payment still succeeds, but its "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"compliance_status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"action_required"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and a payment-screening RFI is raised against it, with settlement held until the RFI is resolved. This works for any payment method and whether or not a customer is attached. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"../../../product-guide/request-for-information/compliance-reviews-and-rfis-on-successful-payments"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Compliance Reviews & RFIs on Successful Payments"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":10000},"currency":{"type":"string","format":"iso-4217","description":"The currency code in ISO 4217 format","example":"AED"},"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":"Required if no "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payin_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is passed."},"children":[]}]}]}],"enum":["BankTransfer"],"example":"BankTransfer"},"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. Required if no "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"payment_method"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is passed."},"children":[]}]}]}],"example":"payin_E602dMzgjpDC"},"remitter_name":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Name of the remitter. Optional, defaults to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Non_Sanctioned_Entity"},"children":[]}]}]}],"enum":["Sanctioned_Entity","Non_Sanctioned_Entity"],"example":"Non_Sanctioned_Entity"}},"required":["amount","currency"]},"id":"schema_204"},"schema_205":{"kind":"json-schema","data":{"type":"string","description":"The unique identifier for the payment.","example":"payt_E602dMzgjpDC"},"id":"schema_205"},"schema_206":{"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_206"},"schema_207":{"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":"Gateway Error:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Payment must be from LRS gateway"},"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":[]}]}]},{"$$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":"Funds Already Available:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Transaction already has funds available"},"children":[]}]}]}]}],"example":"Payment must be in success status"}}},"id":"schema_207"},"schema_208":{"kind":"json-schema","data":{"type":"object","properties":{"reason":{"type":"string","enum":["Requested By Customer","Duplicate","Fradulent","Others"],"description":"The reason for the refund.\n"},"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 cents. Required for partial refunds. If not provided, the full payment amount will be refunded. For example, 1000 cents is $10.00. The currency is determined by the payment's currency."},"children":[]}]}]}],"example":1000},"request_id":{"type":"string","description":"Optional idempotency key.\n","example":"unique_refund_request_id_123"}},"required":["payment_id","reason"]},"id":"schema_208"},"schema_209":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string","description":"Error message.\n","example":"Refund is already in progress."}}},"id":"schema_209"},"schema_210":{"kind":"json-schema","data":{"type":"string","enum":["success","failed","action_required","pending","under_review"]},"id":"schema_210"},"schema_211":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Refund"}},"page_meta":{"$ref":"#/components/schemas/PageMeta"}}},"id":"schema_211"},"schema_212":{"kind":"json-schema","data":{"type":"object","properties":{"status":{"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 status of the refund. You can only mark a refund as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"success"},"children":[]}]}]}],"example":"success"}}},"id":"schema_212"},"schema_213":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string","description":"Error message.\n","example":"Refund cannot be marked success."}}},"id":"schema_213"},"schema_214":{"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_214"},"schema_215":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Price"}},"page_meta":{"$ref":"#/components/schemas/PageMeta"}}},"id":"schema_215"},"schema_216":{"kind":"json-schema","data":{"allOf":[{"$ref":"#/components/schemas/Price"},{"example":{"bps":null}}]},"id":"schema_216"},"schema_217":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/DynamicPrice"}},"page_meta":{"$ref":"#/components/schemas/PageMeta"}}},"id":"schema_217"},"schema_218":{"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_218"},"schema_219":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Unauthorized"},"message":{"type":"string","example":"Invalid or missing authentication token"}}},"id":"schema_219"},"schema_220":{"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_220"},"schema_221":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PricingSplit"}},"page_meta":{"$ref":"#/components/schemas/PageMeta"}}},"id":"schema_221"},"schema_222":{"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."},"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":"Investment scheme details used to prefill the scheme plan and amount step.","properties":{"plan":{"type":"string","enum":["regular","direct"],"description":"AMC scheme plan.","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":"."},"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.\n","example":"ARN12345"}}}}}}},"id":"schema_222"},"schema_223":{"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_223"},"schema_224":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Payment sessions are not enabled for this business"}}},"id":"schema_224"},"schema_225":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Unprocessable Entity"},"message":{"type":"string","example":"email is invalid"}}},"id":"schema_225"},"schema_226":{"kind":"json-schema","data":{"type":"string","enum":["created","active","paused","expired","failed","halted","cancelled","completed"]},"id":"schema_226"},"schema_227":{"kind":"json-schema","data":{"type":"string","format":"date"},"id":"schema_227"},"schema_228":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Subscription"}},"page_meta":{"$ref":"#/components/schemas/PageMeta"}}},"id":"schema_228"},"schema_229":{"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_229"},"schema_230":{"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_230"},"schema_231":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","enum":["Not Found"]},"message":{"type":"string","example":"Subscription not found"}}},"id":"schema_231"},"schema_232":{"kind":"json-schema","data":{"allOf":[{"$ref":"#/components/schemas/Subscription"},{"type":"object","properties":{"status":{"example":"paused"},"next_payment_date":{"example":null}}}]},"id":"schema_232"},"schema_233":{"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_233"},"schema_234":{"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_234"},"schema_235":{"kind":"json-schema","data":{"allOf":[{"$ref":"#/components/schemas/Subscription"},{"type":"object","properties":{"status":{"example":"cancelled"},"next_payment_date":{"example":null}}}]},"id":"schema_235"},"schema_236":{"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_236"},"schema_237":{"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_237"},"schema_238":{"kind":"json-schema","data":{"type":"object","properties":{"quotes":{"type":"array","items":{"$ref":"#/components/schemas/Quote"}}}},"id":"schema_238"},"schema_239":{"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_239"},"schema_240":{"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_240"},"schema_241":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Conflict"},"message":{"type":"string","example":"A payout with this request_id already exists"}}},"id":"schema_241"},"schema_242":{"kind":"json-schema","data":{"type":"string","enum":["pending_approval","in_progress","success","failed","action_required","cancelled"]},"id":"schema_242"},"schema_243":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Payout"}},"page_meta":{"$ref":"#/components/schemas/PageMeta"}}},"id":"schema_243"},"schema_244":{"kind":"json-schema","data":{"type":"string","example":"pout_DdWp_HUbOnlg"},"id":"schema_244"},"schema_245":{"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_245"},"schema_246":{"kind":"json-schema","data":{"type":"string","description":"The unique identifier for the payout.","example":"payout_E602dMzgjpDC"},"id":"schema_246"},"schema_247":{"kind":"json-schema","data":{"type":"object","properties":{"documents":{"type":"array","items":{"$ref":"#/components/schemas/AttachedDocument","required":["rfi_doc_id","id"]}}},"required":["documents"]},"id":"schema_247"},"schema_248":{"kind":"json-schema","data":{"allOf":[{"$ref":"#/components/schemas/MockUpdatePayoutStatusRequest","required":["id","status"]}]},"id":"schema_248"},"schema_249":{"kind":"json-schema","data":{"type":"string","format":"iso-3166-1-alpha-3, case-insensitive","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"},"id":"schema_249"},"schema_250":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Beneficiary"}},"page_meta":{"$ref":"#/components/schemas/PageMeta"}}},"id":"schema_250"},"schema_251":{"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_251"},"schema_252":{"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_252"},"schema_253":{"kind":"json-schema","data":{"type":"string","enum":["pending","active","rejected"]},"id":"schema_253"},"schema_254":{"kind":"json-schema","data":{"type":"integer"},"id":"schema_254"},"schema_255":{"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_255"},"schema_256":{"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_256"},"schema_257":{"kind":"json-schema","data":{"type":"object","required":["review_action"],"properties":{"review_action":{"type":"string","enum":["approve","reject"],"description":"The review action to perform on the beneficiary.","example":"approve"}}},"id":"schema_257"},"schema_258":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string","example":"Beneficiary status updated successfully"}}},"id":"schema_258"},"schema_259":{"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_259"},"schema_260":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Invalid beneficiary status update"}}},"id":"schema_260"},"schema_261":{"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_261"},"schema_262":{"kind":"json-schema","data":{"type":"string","format":"iso-3166-1-alpha-3, case-insensitive","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"},"id":"schema_262"},"schema_263":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/BankAccountValidation"}},"page_meta":{"$ref":"#/components/schemas/PageMeta"}}},"id":"schema_263"},"schema_264":{"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_264"},"schema_265":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Document"}},"page_meta":{"$ref":"#/components/schemas/PageMeta"}}},"id":"schema_265"},"schema_266":{"kind":"json-schema","data":{"type":"string","example":"doc_12345"},"id":"schema_266"},"schema_267":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Invalid document id"}}},"id":"schema_267"},"schema_268":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"Document with given id does not exist"}}},"id":"schema_268"},"schema_269":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Invalid request data"}}},"id":"schema_269"},"schema_270":{"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_270"},"schema_271":{"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_271"},"schema_272":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","enum":["Not Found"]},"message":{"type":"string","example":"Withdrawal account not found"}}},"id":"schema_272"},"schema_273":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Settlement"}},"page_meta":{"$ref":"#/components/schemas/PageMeta"}}},"id":"schema_273"},"schema_274":{"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_274"},"schema_275":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Transaction"}},"page_meta":{"$ref":"#/components/schemas/PageMeta"}}},"id":"schema_275"},"schema_276":{"kind":"json-schema","data":{"$ref":"#/components/schemas/Currency"},"id":"schema_276"},"schema_277":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/VirtualAccount"}},"page_meta":{"$ref":"#/components/schemas/PageMeta"}}},"id":"schema_277"},"schema_278":{"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_278"},"schema_279":{"kind":"json-schema","data":{"type":"string","enum":["local","swift"]},"id":"schema_279"},"schema_280":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string","example":"Virtual account closed successfully"}}},"id":"schema_280"},"schema_281":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Active account not found"}}},"id":"schema_281"},"schema_282":{"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_282"},"schema_283":{"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_283"},"schema_284":{"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_284"},"schema_285":{"kind":"json-schema","data":{"oneOf":[{"$ref":"#/components/schemas/MerchantSanctionScreeningResponse","x-title":"action_required"},{"$ref":"#/components/schemas/MerchantKYCVerificationResponse","x-title":"pending"}]},"id":"schema_285"},"schema_286":{"kind":"json-schema","data":{"type":"string","example":"merch_68c777fcOOMpl"},"id":"schema_286"},"schema_287":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Invalid merchant ID format"}}},"id":"schema_287"},"schema_288":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"unauthorized"},"message":{"type":"string","example":"Invalid or missing authentication token"}}},"id":"schema_288"},"schema_289":{"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_289"},"schema_290":{"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_290"},"schema_291":{"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_291"},"schema_292":{"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_292"},"schema_293":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Invalid merchant status update"}}},"id":"schema_293"},"schema_294":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Unauthorized"},"message":{"type":"string","example":"Unauthorized"}}},"id":"schema_294"},"schema_295":{"kind":"json-schema","data":{"type":"string","enum":["initiated","in_progress","completed","action_required","under_review","rejected"]},"id":"schema_295"},"schema_296":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/KycLinkDetail"}},"page_meta":{"$ref":"#/components/schemas/PageMeta"}}},"id":"schema_296"},"schema_297":{"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_297"},"schema_298":{"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_298"},"schema_299":{"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":"The shareable URL to send to the customer to complete KYC.","example":"https://app.glomopay.com/kyc-links/kyc_69b3f97eSThQY"},"expires_at":{"type":"string","format":"date-time","description":"Timestamp when the link expires.","example":"2026-06-11T11:48:14.361Z"},"created_at":{"type":"string","format":"date-time","description":"Timestamp when the link was created.","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_299"},"schema_300":{"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_300"},"schema_301":{"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_301"},"schema_302":{"kind":"json-schema","data":{"type":"object","required":["email","pan","scheme_no"],"properties":{"email":{"type":"string","format":"email","example":"investor@example.com"},"pan":{"type":"string","pattern":"^[A-Z]{3}P[A-Z][0-9]{4}[A-Z]$","example":"ABCPD1234E"},"scheme_no":{"type":"string","example":"HGEMR"}}},"id":"schema_302"},"schema_303":{"kind":"json-schema","data":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri","example":"https://investor-portal.glomopay.com#payload=..."}}},"id":"schema_303"},"schema_304":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Scheme not found"}}},"id":"schema_304"},"schema_305":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Unauthorized"},"message":{"type":"string","example":"Access restricted to platform businesses only"}}},"id":"schema_305"},"schema_306":{"kind":"json-schema","data":{"type":"string","enum":["action_required","under_review","approved","rejected","superseded","expired"]},"id":"schema_306"},"schema_307":{"kind":"json-schema","data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/RfiListItem"}},"page_meta":{"$ref":"#/components/schemas/PageMeta"}}},"id":"schema_307"},"schema_308":{"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_308"},"schema_309":{"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}},"uploader_comments":{"type":"string","description":"An optional note recorded against the RFI alongside the submitted documents.\n","example":"Passport attached for review"}},"required":["documents"],"additionalProperties":false},"id":"schema_309"},"schema_310":{"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_310"},"schema_311":{"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_311"}},"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/~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/~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/~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/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/~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":"2025-01-07","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":"2025-01-07","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":"2025-01-07","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/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","id":"paths/~1quotes/post/responses/400/content/application~1json/examples/missing_subtype"},"paths/~1quotes/post/responses/400/content/application~1json/examples/unsupported_payment_method":{"value":{"error":"Bad Request","message":"'card' 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/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":"PYR002","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":"PYR002","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":"REG123456","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 (passport required)","id":"paths/~1platform~1merchants/post/requestBody/content/application~1json/examples/individual"},"paths/~1platform~1merchants/post/requestBody/content/application~1json/examples/business":{"value":{"name":"Acme LLC","address_line1":"456 Commerce Street","address_line2":"Suite 101","city":"Mumbai","state":"Maharashtra","pincode":"400001","registration_number":"REG123456","registration_country":"IND","entity_type":"business","category":"Agricultural Services","sub_category":"Veterinary Services","operation_countries":["IND"],"registration_date":"2020-06-01"},"key":"business","summary":"Business merchant (registration_date required)","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":""}},"options":{"hideSidebar":true,"mockServer":{"url":"/_mock/api-documentation/apis/openapi","position":"off","description":"Mock server"},"disableRouter":true,"downloadUrls":[{"url":"/_bundle/api-documentation/apis/openapi.json?download"},{"url":"/_bundle/api-documentation/apis/openapi.yaml?download"}],"excludeFromSearch":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"}},"baseSlug":"/api-documentation/apis/openapi","routesMapping":{}}