Automatic Web Service Fees
Web service fees can be applied to specific endpoints when run, such as issuing a virtual card or unblocking a PIN, resulting in an automatic charge to the customer. Fees are set up in the Product Setup Form (PSF).
Note
Automatic web service fees should be completed on the Web Services Fees tab of the customer PSF. For more details, see the Fees Guide.
There are some requirements for an automatic fee transaction:
-
A fee transaction should be created when the specific condition for that endpoint is met. If there is no condition specified for the endpoint then the fee will always be generated.
-
The FeeAmount is taken from the webservice fee group. If the required FeeType is not specified in the webservice fee group, the transaction will not be created.
-
If the card is in EHI mode Gateway Processing (Mode 1), Gateway Processing with STIP (Mode 4) or Gateway Processing with STIP (Mode 5), the card balance is not checked, and the transaction is created as in Generic Fees for these EHI modes.
-
If the EHI mode is Cooperative Processing (Mode 2) or Full Service Processing (Mode 3), if the card does not have enough balance, then pending fees and partial fees parameters should be checked from the card’s webservice fee group.
Available Endpoints
Only certain endpoints can have web service fees associated with them (and some of those fees can only be charged under specific conditions). The following table details each of the available endpoints, the conditions (where applicable) and the FeeType associated with the fee.
Endpoint | Condition | FeeType |
---|---|---|
POST /cards | CardType is Virtual | VirtualCardIssuingFee |
POST /cards | CardType is Physical | PhysicalCardIssuingFee |
PUT /cards/{publicToken}/status | Status is “Active” and Card is Parent Card | ParentCardActivationFee |
PUT /cards/[publicToken}/status | Status is “Active” and Card is Parent Card | ChildCardActivationFee |
POST /cards/{publicToken}/pin | N/A | PINCVVServiceFee |
GET /cards/{publicToken}/pin/status | N/A | PINCVVServiceFee |
POST /cards/{publicToken}/pin/unblock | N/A | PINCVVServiceFee |
GET /cards/{publicToken}/cvv | N/A | PINCVVServiceFee |
GET /cards/{publicToken}/cvv/status | N/A | PINCVVServiceFee |
GET /cards/{publicToken}/cvv/status | N/A | PINCVVServiceFee |
POST /cards/{publicToken}/renew | N/A | CardReplacementFee |
POST /cards/{publicToken}/replace | RenewStep is empty or RenewState is Renew or RenewStep is RenewWithSameExpiry | CardReplacementFee |
POST /cards/{public Token}/cardType | CardType is Physical | CardConversionFee |
Updated 9 months ago