cardTokenization

Extract Card From Image

Changed on

Extract the card details from a photo of a physical card and tokenize them.

This allows a customer to take a photo of their credit/debit card and have the card details auto-populated during checkout instead of typing them in manually. The card is extracted and stored as a token in Coinflow's PCI-compliant vault, and the resulting token is returned so it can be used in the cards endpoint.

In order to gain access to this endpoint your company must have PCI-DSS certification, and provide that to your Coinflow Integrations Representative.

post/tokenize/extract-card

Request

  • Base URL
    https://api-sandbox.coinflow.cash/api
  • URL
    https://api-sandbox.coinflow.cash/api/tokenize/extract-card
  • Auth
    API key in header Authorization

Request body

imagestring

A base64-encoded image of the physical card to extract details from.

Note: This is only for documentation purposes, this endpoint returns an HTTP redirect where the card image should be sent.

mimeTypestring

The MIME type of the provided image. Defaults to image/jpeg.

Note: This is only for documentation purposes, this endpoint returns an HTTP redirect where the card image should be sent.

Response

Ok

tokenstring required

The token representing the extracted card. Use this token in the cards endpoint to complete the checkout.

firstSixstring required

The first six digits of the extracted card number.

lastFourstring required

The last four digits of the extracted card number.

expirationMonthstring nullable required

The extracted card expiration month, if available.

expirationYearstring nullable required

The extracted card expiration year, if available.

cvvCapturedboolean required

Whether a CVV/CVC was captured from the image and stored with the token.

Changes

  • 81b590227b14Revision changes
    • warning

      deleted the header request parameter Authorization

    • info

      the endpoint scheme security merchant was added to the API

  • 66b771d6d31fRevision changes
    • info

      api operation id extract-card removed and replaced with cardTokenization_ExtractCard