# Development Integration Guidelines

# 1. Sequencing the Integration Experience

![Vamospago merchant integration workflow.png](https://api.apifox.com/api/v1/projects/7264064/resources/585401/image-preview)
# 2. Pre-integration Preparation
<Steps>
  <Step title="Obtain Production Merchant ID and API Key">
   After the merchant completes the product application and passes the KYB review, the business team will provide the super administrator account, merchant ID, and API key for the corresponding region in the business support group.  
  </Step>
</Steps>

# 3. API Integration
<Steps>
  <Step title="Development Integration">
    1. Refer to the **[APIs Signature]** document to confirm the API signature rules. 
    2. Integrate the collection and payout APIs for the target region under **[Transaction APIs]**.  
    3. Set the webhook URL when placing an order in the transaction API.  
    4. Integrate the **Order Status Query** and **Account Balance Query** under **[Common APIs]**.  
    5. Check **[Payment of Video Case]** to understand the practical use cases of each API.  
  </Step>
  <Step title="Integration Testing">
     1. Use the examples in **[Transaction APIs]** to test the corresponding payment scenarios.  
    2. For callback testing, contact customer support to assist with mock callback validation. 
  </Step>
  <Step title="Production Preparation">
    1. Provide the complete list of production IP addresses for us to whitelist.  
    2. Add our callback IP addresses to your whitelist.  
    3. Ensure secure distribution of API keys; contact us if you need to update the key.
    4. Enable 2FA binding for your Dashboard admin account.  
    5. Notify us when going live in production so we can help monitor data and verify the integration.
  </Step>
</Steps>
   

# 4. Fee Description

- Our platform charges transaction fees instantly for each order (fees are applied per completed transaction), rounded up to two decimal places. No fee is charged for failed orders.
- Example: For an order amount of 99 with a 0.6% fee, the total fee charged will be 0.60 instead of 0.59.