Create, load and modify your Token Payments [Non-Accommodation]

A Token is a temporary digital contract, identified by a unique ID, between authorized Users and PayDocker. Tokens are typically used for procuring travel accommodations or services and are issued by Buyers (you) to suppliers on the PayDocker platform.

The process for using a Token follows a clear lifecycle:

1. Create a Token
2. Load the Token
3. Send the Token
4. Manage all your sent or draft Tokens

How to access

1. Click Purchase, then Token

You will be brought to your Purchased Token dashboard:

You may click on the eye icon at the end of each entry to verify the details of the token that has been created.

How to create a Token

You will be able to create tokens through 3 ways: 

1. Manually
2. Through an API
3. You can also configure an automation for Booking

Manually create a token

1. Click + Create Token.

2. Fill in the required fields, including Seller Account, payment, and Booking details.

Key things to note:

1. Fee Payer: If there are no pre-existing smart contract setups, you will need to select the Fee Payer manually.
2. Successful Generation: A Token will only generate successfully if:
   • You have enough balance in the specified currency to cover the load amount and any associated fees.
3. Sending Configuration:
   • Choosing Send Now means the Token will be sent immediately upon successful loading.
   • Choosing Send Later means the Token will be sent on its scheduled available date.

Through an API

The API would be able to capture these details in the process of creating a token:

• Destination of the token
• Currency of exchange
• Load amount
• Available and expiry date
• Name, type and reference ID of the token
• Recipient email

Read more here: API & Webhooks Integration

Load Funds into the Token

Once the tokens have been generated, you will need to load funds into the tokens and then send them out. 

You can only load a token if:

1. Token has not expired
2. There are sufficient balances in your account

What happens during the loading process

The PayDocker system will confirm the following:

• Authentication Check: If you have Two-step authentication set up, you will be prompted for an authentication code (via email or app).
• Balance Check: The system confirms sufficient balance to cover the required load amount and any fees.
  • If you need to increase your balance, please refer to this article: Top-up your Balances
  • You may also choose to convert balances of other currencies: Converting Balances

If successful, you will receive a Transaction ID, and your account balance will reflect a negative amount equal to the loaded value.

If unsuccessful, you must refer to the error message and resubmit the request.

You will be able to load tokens through 3 ways: 

1.  
   1. Loading tokens manually
   2. Loading tokens through an automation
   3. Loading tokens through an API

Loading tokens manually

1. Go into the token that you wish to load and click load token

2. A pop-up will appear. Fill in the amount to be loaded.

3. Once you have completed this step, click Load to start the loading process. 

Schedule your loading

If you would like to load funds later, you can schedule it. The same loading conditions (non-expired, sufficient funds) apply.

1. Click Schedule

You will then see the schedule load pop-up. Click Schedule to confirm your settings. 

The scheduled load time will take place at 00:00 (In your timezone) on the date that you have selected.

Loading tokens through an automation

To set up token loading automation, configure it here:

Automation: If configured, loading will happen according to the Token's due date and the booking's rates. If a booking has two rates with different due dates, two separate load schedules will be created.

• You will be able to see the load schedule of each token under the token's details. 
  

If you choose Don't configure token load schedule, loading will happen immediately.

Loading tokens through an API

The load amount information would have been captured during the initial API push. The maximum load amount is 12, and the first value cannot be 0. 

Errors occurring at this stage will be labelled as "415 Invalid Load Amount"

Tokens will be loaded immediately once they can be successfully generated.

Modifying your tokens

You can modify your tokens (Unload, edit and freeze, delete tokens) either

• Manually or
• Through the API

Manually modifying your tokens

Unloading Funds from your Token

To unload funds, follow these steps: 

1. Go into the token that you wish to unload and click unload token

This will take you into a pop-up where you can choose the amount to unload

You can only unload a token if:

1. The token has not expired
2. Your unload amount is less than or equal to the token balance

What happens during the unloading process

The system will check for two-step authentication. If successful, you will receive a Transaction ID, and your account balance will reflect a positive amount equal to the unloaded value.

Edit and freeze tokens

After generating tokens, you can still edit the name, availability, and expiration dates of the token.

1. Click edit token

2. Then, fill up the pop-up with the amended details and click save

You can also choose to freeze the token by clicking Freeze

You can also just unfreeze this token at a later date if you need to. 

Deleting tokens

The process of deleting tokens that have already been generated and loaded would go as follow: 

1. You will be required to authorize this transaction if you have two-factor authentication set up 
2. Your token would need to have 0 value before deleting
   • To unload the value, refer to this section: Unloading Funds from your Token

To delete, you can find the button within the token view

Once you have successfully frozen or deleted your tokens, the status will change respectively. 

Modifying your tokens through the API

When modifying your token through the API, the process is very similar to creating a token through an API with 1 extra step: The API will verify if the token is "Active".

Send Tokens

The method for sending depends on the configuration chosen during generation:

• Send Now: The Token is sent immediately once the load process is complete.
• Send Later: You must return to the Token view and click Send Token once the Token is available.

Once successfully sent, the receiving party will automatically receive an email.

If you have created your token through the API, it will be sent immediately once it is successfully generated. 

Export data of all your tokens

You can extract a running list of all your Tokens through PayDocker's extract function. You can also configure and autoamtion to send token activity updates to your email regularly. 

1. To manually export data of all tokens, click on Export, which is located at the top of the page.

2. Next, you can select the information you would like to extract. This information will be exported into an Excel file.