Two-card payments (v2)
Create Payment (two cards)
Create one payment funded by exactly two cards with POST /v2/payments, using the DIRECT, REDIRECT or SDK_CHECKOUT workflow.
POST
This request creates one payment funded by exactly two cards. Each card pays its part of
amount, and the two parts must add up to amount.value. The base URL is https://api-sandbox.y.uno/v2 in sandbox and https://api.y.uno/v2 in production. Read Pay with two cards before you integrate.
DIRECTorREDIRECT: sendpayment_method.payment_methodswith exactly two items, bothtype: CARD. Each item has itsamountanddetail.cardor avaulted_token.SDK_CHECKOUT: sendcheckout.sessionand the compositepayment_method.tokenfrom the headless Web SDK. Do not sendpayment_methods.
payment_method.capture applies to both cards and defaults to true. Do not send capture inside detail.card: the request is rejected.
The response has the same shape as Retrieve Payment (two cards).
EnablementIn production, two-card payments are enabled per organization. Until then, this request returns
403 PRODUCT_NOT_ENABLED. In sandbox they are enabled for every organization.split_marketplace, external_subscription and amount.currency_conversion are not allowed with two cards, and promotion quotes are not accepted.
This request requires an X-Idempotency-Key. See Authentication for details.Authorizations
Headers
Body
application/json
Response
Payment created. Read status and sub_status, then each card's transactions.
A payment funded by two cards.