Firstoken API Docs
  • ⚙️API Reference
    • Firstoken API
      • Tokenization As A Service
        • Simple Tokenization
        • Simple Detokenization
        • Inspect Token
        • Delete Tokens
      • Transactions
        • Create a Transaction
        • Retrieve a Transaction
        • Inspect a Transaction
        • Delete a Transaction
        • Tokenize a Transaction
      • Proxy
        • Allowed Headers
        • Actions
        • Methods
          • POST - Proxy
          • GET - Proxy
          • PUT - Proxy
          • PATCH - Proxy
          • DELETE - Proxy
        • Get Payload Hash
        • Proxy JOSE
        • Proxy WSSEC
      • Inbound Routes
        • Create an Inbound - POST
      • Payments
        • Attributes of the Request
        • Common response
        • Endpoints
          • Authorizations
          • Reversals
          • Capture
            • Capture Refunds
            • Capture Void
          • Payments
            • Payment Refunds
            • Payment Void
          • Refunds void
          • Credit
            • Credit Void
          • Get Transaction Details
        • Decision Manager
          • How it works
          • Create decision
          • Update Decision
        • Risk Payer Authentication
          • How to use it
          • 3-D Secure Flows
            • Successful Frictionless Authentication
            • Unsuccessful Frictionless Authentication
            • Attempts Processing Frictionless Authentication
            • Unavailable Frictionless Authentication
            • Rejected Frictionless Authentication
            • Authentication not available on Lookup
            • Enrollment check error
            • Time-out
            • Bypassed Authentication
            • Successful Step-Up Authentication
            • Unsuccessful Step-Up Authentication
            • Unavailable Step-Up Authentication
            • Require Method URL
        • Point of Sale Payments
          • Authorization
          • Capture
          • Payment
          • Credit
  • 📖Guides
    • Firstoken Captures Hosted Iframe
      • How Firstoken Captures works
      • Generating a JSON Web Token
      • JSON form Schema
      • Iframe Communication
    • De-scoping Components
      • How Firstoken De-scoping Components works
      • Inbound Routes Module
        • Create an Inbound Route
        • Edit an Inbound Route
        • Delete an Inbound Route
      • Webhook Module
        • Create a Webhook
        • Edit a Webhook
        • Delete a Webhook
        • Webhook events
        • How to sign Webhooks data
      • Proxy Module
        • Create a Proxy
        • Edit a Proxy
        • Delete a Proxy
    • Firstoken Captures SDK JS
      • Getting Started
      • Functions
      • Type of Elements
      • Elements Options
      • CSS Object
      • Full Example of Usage
      • SDK versions
Powered by GitBook
On this page

Was this helpful?

  1. Guides
  2. Firstoken Captures Hosted Iframe

JSON form Schema

In Firstoken Captures you are capable to defined multiples forms for every need. If you have multiples payments scenarios you can build your custom payment flow.

Forms with the payment card are built entirely in HTML components and you can add JSON schema to add or remove general fields, include logic for validate the input fields and control the behavior of the input’s fields.

The list below explains in detail every key into the JSON schema logic. The example below shows a basic payment form generated from a JSON schema:

{
    "object": "captures",
    "id": "3d824b19-fbeb-4ecd-addb-fbc57e5c0545",
    "type": "iframe",
    "version": "1.0",
    "schema": {
        "elements": [{
            "type": "card",
            "label": "card number"
          }, {
            "type": "name",
            "label": "name on card"
          }, {
            "type": "expiry",
            "label": "MM/YY"
          }, {
            "type": "cvc",
            "label": "CVC"
          }, {
            "type": "amount",
            "label": "amount"
          }],
        "currency": {
            "name": "US Dollars",
            "code": "USD",
            "simbol": "$
        },
        "format": {
            "decimal": "."
        },
        "additional_fields": [{
            "tag": "input",
            "type": "text",
            "label": "Phone",
            "validate": "true",
            "mode": "text",
            "pattern": “^[+]*[(]{0,1}[0-9]{1,4}[)]{0,1}[-\s\./0-9]*$",
            "placeholder": "(555) 555-1234",
            "required": "true",
            "max_length": 16,
            "min_lenght": 16
        }]
    },
    "lang": "us",
    "ttl": "300"
}
PreviousGenerating a JSON Web TokenNextIframe Communication

Last updated 1 year ago

Was this helpful?

📖