Verifications
are used to verify Identities
and Payment Instruments
.
For Identities
, a verification represents an attempt to onboard and underwrite an identity.
For Payment Instruments
, a verification represents getting additional information from the card brands to verify a card is eligible for push to card.
Related Guides: Onboarding with the API, Push to Card
Get a list of all the Verifications
for a Merchant
resource.
limit | integer <int64> The number of entries to return. |
after_cursor | string Return every resource created after the cursor value. |
before_cursor | string Return every resource created before the cursor value. |
tags.key | string Filter by the |
tags.value | string Filter by the value of a |
List of Verification objects
Authentication information is missing or invalid
Forbidden
Object does not exist
Not Acceptable
curl https://finix.sandbox-payments-api.com/merchants/MUpaGK5dUb2Sb7aGuXhFRNbj/verifications \ -H "Content-Type: application/vnd.api+json" \ -u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e
{- "_embedded": {
- "verifications": [
- {
- "id": "VInHzhoRAnAizVU7jcj2K6bX",
- "created_at": "2022-08-15T23:12:56.40Z",
- "updated_at": "2022-08-15T23:12:56.85Z",
- "application": "APgPDQrLD52TYvqazjHJJchM",
- "identity": null,
- "merchant": "MUpaGK5dUb2Sb7aGuXhFRNbj",
- "merchant_identity": "IDgahPGJ6hangmVJwrMRyZzr",
- "messages": [ ],
- "payment_instrument": null,
- "processor": "DUMMY_V1",
- "raw": "RawDummyMerchantUnderwriteResult",
- "state": "SUCCEEDED",
- "tags": { },
- "trace_id": "1c8fb49d-6f1c-40a0-8646-1bcb88047583",
- "_links": {
- "application": {
},
}
}, - {
- "id": "VIdS8qSW3kZbnK9AsFHJZ81U",
- "created_at": "2022-08-15T23:12:54.32Z",
- "updated_at": "2022-08-15T23:12:54.65Z",
- "application": "APgPDQrLD52TYvqazjHJJchM",
- "identity": null,
- "merchant": "MUpaGK5dUb2Sb7aGuXhFRNbj",
- "merchant_identity": "IDgahPGJ6hangmVJwrMRyZzr",
- "messages": [ ],
- "payment_instrument": null,
- "processor": "DUMMY_V1",
- "raw": "RawDummyMerchantUnderwriteResult",
- "state": "SUCCEEDED",
- "tags": {
- "key": "value_2"
}, - "trace_id": "4d12cbe6-032d-4e9d-8291-ce16f4add412",
- "_links": {
- "application": {
},
}
}
]
}, - "page": {
- "offset": 0,
- "limit": 20,
- "count": 2
}
}
List all the Verifications
created for a Payment Instrument
.
limit | integer <int64> The number of entries to return. |
offset | integer <int64> The number of items to skip before starting to collect the result set. |
pageNumber | integer <int64> The page number to list. |
pageSize | integer <int64> The size of the page. |
tags.key | string Filter by the |
tags.value | string Filter by the value of a |
List of Verification objects
Authentication information is missing or invalid
Forbidden
Object does not exist
Not Acceptable
curl https://finix.sandbox-payments-api.com/payment_instruments/PImc5nvdnp15atLxEBAGtxJs/verifications/ \ -H "Content-Type: application/vnd.api+json" \ -u USpEbizhxFRAFT7oYgWjX87B:6d3ace2c-23f9-4e59-8b75-a1a5b8a53055
{- "_embedded": {
- "verifications": [
- {
- "id": "VInHzhoRAnAizVU7jcj2K6bX",
- "created_at": "2022-08-15T23:12:56.40Z",
- "updated_at": "2022-08-15T23:12:56.85Z",
- "application": "APgPDQrLD52TYvqazjHJJchM",
- "identity": null,
- "merchant": "MUpaGK5dUb2Sb7aGuXhFRNbj",
- "merchant_identity": "IDgahPGJ6hangmVJwrMRyZzr",
- "messages": [ ],
- "payment_instrument": null,
- "processor": "DUMMY_V1",
- "raw": "RawDummyMerchantUnderwriteResult",
- "state": "SUCCEEDED",
- "tags": { },
- "trace_id": "1c8fb49d-6f1c-40a0-8646-1bcb88047583",
- "_links": {
- "application": {
},
}
}, - {
- "id": "VIdS8qSW3kZbnK9AsFHJZ81U",
- "created_at": "2022-08-15T23:12:54.32Z",
- "updated_at": "2022-08-15T23:12:54.65Z",
- "application": "APgPDQrLD52TYvqazjHJJchM",
- "identity": null,
- "merchant": "MUpaGK5dUb2Sb7aGuXhFRNbj",
- "merchant_identity": "IDgahPGJ6hangmVJwrMRyZzr",
- "messages": [ ],
- "payment_instrument": null,
- "processor": "DUMMY_V1",
- "raw": "RawDummyMerchantUnderwriteResult",
- "state": "SUCCEEDED",
- "tags": {
- "key": "value_2"
}, - "trace_id": "4d12cbe6-032d-4e9d-8291-ce16f4add412",
- "_links": {
- "application": {
},
}
}
]
}, - "page": {
- "offset": 0,
- "limit": 20,
- "count": 2
}
}
Retrieve a list of Verifications
.
limit | integer The numbers of items to return. Example: limit=10 |
after_cursor | string Return every resource created after the cursor value. |
before_cursor | string Return every resource created before the cursor value. |
tags.key | string Filter by the |
tags.value | string Filter by the value of a |
List of Verification objects
Authentication information is missing or invalid
Forbidden
Not Acceptable
curl https://finix.sandbox-payments-api.com/verifications \ -H "Content-Type: application/vnd.api+json" \ -u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e
{- "_embedded": {
- "verifications": [
- {
- "id": "VInHzhoRAnAizVU7jcj2K6bX",
- "created_at": "2022-08-15T23:12:56.40Z",
- "updated_at": "2022-08-15T23:12:56.85Z",
- "application": "APgPDQrLD52TYvqazjHJJchM",
- "identity": null,
- "merchant": "MUpaGK5dUb2Sb7aGuXhFRNbj",
- "merchant_identity": "IDgahPGJ6hangmVJwrMRyZzr",
- "messages": [ ],
- "payment_instrument": null,
- "processor": "DUMMY_V1",
- "raw": "RawDummyMerchantUnderwriteResult",
- "state": "SUCCEEDED",
- "tags": { },
- "trace_id": "1c8fb49d-6f1c-40a0-8646-1bcb88047583",
- "_links": {
- "application": {
},
}
}, - {
- "id": "VIdS8qSW3kZbnK9AsFHJZ81U",
- "created_at": "2022-08-15T23:12:54.32Z",
- "updated_at": "2022-08-15T23:12:54.65Z",
- "application": "APgPDQrLD52TYvqazjHJJchM",
- "identity": null,
- "merchant": "MUpaGK5dUb2Sb7aGuXhFRNbj",
- "merchant_identity": "IDgahPGJ6hangmVJwrMRyZzr",
- "messages": [ ],
- "payment_instrument": null,
- "processor": "DUMMY_V1",
- "raw": "RawDummyMerchantUnderwriteResult",
- "state": "SUCCEEDED",
- "tags": {
- "key": "value_2"
}, - "trace_id": "4d12cbe6-032d-4e9d-8291-ce16f4add412",
- "_links": {
- "application": {
},
}
}
]
}, - "page": {
- "offset": 0,
- "limit": 20,
- "count": 2
}
}
Retrieve the details of a Verification
.
Single Verification object
Authentication information is missing or invalid
Forbidden
Object does not exist
Not Acceptable
curl https://finix.sandbox-payments-api.com/verifications/VIbXwBuccEcqw7rfZneELCv4 \ -H "Content-Type: application/vnd.api+json" \ -u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e
{- "id": "VIvZKP8XKzxyJaxJsfAEHbw6",
- "created_at": "2022-10-11T00:46:48.68Z",
- "updated_at": "2022-10-11T00:46:48.72Z",
- "application": "APgPDQrLD52TYvqazjHJJchM",
- "identity": null,
- "merchant": "MUgWbPVvtKbzjKNNGKqdQYV7",
- "merchant_identity": "ID2CGJmjqyYaQAu6qyuvGeWK",
- "messages": [ ],
- "payment_instrument": "PIwWisLuZNwPBoLbCgQVTCoY",
- "processor": "DUMMY_V1",
- "raw": "RawDummyMerchantUnderwriteResult",
- "state": "SUCCEEDED",
- "tags": {
- "card_name": "Personal Card"
}, - "trace_id": "a7355d05-95b0-4b44-938d-bf0a99f19c17",
- "_links": {
- "application": {
},
}
}