Try it

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
  • Payment Card Token
  • Bank Account Token
  • Payment Token
  • Digital Wallet Token
method
required
string
Value: "payment-card"

The token payment method

paymentInstrument
required
object

The payment instrument details

billingAddress
required
object

The billing address object

fingerprint
string
Deprecated

Device fingerprint hash

browserData
object (Browser data)

Browser data used for 3DS and risk scoring.

leadSource
object

Responses

201

Token was created

401

Unauthorized access, invalid credentials was used

403

Access forbidden

422

Invalid data was sent

post/tokens

Live Server

https://api.rebilly.com/v2.1/tokens

Sandbox Server

https://api-sandbox.rebilly.com/v2.1/tokens

Request samples

Content type
application/json
Example
Payment Card Token
Copy
 Expand all Collapse all
{
  • "method": "payment-card",
  • "paymentInstrument":
    {
    },
  • "billingAddress":
    {
    },
  • "fingerprint": "string",
  • "browserData":
    {
    },
  • "leadSource":
    {
    }
}

Response samples

Content type
application/json
Example
Payment Card Token
Copy
 Expand all Collapse all
{
  • "method": "payment-card",
  • "paymentInstrument":
    {
    },
  • "billingAddress":
    {
    },
  • "id": "4f6cf35x-2c4y-483z-a0a9-158621f77a21",
  • "isUsed": false,
  • "fingerprint": "string",
  • "browserData":
    {
    },
  • "createdTime": "2020-08-05T14:25:56Z",
  • "updatedTime": "2020-08-05T14:25:56Z",
  • "usageTime": "2020-08-05T14:25:56Z",
  • "expirationTime": "2020-08-05T14:25:56Z",
  • "_links":
    [
    ]
}
Next to Retrieve a list of tokens