POST Tokenization Authentication
Completes the authentication step some processors require when a customer saves a card, as opposed to paying with one.
It belongs to the Store Payment Method flow: call Generate Token Payment Processor first, follow the action it gives you, and call this only if that processor's flow requires a verification step. PAR Pay does not.
Unlike the payment authentication endpoints, this one is not tied to a payment: it identifies the processor directly and takes no payment_init_hash. The remaining fields are defined by the processor.
Headers
- Type: stringAcceptrequired
Type of content accepted by the API (application/json in most cases)
- Type: stringApplicationrequired
Application key for specific client app
- Type: stringContent
- Type requiredContent-Type header
- Type: stringA
P I - V E R S I O N requiredVersion of the API to be used
- Type: stringAuthorization
Authorization header
- Type: stringX
- Request - I D requiredUnique request identifier
Body
- Type: stringFormat: uuidpayment
_processor _id requiredUUID of the payment processor, from the Generate Token response.
- Type: objectauth
_info Processor-specific verification data.
- Type: objectproperties
Processor-specific token properties.
Responses
- application/json
- 400
The processor rejected the verification.
- 404
Unknown payment processor for this brand.
curl https://api-public-demo.menu.app/api/payment-processors/auth-tokenization \
--request POST \
--header 'Accept: application/json' \
--header 'Application: application-key' \
--header 'Content-Type: application/json' \
--header 'API-VERSION: ' \
--header 'X-Request-ID: c10b4a70-6274-490d-80a0-03e7bb826937' \
--data '{
"payment_processor_id": "3c07ddd3-925e-4549-b6a3-ec5cec38a0dd",
"auth_info": {},
"properties": {}
}'
{
"status": "OK",
"code": 200,
"data": {
"payment_processor_type_id": 22,
"payment_processor_id": "3c07ddd3-925e-4549-b6a3-ec5cec38a0dd",
"additional_info": {
"token": "4e1f0b7c-2a3d-4f5e-8b9a-1c2d3e4f5a6b"
}
}
}Authentication completed. The payload beyond the two identifiers is processor-specific.
