{"object":"catalogue","service":"bolrachpay","version":"v1","host":"https://api.bolrachpay.com","public_v1_mode":"option_b_private","note":"Private coordinated-launch track. Public marketing of Pay requires Chairman C4 (A or B). Sandbox-only brand stays off the public product directory.","auth":{"header":"Authorization: Bearer sk_test_… or sk_live_…","scopes":["payments:read","payments:write","*"]},"option_b_surfaces":["payment_intents (create + get)","payment_links (create + list)","invoices (create + list)","refunds (create + list)","payments list","merchant me"],"endpoints":[{"method":"GET","path":"/api/v1","auth":false,"summary":"This catalogue"},{"method":"GET","path":"/api/v1/ping","auth":false,"summary":"Liveness"},{"method":"GET","path":"/api/v1/me","auth":true,"scope":"any"},{"method":"GET","path":"/api/v1/payments","auth":true,"scope":"payments:read"},{"method":"POST","path":"/api/v1/payment_intents","auth":true,"scope":"payments:write","requires":"Idempotency-Key","body":{"type":"object","required":["amount","currency","return_url"],"properties":{"amount":{"type":"string","description":"Integer MINOR units as a string: 250000 is NGN 2,500.00. Sent as a string so no JSON parser can round it.","example":"250000"},"currency":{"type":"string","description":"Three-letter ISO code.","example":"NGN"},"return_url":{"type":"string","description":"Absolute https URL the buyer returns to after 3-D Secure.","example":"https://example.com/thanks"},"description":{"type":"string","maxLength":500},"method":{"type":"string","description":"Preferred method; the router still decides what is available."},"buyer_country":{"type":"string","description":"Two-letter country of the buyer, for routing.","example":"NG"},"request_3ds":{"type":"string","enum":["auto","any"],"description":"'any' forces a challenge, for testing the 3-DS path."},"customer":{"type":"object","properties":{"id":{"type":"string"},"email":{"type":"string"},"name":{"type":"string"}}}}}},{"method":"GET","path":"/api/v1/payment_intents/:id","auth":true,"scope":"payments:read"},{"method":"POST","path":"/api/v1/payment_links","auth":true,"scope":"payments:write","body":{"type":"object","required":["name","amount","currency"],"properties":{"name":{"type":"string","maxLength":200,"description":"Labels the link and forms its slug.","example":"August workshop ticket"},"amount":{"type":"string","description":"Integer minor units as a string.","example":"250000"},"currency":{"type":"string","example":"NGN"},"kind":{"type":"string","enum":["one_time","reusable","donation"],"default":"one_time"},"success_url":{"type":"string","description":"Absolute https URL."},"cancel_url":{"type":"string","description":"Absolute https URL."}}}},{"method":"GET","path":"/api/v1/payment_links","auth":true,"scope":"payments:read"},{"method":"POST","path":"/api/v1/refunds","auth":true,"scope":"payments:write","requires":"Idempotency-Key","body":{"type":"object","required":["payment"],"properties":{"payment":{"type":"string","description":"The payment id to refund.","example":"pay_1a2b3c"},"amount":{"type":"string","description":"Integer minor units. Omit to refund the whole payment."},"reason":{"type":"string","maxLength":200}}}},{"method":"GET","path":"/api/v1/refunds","auth":true,"scope":"payments:read"},{"method":"GET","path":"/api/v1/refunds/:id","auth":true,"scope":"payments:read"},{"method":"POST","path":"/api/v1/invoices","auth":true,"scope":"payments:write"},{"method":"GET","path":"/api/v1/invoices","auth":true,"scope":"payments:read"},{"method":"GET","path":"/api/health","auth":false,"summary":"Service health + DB"}],"product_auth":{"merchant_readiness":{"method":"GET","path":"/api/auth/merchant-readiness","auth":"session Bearer","unauth":"merchant_readiness_discovery with steps_catalog.prompt_url","prompt_base":"https://id.authv.io/continue/verify?product=bolrachpay","return_to":"https://app.bolrach.com/dashboard/onboarding","notes":["Person/business verification opens id.authv.io/continue/verify (product checklist), never /account dump."]},"authvio_identity_webhook":{"method":"POST","path":"/api/webhooks/authvio/identity","auth":"Authvio-Signature","discovery_get":"https://api.bolrachpay.com/api/webhooks/authvio/identity"},"platform_requirements":{"method":"GET","path":"https://api.bolrach.io/v1/identity/requirements?product=bolrachpay","auth":null},"platform_readiness_discovery":{"method":"GET","path":"https://api.bolrach.io/v1/identity/readiness/discovery","auth":null},"app_onboarding":"https://app.bolrach.com/dashboard/onboarding","app_bff":"https://app.bolrach.com/api/auth/merchant-readiness"},"dashboard":"https://app.bolrach.com","docs_index":"https://docs.bolrach.dev"}