Wompi - TokenBox

This page presents all information related to the Wompi connection using the TokenBox as payment. Use the following buttons to navigate to the desired section.

Connecting with Yuno

Mandatory fields when integrating via Yuno:


General Information





Minimum amount:

1.500 COP

Maximum amount:

Depends on the transactional limits of the shoppers in accordance with what is stablished in their digital channels.

TRX Limit:

150 transactions per second.

Purchase TRX in 1-Step:

Allows your customers to pay using their savings or checking account from Bancolombia in an easy and fast way through tokenization.

Purchase TRX in 2-Step:


Support for recurrency:







Refund Support:

No, in case of requiring a refund, the merchant must make a new transfer from its account to the shopper's.


Void support:



Notifications of chargebacks:



E3DS v2:


Testing guidelines for sandbox environment

Necessary fields for testing:

Public key, private key and Eventos.

Limitations/ Specifications for testing:

In the token authorization flow:
  • Username can take any value.
  • There are a series of buttons to test differents flows.
  • The only valid value for the dynamic key is 123456.
  • There are listed accounts in testing, choosing any of them will result in a succesful authorization.

Testing steps

Bancolombia Tokenbox works as an enrolled payment method. Therefore, you will need to start enrolling it before making a payment. Similar to the Bancolombia transfer, the payment gets automatically approved. However, with Bancolombia, you can test different scenarios for enrollment.

In order to make a payment using Bancolombia Tokenbox, you should complete the following steps:

  1. Create Customer
  2. Create Checkout Session
  3. Retrieve Payment Methods Available
  4. Enroll Payment Method
  5. Retrieve Payment Method by Customer Session

    To complete the enrollment in the Banbox environment, use the redirect URL (provider.redirect.init_url) to follow the next steps and complete the enrollment:

    1. User: This can be any email with the correct format. For example: [email protected].
    2. 4-digit password: This can be any 4-digit password. For example: 1234. At that stage, you can choose the result of your enrollment.
    3. Dynamic key: Can be any 6-digit number. For example: 123456.
    4. Select account: This could be any of the accounts already available for testing.
  1. Create Checkout Session
  2. Retrieve Payment Methods Available for Checkout
  3. Create Payment

Integration configuration

Credentials and steps to obtain them:

  1. Log in to Wompi dashboard.
  2. Navigate to Developers.
  3. Get your API keys (public key and private key) and Secrets (Eventos and Integridad) for technical integration.
There are a pair of keys for each execution environment one for Sandbox and another for Production, the keys shown correspond to the activated environment:
- For Sandbox the keys have a prefix pub_test_ and prv_test_
- For Production the keys have a prefix pub_prod_ and prv_prod_

Dashboard configuration:

  1. Log in to dashboard.y.uno.
  2. Click Connections and then select Wompi.
  3. Click Connect.
  4. Introduce Name, Public Key, Private Key, Eventos and the company's NIT
  5. Click Connect

Configuration of webhooks in partner:

Via dashboard:
  1. Log in to Wompi dashboard.
  2. Navigate to Developers.
  3. Set up your Event URL.

Production environment

Specific procedure for a merchant to go live: