Credit Card Verification

Credit Card Verification: Search

For operators available on search fields, see the search fields page.

Ruby

collection = gateway.verification.search do |search|
  search.id.is "the_verification_id"
end

collection.each do |verification|
  puts verification.status
end

Parameters

:billing_address_details_postal_codetext

The postal code on the billing address used for the credit card verification.

:created_atrange

The date/time at which the credit card verification was created.

:credit_card_card_typemultiple

The type of credit card verified. Possible values:

"American Express"
"Discover"
"Maestro"
"JCB"
"MasterCard"
"UnionPay"
"Visa"

:credit_card_cardholder_nametext

The cardholder name in the credit card verification.

:credit_card_expiration_datetext

The expiration date of the credit card verified.

:credit_card_numbertext

The number of the credit card verified.

Card number search is restricted: starts with searches up to the first 6 digits, ends with searches last 4 digits, and contains is not allowed.

:customer_emailtext

The customer's email address associated with the credit card verification.

:customer_idtext

A string value representing an existing customer in your Vault that is associated with the credit card verification.

:idtext

The ID of the verification.

:idsmultiple

The list of verification IDs to search for.

:payment_method_tokentext

The payment method token for the credit card verification.

Examples

Customer Details

Ruby

search_results = gateway.verification.search do |search|
  search.customer_email.is "smith@example.com"
  search.customer_id.is "cust1234"
end

See search fields for a list of available operators. They allow you to do nice things like this:

Ruby

search_results = gateway.verification.search do |search|
  search.customer_email.ends_with "example.com"
end

Credit Card Details

Ruby

search_results = gateway.verification.search do |search|
  search.credit_card_cardholder_name.is "Patrick Smith"
  search.credit_card_expiration_date.is "05/2012"
  search.credit_card_number.starts_with "4111"
  search.credit_card_number.ends_with "1111"
  search.credit_card_card_type.is Braintree::CreditCard::CardType::Visa
  search.credit_card_expiration_date.is "02/16"
end

Payment Methods

You can search for credit card verifications associated to a payment method token.

Ruby

search_results = gateway.verification.search do |search|
  search.payment_method_token.is "the_token"
end

Billing Address

Ruby

search_results = gateway.verification.search do |search|
  search.billing_address_details_postal_code.is "12345"
end

Created At

Ruby

search_results = gateway.verification.search do |search|
  search.created_at.between "12/15/07 17:00", "12/17/07 17:00"
end

Note

Time zones specified in the time value will be respected in the search; if you do not specify a time zone, the search will default to the time zone associated with your gateway account. Results will always be returned with time values in UTC.

Credit Card Verification