curl --request POST \
--url https://api.tagada.io/api/public/v1/payments/process \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"paymentInstrumentId": "pi_123",
"amount": 2999,
"currency": "USD",
"storeId": "store_123",
"customerId": "cus_456",
"mode": "purchase"
}
'{
"payment": {
"id": "pay_123",
"amount": 2999,
"currency": "USD",
"status": "succeeded",
"subStatus": "approved",
"requireAction": "none"
}
}{
"message": "<string>",
"code": "<string>",
"issues": [
{
"message": "<string>"
}
]
}Process payment
Process a payment using the payment flow system with comprehensive options for different payment scenarios
curl --request POST \
--url https://api.tagada.io/api/public/v1/payments/process \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"paymentInstrumentId": "pi_123",
"amount": 2999,
"currency": "USD",
"storeId": "store_123",
"customerId": "cus_456",
"mode": "purchase"
}
'{
"payment": {
"id": "pay_123",
"amount": 2999,
"currency": "USD",
"status": "succeeded",
"subStatus": "approved",
"requireAction": "none"
}
}{
"message": "<string>",
"code": "<string>",
"issues": [
{
"message": "<string>"
}
]
}Authorizations
Enter your API key as: Bearer your-api-key
Body
x >= 0purchase, auth, capture, verify customer, merchant recurring, unscheduled, installment Ask for a 3DS challenge on this card payment, whatever the processor's 3DS settings. The card issuer makes the final call: the payment can still be approved without a challenge. Customer-initiated card payments only.
challenge Optional — only for physical goods; omit entirely for digital products. When provided, include a valid ISO 3166-1 alpha-2 country; an address without one is not forwarded to the acquirer.
Show child attributes
Show child attributes
Optional but recommended — improves issuer approval rates (AVS) and 3DS frictionless outcomes. When provided, include a valid ISO 3166-1 alpha-2 country; an address without one is not forwarded to the acquirer.
Show child attributes
Show child attributes
The shopper behind this server-to-server call, as seen by YOUR server. Processors weigh the shopper IP heavily (Stripe Radar, Adyen risk, issuer scoring); Tagada cannot read it from your request and never substitutes your server's address. Forward what your framework gives you (e.g. Express req.ip behind a trusted proxy) and the browser's User-Agent.
Show child attributes
Show child attributes
Response
Successful response