This endpoint allows JWTs assigned role service
, anonymous
, or buyer
to be exchanged for a JWT assigned role buyer
. Request body parameters programID
and merchantID
are required if the associated claim(s) are present on the provided JWT.
Exchanging a service account JWT allows for a service account to perform actions on a user's behalf if necessary. Buyers should use the checkout flow instead (see /send/code
+ /buyer/authorize
).
Exchanging an anonymous JWT allows for new users to login with their recently created buyer account. This is an alternative way of getting a buyer JWT for apps that cannot access the Authorization response header following buyer registration.
Exchanging a buyer JWT is a special case allowing previously unverified buyers who have recently OTP verified to upgrade their buyer account to reflect that verification.