Returns a collection of CreditCardVerification response objects.

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
This code snippet now uses gateway instance methods instead of class-level methods. Learn more.
Parameters
:billing_address_details_postal_code text

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

:created_at range

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

:credit_card_card_type multiple

The type of credit card verified. Possible values:

  • "American Express"
  • "Discover"
  • "Maestro"
  • "JCB"
  • "MasterCard"
  • "UnionPay"
  • "Visa"
:credit_card_cardholder_name text

The cardholder name in the credit card verification.

:credit_card_expiration_date text

The expiration date of the credit card verified.

:credit_card_number text

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_email text

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

:customer_id text

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

:id text

The ID of the verification.

:ids multiple

The list of verification IDs to search for.

:payment_method_token text

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
This code snippet now uses gateway instance methods instead of class-level methods. Learn more.

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
This code snippet now uses gateway instance methods instead of class-level methods. Learn more.

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
This code snippet now uses gateway instance methods instead of class-level methods. Learn more.

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
This code snippet now uses gateway instance methods instead of class-level methods. Learn more.

Billing Address

Ruby
search_results = gateway.verification.search do |search|
  search.billing_address_details_postal_code.is "12345"
end
This code snippet now uses gateway instance methods instead of class-level methods. Learn more.

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
This code snippet now uses gateway instance methods instead of class-level methods. Learn more.
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.

See also