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 Code | Meaning |
---|---|
100 | Continue |
101 | Switching Protocols |
102 | Processing |
103 | Early Hits |
2xx: Success
Status Code | Meaning |
---|---|
200 | OK |
201 | Created |
202 | Accepted |
203 | Non-Authoritative Information |
204 | No Content |
205 | Reset content |
206 | Partial Consent |
207 | Multi-Status |
208 | Already Reported |
226 | IM Used |
3xx: Redirection
Status Code | Meaning |
---|---|
300 | Multiple Choice |
301 | Moved Permanently |
302 | Found |
303 | See Other |
304 | Not Modified |
305 | User Proxy |
306 | Unused |
307 | Temporary Redirect |
308 | Permanent Redirect |
4xx: Client Error
Status Code | Meaning |
---|---|
400 | Bad Request |
401 | Unauthorized |
402 | Payment required |
403 | Forbidden |
404 | Not Found |
405 | Method Not Allowed |
406 | Not Acceptable |
407 | Proxy Authentication Required |
408 | Request Timeout |
409 | Conflict |
410 | Gone |
411 | Length Required |
412 | Precondition Failed |
413 | Payload Too Large |
414 | URI Too Long |
415 | Unsupported Media Type |
416 | Range Not Satisfiable |
417 | Expectation Failed |
418 | I'm a Teapot |
421 | Misdirect Request |
422 | Unprocessable Entity |
423 | Locked |
424 | Failed Dependency |
425 | Too Early |
426 | Upgrade Required |
428 | Precondition Required |
429 | Too Many Requests |
431 | Request Header Fields Too Large |
451 | Unavailable for Legal Reasons |
5xx: Server Error
Status Code | Meaning |
---|---|
500 | Internal Server Error |
501 | Not Implemented |
502 | Bad Gateway |
503 | Service Unavailable |
504 | Gateway Timeout |
505 | HTTP Version Not Supported |
511 | Network 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.
Environment | Endpoint |
---|---|
Staging/Sandbox | https://in.staging.decentro.tech |
Production | https://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]
Updated about 2 months ago