Create a payment token

FramePay is the recommended way to create a payment token because it minimizes PCI DSS compliance. Once a payment token is created, it can only be used once.

A payment token expires upon first use or within 30 minutes of the token creation (whichever comes first).

Authorizations:
PublishableApiKeySecretApiKeyJWT
header Parameters
Organization-Id
string (ResourceId) <= 50 characters
Example: 4f6cf35x-2c4y-483z-a0a9-158621f77a21

Organization identifier in scope of which need to perform request (if not specified, the default organization will be used).

Request Body schema: application/json

PaymentToken resource.

One of
method
required
string
Value: "payment-card"

The token payment method.

required
object

The payment card instrument details.

object

The billing address object.

object (Browser data)

Browser data used for 3DS and risk scoring.

object

Responses

Response Headers
Rate-Limit-Limit
integer

The number of allowed requests in the current period.

Rate-Limit-Remaining
integer

The number of remaining requests in the current period.

Rate-Limit-Reset
string

The date in format defined by RFC 822 when the current period will reset.

Response Schema: application/json
One of
method
required
string
Value: "payment-card"

The token payment method.

required
object

The payment card instrument details.

object

The billing address object.

id
string <= 50 characters

The token identifier string.

isUsed
boolean
Default: false

Whether the token was already used.

object (Browser data)

Browser data used for 3DS and risk scoring.

createdTime
string <date-time>

Token created time.

updatedTime
string <date-time>

Token updated time.

usageTime
string <date-time>

Token usage time.

expirationTime
string <date-time>

Token expiration time.

Array of objects (SelfLink) non-empty

The links related to resource.

Request samples

Content type
application/json
Example
Payment Card Token
Payment Card Token
Bank Account Token.
Digital Wallet Token
Plaid Account Token
Khelocard card token
Alternative payment token.
{
  • "method": "payment-card",
  • "paymentInstrument": {
    },
  • "billingAddress": {
    },
  • "browserData": {
    },
  • "leadSource": {
    }
}

Response samples

Content type
application/json
Example
Payment Card Token
Payment Card Token
Bank Account Token.
Digital Wallet Token
Plaid Account Token
Khelocard card token
Alternative payment token.
{
  • "method": "payment-card",
  • "paymentInstrument": {
    },
  • "billingAddress": {
    },
  • "id": "4f6cf35x-2c4y-483z-a0a9-158621f77a21",
  • "isUsed": false,
  • "browserData": {
    },
  • "createdTime": "2019-08-24T14:15:22Z",
  • "updatedTime": "2019-08-24T14:15:22Z",
  • "usageTime": "2019-08-24T14:15:22Z",
  • "expirationTime": "2019-08-24T14:15:22Z",
  • "_links": [
    ]
}
Next to Retrieve a list of tokens