JPMorgan Chase Token Processing API is one of 65 APIs that JPMorgan Chase publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Token Processing. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.
This API exposes
5 operations
across 5 paths,
and defines 61 schemas.
It is described by OpenAPI 3.2.0, at version 1.5.0.
Requests are made against 3 base URLs: https://api.merchant.jpmorgan.com/payments/v1/, https://api-test.merchant.jpmorgan.com/payments/v1/, https://api-mock.payments.jpmorgan.com/payments/v1.
The identity and technical contract details declared by the specification.
cardReferenceNumber
string
Identifier assigned to a credit/debit card number that was tokenized.
acquirerTokenProvisionResponse
object
Acquirer Token Provision Response
8 properties
accountInformation
object
Account Object
14 properties
3 required
validationMessage
object
Object containing information about transaction validation.
3 properties
2 required
expiry
object
A number in the form of Month/Year that is displayed on a card (Debit/Credit). Provided in format MM/YY.
2 properties
2 required
adfsError
object
Object containing information about the active directory file system error.
3 properties
3 required
messages
object
A list of errors and warnings.
4 properties
2 required
tokenInfoMerchant
object
Current information and status of a token
1 property
url
string
Reference to a web resource.
identifier
string
It is the resource identifier for a given merchant request, provided/generated by JPMC.
address
object
Address Object
6 properties
accountHolderReference
string
Unique reference identifier for a consumer within the token requestor. Required by Visa Token Service, optional for Amex and Mastercard. Visa token service max…
payload
object
Payload Object
4 properties
tokenProvisionResponse
object
Token provisioning response
9 properties
1 required
merchantDoingBusinessAs
string
Alternate name for the merchant if it exists (trading name).
tokenInformationResponse
object
Current information and status of a token.
8 properties
tokenCryptogramType
string
Type of cryptogram to be requested from Token service.
acquirerTokenProvisionRequest
object
Acquirer Token Provision Request
6 properties
1 required
tokenReferenceIdentifier
string
Identifier given to a token at the time of provisioning. Can be used as a reference to the token number.
cardExpiry
object
A number in the form of Month/Year. Provided in format MM/YY.
2 properties
2 required
acquirerTokenInformation
object
Acquirer Token Information
14 properties
merchant
object
Contains information about the Merchant.
5 properties
1 required
accountholderValidation
object
Contains information related to validation of the consumer or accountholder.
3 properties
cardMetaData
object
Information about the card related to a token.
10 properties
tokenRequestorIdentifier
string
Identifier for the merchant given by payment networks or token provider.
device
object
Contains additional information related to the consumer device.
11 properties
responseCode
string
Short explanation of the response code.
timestamp
string
Designates the date, hour, minute and second when response was provided for a request. Using ISO 8601 date-time format.
walletRisk
object
Risk information related to the wallet.
4 properties
userRisk
object
Information about risk related to account holder.
7 properties
month
integer
The month of the expiration date
cardAssetDataElement
object
Card assets which help to build virtual replication of actual physical card art.
6 properties
cardLast4Digits
string
Identifies the final 4 digits card number.
tokenNumber
string
The token number is a SECURE surrogate value for the account number utilized in payment. A token is created at enrollment into programs or when consumer creden…
code
string
Codifies a raised exception encountered by an internal or external system, sub-system, interface, job, module, system component with which the web service appl…
year
integer
The year of the expiration date
cardNumber
string
The Card Number is a number recognized by an issuer and used to identify the underlying account to which each transaction should be applied.
responseStatus
string
Request result status.
tokenizationApprovalStatus
string
Processing status of a tokenization request from the merchant.
issuerInformation
object
Information about the card issuer
12 properties
cardAssetData
array
Card assets which help to build virtual replication of actual physical card art.
message
string
Provides textual description of a problem that has occurred and is preventing the system from completing a task. Messages can be a confirmation, warning or not…
tokenInfoPaymentInstrument
object
Current information and status of a token
6 properties
1 required
cardTokenStatus
string
Current state of the token.
responseMessage
string
Long explanation of the response message.
requestIdentifier
string
Merchant identifier for the request. The value must be unique.
deviceRisk
object
Information about risk related to device.
4 properties
ipAddress
string
IP address of the consumer's device used in token transactions. Supports both IPv4 and IPv6. When processing American Express - IP Address is required in IPv4…
accountholderName
string
Consumer name that includes the first, middle, and last name.
tokenProvisonMerchant
object
Contains information about the merchant.
2 properties
paymentAccountReference
string
Payment Account Reference (PAR) acts as a linkage mechanism for processing transactions when full PAN is unavailable. PAR is not intended to be a PAN replaceme…
acquirerAccountInformation
object
Acquirer Account Information
13 properties
2 required
tokenProvisionRequest
object
Token provisioning request
6 properties
1 required
merchantName
string
Merchant legal name.
tokenAssetResponse
object
Contains card asset information including card art, and Issuer information
7 properties
tokenInformation
object
Information about provisioned token
15 properties
2 required
cardRisk
object
A list of errors and warnings.
2 properties
stateChangeReason
string
Lifecycle action requested by merchant for a token.
tokenProvisionDuplicateResponse
object
Token Provision Duplicate Response
3 properties
accountholderTelephone
object
Conditional - Provide either email or telephone number for the accountholder.
2 properties
1 required
riskInformation
object
Risk information related to token request.
4 properties
The full machine-readable OpenAPI contract behind this narrative.
Other APIs JPMorgan Chase publishes across the network.
