PAY.JP Tokens API

The Tokens API from PAY.JP — 3 operation(s) for tokens.

Operations 3

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /tokens Tokenize a card · Create a single-use card token #
Ask an LLM
“How do I turn card details into a single-use token?”
“Can I avoid raw card numbers touching my server?”
Tell an agent
Create a card token for number {number} expiring {exp_month}/{exp_year}.
Tokenize card {number}, exp {exp_month}/{exp_year}, CVC {cvc}.
GET /tokens/{id} Get a card token · Retrieve a token #
Ask an LLM
“How do I check whether a card token has been used?”
“What card details can I see from a token?”
Tell an agent
Show token {id}.
Get the details of card token {id}.
POST /tokens/{id}/tds_finish Finish 3D Secure authentication for a card token · Complete the 3D Secure flow for a token #
Ask an LLM
“Once a cardholder completes 3D Secure on a token, how do I mark the token as authenticated?”
“Is there a step to finalize 3D Secure on a card token before I charge it?”
Tell an agent
Finish the 3D Secure flow for token {id}.
Complete 3D Secure authentication on card token {id}.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/payjp:payjp-tokens-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

payjp-tokens-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: PAY.JP Tokens API
  description: PAY.JP is an online payment service operated by PAY, Inc. (PAY株式会社) in Japan. The REST API creates charges, tokenizes cards, manages customers, runs subscriptions (定期課金), and reports transfers (入金) and balances in Japanese yen. Authentication is HTTP Basic with a secret key (sk_test_ / sk_live_) as the username and an empty password. All amounts are integer JPY.
  termsOfService: https://pay.jp/terms
  contact:
    name: PAY.JP Support
    url: https://help.pay.jp/
  version: '1.0'
servers:
- url: https://api.pay.jp/v1
  description: PAY.JP REST API (HTTPS only)
security:
- basicAuth: []
tags:
- name: Tokens
paths:
  /tokens:
    post:
      operationId: createToken
      tags:
      - Tokens
      summary: Create a single-use card token
      description: Normally called client-side with the publishable key (pk_xxx) via payjp.js so raw card numbers never touch the merchant server.
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                card[number]:
                  type: string
                card[exp_month]:
                  type: integer
                card[exp_year]:
                  type: integer
                card[cvc]:
                  type: string
      responses:
        '200':
          $ref: '#/components/responses/Token'
  /tokens/{id}:
    parameters:
    - $ref: '#/components/parameters/id'
    get:
      operationId: retrieveToken
      tags:
      - Tokens
      summary: Retrieve a token
      responses:
        '200':
          $ref: '#/components/responses/Token'
  /tokens/{id}/tds_finish:
    parameters:
    - $ref: '#/components/parameters/id'
    post:
      operationId: finishTokenThreeDSecure
      tags:
      - Tokens
      summary: Complete the 3D Secure flow for a token
      responses:
        '200':
          $ref: '#/components/responses/Token'
components:
  schemas:
    Token:
      type: object
      properties:
        id:
          type: string
          example: tok_xxxxxxxxxxxxxxxx
        object:
          type: string
          example: token
        livemode:
          type: boolean
        used:
          type: boolean
        card:
          $ref: '#/components/schemas/Card'
        created:
          type: integer
    Card:
      type: object
      properties:
        id:
          type: string
          example: car_xxxxxxxxxxxxxxxx
        object:
          type: string
          example: card
        brand:
          type: string
          example: Visa
        last4:
          type: string
          example: '4242'
        exp_month:
          type: integer
        exp_year:
          type: integer
        name:
          type:
          - string
          - 'null'
        three_d_secure_status:
          type:
          - string
          - 'null'
        created:
          type: integer
  parameters:
    id:
      name: id
      in: path
      required: true
      schema:
        type: string
  responses:
    Token:
      description: A Token object
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Token'
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: HTTP Basic authentication. Use the secret key (sk_test_ / sk_live_) as the username and leave the password empty.