GET api/customercc/{id}
Returns a specific Customer Credit Card record by CustomerCCID
Request Information
URI Parameters
Name | Description | Type | Additional information |
---|---|---|---|
id | integer |
Required |
Body Parameters
None.
Response Information
Resource Description
CustomerCCName | Description | Type | Additional information |
---|---|---|---|
CustomerCCId |
The Customer_CC_Id from the AR_Customer_CC table |
integer |
None. |
CustomerId |
The Customer_Id foreign key from the AR_Customer_CC table; must reference a record in the AR_Customer |
integer |
Required |
CardType |
The type of Credit Card; possible values: AMER, DISC, MAST, VISA; required for POST/PUT |
string |
Max length: 4 Min length: 4 String length: inclusive between 0 and 4 |
CardTypeLong | string |
None. |
|
CardNumber |
Pass in only if not using tokenization (value will come back encrypted on GET) |
string |
String length: inclusive between 0 and 16 |
ExpirationMonth |
2-digit Expiration Month |
string |
Max length: 2 Min length: 2 String length: inclusive between 0 and 2 |
ExpirationYear |
2-digit Expiration Year |
string |
Max length: 2 Min length: 2 String length: inclusive between 0 and 2 |
ExpirationDate |
Read-only, formatted as: MM / YY |
string |
None. |
AccountName |
Name on the account |
string |
String length: inclusive between 0 and 22 |
PaymentMethodId |
foreign key from AR_Payment_Method; do not set explicitly (will be determined from CardType) |
integer |
None. |
CustomerAddress |
Street of address associated with the credit card |
string |
String length: inclusive between 0 and 35 |
CustomerZip |
Zip code of the address associated with the credit card |
string |
String length: inclusive between 0 and 10 |
SecurityCode |
3-digit security code on the back of the card |
string |
String length: inclusive between 0 and 8 |
UsedForAutoProcess |
This credit card should be used for Recurring Auto Processing; defaults to false if not supplied |
boolean |
None. |
AutoPay |
Display only; Y if UsedForAutoProcess = true |
string |
String length: inclusive between 0 and 1 |
AutoProcessDay |
Day of month to auto-process payment; required if UsedForAutoProcess is true |
integer |
None. |
LastFour |
Last 4 digit of the credit card number |
string |
String length: inclusive between 0 and 4 |
ACHDirectToken |
the token returned from Forte |
string |
String length: inclusive between 0 and 50 |
UsedForNonRecurAuto |
This credit card should be used for Non-Recurring Auto Processing; defaults to false if not supplied |
boolean |
None. |
UsedForInitialPmt |
Set to true only to designate this credit card in conjunction with an initial ACH payment |
boolean |
None. |
CustomerBillId |
Optional - pass in the CustomerBillId this is tied to; defaults to 1 if not supplied |
integer |
None. |
ChangeExistingEFTDay |
Optional - set true on PUT to update the Hold Date for any unsubmitted EFT transactions using this Credit Card to a new AutoProcessDay (same month only) |
boolean |
None. |
VoidExistingEFTs |
Optional - set true on PUT to void any existing unsubmitted EFT transactions using this Credit Card; if true, do not pass in ReplaceEFTsForCustomerBankID or ReplaceEFTsForCustomerCCID |
boolean |
None. |
VoidExistingEFTsReason | string |
String length: inclusive between 0 and 50 |
|
ReplaceEFTsForCustomerBankID |
Optional - pass in an existing CustomerBankID that this payment method is replacing; the system will void any pending ACH transactions for that CustomerBankID (unsubmitted only), and replace them with this new Credit Card; if set, do not set VoidExistingEFTs to true |
integer |
None. |
ReplaceEFTsForCustomerCCID |
Optional - pass in an existing CustomerCCID that this payment method is replacing; the system will void any pending ACH transactions for that CustomerCCID (unsubmitted only), and replace them with this new Credit Card; if set, do not set VoidExistingEFTs to true |
integer |
None. |
ReplaceExistingEFTsReason |
specify the Void reason for replacing existing ACH entries; automatically set if blank |
string |
String length: inclusive between 0 and 50 |
PrintCycleInvoices |
Print Cycle Invoices in AR_Customer table |
boolean |
None. |
Response Formats
application/json, text/json
{ "CustomerCCId": 1, "CustomerId": 2, "CardType": "sample string 3", "CardTypeLong": "sample string 4", "CardNumber": "sample string 5", "ExpirationMonth": "sample string 6", "ExpirationYear": "sample string 7", "ExpirationDate": "sample string 8", "AccountName": "sample string 9", "PaymentMethodId": 1, "CustomerAddress": "sample string 10", "CustomerZip": "sample string 11", "SecurityCode": "sample string 12", "UsedForAutoProcess": true, "AutoPay": "sample string 13", "AutoProcessDay": 1, "LastFour": "sample string 14", "ACHDirectToken": "sample string 15", "UsedForNonRecurAuto": true, "UsedForInitialPmt": true, "CustomerBillId": 1, "ChangeExistingEFTDay": true, "VoidExistingEFTs": true, "VoidExistingEFTsReason": "sample string 16", "ReplaceEFTsForCustomerBankID": 1, "ReplaceEFTsForCustomerCCID": 1, "ReplaceExistingEFTsReason": "sample string 17", "PrintCycleInvoices": true }
application/xml, text/xml
<CustomerCC xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SedonaServices.Models"> <ACHDirectToken>sample string 15</ACHDirectToken> <AccountName>sample string 9</AccountName> <AutoPay>sample string 13</AutoPay> <AutoProcessDay>1</AutoProcessDay> <CardNumber>sample string 5</CardNumber> <CardType>sample string 3</CardType> <CardTypeLong>sample string 4</CardTypeLong> <ChangeExistingEFTDay>true</ChangeExistingEFTDay> <CustomerAddress>sample string 10</CustomerAddress> <CustomerBillId>1</CustomerBillId> <CustomerCCId>1</CustomerCCId> <CustomerId>2</CustomerId> <CustomerZip>sample string 11</CustomerZip> <ExpirationDate>sample string 8</ExpirationDate> <ExpirationMonth>sample string 6</ExpirationMonth> <ExpirationYear>sample string 7</ExpirationYear> <LastFour>sample string 14</LastFour> <PaymentMethodId>1</PaymentMethodId> <PrintCycleInvoices>true</PrintCycleInvoices> <ReplaceEFTsForCustomerBankID>1</ReplaceEFTsForCustomerBankID> <ReplaceEFTsForCustomerCCID>1</ReplaceEFTsForCustomerCCID> <ReplaceExistingEFTsReason>sample string 17</ReplaceExistingEFTsReason> <SecurityCode>sample string 12</SecurityCode> <UsedForAutoProcess>true</UsedForAutoProcess> <UsedForInitialPmt>true</UsedForInitialPmt> <UsedForNonRecurAuto>true</UsedForNonRecurAuto> <VoidExistingEFTs>true</VoidExistingEFTs> <VoidExistingEFTsReason>sample string 16</VoidExistingEFTsReason> </CustomerCC>