EasySlip
1. What is this page for?
The EasySlip page is used to configure and verify your EasySlip API credential for automated bank transfer slip verification, as well as to check your active package details and remaining slip-checking quota. EasySlip powers automated slip checking for the bank slip upload deposit channel and serves as the automatic fallback verifier for Jinlipay P2P. It is designed for finance staff and administrators.
2. Before you start
- Required permissions: You must be granted the 'EasySlip' (or 'Bank Account') permission in system roles to view and edit this page.
- Things to prepare:
- An API key obtained from your EasySlip merchant dashboard.
- Confirmation from EasySlip that your active plan has remaining slip verification quota.
3. Screen layout
When opening Payment services > EasySlip, you will see the following components from top to bottom:
- Page Header: Displays the title EasySlip Configuration and a description explaining credential management for slip verification.
- API Credential Section:
- Configuration Badge: Shows Configured (green) with the partially masked key string, or Not configured (gray).
- EasySlip API Key Input: A password-type field to enter the key, with a Check API Key button to the right.
- Helper Text: Reminds you that the current key is never revealed and that every new key must be checked before saving.
- Verification Details Box: A green box displaying validated metadata (Application, Branch, Product, and Remaining quota), or a red box if the key is invalid.
- Bottom Action Bar: A sticky bottom bar containing the Remove key button (red, visible only when a key is already saved) and the Save button (enabled only after passing verification).
4. Search and filters
This is a single-channel configuration screen and does not contain a data table, search input, or filter controls.
5. Data table
This page does not contain a multi-row data table, but it includes a Verification Details Box that appears once you click Check API Key and validation succeeds:
| Field | What is shown | What it means | Badges or styling |
|---|---|---|---|
| Verification result | Status message | Indicates whether the key is valid and active, or invalid/inactive | Green with checkmark on success / Red with alert icon on failure |
| Application | Business or app name | The application name registered in EasySlip | Plain text |
| Branch | Branch name | The specific branch tied to this API key | Plain text (or — if not set) |
| Product | Package name | The EasySlip subscription package name | Plain text |
| Remaining quota | Number count | The number of slip verification checks remaining on your plan | Number |
6. Step-by-step instructions
1. Setting up or changing your EasySlip API key
- Go to Payment services > EasySlip from the left navigation menu.
- Paste your EasySlip key into the EasySlip API Key field.
- Click the Check API Key button on the right.
- Wait for the system to verify the key. A green box will appear showing Application, Branch, Product, and Remaining quota.
- Scroll down to the bottom action bar and click Save.
- The system displays a green notification confirming EasySlip configuration saved., and the badge changes to Configured.
2. Checking your current remaining quota
- Open Payment services > EasySlip.
- Enter your current key into the EasySlip API Key field.
- Click Check API Key.
- Check the number in the Remaining quota field to confirm how many verification checks you have left.
3. Removing the EasySlip key from the system
- On the EasySlip page with an active configuration, scroll to the bottom action bar.
- Click the red Remove key button.
- The system removes the key immediately, displays a green confirmation stating EasySlip configuration removed., and updates the status badge to Not configured.
7. Form fields and edit screens
Fields in the API Credential section:
| Field | Required? | What to enter | Example | Constraints |
|---|---|---|---|---|
| EasySlip API Key | Required when setting or updating | The API key string provided by EasySlip | sk_live_abc123456789... | Masked as password characters, no spaces allowed, must pass Check API Key before the save button unlocks |
8. Popups and modal dialogs
This screen does not open separate popup modals; all feedback is displayed directly within the verification box and via snackbar alerts at the corner of the screen when actions succeed or fail.
9. Status badges and indicators
| Badge / Box | Color | Meaning | What to do next |
|---|---|---|---|
| Configured | Green | An EasySlip API key is saved and active for automatic slip checking | Normal operation; periodically monitor quota |
| Not configured | Gray | No EasySlip key is currently saved in the system | Enter your key, click check, and save |
| Verification success box | Green | The API key is valid, active, and returned plan quota | Click Save to activate this key |
| Verification failure box | Red | The API key is invalid, inactive, or expired | Re-check the key string copied from EasySlip |
10. Frequently asked questions / troubleshooting
- If the "Save" button is grayed out and cannot be clicked:
- After entering or editing the key in EasySlip API Key, you must click Check API Key and wait for the green success box to appear before Save becomes enabled.
- If player slips are uploaded but not verified automatically:
- Open EasySlip and check your Remaining quota. If it has reached
0, top up your quota on EasySlip or switch to a new active key.
- Open EasySlip and check your Remaining quota. If it has reached
- If you cannot see the "Remove key" button:
- Check that your user account has update permissions for EasySlip. Also note that the button only appears when a key is already configured.