{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-products/billpay/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Billpay Quickstart Guide","siteUrl":"https://docs.monato.com","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"billpay-quickstart-guide","__idx":0},"children":["Billpay Quickstart Guide"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Greetings, welcome to Monato-API, in this quickstart you will find all the requirements to consume our API v1."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"environments","__idx":1},"children":["Environments"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Monato Team manages Sandbox and Production environments:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sandbox:"]}," In this enviroment developers can make API calls and receive mocked responses so they can get to know how the API behaves in each scenario."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Sandbox Enviroment is were the client will certified the integration."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can make requests to sandbox environment in the following URL: https://dev-api.finco.lat"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Production:"]}," When the integration is certified the finch team will provide the production ApiKey."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can make requests to production environment in the following URL: https://api.finco.lat"]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Timeout for requests is 60 seconds."]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All Requests must use the HTTPS protocol."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"1-authentication","__idx":2},"children":["1. Authentication"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To Authenticate the Finch-API you must have the Authentication header with your Bearer token (ApiKey) in all your requests."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"$ curl https://dev-api.finco.lat/api/v1/client/account \\\n-H 'Authorization: Bearer your_api_key'\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"2-select-payee-service","__idx":3},"children":["2. Select Payee Service"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once you have your API Key, you have to select a payee service from the catalog, to make a payment or consult."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"# Payee Actions\n- pay: The payee offers payments, though the /payments endpoint.\n- balance: The payee offers consults for account balance, through the /balances endpoint\n- topup: The payee offers, phone recharge packages, through the /topups endpoint\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"$ curl https://dev-api.finco.lat/api/v1/payees \\\n-H 'Authorization: Bearer your_api_key'\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"3-consult-account-balance","__idx":4},"children":["3. Consult Account Balance"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once you selected a payee_id, you can consult an account balance if the payee has the balance action available. This step is optional"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"curl https://dev-api.finco.lat/api/v1/balances \\\n-H 'Authorization: Bearer your_api_key' \\\n-H 'Content-Type: application/json' \\\n--data '{\n\"payee_id\": \"0d93acf6-b63d-46e8-aa5f-6f2520462608\",\n\"payer_account\": \"055810100345\"\n}'\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"4-make-payment","__idx":5},"children":["4. Make Payment"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To make a payment you need the selected ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payee_id"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payer_account"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amount"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency"]},", the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["idempotency_key"]}," is optional."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"curl https://dev-api.finco.lat/api/v1/payments \\\n-H 'Authorization: Bearer your_api_key' \\\n-H 'Content-Type: application/json' \\\n--data '{\n\"payee_id\": \"0d93acf6-b63d-46e8-aa5f-6f2520462608\",\n\"payer_account\": \"055810100345\",\n\"amount\": 100,\n\"currency\": \"MXN\",\n\"idempotency_key\": \"client_side_idempotency_key\"\n}'\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," For for infomation in each endpoint check the Finch API endpoints."]}]},"headings":[{"value":"Billpay Quickstart Guide","id":"billpay-quickstart-guide","depth":1},{"value":"Environments","id":"environments","depth":2},{"value":"1. Authentication","id":"1-authentication","depth":3},{"value":"2. Select Payee Service","id":"2-select-payee-service","depth":3},{"value":"3. Consult Account Balance","id":"3-consult-account-balance","depth":3},{"value":"4. Make Payment","id":"4-make-payment","depth":3}],"frontmatter":{"seo":{"title":"Billpay Quickstart Guide"}},"lastModified":"2026-06-23T21:56:40.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/billpay/guides/quickstart","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}