Recurring
Click here for a complete list of operations.
ManageCreditCardInfo
ParametersUsername | (Required) The username of the admin user. |
Password | (Required) The password of the admin user. |
TransType | (Required) The type of transaction being performed:
|
Vendor | (Required) The numerical Vendor/Merchant key. |
CustomerKey | (Required) The numerical Customer key. |
CardInfoKey | (Required) The numerical Credit Card Info key. |
CcAccountNum | (Required) Credit Card Account Number |
CcExpDate | (Required) Credit Card Expiration Date |
CcNameOnCard | (Optional) The Card Holder's name as it is on the card. |
CcStreet | (Optional) The Card Holder's billing address. |
CcZip | (Optional) The Card Holder's billing zip code. |
ExtData | (Optional) Extended Data. |
Returns
RecurringResult including keys of the newly added/updated records if the call is successful.
- Username - The admin user
- Partner - The reseller of the merchant
- Vendor - The merchant key
- CustomerKey - Customer Key
- CcInfoKey - Credit Card Payment Info Key
- CheckInfoKey - Check Payment Info Key
- ContractKey - Contract Key
- code - result code: 0 - success, error otherwise
- error - description of the erorr
- Result - payment transaction result: 0 - approved, decline otherwise
- AuthCode - Authorization code for payment transaction
- PNRef - unique reference number for the payment transaction, returned by the payment server
- Message - description of the payment transaction
Test
To test the operation using the HTTP POST protocol, click the 'Invoke' button.SOAP 1.1
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.
POST /admin/ws/recurring.asmx HTTP/1.1 Host: secure.ftipgw.com Content-Type: text/xml; charset=utf-8 Content-Length: length SOAPAction: "http://www.tpisoft.com/Admin/ws/ManageCreditCardInfo" <?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <ManageCreditCardInfo xmlns="http://www.tpisoft.com/Admin/ws"> <Username>string</Username> <Password>string</Password> <TransType>string</TransType> <Vendor>string</Vendor> <CustomerKey>string</CustomerKey> <CardInfoKey>string</CardInfoKey> <CcAccountNum>string</CcAccountNum> <CcExpDate>string</CcExpDate> <CcNameOnCard>string</CcNameOnCard> <CcStreet>string</CcStreet> <CcZip>string</CcZip> <ExtData>string</ExtData> </ManageCreditCardInfo> </soap:Body> </soap:Envelope>
HTTP/1.1 200 OK Content-Type: text/xml; charset=utf-8 Content-Length: length <?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <ManageCreditCardInfoResponse xmlns="http://www.tpisoft.com/Admin/ws"> <ManageCreditCardInfoResult> <CustomerID>string</CustomerID> <ClientSessionID>string</ClientSessionID> <CustomerKey>string</CustomerKey> <ContractKey>string</ContractKey> <CcInfoKey>string</CcInfoKey> <CheckInfoKey>string</CheckInfoKey> <code>OK or Unknown_Error or Access_Denied or Invalid_Login or Invalid_User_Status or Invalid_User or User_Not_Found or Username_Already_In_Use or Username_Has_Invalid_Characters or Not_Enough_Privilege or Invalid_PartnerID or Invalid_VendorID or Invalid_Argument or Invalid_Record or Transaction_Type_Not_Supported_By_Host or Internal_Error or Invalid_ProcessorID or Processor_Not_Found or InValidPassword</code> <error>string</error> <Partner>string</Partner> <Vendor>string</Vendor> <Username>string</Username> <Result>string</Result> <AuthCode>string</AuthCode> <PNRef>string</PNRef> <Message>string</Message> <Contracts> <ContractInfo> <Contract_Key>string</Contract_Key> <Next_Bill_Date>string</Next_Bill_Date> </ContractInfo> <ContractInfo> <Contract_Key>string</Contract_Key> <Next_Bill_Date>string</Next_Bill_Date> </ContractInfo> </Contracts> <ContractTransactions> <LastContractTrans> <PaymentPref>string</PaymentPref> <Contract_Key>string</Contract_Key> <Transaction_Date>string</Transaction_Date> <Transaction_Amount>string</Transaction_Amount> <Convenience_Fee>string</Convenience_Fee> <PNRef>string</PNRef> <ResultCode>string</ResultCode> <ResponseMessage>string</ResponseMessage> <AuthCode>string</AuthCode> </LastContractTrans> <LastContractTrans> <PaymentPref>string</PaymentPref> <Contract_Key>string</Contract_Key> <Transaction_Date>string</Transaction_Date> <Transaction_Amount>string</Transaction_Amount> <Convenience_Fee>string</Convenience_Fee> <PNRef>string</PNRef> <ResultCode>string</ResultCode> <ResponseMessage>string</ResponseMessage> <AuthCode>string</AuthCode> </LastContractTrans> </ContractTransactions> <AccountNumber>string</AccountNumber> </ManageCreditCardInfoResult> </ManageCreditCardInfoResponse> </soap:Body> </soap:Envelope>
HTTP GET
The following is a sample HTTP GET request and response. The placeholders shown need to be replaced with actual values.
GET /admin/ws/recurring.asmx/ManageCreditCardInfo?Username=string&Password=string&TransType=string&Vendor=string&CustomerKey=string&CardInfoKey=string&CcAccountNum=string&CcExpDate=string&CcNameOnCard=string&CcStreet=string&CcZip=string&ExtData=string HTTP/1.1 Host: secure.ftipgw.com
HTTP/1.1 200 OK Content-Type: text/xml; charset=utf-8 Content-Length: length <?xml version="1.0" encoding="utf-8"?> <RecurringResult xmlns="http://www.tpisoft.com/Admin/ws"> <CustomerID>string</CustomerID> <ClientSessionID>string</ClientSessionID> <CustomerKey>string</CustomerKey> <ContractKey>string</ContractKey> <CcInfoKey>string</CcInfoKey> <CheckInfoKey>string</CheckInfoKey> <code>OK or Unknown_Error or Access_Denied or Invalid_Login or Invalid_User_Status or Invalid_User or User_Not_Found or Username_Already_In_Use or Username_Has_Invalid_Characters or Not_Enough_Privilege or Invalid_PartnerID or Invalid_VendorID or Invalid_Argument or Invalid_Record or Transaction_Type_Not_Supported_By_Host or Internal_Error or Invalid_ProcessorID or Processor_Not_Found or InValidPassword</code> <error>string</error> <Partner>string</Partner> <Vendor>string</Vendor> <Username>string</Username> <Result>string</Result> <AuthCode>string</AuthCode> <PNRef>string</PNRef> <Message>string</Message> <Contracts> <ContractInfo> <Contract_Key>string</Contract_Key> <Next_Bill_Date>string</Next_Bill_Date> </ContractInfo> <ContractInfo> <Contract_Key>string</Contract_Key> <Next_Bill_Date>string</Next_Bill_Date> </ContractInfo> </Contracts> <ContractTransactions> <LastContractTrans> <PaymentPref>string</PaymentPref> <Contract_Key>string</Contract_Key> <Transaction_Date>string</Transaction_Date> <Transaction_Amount>string</Transaction_Amount> <Convenience_Fee>string</Convenience_Fee> <PNRef>string</PNRef> <ResultCode>string</ResultCode> <ResponseMessage>string</ResponseMessage> <AuthCode>string</AuthCode> </LastContractTrans> <LastContractTrans> <PaymentPref>string</PaymentPref> <Contract_Key>string</Contract_Key> <Transaction_Date>string</Transaction_Date> <Transaction_Amount>string</Transaction_Amount> <Convenience_Fee>string</Convenience_Fee> <PNRef>string</PNRef> <ResultCode>string</ResultCode> <ResponseMessage>string</ResponseMessage> <AuthCode>string</AuthCode> </LastContractTrans> </ContractTransactions> <AccountNumber>string</AccountNumber> </RecurringResult>
HTTP POST
The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.
POST /admin/ws/recurring.asmx/ManageCreditCardInfo HTTP/1.1 Host: secure.ftipgw.com Content-Type: application/x-www-form-urlencoded Content-Length: length Username=string&Password=string&TransType=string&Vendor=string&CustomerKey=string&CardInfoKey=string&CcAccountNum=string&CcExpDate=string&CcNameOnCard=string&CcStreet=string&CcZip=string&ExtData=string
HTTP/1.1 200 OK Content-Type: text/xml; charset=utf-8 Content-Length: length <?xml version="1.0" encoding="utf-8"?> <RecurringResult xmlns="http://www.tpisoft.com/Admin/ws"> <CustomerID>string</CustomerID> <ClientSessionID>string</ClientSessionID> <CustomerKey>string</CustomerKey> <ContractKey>string</ContractKey> <CcInfoKey>string</CcInfoKey> <CheckInfoKey>string</CheckInfoKey> <code>OK or Unknown_Error or Access_Denied or Invalid_Login or Invalid_User_Status or Invalid_User or User_Not_Found or Username_Already_In_Use or Username_Has_Invalid_Characters or Not_Enough_Privilege or Invalid_PartnerID or Invalid_VendorID or Invalid_Argument or Invalid_Record or Transaction_Type_Not_Supported_By_Host or Internal_Error or Invalid_ProcessorID or Processor_Not_Found or InValidPassword</code> <error>string</error> <Partner>string</Partner> <Vendor>string</Vendor> <Username>string</Username> <Result>string</Result> <AuthCode>string</AuthCode> <PNRef>string</PNRef> <Message>string</Message> <Contracts> <ContractInfo> <Contract_Key>string</Contract_Key> <Next_Bill_Date>string</Next_Bill_Date> </ContractInfo> <ContractInfo> <Contract_Key>string</Contract_Key> <Next_Bill_Date>string</Next_Bill_Date> </ContractInfo> </Contracts> <ContractTransactions> <LastContractTrans> <PaymentPref>string</PaymentPref> <Contract_Key>string</Contract_Key> <Transaction_Date>string</Transaction_Date> <Transaction_Amount>string</Transaction_Amount> <Convenience_Fee>string</Convenience_Fee> <PNRef>string</PNRef> <ResultCode>string</ResultCode> <ResponseMessage>string</ResponseMessage> <AuthCode>string</AuthCode> </LastContractTrans> <LastContractTrans> <PaymentPref>string</PaymentPref> <Contract_Key>string</Contract_Key> <Transaction_Date>string</Transaction_Date> <Transaction_Amount>string</Transaction_Amount> <Convenience_Fee>string</Convenience_Fee> <PNRef>string</PNRef> <ResultCode>string</ResultCode> <ResponseMessage>string</ResponseMessage> <AuthCode>string</AuthCode> </LastContractTrans> </ContractTransactions> <AccountNumber>string</AccountNumber> </RecurringResult>