Server-Side API Requests/
Credit Card Verification/
Search

Credit Card Verification: Search

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

  1. 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.
;

ExamplesAnchorIcon

Customer DetailsAnchorIcon

  1. Ruby
search_results = gateway.verification.search do |search|
  search.customer_email.is "[email protected]"
  search.customer_id.is "cust1234"
end

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

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

Credit Card DetailsAnchorIcon

  1. 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 MethodsAnchorIcon

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

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

Billing AddressAnchorIcon

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

Created AtAnchorIcon

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

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.