Answer5

AppResellerAccount6

AppResellerAssignment3

AppResellerCatalog2

AppResellerCompanyAssociation3

AppResellerLeads11

AppResellerOpportunities23

AppResellerOrder1

AppResellerPaymentMethod3

AppResellerQuoteVersion4

AppResellerReconciliation3

AppResellerSubscription5

Bundle3

checkoutItemDetails1

Comment5

Companies7

CompanyMemberships15

CurrencyExchangeRate4

CustomerNotification9

DataUploader3

DefaultNotificationTemplateApi5

Discount5

Domains3

Edition1

Event2

Group10

InboundEvents1

Integration4

Invitation5

Invoice7

Marketplace Product Settings5

MyApps4

Navigation1

Payment5

Payment Methods7

PaymentInstrument6

PaymentPlan3

Payments v29

Product8

Product Management API4

ProductContext2

PurchaseOrder7

Question4

Reconciliation1

Reporting3

Reporting V22

Review5

Search1

SegmentFolders15

Settings2

ShoppingCart28

SubscriptionAssignments5

Subscriptions23

Sync5

User13

UserAccounts2

Payment Methods

Tokenize payment methods

Changed on Nov 6, 2026

Calls the payment gateway to validate the payment method, which is not yet associated with a user. A front-end should call this endpoint directly, not a back-end. Requires a public developer key (use the AD-Public-Developer-Key header), which you must obtain from AppDirect.

post/appMarket/v2/paymentMethodTokens

Request

Base URL
https://marketplace.appdirect.com/api
Auth
none declared. Required headers: AD-Public-Developer-Key
TypeScript
https://skmtc.dev/appdirect/apis/companies/docs/appMarket/v2/paymentMethodTokens/post.ts
A function with typed inputs. Its response is checked against the schema.

Headers

AD-Public-Developer-Keystring required

Request body

paymentMethodTypestring required

The type of payment method, such as CARD, BANKACCOUNT, and so on.

propertiesobject required

The properties of the payment method, as listed in getPaymentMethodTypes

Example request

{
  "paymentMethodType": "CARD",
  "properties": {
    "number": "4111111111111111",
    "securityCode": "123",
    "cardHolderName": "John Smith",
    "expirationMonth": "5",
    "expirationYear": "2019",
    "brand": "VISA"
  },
  "billingAddress": {
    "street1": "279 Prince St",
    "city": "Montreal",
    "state": "Quebec",
    "country": "CA",
    "zip": "H3C 2N4"
  }
}

Response

idstring required

The token for the payment method.

expirationstring date-time required

The date and time when the token expires

Example response

{
  "id": "pm_0838a859-dfa6-4863-aa38-042d50a9e69a",
  "expiration": "2018-04-112T19:15:00Z",
  "paymentMethod": {
    "accountDisplay": "1111",
    "paymentMethodType": "CARD",
    "properties": {
      "cardHolderName": "John Smith",
      "expirationMonth": "5",
      "expirationYear": "2019",
      "brand": "VISA"
    },
    "billingAddress": {
      "street1": "279 Prince St",
      "city": "Montreal",
      "state": "Quebec",
      "country": "CA",
      "zip": "H3C 2N4"
    }
  }
}

Changes

Nov 6, 20261fc240f06971 Revision changes
- breaking
  added subschema #2: PaymentMethodTokenRequest to the request body allOf list
- breaking
  the response's body type changed from no type to object for status
- breaking
  the response's body type changed from no type to object for status
- breaking
  the response's body type changed from no type to object for status
- breaking
  the response's body type changed from no type to object for status
- breaking
  the response's body type changed from no type to object for status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status

Operation history