Create your first top-up

✅ You can use payment-attempts or create the payment directly.

💰 TOPUP_ACCOUNT Payment Flow

A TOPUP_ACCOUNT transaction is used to fund an account within conomy_hq. This type allows users to add money to their balance for future transactions, such as payments, purchases, or transfers.

1. Retrieve Payment Origins

Before creating a top-up, you must retrieve the available payment origins (e.g., ETPAY, WOMPI, etc.) linked to the user or entity.

2. Create Payment

Creates a top-up request using a selected origin and specifying the destination account to be funded.

3. Capture Payment

After confirming the top-up (via the payment provider), capture the funds to reflect them in the user’s account.

4. Webhook Simulation

Simulate a webhook notification to test your payment confirmation handling.

5. Check Account Information

Use this request to verify that the funds were deposited correctly into the account.

Create your first top-up

💰 TOPUP_ACCOUNT Payment Flow#

1. Retrieve Payment Origins#

2. Create Payment#

3. Capture Payment#