GetTAVSignature
Action: POST
Endpoint: /api/CoreCredit/DigitalWallets/GetTAVSignature
The purpose of this API is to get TAV signature for MDES Push Provisioning.
Request fields details
Fields | Description |
---|---|
Source string Mandatory |
Source of API Consumer For external system expected sources will be WEB. Allowable Values: 50 |
IPAddress string Optional |
IP Address of Client / Application Hosting Server Example: 10.206.0.204 Allowable Values: 15 |
DateFormat string Optional |
Place Holder for Future Use. Values are: 1 : MM/dd/yyyy HH:MM:SS (Default) 2 : MM/dd/yy HH:MM:SS 3 : dd/MM/yyyy HH:MM:SS Allowable Values: 25 |
CurrencyCode string Optional |
Currency Code Place Holder for Future Use. Valid Values: Refer Appendix Section - Currency Code Example:840 = US Dollar Condition:If no value is passed, default value = 840 Allowable Values: 10 |
CurrencySymbolType string Optional |
Place Holder for Future Use. CurrencySymbolType: 1: Currency Sign like $ 2: 3 ALPHA Currency Code like USD Allowable Values: 10 |
Language string Optional |
Place Holder for Future Use. Language: en: means use English Default: en - English Allowable Values: 10 |
ExternalIP string Mandatory |
IP Address of end user of API Allowable Values: 50 |
SessionID string Optional |
Session identifier of the API Example: 000028;026;1349906692 Allowable Values: 100 |
APIVersion string Mandatory |
Version of the API to be invoked. Example: 2.0 API Version Current Version 2.0 Allowable Values: 10 |
CallerID string Optional |
Caller ID of source from where API is initiated it is End User Caller ID Example: 7204454214 (phone number applicable in Case of IVR) Allowable Values: 20 |
CalledID string Optional |
Called ID of destination for which API is initiated It is Destination Called ID Example: 7314145404 (phone number applicable in Case of IVR) Allowable Values: 20 |
RequestTime datetime Optional |
Request Date Time of API Format: MM/dd/yyyy HH:mm:ss Example:01/15/2020 10:05:23 |
AdminNumber int64 Conditional |
Admin Number of Primary Account Number Valid Values: 0-9 Format:XXXXX Example:12345 Condition:At least one account identifier is required. |
CardExpirationDate string Optional |
Expiration date and month of PAN Valid Values: 0-9 Format:MMYY Example:0121 Allowable Values: 4 |
TavVersionNumber string Mandatory |
TAV Format Valid Values:3 Format:X Example:3 Allowable Values: 1 |
DataValidUntilTimestamp string Mandatory |
ISO 8601 format of the date and time(with Time Zone) the TAV expires and will no longer be honored Valid Values:0-9 Example:2019-12-27T10:05:45-05:00 Allowable Values: 29 |
FinancialAccountInformation string Optional |
Identifier of the financial account being tokenized Valid Values:0-9,a-z Example:1235abcd Allowable Values: 78 |
TokenUniqueReference string Optional |
Token Unique Reference associated with the token. Valid Values:0-9,a-z Example: D313958EB444F9A887E96F98483D6FF4E198815DC7BF4C72322E473E9CEF83E27E2F9BCA8762E3121D4FD1FD32B, Allowable Values: 64 |
IdentifierToken string Conditional |
A generated token that is not expired can be used as an input field to access API. If we are passing this field in input, user should not pass any other account identifier. Condition:At least one account identifier is required. Allowable Values: 800 |
Sample request body
{ "Source": "Web", "IPAddress": "10.120.0.1", "DateFormat": null, "CurrencyCode": null, "CurrencySymbolType": null, "Language": null, "ExternalIP": "10.120.0.0", "SessionID": null, "APIVersion": "2.0", "CallerID": null, "CalledID": null, "RequestTime": null, "AdminNumber": 129432, "CardExpirationDate": "0423", "TavVersionNumber": "3", "DataValidUntilTimestamp": "2019-12-27T10:05:45-05:00", "FinancialAccountInformation": null, "TokenUniqueReference": null, "IdentifierToken": null }
Response fields details
Fields | Description |
---|---|
AdminNumber integer |
Admin Number of Primary Account Number Valid Values: 0-9 Format:XXXX Example:200 |
IncludedFieldsInOrder string |
Concatenated string of fields in TAV signature, separated by “|â€,in their order in signature. Example:dataValidUntilTimestamp|accountNumber|accountExpiry|financialAccountInformation|tokenUniqueReference |
DigitalSignature string |
Digital signature calculated over a concatenated string of the included field values separated by a | delimiter, in the same order as specified in the IncludedFieldsInOrder field. Example:6523026E6214927059B98F8DC859EF5B2B6F7F6D9E7DAC13B38DCE6F0991F5F37DB7F9B95BD4BA8F9E6157CA1A5C8B5F880E044DD1A0D0F667F0D80619AE2637EF04BE80C4A05A8C98AA090A15EA29A43BC0846D6074724105839E8D7FC582F607C0CC40C29BF2586AE4CBE29E43E32665923838ED331CD56A557322B |
Sample response body
{ "Message": "Signature generated successfully", "Status": true, "ErrorCode": "ERR01620", "ResponseData": { "AdminNumber": 129432, "IncludedFieldsInOrder": "dataValidUntilTimestamp|accountNumber|accountExpiry|financialAccountInformation|tokenUniqueReference", "DigitalSignature": "6523026E6214927059B98F8DC859EF5B2B6F7F6D9E7DAC13B38DCE6F0991F5F37DB7F9B95BD4BA8F9E6157CA1A5C8B5F880E044DD1A0D0F667F0D80619AE2637EF04BE80C4A05A8C98AA090A15EA29A3BC0846D6074724105839E8D7FC582F607C0CC40C29BF2586AE4CBE29E43E32665923838ED331CD56A557322B7CCC296D9DC3B14A39377F928A668FF393CF46B8A4972A0905076AAF8115D16BCC87131906E9E09C4273389FB2EB474AFCA61958D377D415CE8E9ADECF0D011FC3C084ACC5EA3AF9CA5300960BA9C668972086CB08D4D313958EB444F9A887E96F98483D6FF4E198815DC7BF4C72322E473E9CEF83E27E2F9BCA8762E3121D4FD1FD32B" } }