Skip to main content
POST
Exchange an application-managed payment authorization

Authorizations

Authorization
string
header
required

Production keys begin with darwin_. Isolated sandbox keys begin with darwin_test_. Create keys in Developer settings.

Headers

Idempotency-Key
string
required

A caller-generated key, unique to this operation and payload.

Required string length: 1 - 200

Path Parameters

transactionId
string
required

Body

application/json
aiId
string
required
Maximum string length: 200
type
string
required
Allowed value: "STRIPE_SHARED_PAYMENT_TOKEN"
networkProfileId
string
required

Darwin seller network identifier used when the application provisions the SPT.

Maximum string length: 200
grantedToken
string
required
write-only

One transaction-scoped, time-limited Stripe Shared Payment Token.

Maximum string length: 200
Pattern: ^spt_[A-Za-z0-9]+$

Response

The transaction-scoped payment authorization state.

paymentAuthorization
object
required