Create Payment Method Token

post

https://api.preczn.com/v1/tokens

Body Params

type

string

enum

required

Type of payment method.

Allowed:

firstName

string

First name of payment account holder. This value can be set when creating the token, either directly through the Token API or by using the tokenize parameter with the Transactions API. Any updated values sent in a Payments API request using this token will be stored.

lastName

string

Last name of payment account holder. This value can be set when creating the token, either directly through the Token API or by using the tokenize parameter with the Transactions API. Any updated values sent in a Payments API request using this token will be stored.

string

Email address of payment account holder. This value can be set when creating the token, either directly through the Token API or by using the tokenize parameter with the Transactions API. Any updated values sent in a Payments API request using this token will be stored.

phone

string

Phone number of payment account holder. This value can be set when creating the token, either directly through the Token API or by using the tokenize parameter with the Transactions API. Any updated values sent in a Payments API request using this token will be stored.

card

object

Card payment method.

billingAddress

object

The payment account holders billing address. This value is retained from the most recent transaction request in which it was included

bankAccount

object

Bank account payment method.

loan

object

Loan payment method.

merchantId

string

The Preczn merchant with which the token will be associated. Required for bankAccount and loan token types.

achMandate

string

ACH mandate text that the customer agreed to, authorizing the ACH debit. Required for ACH transactions with some processors.

accountBusinessName

string

Business name associated with the bank account. Used for corporate/business ACH transactions.

tptConfig

object

Third-party tokenization configuration. Contains settings used when exporting this token to a destination processor (e.g., shopper reference).

Headers

idempotency-key

string

Unique key to ensure idempotency of requests. If provided, the server will return the same response for subsequent requests with the same key.

Responses

400

Request not serviced due to invalid format.

401

Invalid API key.

403

Token creation for the specified merchant is not permitted.

500

Unable to service request due to server-side error. Please reattempt request.

200Single use token succesfully created.

defaultAll responses include the following headers.