Overview

Authorize a payment through the customer's payment gateway (currently Tap). The request saves the submitted customer details, then creates an authorization on the gateway. When 3D Secure applies, the response includes a threeDSecure_url — redirect the customer there to complete authentication. The customer is taken from the JWT.

Example:

curl --request POST   --url 'https://www.pelcro.com/api/v1/sdk/payment/tap/authorize?site_id=1232'   --header 'Authorization: Bearer <JWT>'   --header 'Content-Type: application/json'   --data '{
    "first_name": "Jane",
    "last_name": "Doe",
    "phone": "15555550123",
    "currency": "USD",
    "funding": "CREDIT",
    "tap_token": "tok_xxxxxxxxxxxx",
    "redirect_url": "https://example.com/payment/return"
  }'

Conditional Requirements

• first_name, last_name, phone, currency, and funding (DEBIT or CREDIT) are required.
• redirect_url, tap_token, and amount are optional; amount is in the smallest currency unit (e.g. cents).
• Requires an active gateway on the account; only Tap implements authorization today.