The verifyclientbilling Method allows the merchant to verify the integrity of a client's credit card and billing address immediately, rather than waiting for Billing Circle to batch the first payment. This method functions by creating a $0.10 authorization to the customer's account, which is then immediately voided. The customer must be told if the card is being checked in this fashion. Though the $0.10 will never settle and charge the client, the customer may be able to see this authorization for a few hours (if they checked their credit card online for example). On failure the error message returned from AuthorizeNet will be returned through the API. This method can not be used for clients billed using ACH/eCheck.
If this method is used, it should be called between the createclient and confirmclient methods, or following an modifyclient method where the payment information (including billing address) has been changed. Note: Any transactions processed through AuthorizeNet may result in fees depending on the gateway setup. Billing Circle has no part in these charges.
| Field | Required | Value | Max Length | Description |
|---|---|---|---|---|
| method | Required | verifyclientbilling | N/A | Indicates the function the merchant wishes to perform. |
| companyid | Required | Varies by merchant | 30 | Issued by Billing Circle. |
| username | Required | Varies by merchant | 30 | Any Admin level account defined within Billing Circle. |
| password | Required | Varies by merchant | 100 | Password associated with username field. |
| c_merchantid | Conditional | Any unique value | 255 | The "merchantid" allows a merchant to refer to a client record by their own proprietary key as defined within their database. This value is required if a "clientid" is not submitted. |
| c_clientid | Conditional | Integer | N/A | The "clientid" is an integer value returned upon after a successful createclient post. This value is required if a "merchantid" is not submitted. |
Members Login 