Create/Update Token Details

put

https://au.gsc.verifone.cloud/oidc/api/v2/card

Create/Update a token using the OnlinePay Tokenisation Service.

If a token exists for the card already, it is updated with the information in the request. Otherwise, a new token is created for the given card.

Body Params

token_scope

uuid

required

The token scope under which this token was created.

encrypted_card

string

required

The cardholder data encrypted using the OnlinePay provided public key. This can be obtained using either Verifone.JS solution or OnlinePay Checkout in capture mode.

The data to encrypt is a JSON with possible tags being cardNumber, sequenceNumber, cardholderName, startMonth, startYear, expiryMonth, expiryYear, cvv. This should be a single JSON line and should not contain any spaces. Read Secure card capture key for details.

Additionally, a tag called captureTime must be presenting indicating the time the card was captured in UTC in format RFC 3339, section 5.6. eg. 2019-08-24T14:15:22Z. Encrypted card is valid for only 15 minutes.

card_brand

string

Represents a Card type or brand. It should correspond to a consistent name, the list of standard names is as follows:

Value	Description
AMEX	American Express
JCB	Japan Credit Bureau
MASTERCARD	MasterCard
VISA	Visa

token_type

string

enum

Defaults to REUSE

Token type

Allowed:

reuse_token_type

string

enum

Defaults to INTERNAL

The type of Reuse Token. This indicates if the reuse token is an internal OnlinePay type or an external Third-Party type.

Allowed:

token_expiry_date

date

When this Token will expire.

public_key_alias

string

required

token_context

object

The context and identifiers related to the token request. Mandatory for external Third-Party tokens. Use of the /v2/card endpoint:

If reuse_token_type = INTERNAL => then token_scope mandatory; token_context optional, and only token_context.entity_id would be used (if provided);

Responses

200Token result

400Bad Request

401Unauthorised

403Forbidden

404Not Found

500Internal Server Error