API Basics & Endpoints

What is an API?

API stands for Application Programming Interface. An API is an intermediary that allows two applications to interact with each other. It works like a messenger between two parties, where one party requests and receives a response from another party for the request.

Who is a Client?

A client is a software distributed to customers who can access or communicate with the server by using an API. This could be an internal service or an external facing asset like a mobile app (Android/iOS) or mobile website or website.

What is a Server?

A server is a machine running some processes that will process some service for you based on a user's request via API.

What are Status Codes?

Status codes are sent by a server in response to the request made by a client.

Response status codes are distributed into five categories -

  • 1xx: Informational
  • 2xx: Success
  • 3xx: Redirection
  • 4xx: Client Error
  • 5xx: Server Error

1xx: Informational

Status CodeMeaning
100Continue
101Switching Protocols
102Processing
103Early Hits

2xx: Success

Status CodeMeaning
200OK
201Created
202Accepted
203Non-Authoritative Information
204No Content
205Reset content
206Partial Consent
207Multi-Status
208Already Reported
226IM Used

3xx: Redirection

Status CodeMeaning
300Multiple Choice
301Moved Permanently
302Found
303See Other
304Not Modified
305User Proxy
306Unused
307Temporary Redirect
308Permanent Redirect

4xx: Client Error

Status CodeMeaning
400Bad Request
401Unauthorized
402Payment required
403Forbidden
404Not Found
405Method Not Allowed
406Not Acceptable
407Proxy Authentication Required
408Request Timeout
409Conflict
410Gone
411Length Required
412Precondition Failed
413Payload Too Large
414URI Too Long
415Unsupported Media Type
416Range Not Satisfiable
417Expectation Failed
418I'm a Teapot
421Misdirect Request
422Unprocessable Entity
423Locked
424Failed Dependency
425Too Early
426Upgrade Required
428Precondition Required
429Too Many Requests
431Request Header Fields Too Large
451Unavailable for Legal Reasons

5xx: Server Error

Status CodeMeaning
500Internal Server Error
501Not Implemented
502Bad Gateway
503Service Unavailable
504Gateway Timeout
505HTTP Version Not Supported
511Network Authentication Required

What is an API endpoint?

An API endpoint is a point where the API connects with the software program. Usually, there are two endpoints, one each for Testing and for the Production environment.

Decentro's Endpoints (India)

We have two endpoints, one for Staging and another for Production.

EnvironmentEndpoint
Staging/Sandboxhttps://in.staging.decentro.tech
Productionhttps://in.decentro.tech

What is UAT environment? How is it different from production?

The UAT environment is like a test environment that allows you to explore our APIs and try them out using the staging credentials. This one doesn’t involve real money transfers for safety purposes but essentially gives you all the responses exactly like the way they would come in production.


Dashboard

Decentro provides a detailed and holistic dashboard to any customer who signs up for the same. Decentro's dashboard is designed to allow businesses to harness the capabilities offered by Decentro without any integration effort.

Decentro's onboarding team provides access to the dashboard once all the onboarding formalities are completed on the production environment.

Decentro's dashboard allows you to undertake some of the key actions below.

  • View the history of your API hits across modules
  • View the list of transactions, and their details and update the status in real-time
  • Collect funds using UPI through a payment link or collection request
  • Pay your beneficiaries using any of the supported modes
  • Track the usage of credits and commissions across modules
  • Download reports or transaction details or email them
  • View configured callbacks across modules

If you are an existing customer of Decentro and wish to use the dashboard, please drop us a mail at [email protected].

If the above capabilities excite you and you are yet to sign up, please signup here.


How to move from UAT (Sandbox) to Production?

Once you’ve finished the complete integration process and testing and wish to move into the production environment, you can do so by:
a) Reach out to the business manager who has been in touch with you to request them to give you access to the production environment.
b) Write a mail to us at [email protected] and request to be moved to the production environment.

Decentro shares the production credentials as soon as the relevant commercials and agreements are closed. These agreements are standardized but might vary for some specific use cases, especially in the Payments and Cards modules.

What is pricing structure on production?

Decentro charges its customers for success scenarios across modules from the platform. The platform can finalize the final pricing for modules with the concerned business manager who's in touch. If you wish to receive the commercials, please reach out to us at [email protected].

What are the KYC requirements to go to production?

To access the production environment, you will need to share your KYC documents with Decentro. We need the following documents:

  • Entity proof and address proof of the entity Or Certificate of Incorporation
  • PAN Card in the name of the company
  • GSTIN (Where registered)
  • Company Name (Legal Name)
  • KYC Documents of a Director or Authorized Signatory

Decentro might ask for some additional documentation in case of specific scenarios, that are required as per internal and partner compliance requirements.

What is the TPS at Decentro?

We have upgraded our TPS limits to help our customers leverage more transactions and address more customer requests. The new TPS is -

  • 10 Transactions Per Second
  • 300 Transactions Per Minute
  • 6000 Transactions Per Hour

📘

Here here!

If you need more TPS, we got it covered for you at a nominal price. Please connect with our Support Team here - [email protected]