FAQs

The payee API is used to get or update payee information.Tipalti payee functions are payee specific and the call to the API web service includes the payee ID.

The payer API is used for payer administrative operations, such as processing and testing a payment file A CSV or TXT file that contains one or more payment orders/ instructions to Tipalti. It can be submitted via the Tipalti Hub or Tipalti's FTP path.. Tipalti payer functions either relate to multiple payees or to the payer configuration.

You need to use the Tipalti sandbox environment. The production environment is live and should not be used for testing.

To calculate the signature:

1. Create an "authorization string" by concatenating the payer name, payee ID (for payee functions) and current UTC Coordinated Universal Time time in Unix format (i.e., seconds since 1/1/1970).

"MyPayerNamePayee9991222657071"

2. Concatenate additional information per the web service definition (i.e., EAT Encryption Additional Terms).

For PayeePayable, the requested EAT is the amount. If the amount is 50, the above example would change to MyPayerNamePayee999122265707150.

3. UTF8 encode the string.
4. Encrypt with HMACSHA256.Use the master encryption key assigned to you by Tipalti.

Output key:

        1Ph7zfqqDasBCw0WTxxDaDpdTAOXLbxSVJeLswfK7Ppx7tkw60YLDzHFNpcSx8Mz

EAT parameters are concatenated to the authorization string as strings.

To convert EAT parameters to strings:

1. String: Leave as is.
2. Integer: Convert to string.
3. Floating point: Round down, convert to integer, then to string.
4. Date/ time: Convert to Unix time, then to string.
5. Add date: 1/1/2015, convert to Unix time, then to string.
6. Add time: 00:00, convert to Unix time, then to string.
7. Character: Convert to string.

Use the payee API. Click here for a complete list of Tipalti’s payee API functions.

Use the payer API. Click here for a complete list of Tipalti’s payer API functions.