curl --request POST \
  --url https://api.tagada.io/api/public/v1/checkout/pay-v2 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "checkoutSessionId": "ch_1234567890",
  "paymentInstrumentId": "pi_1234567890"
}
'

{
  "order": {
    "id": "ord_1234567890",
    "status": "paid",
    "totalAmount": 2999,
    "currency": "USD"
  },
  "payment": {
    "id": "pay_1234567890",
    "status": "succeeded",
    "amount": 2999,
    "currency": "USD"
  },
  "redirectUrl": "https://mystore.com/thankyou/ord_1234567890"
}

{
  "message": "<string>",
  "code": "<string>",
  "issues": [
    {
      "message": "<string>"
    }
  ]
}

checkout

Pay checkout session V2

Pay for a checkout session with enhanced control over payment initiation.

This V2 endpoint provides additional parameters:

initiatedBy: Specify whether payment was initiated by ‘customer’ (default) or ‘merchant’
source: Specify the payment source, defaults to ‘checkout’
paymentFlowId: Override the store’s default payment flow (uses a specific routing strategy, processors, etc.)

These parameters are used for tracking and payment routing.

POST

api

public

checkout

pay-v2

curl --request POST \
  --url https://api.tagada.io/api/public/v1/checkout/pay-v2 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "checkoutSessionId": "ch_1234567890",
  "paymentInstrumentId": "pi_1234567890"
}
'

{
  "order": {
    "id": "ord_1234567890",
    "status": "paid",
    "totalAmount": 2999,
    "currency": "USD"
  },
  "payment": {
    "id": "pay_1234567890",
    "status": "succeeded",
    "amount": 2999,
    "currency": "USD"
  },
  "redirectUrl": "https://mystore.com/thankyou/ord_1234567890"
}

{
  "message": "<string>",
  "code": "<string>",
  "issues": [
    {
      "message": "<string>"
    }
  ]
}

Authorizations

Authorization

string

header

required

Enter your API key as: Bearer your-api-key

Body

application/json

checkoutSessionId

string

required

paymentInstrumentId

string

returnUrl

string

metadata

object

Show child attributes

draft

boolean

default:false

initiatedBy

enum<string>

default:customer

Available options:

customer,

merchant

source

enum<string>

default:checkout

Available options:

upsell,

checkout,

offer,

missing_club,

forced

paymentFlowId

string

processorId

string

paymentMethod

string

isExpress

boolean

shippingRateId

string

threedsSessionId

string

blikCode

string

Required string length: 6

Response

Successful response

Initialize checkout session List payments with transactions

Overview

Guides

auth

builder

checkout

payments

block-rules

plugins

plugins-v2

domains

orders

subscriptions

products

events

customers

payment-instruments

3ds

stores

funnels

funnel-sessions

funnel-tracking

health

test

webhooks

promotions

promotion-codes

processors

payment-flows

offers

checkout-offers

radar-sessions

email-templates

shipping

tax-exemptions

Pay checkout session V2

Authorizations

Body

Response