# Verify Push-to-Card Eligibility

Determine Push To Card eligibility for Push To Card customers.

Endpoint: POST /payment_instruments/{payment_instrument_id_verify}/verifications
Version: 2022-02-01
Security: BasicAuth

## Path parameters:

  - `payment_instrument_id_verify` (string, required)
    The ID of the  you wish to verify.

## Request fields (application/json):

  - `processor` (string, required)
    The acquiring processor. Use  to use your sandbox. For more details on which processor to use, reach out to your Finix point of contact or email [Finix Support](/guides/getting-started/support-at-finix/).
    Enum: "DUMMY_V1", "FINIX_V1", "MASTERCARD_V1", "VISA_V1"

  - `tags` (object,null)
    Include up to 50  pairs to annotate requests with custom metadata.
- Maximum character length for individual  is 40.
- Maximum character length for individual  is 500.
(For example, , , )

## Response 200 fields (application/json):

  - `id` (string)
    The ID of the resource.

  - `created_at` (string)
    Timestamp of when the object was created.

  - `updated_at` (string)
    Timestamp of when the object was last updated.

  - `application` (string)
    ID of the  the  was created under.

  - `identity` (string)
    ID of the  that created the .

  - `merchant` (string)
    ID of the  resource.

  - `merchant_identity` (string)
    ID of the  associated with the .

  - `messages` (array)
    Codified list of reasons the  was . For  Merchants, please use the newer  and  fields.

  - `outcome_summary` (string)
    An optional message providing additional context about why the Verification was , available for  Merchants only.

  - `outcomes` (array)
    Codified list of reasons the Verification was , available for  Merchants only.

  - `payment_instrument` (string)
    The  that's used to settle the  processed funds.

  - `payment_instrument_verification_details` (object)
    Details the verification results of .

  - `payment_instrument_verification_details.push_to_card_domestic` (string)
    Details if the  supports push and pull from card, domestically. For more details, see [Push to Card](/guides/payouts/card-payouts).

  - `payment_instrument_verification_details.push_to_card_cross_border` (string)
    Details if the  supports push and pull from card, cross-border. For more details, see [Push to Card](/guides/payouts/card-payouts).

  - `payment_instrument_verification_details.card_type` (string)
    The type of card. Same value as .

  - `payment_instrument_verification_details.billing_currency` (string)

  - `payment_instrument_verification_details.issuer_country` (string)

  - `processor` (string)
    Name of the verification processor.
    Enum: "LITLE_V1", "VANTIV_V1", "FINIX_V1", "DUMMY_V1"

  - `raw` (array)
    Codified list of reasons the  was . For  Merchants, please use the newer  and  fields.

  - `state` (string)
    State of the  request.
    Enum: "PENDING"

  - `tags` (object,null)
    Include up to 50  pairs to annotate requests with custom metadata.
- Maximum character length for individual  is 40.
- Maximum character length for individual  is 500.
(For example, , , )

  - `trace_id` (string)
    Trace ID of the .

  - `type` (string)
    Details the type of resource getting verified.
    Enum: "MERCHANT"

  - `_links` (object)
    For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these  to make your follow-up requests and quickly access relevant IDs.

  - `_links.self` (object)
    Link to the resource that was used in the request.

  - `_links.self.href` (string)

  - `_links.merchant` (object)
    Link to the  that was used in the request.

  - `_links.application` (object)
    Link to the  that was used in the request.

## Response 400 fields (application/json):

  - `total` (integer, required)
    Total number of errors returned.

  - `_embedded` (object, required)
    Container for embedded error objects.

  - `_embedded.errors` (array)
    List of individual error objects.

  - `_embedded.errors.code` (string)
    The error code. The  error code is returned for a 401 Unauthorized or 403 Forbidden request.

  - `_embedded.errors.logref` (object)

  - `_embedded.errors.message` (string)
    A human-friendly error message.

  - `_embedded.errors._links` (object)
    Links related to this error.

  - `_embedded.errors._links.source` (object)
    Link to the resource related to the error.

  - `_embedded.errors._links.source.href` (string)
    URL of the related resource.

## Response 401 fields (application/json):

  - `total` (integer, required)
    Total number of errors returned.

  - `_embedded` (object, required)
    Container for embedded error objects.

  - `_embedded.errors` (array)
    List of individual error objects.

  - `_embedded.errors.code` (string)
    The error code. The  error code is returned for a 401 Unauthorized or 403 Forbidden request.

  - `_embedded.errors.logref` (object)

  - `_embedded.errors.message` (string)
    A human-friendly error message.

  - `_embedded.errors._links` (object)
    Links related to this error.

  - `_embedded.errors._links.source` (object)
    Link to the resource related to the error.

  - `_embedded.errors._links.source.href` (string)
    URL of the related resource.

## Response 403 fields (application/json):

  - `total` (integer, required)
    Total number of errors returned.

  - `_embedded` (object, required)
    Container for embedded error objects.

  - `_embedded.errors` (array)
    List of individual error objects.

  - `_embedded.errors.code` (string)
    The error code. The  error code is returned for a 401 Unauthorized or 403 Forbidden request.

  - `_embedded.errors.logref` (object)

  - `_embedded.errors.message` (string)
    A human-friendly error message.

  - `_embedded.errors._links` (object)
    Links related to this error.

  - `_embedded.errors._links.source` (object)
    Link to the resource related to the error.

  - `_embedded.errors._links.source.href` (string)
    URL of the related resource.

## Response 404 fields (application/json):

  - `total` (integer, required)
    Total number of errors returned.

  - `_embedded` (object, required)
    Container for embedded error objects.

  - `_embedded.errors` (array)
    List of individual error objects.

  - `_embedded.errors.code` (string)
    The error code. The  error code is returned for a 401 Unauthorized or 403 Forbidden request.

  - `_embedded.errors.logref` (object)

  - `_embedded.errors.message` (string)
    A human-friendly error message.

  - `_embedded.errors._links` (object)
    Links related to this error.

  - `_embedded.errors._links.source` (object)
    Link to the resource related to the error.

  - `_embedded.errors._links.source.href` (string)
    URL of the related resource.

## Response 406 fields (application/json):

  - `total` (integer, required)
    Total number of errors returned.

  - `_embedded` (object, required)
    Container for embedded error objects.

  - `_embedded.errors` (array)
    List of individual error objects.

  - `_embedded.errors.code` (string)
    The error code. The  error code is returned for a 401 Unauthorized or 403 Forbidden request.

  - `_embedded.errors.logref` (object)

  - `_embedded.errors.message` (string)
    A human-friendly error message.

  - `_embedded.errors._links` (object)
    Links related to this error.

  - `_embedded.errors._links.source` (object)
    Link to the resource related to the error.

  - `_embedded.errors._links.source.href` (string)
    URL of the related resource.