Function: GetDynamicKeyOfSubPayer

The GetDynamicKeyOfSubPayer function returns a dynamic encryption key for the subpayer. The dynamic key is encrypted with the parent payer key (see Enhance security for guidelines on using dynamic keys). Do not send the key over the wire or include it in the query string. Store it in a secure location.

The following is a sample SOAP 1.2 request and response. In the request, you need to replace the data types in yellow with actual values.

SOAP 1.2: Request

POST /v7/payerfunctions.asmx HTTP/1.1

Host: api.tipalti.com

Content-Type: application/soap+xml; charset=utf-8

Content-Length: length

<?xml version="1.0" encoding="utf-8"?>

<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xmlns:xsd="http://www.w3.org/2001/XMLSchema"

xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">

<soap12:Body>

<GetDynamicKeyOfSubPayer xmlns="http://Tipalti.org/">

<payerName>string</payerName>

<subPayerName>string</subPayerName>

<timestamp>double</timestamp>

<key>string</key>

</GetDynamicKeyOfSubPayer>

</soap12:Body>

</soap12:Envelope>

SOAP 1.2: Response

HTTP/1.1 200 OK

Content-Type: application/soap+xml; charset=utf-8

Content-Length: length

<?xml version="1.0" encoding="utf-8"?>

<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xmlns:xsd="http://www.w3.org/2001/XMLSchema"

xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">

<soap12:Body>

<GetDynamicKeyOfSubPayerResponse xmlns="http://Tipalti.org/">

<GetDynamicKeyOfSubPayerResult>

<errorMessage>string</errorMessage>

<errorCode>integer</errorCode>

<Key>string</Key>

<Token>string</Token>

</GetDynamicKeyOfSubPayerResult>

</GetDynamicKeyOfSubPayerResponse>

</soap12:Body>

</soap12:Envelope>

Request parameters

element	description	limitation	Mandatory?	data type
payerName	The name of the payer, as assigned by Tipalti	Max. length = 50 Value is case sensitive	Mandatory	string
subPayerName	Subpayer name, as assigned by Tipalti	Max. length = 50	Mandatory	string
timestamp	Current time (UTC) when the request is sent	Unix time	Mandatory	double
key	Encryption key		Mandatory	string

Response parameters

element	description	data type
GetDynamicKeyOf SubPayerResult	Contains the response parameters	TipaltiSubPayerSecurityToken

TipaltiSubPayerSecurityToken

element	description	limitation	data type
errorMessage	A description of the error	See API error codes.	string
errorCode	The code for the error	See API error codes.	integer
Key	Dynamic encryption key (no EAT)	Max. length = 64	string
Token	The token to concatenate with the query string The token identifies which dynamic encryption key you are using to encrypt the query string.	Max. length = 64	string