Introduction
Welcome to the CHIP Send documentation.
CHIP Send API
The CHIP Send API allows you to send funds programmatically via a REST API. Additionally, it provides functionality for registering and validating recipient bank accounts.
Prerequisites
For integration, you will need credentials provided upon the creation of your CHIP Send Account by the CHIP Admin. If you haven’t received your credentials, please reach out to your CHIP Account Manager and provide the following details:
- Primary email address.
- List of approvers’ email addresses. If two approvals are required, include both email addresses.
Basic Integration Flow
Follow these four steps to test the full integration flow:
- Call the Accounts API.
- Call the Increase Send Limit API.
- Call the Add Bank Account API.
- Call the Create Send Instruction API.
Endpoints
Ensure you select the appropriate endpoint based on the environment you are working in:
- Staging: https://staging-api.chip-in.asia/api/
- Production: https://api.chip-in.asia/api/
Credentials
For integration with CHIP Send, you’ll require two pieces of information:
-
API Key: Used to construct a signing string and Authorization Header.
-
API Secret: Used to sign the signing string.
Obtain your API Key and API Secret from the CHIP Control Applications or contact our sales team. Use this key as a Bearer Token in the Authorization header for every request: Authorization: Bearer <API Key>
.
Given the sensitive nature of the API, which enables tasks such as sending payments, added security measures are crucial. Thus, you also need the API Secret to sign the requests you make. This key should never leave your server and must be stored securely. Each request should include both an epoch (containing Unix time) and a checksum (a hash for epoch signed with the API Secret) in the header.
Approving CHIP Send Budget Allocation requests
Every approver will receive an email notification. To approve, click the “Approve” button within the email. Once all approvals are collected, the updated balance will be reflected in the Accounts API response.
Token used in the Authorization is the API Key mentioned in the Credentials section above.