Qualpay Embedded Fields API

openapi: 3.2.0
info:
  title: APIs Embedded Fields API
  description: This document describes the Platform and PG API.
  contact:
    name: Qualpay
  license:
    name: Apache
    url: http://apache.org
  version: 2.1.3
servers:
- url: https://api-test.qualpay.com
  description: Sandbox Platform API
- url: https://api.qualpay.com
  description: Production Platform API
tags:
- name: Embedded Fields
  description: Embedded Fields
paths:
  /platform/embedded:
    get:
      tags:
      - Embedded Fields
      summary: Get Transient Key
      description: Gets a transient key for use with embedded fields. The transient key is a one-time key used to invoke embedded fields. This key is valid for up to 12 hours. The key will be automatically invalidated once a card is successfully tokenized through embedded fields or if there are too many declines during verification.
      operationId: getEmbeddedTransientKey
      parameters: []
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EmbeddedKeyResponse'
        '400':
          description: Request Validation Failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QPApiResponse'
        '500':
          description: Internal Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QPApiResponse'
      security:
      - basicAuth: []
components:
  schemas:
    EmbeddedKeyResponse:
      type: object
      properties:
        code:
          type: integer
          description: '<strong>Format: </strong>Fixed length, 1 N<br><strong>Description: </strong>Response code from the API. `0` indicates success. Refer to <a href="/docs/api-conventions#platform-api-response-codes" target="_blank">Platform API Response Codes</a> for the entire list of return codes.'
          format: int32
          readOnly: true
          example: 0
        message:
          type: string
          description: '<strong>Format: </strong>Variable length AN<br><strong>Description: </strong>A short description of the API response code.'
          readOnly: true
          example: Success
        data:
          $ref: '#/components/schemas/EmbeddedKey'
    QPApiData:
      type: object
    QPApiResponse:
      type: object
      properties:
        code:
          type: integer
          description: '<strong>Format: </strong>Fixed length, 1 N<br><strong>Description: </strong>Response code from the API. `0` indicates success. Refer to <a href="/docs/api-conventions#platform-api-response-codes" target="_blank">Platform API Response Codes</a> for the entire list of return codes.'
          format: int32
          readOnly: true
          example: 0
        message:
          type: string
          description: '<strong>Format: </strong>Variable length AN<br><strong>Description: </strong>A short description of the API response code.'
          readOnly: true
          example: Success
        data:
          $ref: '#/components/schemas/QPApiData'
    EmbeddedKey:
      type: object
      properties:
        transient_key:
          type: string
          description: '<strong>Format: </strong>Fixed length, 32 AN<br><strong>Description: </strong>A single-use token for loading embedded fields. The key will be invalidated   when a card is successfully verified. If unused, the token will expire in 12 hours. '
          readOnly: true
          example: a393941797c811e6825102a019999999
        merchant_id:
          type: integer
          description: '<strong>Format: </strong>Variable length, up to 16 AN<br><strong>Description: </strong>The unique ID assigned to a merchant.'
          format: int64
          readOnly: true
          example: 212000000001
        db_timestamp:
          type: string
          description: '<strong>Format: </strong>Variable length AN<br><strong>Description: </strong>The timestamp of transient key creation. '
          readOnly: true
          example: 2026-02-21T12:57:47.000-0700
        expiry_time:
          type: string
          description: '<strong>Format: </strong>Variable length AN<br><strong>Description: </strong>The timestamp of when the transient key will expire.'
          readOnly: true
          example: 2026-02-21T14:37:47.000-0700
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
x-provenance:
  method: searched
  source: https://developer.qualpay.com/reference
  harvested: '2026-10-26'
  tool: harvest-readme-openapi.py
  note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
  assembled_from:
  - https://developer.qualpay.com/reference/acceptdispute.md
  - https://developer.qualpay.com/reference/addapp.md
  - https://developer.qualpay.com/reference/addausjsonrequest.md
  - https://developer.qualpay.com/reference/addbillingcard.md
  - https://developer.qualpay.com/reference/addcheckout.md
  - https://developer.qualpay.com/reference/addcustomer.md
  - https://developer.qualpay.com/reference/addevent.md
  - https://developer.qualpay.com/reference/addinvoicepayment.md
  - https://developer.qualpay.com/reference/addpayee.md
  - https://developer.qualpay.com/reference/addplan.md
  - https://developer.qualpay.com/reference/addshippingaddress.md
  - https://developer.qualpay.com/reference/addsubscription.md
  - https://developer.qualpay.com/reference/addwebhook.md
  - https://developer.qualpay.com/reference/archiveplan.md
  - https://developer.qualpay.com/reference/authorization.md
  - https://developer.qualpay.com/reference/batch-close.md
  - https://developer.qualpay.com/reference/browseapps.md
  - https://developer.qualpay.com/reference/browseausrequestsdetail.md
  - https://developer.qualpay.com/reference/browseausrequestssummary.md
  - https://developer.qualpay.com/reference/browsebatches.md
  - https://developer.qualpay.com/reference/browsebouncedinvoices.md
  - https://developer.qualpay.com/reference/browsecustomers.md
  - https://developer.qualpay.com/reference/browsedeposits.md
  - https://developer.qualpay.com/reference/browsedisputes.md
  - https://developer.qualpay.com/reference/browseinvoicepayments.md
  - https://developer.qualpay.com/reference/browseinvoicepaymentsbyid.md
  - https://developer.qualpay.com/reference/browseinvoices.md
  - https://developer.qualpay.com/reference/browsepayees.md
  - https://developer.qualpay.com/reference/browseplans.md
  - https://developer.qualpay.com/reference/browsesalesreps.md
  - https://developer.qualpay.com/reference/browsestatementdisputeadjustmentdata.md
  - https://developer.qualpay.com/reference/browsestatementfeedata.md
  - https://developer.qualpay.com/reference/browsestatementplandata.md
  - https://developer.qualpay.com/reference/browsestatementreservedata.md
  - https://developer.qualpay.com/reference/browsestatementsettlementdata.md
  - https://developer.qualpay.com/reference/browsestatementsummarydata.md
  - https://developer.qualpay.com/reference/browsesubscriptions.md
  - https://developer.qualpay.com/reference/browsetrans.md
  - https://developer.qualpay.com/reference/browsewebhook.md
  - https://developer.qualpay.com/reference/cancelausrequest.md
  - https://developer.qualpay.com/reference/cancelcheckout.md
  - https://developer.qualpay.com/reference/cancelinvoice.md
  - https://developer.qualpay.com/reference/cancelsubscription.md
  - https://developer.qualpay.com/reference/capture.md
  - https://developer.qualpay.com/reference/copyinvoice.md
  - https://developer.qualpay.com/reference/createausrequest.md
  - https://developer.qualpay.com/reference/createdispute.md
  - https://developer.qualpay.com/reference/createinvoice.md
  - https://developer.qualpay.com/reference/createtestaccount.md
  - https://developer.qualpay.com/reference/credit.md
  - https://developer.qualpay.com/reference/deletebillingcard.md
  - https://developer.qualpay.com/reference/deletecustomer.md
  - https://developer.qualpay.com/reference/deletedisputefile.md
  - https://developer.qualpay.com/reference/deletepayee.md
  - https://developer.qualpay.com/reference/deleteplan.md
  - https://developer.qualpay.com/reference/deleteshippingaddress.md
  - https://developer.qualpay.com/reference/disablewebhook.md
  - https://developer.qualpay.com/reference/editwebhook.md
  - https://developer.qualpay.com/reference/emailapp.md
  - https://developer.qualpay.com/reference/enablewebhook.md
  - https://developer.qualpay.com/reference/expire.md
  - https://developer.qualpay.com/reference/force.md
  - https://developer.qualpay.com/reference/generatependingtoken.md
  - https://developer.qualpay.com/reference/get-card-type-information.md
  - https://developer.qualpay.com/reference/getallsubscriptiontransactions.md
  - https://developer.qualpay.com/reference/getapp.md
  - https://developer.qualpay.com/reference/getausdetail.md
  - https://developer.qualpay.com/reference/getausresponse.md
  - https://developer.qualpay.com/reference/getaussummary.md
  - https://developer.qualpay.com/reference/getbillingcards.md
  - https://developer.qualpay.com/reference/getcreditedtran.md
  - https://developer.qualpay.com/reference/getcustomer.md
  - https://developer.qualpay.com/reference/getcustomerbycardid.md
  - https://developer.qualpay.com/reference/getdetails.md
  - https://developer.qualpay.com/reference/getdispute.md
  - https://developer.qualpay.com/reference/getdisputefiles.md
  - https://developer.qualpay.com/reference/getdisputeresponse.md
  - https://developer.qualpay.com/reference/getdisputes.md
  - https://developer.qualpay.com/reference/getembeddedtransientkey.md
  - https://developer.qualpay.com/reference/getevents.md
  - https://developer.qualpay.com/reference/getinvoice.md
  - https://developer.qualpay.com/reference/getmerchantsettings.md
  - https://developer.qualpay.com/reference/getnondisputedtran.md
  - https://developer.qualpay.com/reference/getpayee.md
  - https://developer.qualpay.com/reference/getplan.md
  - https://developer.qualpay.com/reference/getremedyundisputedtran.md
  - https://developer.qualpay.com/reference/getshippingaddresses.md
  - https://developer.qualpay.com/reference/getsubscription.md
  - https://developer.qualpay.com/reference/getsubscriptiontransactions.md
  - https://developer.qualpay.com/reference/gettransactionbypgid.md
  - https://developer.qualpay.com/reference/gettransactionrequests.md
  - https://developer.qualpay.com/reference/getwebhook.md
  - https://developer.qualpay.com/reference/initiate-payment.md
  - https://developer.qualpay.com/reference/pausesubscription.md
  - https://developer.qualpay.com/reference/putonaushold.md
  - https://developer.qualpay.com/reference/recharge.md
  - https://developer.qualpay.com/reference/refund.md
  - https://developer.qualpay.com/reference/refundnonpg.md
  - https://developer.qualpay.com/reference/releasefromaushold.md
  - https://developer.qualpay.com/reference/removeevent.md
  - https://developer.qualpay.com/reference/removeinvoicepayment.md
  - https://developer.qualpay.com/reference/request-balance.md
  - https://developer.qualpay.com/reference/resendinvoice.md
  - https://developer.qualpay.com/reference/resetdispute.md
  - https://developer.qualpay.com/reference/resumesubscription.md
  - https://developer.qualpay.com/reference/rotateapikey.md
  - https://developer.qualpay.com/reference/sale.md
  - https://developer.qualpay.com/reference/savedata.md
  - https://developer.qualpay.com/reference/send-receipt.md
  - https://developer.qualpay.com/reference/sendinvoice.md
  - https://developer.qualpay.com/reference/setprimarybillingcard.md
  - https://developer.qualpay.com/reference/setprimaryshippingaddress.md
  - https://developer.qualpay.com/reference/submitdisputeaction.md
  - https://developer.qualpay.com/reference/submitdisputesresponse.md
  - https://developer.qualpay.com/reference/subscriptionlabelsadd.md
  - https://developer.qualpay.com/reference/subscriptionlabelsbrowse.md
  - https://developer.qualpay.com/reference/subscriptionlabelsdelete.md
  - https://developer.qualpay.com/reference/subscriptionlabelsedit.md
  - https://developer.qualpay.com/reference/tokenize.md
  - https://developer.qualpay.com/reference/tokenstatus.md
  - https://developer.qualpay.com/reference/unblocktoken.md
  - https://developer.qualpay.com/reference/updatebillingcard.md
  - https://developer.qualpay.com/reference/updatecustomer.md
  - https://developer.qualpay.com/reference/updatedraftinvoice.md
  - https://developer.qualpay.com/reference/updateinvoicepayment.md
  - https://developer.qualpay.com/reference/updateoutstandinginvoice.md
  - https://developer.qualpay.com/reference/updatepayee.md
  - https://developer.qualpay.com/reference/updatepayeeaccount.md
  - https://developer.qualpay.com/reference/updateplan.md
  - https://developer.qualpay.com/reference/updateshippingaddress.md
  - https://developer.qualpay.com/reference/updatesubscription.md
  - https://developer.qualpay.com/reference/uploaddisputefile.md
  - https://developer.qualpay.com/reference/uploadfile.md
  - https://developer.qualpay.com/reference/validateapp.md
  - https://developer.qualpay.com/reference/verify.md
  - https://developer.qualpay.com/reference/void.md
  merge:
    pages: 136
    deduped: 681
    conflicts_kept_first: 0