Verify Card Security Code

post

https://api-{corename}.{env}.gpsrv.com/intserv/4.0/verifyCardSecurityCode

Use the Verify Card Security Code endpoint to validate a CVV for the specified card that a cardholder inputs. Returns success on a match or failure if it does not match. This endpoint does not return the CVV.

Status codes

See Global Response Statuses for status codes that are common across endpoints.

The table below lists status codes that apply to this specific endpoint.

Status code	Description
440-01	Card security code does not match.
440-02	Card not found using PAN and expiry date.
440-03	No matching card(s) found.
440-04	System error
440-05	System error

Form Data

apiLogin

string

required

Web service username, as provided by SoFi Tech Solutions.
Pattern: Max 50 characters
Example: "AbC123-9999"

apiTransKey

string

required

Web service password, as provided by SoFi Tech Solutions.
Pattern: Max 15 characters
Example: "4sb62fh6w4h7w34g"

transactionId

string

required

1 to 60

Supply a globally unique ID to identify this endpoint request ("transaction"). Might be used for idempotency.. A UUID is preferred.
Pattern: Maximum 60 characters
Example: "9845dk-39fdk3fj3-4483483478"

cardNumber

string

required

^[0-9]{16}$

PAN of the card.
Pattern: 16 digits
Example: "1435074103447228"

cardSecurityCode

string

required

^[0-9]{3}$

The CVV value provided by the cardholder. This value is compared to the CVV in the system.
Pattern: 3 digits
Example: "123"

cardExpiryDate

string | null

^(19|20)\d\d-(0[1-9]|1[012])$

The expiry date provided by the cardholder. This value is compared to the expiry date in the system.
Pattern: YYYY-MM
Example: "2019-01"

Headers

response-content-type

string

enum

Defaults to json

Use this header instead of the standard accept header to specify the response format.

Allowed:

Response

Status codes

default