Skip to main content

Yuno

Yuno Payments API — customers, checkout sessions, payments, payment links, subscriptions, payouts, refunds and reports.

Yuno Logo

Authentication​

This connector uses Token-based authentication.

info

Set up your connection in the Abstra Console before using it in your workflows.

How to use​

Using the Smart Chat​

Execute the action "CHOOSE_ONE_ACTION_BELOW" from my connector "YOUR_CONNECTOR_NAME" using the params "PARAMS_HERE".

Using the Web Editor​

from abstra.connectors import run_connection_action

result = run_connection_action(
  connection_name="your_connection_name",
  action_name="your_action_name",
  params={
    "param1": "value1",
    "param2": "value2"
  })

Available Actions​

This connector provides 40 actions:

ActionPurposeParameters
post_customersCreates a new customer record. Required: merchant_customer_id The returned id is automatically stored in the customer_id variable.data: {
. merchant_customer_id (string)
. first_name (string)
. last_name (string)
. email (string)
. gender (string)
. date_of_birth (string)
. nationality (string)
. country (string)
. document (object)
. phone (object)
. billing_address (object)
. metadata (array)
} (object) required
get_customers_by_customer_idRetrieves a customer by their Yuno UUID.customer_id (string) required
get_customers_external_by_merchant_customer_idRetrieves a customer using your own merchant_customer_id.merchant_customer_id (string) required
patch_customers_by_customer_idPartial update — send only the fields you want to change.customer_id (string) required
data: {
. email (string)
. phone (object)
} (object) required
delete_customers_by_customer_idDelete Customercustomer_id (string) required
post_checkout_sessionsRequired: account_id, merchant_order_id, payment_description, country workflow enum: SDK_CHECKOUT | CHECKOUT | SDK_SEAMLESS Returns checkout_session — pass this to the Yuno SDK.data (object) required
get_checkout_sessions_by_checkout_session_idGet Checkout Sessioncheckout_session_id (string) required
get_checkout_sessions_by_checkout_session_id_payment_methodsReturns available payment methods for the checkout session, including vaulted cards.checkout_session_id (string) required
patch_checkout_sessions_by_checkout_session_idUpdate amount or description before the SDK renders.checkout_session_id (string) required
data: {
. amount (object)
. payment_description (string)
} (object) required
post_customer_sessionsCreates an enrollment session token. Pass the returned customer_session to the Yuno SDK to collect and vault card details.data: {
. account_id (string)
. customer_id (string)
. country (string)
} (object) required
post_customers_sessions_by_customer_session_payment_methodsEnrolls a payment method via the SDK checkout flow. payment_method_type enum: CARD | MERCADO_PAGO_WALLET | NEQUI | BANCOLOMBIA_TOKENBOX | NU_PAY_ENROLLMENT Returns vaulted_token — store this for subscriptions and one-click payments.customer_session (string) required
data: {
. account_id (string)
. payment_method_type (string)
. country (string)
. verify (object)
} (object) required
post_customers_by_customer_id_payment_methodsEnrolls a card via direct API workflow. workflow: DIRECT is required.customer_id (string) required
data (object) required
get_enrolled_payment_methodsGet Enrolled Payment Methodscustomer_id (string)
post_paymentsCreates a payment. Required: account_id, description, country, merchant_order_id, amount, payment_method, checkout, additional_data Set capture: true to charge immediately. Set capture: false to authorize only — call Capture Authorization when ready to charge. X-Idempotency-Key is required and prevents duplicate charges on retries.data: {
. account_id (string)
. description (string)
. country (string)
. merchant_order_id (string)
. amount (object)
. customer_payer (object)
. checkout (object)
. payment_method (object)
. additional_data (object)
. metadata (array)
} (object) required
get_payments_by_payment_idGet Paymentpayment_id (string) required
transactions_history (string)
get_paymentsGet Payment by Merchant Order IDmerchant_order_id (string)
post_payments_by_payment_id_transactions_by_transaction_id_captureCaptures a previously authorized payment. Required: merchant_reference, reason, amount reason enum: PRODUCT_CONFIRMED | REQUESTED_BY_CUSTOMERpayment_id (string) required
transaction_id (string) required
data: {
. merchant_reference (string)
. reason (string)
. amount (object)
} (object) required
post_payments_by_payment_id_transactions_by_transaction_id_cancelCancels an authorized not yet captured payment, releasing the held funds. Required: merchant_reference reason enum: DUPLICATE | FRAUDULENT | REQUESTED_BY_CUSTOMERpayment_id (string) required
transaction_id (string) required
data: {
. merchant_reference (string)
. description (string)
. reason (string)
} (object) required
post_payments_by_payment_id_transactions_by_transaction_id_refundIssues a full refund. Omit amount to refund the entire transaction. Required: merchant_reference reason enum: DUPLICATE | FRAUDULENT | REQUESTED_BY_CUSTOMER | REVERSE Do not run multiple simultaneous refunds on the same transaction.payment_id (string) required
transaction_id (string) required
data: {
. merchant_reference (string)
. description (string)
. reason (string)
} (object) required
post_payments_by_payment_id_transactions_by_transaction_id_cancel_or_refundSmart endpoint that cancels if the payment is authorized-only, or refunds if already captured.payment_id (string) required
transaction_id (string) required
data: {
. merchant_reference (string)
. description (string)
. reason (string)
} (object) required
post_payments_by_payment_id_fulfillmentNotify Fulfillmentpayment_id (string) required
data: {
. fulfilled_at (string)
. reference (string)
} (object) required
post_payment_linksRequired: account_id, country, amount, payment_method_types Returns checkout_url — share this with your customer. Set one_time_use: true for single-use links.data (object) required
get_payment_links_by_payment_link_idGet Payment Linkpayment_link_id (string) required
post_payment_links_by_payment_link_id_cancelCancel Payment Linkpayment_link_id (string) required
post_subscriptionsRequired: name, account_id, country, amount, frequency, payment_method with vaulted_token frequency.type: DAY | WEEK | MONTH Prerequisite: enroll a card first to obtain vaulted_token.data: {
. account_id (string)
. name (string)
. description (string)
. merchant_reference (string)
. country (string)
. amount (object)
. frequency (object)
. billing_cycles (object)
. customer_payer (object)
. payment_method (object)
. availability (object)
} (object) required
get_subscriptions_by_subscription_idGet Subscriptionsubscription_id (string) required
patch_subscriptions_by_subscription_idUpdate frequency, retry policy, or billing day. retries.amount max: 7 attempts.subscription_id (string) required
data: {
. retries (object)
. frequency (object)
} (object) required
post_subscriptions_by_subscription_id_pausePause Subscriptionsubscription_id (string) required
post_subscriptions_by_subscription_id_resumeResume Subscriptionsubscription_id (string) required
post_subscriptions_by_subscription_id_cancelCancel Subscriptionsubscription_id (string) required
post_subscriptions_by_subscription_id_retryManually retry a failed billing cycle.subscription_id (string) required
post_payoutsRequired: account_id, merchant_reference, country, purpose, amount, beneficiary, withdrawal_method withdrawal_method types: CARD | PIX_PAYOUT | PAYPAL_PAYOUT | NEQUI_PAYOUT | ASTROPAY_PAYOUT | STP_PAYOUT | ...data: {
. account_id (string)
. merchant_reference (string)
. description (string)
. country (string)
. purpose (string)
. amount (object)
. beneficiary (object)
. withdrawal_method (object)
} (object) required
get_payouts_by_payout_idGet Payoutpayout_id (string) required
get_payouts_merchant_reference_by_merchant_referenceGet Payout by Merchant Referencemerchant_reference (string) required
post_reportsRequired: type, start_date, end_date Dates must be exactly 24 chars: 2026-03-01T00:00:00.000Z Poll Get Report until status: COMPLETED, then call Download Report.data: {
. type (string)
. start_date (string)
. end_date (string)
. account_id (string)
. transaction_type (string)
} (object) required
get_reportsList ReportsNo parameters
get_reports_by_report_idPoll this endpoint until status: COMPLETED before downloading.report_id (string) required
get_reports_by_report_id_downloadDownload Reportreport_id (string) required
post_currency_conversionRequired: account_id, amount.currency_conversion.cardholder_currency, provider_data.id Returns the conversion rate, cardholder amount, and an expiry timestamp. Pass the returned id in the payment's amount.currency_conversion.id field.data: {
. account_id (string)
. amount (object)
. provider_data (object)
} (object) required
customCall any endpoint of the connected service while reusing the connection auth. Pass the full URL as _url. Other reserved keys: _method, _query, _body, _headers. Remaining params flow naturally — empty → GET, non-empty → POST JSON body._url (string) required
_method (string)
_query (object)
_body (undefined)
_headers (object)

Webhook Events​

This connector emits 38 events back to your workflow. To receive one, create a hook whose path is <connection-name>/<event> — the connection name you configured plus the event from the table below.

EventDescription
payment-purchaseOccurs when a payment is authorized/completed.
payment-chargebackOccurs when a chargeback is filed against a payment.
payment-refundOccurs when a refund is processed for a payment.
subscription-createOccurs when a subscription is created.
subscription-activeOccurs once when a subscription first activates. Renewal charges are delivered as payment.purchase events.
subscription-pauseOccurs when a subscription is paused.
subscription-resumeOccurs when a paused subscription is resumed.
subscription-cancelOccurs when a subscription is canceled.
subscription-completeOccurs when a subscription reaches its final billing cycle.
subscription-close-to-renewalOccurs shortly before a subscription is scheduled to renew.
enrollment-enrollOccurs when a payment method is enrolled for a customer.
enrollment-updateOccurs when an enrolled payment method is updated.
payout-payoutOccurs when a payout is processed.
split-transferOccurs when a marketplace split transfer is executed.
split-transfer-reverseOccurs when a marketplace split transfer is reversed.
banking-entity-createdOccurs when a banking connectivity entity is created.
banking-entity-updatedOccurs when a banking connectivity entity is updated.
banking-entity-deletedOccurs when a banking connectivity entity is deleted.
banking-onboarding-createdOccurs when a banking onboarding is created.
banking-onboarding-pendingOccurs when a banking onboarding moves to pending.
banking-onboarding-pending-additional-documentationOccurs when additional documentation is required for the onboarding.
banking-onboarding-succeededOccurs when a banking onboarding succeeds.
banking-onboarding-failedOccurs when a banking onboarding fails.
banking-onboarding-declinedOccurs when a banking onboarding is declined.
banking-onboarding-cancelledOccurs when a banking onboarding is cancelled.
banking-onboarding-expiredOccurs when a banking onboarding expires.
banking-account-createdOccurs when a banking account is created.
banking-account-updatedOccurs when a banking account is updated.
banking-account-activatedOccurs when a banking account is activated.
banking-account-closedOccurs when a banking account is closed.
banking-transfer-pendingOccurs when an outgoing banking transfer is pending.
banking-transfer-processingOccurs when an outgoing banking transfer is processing.
banking-transfer-completedOccurs when an outgoing banking transfer completes.
banking-transfer-failedOccurs when an outgoing banking transfer fails.
banking-transfer-cancelledOccurs when an outgoing banking transfer is cancelled.
banking-transfer-reversedOccurs when an outgoing banking transfer is reversed.
banking-transfer-incoming-pendingOccurs when an incoming banking transfer is pending.
banking-transfer-incoming-completedOccurs when an incoming banking transfer completes.