{"info":{"_postman_id":"791f9b85-f844-4e10-a265-2cdce0f93a9a","name":"Yuno Payments API Playground","description":"

Official Yuno Payments API collection.

\n

Covers all major integration flows:

\n\n

Setup

\n
    \n
  1. Import Yuno_Sandbox.postman_environment.json
    2. \n
  2. Select the Yuno Sandbox environment
    3. \n
  3. Fill in public_api_key, private_secret_key, and account_id
    4. \n
  4. Run folders in order — test scripts auto-populate IDs into variables
    5. \n
\n

Environments

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
URL
Sandboxhttps://api-sandbox.y.uno/v1
Productionhttps://api.y.uno/v1
\n

Authentication

\n

All requests require:

\n
public-api-key: YOUR_PUBLIC_API_KEY\nprivate-secret-key: YOUR_PRIVATE_SECRET_KEY\n

Payment mutations also require X-Idempotency-Key (UUID).

\n

Docs: https://docs.y.uno/reference/api-reference-overview

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"25083296","collectionId":"791f9b85-f844-4e10-a265-2cdce0f93a9a","publishedId":"2sBXikpXDZ","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-03-27T19:00:20.000Z"},"item":[{"name":"Customers","item":[{"name":"Create Customer","event":[{"listen":"test","script":{"exec":["if (pm.response.code === 201) {"," const id = pm.response.json().id;"," pm.collectionVariables.set('customer_id', id);"," pm.test('Customer created', () => pm.expect(id).to.be.a('string'));","}"],"type":"text/javascript","id":"e5f0fe91-da52-4b91-b7d9-5db64a491d70"}}],"id":"662a4935-45ce-4cb5-85bf-e5f7adfe713e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"public-api-key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private-secret-key","value":"YOUR_PRIVATE_SECRET_KEY"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"merchant_customer_id\": \"customer-1779269669\",\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"email\": \"john.doe@example.com\",\n \"gender\": \"M\",\n \"date_of_birth\": \"1990-01-15\",\n \"nationality\": \"US\",\n \"country\": \"US\",\n \"document\": {\n \"document_type\": \"DNI\",\n \"document_number\": \"123456789\"\n },\n \"phone\": {\n \"country_code\": \"+1\",\n \"number\": \"5550000001\"\n },\n \"billing_address\": {\n \"address_line_1\": \"123 Main St\",\n \"city\": \"New York\",\n \"state\": \"NY\",\n \"zip_code\": \"10001\",\n \"country\": \"US\"\n },\n \"metadata\": [\n { \"key\": \"source\", \"value\": \"web\" }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api-sandbox.y.uno/v1/customers","description":"

Creates a new customer record.

\n

Required: merchant_customer_id

\n

The returned id is automatically stored in the customer_id variable.

\n","urlObject":{"path":["customers"],"host":["https://api-sandbox.y.uno/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"662a4935-45ce-4cb5-85bf-e5f7adfe713e"},{"name":"Get Customer","id":"49a61040-9f2b-44d9-9de6-3d975cdbea43","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"public-api-key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private-secret-key","value":"YOUR_PRIVATE_SECRET_KEY"}],"url":"https://api-sandbox.y.uno/v1/customers/","description":"

Retrieves a customer by their Yuno UUID.

\n","urlObject":{"path":["customers",""],"host":["https://api-sandbox.y.uno/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"49a61040-9f2b-44d9-9de6-3d975cdbea43"},{"name":"Get Customer by External ID","id":"73a55fde-f453-4082-9fb0-2a04ed349878","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"public-api-key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private-secret-key","value":"YOUR_PRIVATE_SECRET_KEY"}],"url":"https://api-sandbox.y.uno/v1/customers/external/:merchant_customer_id","description":"

Retrieves a customer using your own merchant_customer_id.

\n","urlObject":{"path":["customers","external",":merchant_customer_id"],"host":["https://api-sandbox.y.uno/v1"],"query":[],"variable":[{"id":"5aa07742-9070-4f80-abd8-292f3ad7833f","description":{"content":"

Your internal customer ID

\n","type":"text/plain"},"type":"any","value":"customer-001","key":"merchant_customer_id"}]}},"response":[],"_postman_id":"73a55fde-f453-4082-9fb0-2a04ed349878"},{"name":"Update Customer","id":"8a2281e9-2618-4b62-80c3-e3758f45aca8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"public-api-key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private-secret-key","value":"YOUR_PRIVATE_SECRET_KEY"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"email\": \"john.updated@example.com\",\n \"phone\": {\n \"country_code\": \"+1\",\n \"number\": \"5550000099\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://api-sandbox.y.uno/v1/customers/","description":"

Partial update — send only the fields you want to change.

\n","urlObject":{"path":["customers",""],"host":["https://api-sandbox.y.uno/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"8a2281e9-2618-4b62-80c3-e3758f45aca8"},{"name":"Delete Customer","id":"5ffbf2e6-9f46-472d-929a-67b459f3ee15","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"public-api-key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private-secret-key","value":"YOUR_PRIVATE_SECRET_KEY"}],"url":"https://api-sandbox.y.uno/v1/customers/","urlObject":{"path":["customers",""],"host":["https://api-sandbox.y.uno/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"5ffbf2e6-9f46-472d-929a-67b459f3ee15"}],"id":"70f105a7-928d-47a4-a626-03c0b39ab0ee","description":"

Create and manage customer records.

\n

Store the returned id — it is required for checkout sessions, payments, and subscriptions.

\n","_postman_id":"70f105a7-928d-47a4-a626-03c0b39ab0ee"},{"name":"Checkout Sessions","item":[{"name":"Create Checkout Session","event":[{"listen":"test","script":{"exec":["if (pm.response.code === 200) {"," const id = pm.response.json().checkout_session;"," pm.collectionVariables.set('checkout_session_id', id);"," pm.test('Checkout session created', () => pm.expect(id).to.be.a('string'));","}"],"type":"text/javascript","id":"b948eb04-8fb2-42ed-863c-6f89873aca12"}}],"id":"f2ba46a8-d937-4b22-a33b-43d01ea3199e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"public-api-key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private-secret-key","value":"YOUR_PRIVATE_SECRET_KEY"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"account_id\": \"YOUR_ACCOUNT_ID\",\n \"merchant_order_id\": \"order-1779269669\",\n \"payment_description\": \"Order #1779269669\",\n \"country\": \"US\",\n \"customer_id\": \"\",\n \"amount\": {\n \"currency\": \"USD\",\n \"value\": 10000\n },\n \"callback_url\": \"https://example.com/checkout/callback\",\n \"workflow\": \"SDK_CHECKOUT\",\n \"metadata\": [\n { \"key\": \"order_ref\", \"value\": \"ORD-001\" }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api-sandbox.y.uno/v1/checkout/sessions","description":"

Required: account_id, merchant_order_id, payment_description, country

\n

workflow enum: SDK_CHECKOUT | CHECKOUT | SDK_SEAMLESS

\n

Returns checkout_session — pass this to the Yuno SDK.

\n","urlObject":{"path":["checkout","sessions"],"host":["https://api-sandbox.y.uno/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"f2ba46a8-d937-4b22-a33b-43d01ea3199e"},{"name":"Get Checkout Session","id":"86becf2b-4bdb-4d06-a5fe-1cd85a57f67d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"public-api-key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private-secret-key","value":"YOUR_PRIVATE_SECRET_KEY"}],"url":"https://api-sandbox.y.uno/v1/checkout/sessions/","urlObject":{"path":["checkout","sessions",""],"host":["https://api-sandbox.y.uno/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"86becf2b-4bdb-4d06-a5fe-1cd85a57f67d"},{"name":"Get Payment Methods for Session","id":"7509717e-2cf9-4a29-988d-8ab61e8ba497","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"public-api-key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private-secret-key","value":"YOUR_PRIVATE_SECRET_KEY"}],"url":"https://api-sandbox.y.uno/v1/checkout/sessions//payment-methods","description":"

Returns available payment methods for the checkout session, including vaulted cards.

\n","urlObject":{"path":["checkout","sessions","","payment-methods"],"host":["https://api-sandbox.y.uno/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"7509717e-2cf9-4a29-988d-8ab61e8ba497"},{"name":"Update Checkout Session","id":"25386e01-38cd-42cf-8a37-3df7b97e01a5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"public-api-key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private-secret-key","value":"YOUR_PRIVATE_SECRET_KEY"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"amount\": {\n \"currency\": \"USD\",\n \"value\": 15000\n },\n \"payment_description\": \"Updated Order Description\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api-sandbox.y.uno/v1/checkout/sessions/","description":"

Update amount or description before the SDK renders.

\n","urlObject":{"path":["checkout","sessions",""],"host":["https://api-sandbox.y.uno/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"25386e01-38cd-42cf-8a37-3df7b97e01a5"}],"id":"6c621b7d-8820-4463-a314-cf5c3730b970","description":"

Create a checkout session to initialize the Yuno Web or Mobile SDK on the front-end.

\n

The returned checkout_session token is passed to Yuno.initialize() in the SDK.

\n

Path: POST /checkout/sessions

\n","_postman_id":"6c621b7d-8820-4463-a314-cf5c3730b970"},{"name":"Payment Methods","item":[{"name":"Create Customer Session","event":[{"listen":"test","script":{"exec":["if ([200, 201].includes(pm.response.code)) {"," const b = pm.response.json();"," const s = b.customer_session || b.session;"," if (s) pm.collectionVariables.set('customer_session', s);","}"],"type":"text/javascript","id":"e1a9f8dd-4860-417b-bbd3-1a4ccac8f273"}}],"id":"363ed98c-a923-404a-b9b8-036aab560876","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"public-api-key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private-secret-key","value":"YOUR_PRIVATE_SECRET_KEY"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"account_id\": \"YOUR_ACCOUNT_ID\",\n \"customer_id\": \"\",\n \"country\": \"US\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api-sandbox.y.uno/v1/customer-sessions","description":"

Creates an enrollment session token. Pass the returned customer_session to the Yuno SDK to collect and vault card details.

\n","urlObject":{"path":["customer-sessions"],"host":["https://api-sandbox.y.uno/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"363ed98c-a923-404a-b9b8-036aab560876"},{"name":"Enroll Payment Method — Checkout Flow","event":[{"listen":"test","script":{"exec":["if ([200, 201].includes(pm.response.code)) {"," const t = pm.response.json().vaulted_token;"," if (t) pm.collectionVariables.set('vaulted_token', t);","}"],"type":"text/javascript","id":"d21e1e78-b62f-4138-81a6-a2e16fb73520"}}],"id":"957fc8e7-8c5d-4b60-bc18-ff3dcf074829","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"public-api-key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private-secret-key","value":"YOUR_PRIVATE_SECRET_KEY"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"account_id\": \"YOUR_ACCOUNT_ID\",\n \"payment_method_type\": \"CARD\",\n \"country\": \"US\",\n \"verify\": {\n \"vault_on_success\": true,\n \"currency\": \"USD\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://api-sandbox.y.uno/v1/customers/sessions//payment-methods","description":"

Enrolls a payment method via the SDK checkout flow.

\n

payment_method_type enum: CARD | MERCADO_PAGO_WALLET | NEQUI | BANCOLOMBIA_TOKENBOX | NU_PAY_ENROLLMENT

\n

Returns vaulted_token — store this for subscriptions and one-click payments.

\n","urlObject":{"path":["customers","sessions","","payment-methods"],"host":["https://api-sandbox.y.uno/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"957fc8e7-8c5d-4b60-bc18-ff3dcf074829"},{"name":"Enroll Payment Method — Direct API","event":[{"listen":"test","script":{"exec":["if ([200, 201].includes(pm.response.code)) {"," const t = pm.response.json().vaulted_token;"," if (t) pm.collectionVariables.set('vaulted_token', t);","}"],"type":"text/javascript","id":"9d76ee36-4867-4635-aa3c-513db1c9c075"}}],"id":"a3d33249-37e9-4ecb-806b-67cd68ff1196","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"public-api-key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private-secret-key","value":"YOUR_PRIVATE_SECRET_KEY"},{"key":"Content-Type","value":"application/json"},{"key":"X-Idempotency-Key","value":"88a3969d-28d8-4757-94a2-4c5af30e1001"}],"body":{"mode":"raw","raw":"{\n \"account_id\": \"YOUR_ACCOUNT_ID\",\n \"country\": \"US\",\n \"type\": \"CARD\",\n \"workflow\": \"DIRECT\",\n \"callback_url\": \"https://example.com/enrollment/callback\",\n \"verify\": {\n \"vault_on_success\": true,\n \"currency\": \"USD\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://api-sandbox.y.uno/v1/customers//payment-methods","description":"

Enrolls a card via direct API workflow. workflow: DIRECT is required.

\n","urlObject":{"path":["customers","","payment-methods"],"host":["https://api-sandbox.y.uno/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"a3d33249-37e9-4ecb-806b-67cd68ff1196"},{"name":"Get Enrolled Payment Methods","id":"4f86334d-f5e6-4004-b27e-061d22873e6d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"public-api-key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private-secret-key","value":"YOUR_PRIVATE_SECRET_KEY"}],"url":"https://api-sandbox.y.uno/v1/enrolled-payment-methods?customer_id=","urlObject":{"path":["enrolled-payment-methods"],"host":["https://api-sandbox.y.uno/v1"],"query":[{"key":"customer_id","value":""}],"variable":[]}},"response":[],"_postman_id":"4f86334d-f5e6-4004-b27e-061d22873e6d"}],"id":"95e55718-b171-40ce-8b29-0e12e34495a0","description":"

Enroll (vault) payment methods to enable one-click payments and recurring billing.

\n

Checkout flow: SDK collects card → POST /customers/sessions/{session}/payment-methods\nDirect flow: API submits card data → POST /customers/{id}/payment-methods with workflow: DIRECT

\n","_postman_id":"95e55718-b171-40ce-8b29-0e12e34495a0"},{"name":"Payments","item":[{"name":"Create Payment","event":[{"listen":"test","script":{"exec":["if ([200, 201].includes(pm.response.code)) {"," const b = pm.response.json();"," pm.collectionVariables.set('payment_id', b.id);"," const txs = b.payment_status?.transactions;"," if (txs?.length) pm.collectionVariables.set('transaction_id', txs[0].id);"," pm.test('Payment created', () => pm.expect(b.id).to.be.a('string'));","}"],"type":"text/javascript","id":"d2af61b8-7750-4043-86df-4bbd8e85acae"}}],"id":"3d13fbbe-0370-4cb8-b6ef-c41d9a38f8c4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"public-api-key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private-secret-key","value":"YOUR_PRIVATE_SECRET_KEY"},{"key":"Content-Type","value":"application/json"},{"key":"X-Idempotency-Key","value":"07660a0b-8bc7-41bf-9bab-ec3267fe21c6"}],"body":{"mode":"raw","raw":"{\n \"account_id\": \"YOUR_ACCOUNT_ID\",\n \"description\": \"Order #1779269669\",\n \"country\": \"US\",\n \"merchant_order_id\": \"order-1779269669\",\n \"amount\": {\n \"currency\": \"USD\",\n \"value\": 10000\n },\n \"customer_payer\": {\n \"id\": \"\",\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"email\": \"john.doe@example.com\",\n \"country\": \"US\"\n },\n \"checkout\": {\n \"session\": \"\"\n },\n \"payment_method\": {\n \"type\": \"CARD\",\n \"vaulted_token\": \"\",\n \"detail\": {\n \"card\": {\n \"capture\": true,\n \"installments\": 1\n }\n }\n },\n \"additional_data\": {\n \"order\": {\n \"items\": [\n {\n \"id\": \"prod-001\",\n \"name\": \"Product Name\",\n \"quantity\": 1,\n \"unit_amount\": 100.00,\n \"category\": \"electronics\"\n }\n ]\n }\n },\n \"metadata\": [\n { \"key\": \"order_ref\", \"value\": \"ORD-001\" }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api-sandbox.y.uno/v1/payments","description":"

Creates a payment.

\n

Required: account_id, description, country, merchant_order_id, amount, payment_method, checkout, additional_data

\n

Set capture: true to charge immediately. Set capture: false to authorize only — call Capture Authorization when ready to charge.

\n

X-Idempotency-Key is required and prevents duplicate charges on retries.

\n","urlObject":{"path":["payments"],"host":["https://api-sandbox.y.uno/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"3d13fbbe-0370-4cb8-b6ef-c41d9a38f8c4"},{"name":"Create Payment — Authorize Only","event":[{"listen":"test","script":{"exec":["if ([200, 201].includes(pm.response.code)) {"," const b = pm.response.json();"," pm.collectionVariables.set('payment_id', b.id);"," const txs = b.payment_status?.transactions;"," if (txs?.length) pm.collectionVariables.set('transaction_id', txs[0].id);","}"],"type":"text/javascript","id":"eaa5c20f-0acb-4369-838c-b13ecb9cf49c"}}],"id":"ae9fb488-cf09-4eb9-b63a-8de5db0e6787","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"public-api-key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private-secret-key","value":"YOUR_PRIVATE_SECRET_KEY"},{"key":"Content-Type","value":"application/json"},{"key":"X-Idempotency-Key","value":"7e8b3153-0725-4452-a508-dcc256820c89"}],"body":{"mode":"raw","raw":"{\n \"account_id\": \"YOUR_ACCOUNT_ID\",\n \"description\": \"Pre-authorization — Order #1779269669\",\n \"country\": \"US\",\n \"merchant_order_id\": \"order-auth-1779269669\",\n \"amount\": {\n \"currency\": \"USD\",\n \"value\": 10000\n },\n \"customer_payer\": {\n \"id\": \"\"\n },\n \"checkout\": {\n \"session\": \"\"\n },\n \"payment_method\": {\n \"type\": \"CARD\",\n \"vaulted_token\": \"\",\n \"detail\": {\n \"card\": {\n \"capture\": false\n }\n }\n },\n \"additional_data\": {\n \"order\": {\n \"items\": [\n {\n \"id\": \"prod-001\",\n \"name\": \"Product Name\",\n \"quantity\": 1,\n \"unit_amount\": 100.00,\n \"category\": \"electronics\"\n }\n ]\n }\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://api-sandbox.y.uno/v1/payments","description":"

Authorizes a payment without capturing funds.

\n

Use this for two-step flows: authorize now, capture when you fulfil the order.

\n

After authorization, call Capture Authorization to charge, or Cancel Payment to release the hold.

\n","urlObject":{"path":["payments"],"host":["https://api-sandbox.y.uno/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"ae9fb488-cf09-4eb9-b63a-8de5db0e6787"},{"name":"Get Payment","id":"4d7e881a-d8eb-48db-a5f9-293a7be04565","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"public-api-key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private-secret-key","value":"YOUR_PRIVATE_SECRET_KEY"}],"url":"https://api-sandbox.y.uno/v1/payments/?transactions_history=true","urlObject":{"path":["payments",""],"host":["https://api-sandbox.y.uno/v1"],"query":[{"key":"transactions_history","value":"true"},{"disabled":true,"key":"raw_response","value":"false"}],"variable":[]}},"response":[],"_postman_id":"4d7e881a-d8eb-48db-a5f9-293a7be04565"},{"name":"Get Payment by Merchant Order ID","id":"8728ddba-b570-4909-a228-76410c2162ac","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"public-api-key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private-secret-key","value":"YOUR_PRIVATE_SECRET_KEY"}],"url":"https://api-sandbox.y.uno/v1/payments?merchant_order_id=order-001","urlObject":{"path":["payments"],"host":["https://api-sandbox.y.uno/v1"],"query":[{"key":"merchant_order_id","value":"order-001"}],"variable":[]}},"response":[],"_postman_id":"8728ddba-b570-4909-a228-76410c2162ac"},{"name":"Capture Authorization","id":"47f7821f-35ad-46c1-84c2-2bc1adf72313","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"public-api-key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private-secret-key","value":"YOUR_PRIVATE_SECRET_KEY"},{"key":"Content-Type","value":"application/json"},{"key":"X-Idempotency-Key","value":"28dfb0fd-da21-4469-976a-1a8930b556f4"}],"body":{"mode":"raw","raw":"{\n \"merchant_reference\": \"capture-1779269669\",\n \"reason\": \"PRODUCT_CONFIRMED\",\n \"amount\": {\n \"currency\": \"USD\",\n \"value\": 10000\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://api-sandbox.y.uno/v1/payments//transactions//capture","description":"

Captures a previously authorized payment.

\n

Required: merchant_reference, reason, amount

\n

reason enum: PRODUCT_CONFIRMED | REQUESTED_BY_CUSTOMER

\n","urlObject":{"path":["payments","","transactions","","capture"],"host":["https://api-sandbox.y.uno/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"47f7821f-35ad-46c1-84c2-2bc1adf72313"},{"name":"Cancel Payment","id":"38dbb791-9ca8-4f36-8b1a-09bcdaa24eec","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"public-api-key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private-secret-key","value":"YOUR_PRIVATE_SECRET_KEY"},{"key":"Content-Type","value":"application/json"},{"key":"X-Idempotency-Key","value":"8ba01123-265d-46a9-ad68-009436054443"}],"body":{"mode":"raw","raw":"{\n \"merchant_reference\": \"cancel-1779269669\",\n \"description\": \"Order cancelled by customer\",\n \"reason\": \"REQUESTED_BY_CUSTOMER\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api-sandbox.y.uno/v1/payments//transactions//cancel","description":"

Cancels an authorized (not yet captured) payment, releasing the held funds.

\n

Required: merchant_reference

\n

reason enum: DUPLICATE | FRAUDULENT | REQUESTED_BY_CUSTOMER

\n","urlObject":{"path":["payments","","transactions","","cancel"],"host":["https://api-sandbox.y.uno/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"38dbb791-9ca8-4f36-8b1a-09bcdaa24eec"},{"name":"Refund Payment — Full","id":"260ca874-f2c2-45aa-a71d-8efa127ce269","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"public-api-key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private-secret-key","value":"YOUR_PRIVATE_SECRET_KEY"},{"key":"Content-Type","value":"application/json"},{"key":"X-Idempotency-Key","value":"de69f1ac-75cb-4406-8c0b-8b8867d823ea"}],"body":{"mode":"raw","raw":"{\n \"merchant_reference\": \"refund-1779269669\",\n \"description\": \"Full refund — customer request\",\n \"reason\": \"REQUESTED_BY_CUSTOMER\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api-sandbox.y.uno/v1/payments//transactions//refund","description":"

Issues a full refund. Omit amount to refund the entire transaction.

\n

Required: merchant_reference

\n

reason enum: DUPLICATE | FRAUDULENT | REQUESTED_BY_CUSTOMER | REVERSE

\n
\n

Do not run multiple simultaneous refunds on the same transaction.

\n
\n","urlObject":{"path":["payments","","transactions","","refund"],"host":["https://api-sandbox.y.uno/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"260ca874-f2c2-45aa-a71d-8efa127ce269"},{"name":"Refund Payment — Partial","id":"0202d81f-f9c2-461b-a43b-1b6971fd9f17","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"public-api-key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private-secret-key","value":"YOUR_PRIVATE_SECRET_KEY"},{"key":"Content-Type","value":"application/json"},{"key":"X-Idempotency-Key","value":"0073e8bd-e377-4185-b6f2-034461d9443a"}],"body":{"mode":"raw","raw":"{\n \"merchant_reference\": \"partial-refund-1779269669\",\n \"description\": \"Partial refund\",\n \"reason\": \"REQUESTED_BY_CUSTOMER\",\n \"amount\": {\n \"currency\": \"USD\",\n \"value\": 5000\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://api-sandbox.y.uno/v1/payments//transactions//refund","description":"

Issues a partial refund by specifying an amount less than the original transaction.

\n","urlObject":{"path":["payments","","transactions","","refund"],"host":["https://api-sandbox.y.uno/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"0202d81f-f9c2-461b-a43b-1b6971fd9f17"},{"name":"Cancel or Refund","id":"7d42b3b1-8873-4e5d-85c9-32b994562ab4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"public-api-key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private-secret-key","value":"YOUR_PRIVATE_SECRET_KEY"},{"key":"Content-Type","value":"application/json"},{"key":"X-Idempotency-Key","value":"6c83e195-a763-4b8e-9c4c-4885061fd17e"}],"body":{"mode":"raw","raw":"{\n \"merchant_reference\": \"cor-1779269669\",\n \"description\": \"Cancel or refund\",\n \"reason\": \"REQUESTED_BY_CUSTOMER\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api-sandbox.y.uno/v1/payments//transactions//cancel-or-refund","description":"

Smart endpoint that cancels if the payment is authorized-only, or refunds if already captured.

\n","urlObject":{"path":["payments","","transactions","","cancel-or-refund"],"host":["https://api-sandbox.y.uno/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"7d42b3b1-8873-4e5d-85c9-32b994562ab4"},{"name":"Notify Fulfillment","id":"6a1d5d8c-0af4-4861-929a-0e9acc8cf828","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"public-api-key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private-secret-key","value":"YOUR_PRIVATE_SECRET_KEY"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"fulfilled_at\": \"2026-04-01T12:00:00Z\",\n \"reference\": \"SHIP-1779269669\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api-sandbox.y.uno/v1/payments//fulfillment","urlObject":{"path":["payments","","fulfillment"],"host":["https://api-sandbox.y.uno/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"6a1d5d8c-0af4-4861-929a-0e9acc8cf828"}],"id":"173ba2dd-1dbb-466c-934c-19a4308d9d80","description":"

Core payment operations.

\n

Single-step: capture: true — authorize and charge in one call.\nTwo-step: capture: false — authorize now, capture later.

\n
\n

Capture, cancel, and refund all operate on a specific transaction:\nPOST /payments/{payment_id}/transactions/{transaction_id}/[capture|cancel|refund]

\n
\n","_postman_id":"173ba2dd-1dbb-466c-934c-19a4308d9d80"},{"name":"Payment Links","item":[{"name":"Create Payment Link","event":[{"listen":"test","script":{"exec":["if (pm.response.code === 200) {"," pm.collectionVariables.set('payment_link_id', pm.response.json().code);","}"],"type":"text/javascript","id":"cc7ce37e-1384-4f6f-b4fd-ac5b967e7cd4"}}],"id":"04b13843-8c55-48a9-8e79-75390e2f8993","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"public-api-key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private-secret-key","value":"YOUR_PRIVATE_SECRET_KEY"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"account_id\": \"YOUR_ACCOUNT_ID\",\n \"country\": \"US\",\n \"amount\": {\n \"currency\": \"USD\",\n \"value\": 10000\n },\n \"payment_method_types\": [\"CARD\"],\n \"description\": \"Payment Link — Order #001\",\n \"merchant_order_id\": \"order-link-1779269669\",\n \"capture\": true,\n \"one_time_use\": true,\n \"callback_url\": \"https://example.com/payment/success\",\n \"availability\": {\n \"start_at\": \"2026-01-01T00:00:00Z\",\n \"finish_at\": \"2026-12-31T23:59:59Z\"\n },\n \"customer_payer\": {\n \"id\": \"\",\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"billing_address\": {\n \"address_line_1\": \"123 Main St\",\n \"city\": \"New York\",\n \"country\": \"US\",\n \"zip_code\": \"10001\"\n }\n },\n \"metadata\": [\n { \"key\": \"campaign\", \"value\": \"spring-sale\" }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api-sandbox.y.uno/v1/payment-links","description":"

Required: account_id, country, amount, payment_method_types

\n

Returns checkout_url — share this with your customer.

\n

Set one_time_use: true for single-use links.

\n","urlObject":{"path":["payment-links"],"host":["https://api-sandbox.y.uno/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"04b13843-8c55-48a9-8e79-75390e2f8993"},{"name":"Get Payment Link","id":"9ce1d819-089d-4d88-b413-c2791ff44394","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"public-api-key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private-secret-key","value":"YOUR_PRIVATE_SECRET_KEY"}],"url":"https://api-sandbox.y.uno/v1/payment-links/","urlObject":{"path":["payment-links",""],"host":["https://api-sandbox.y.uno/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"9ce1d819-089d-4d88-b413-c2791ff44394"},{"name":"Cancel Payment Link","id":"87a25f10-5374-47a6-82e9-199ab015de74","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"public-api-key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private-secret-key","value":"YOUR_PRIVATE_SECRET_KEY"}],"url":"https://api-sandbox.y.uno/v1/payment-links//cancel","urlObject":{"path":["payment-links","","cancel"],"host":["https://api-sandbox.y.uno/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"87a25f10-5374-47a6-82e9-199ab015de74"}],"id":"7b005750-de96-457e-bea2-b58418941835","description":"

Create hosted payment pages that can be shared via email, SMS, or embedded on any website. No SDK required on the customer's side.

\n","_postman_id":"7b005750-de96-457e-bea2-b58418941835"},{"name":"Subscriptions","item":[{"name":"Create Subscription","event":[{"listen":"test","script":{"exec":["if ([200, 201].includes(pm.response.code)) {"," pm.collectionVariables.set('subscription_id', pm.response.json().id);","}"],"type":"text/javascript","id":"0954a10b-3d1d-4fc5-bfaa-9cbcb20a05b1"}}],"id":"548a8aa5-5025-49f7-b7be-86eaba542cea","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"public-api-key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private-secret-key","value":"YOUR_PRIVATE_SECRET_KEY"},{"key":"Content-Type","value":"application/json"},{"key":"X-Idempotency-Key","value":"09478d81-c580-4a7c-b86d-90fe19834ee5"}],"body":{"mode":"raw","raw":"{\n \"account_id\": \"YOUR_ACCOUNT_ID\",\n \"name\": \"Monthly Subscription Plan\",\n \"description\": \"Billed monthly\",\n \"merchant_reference\": \"sub-1779269669\",\n \"country\": \"US\",\n \"amount\": {\n \"currency\": \"USD\",\n \"value\": 9900\n },\n \"frequency\": {\n \"type\": \"MONTH\",\n \"value\": 1\n },\n \"billing_cycles\": {\n \"total\": 12\n },\n \"customer_payer\": {\n \"id\": \"\"\n },\n \"payment_method\": {\n \"type\": \"CARD\",\n \"vaulted_token\": \"\"\n },\n \"availability\": {\n \"start_at\": \"2026-04-01T00:00:00Z\",\n \"finish_at\": \"2027-03-31T23:59:59Z\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://api-sandbox.y.uno/v1/subscriptions","description":"

Required: name, account_id, country, amount, frequency, payment_method (with vaulted_token)

\n

frequency.type: DAY | WEEK | MONTH

\n

Prerequisite: enroll a card first to obtain vaulted_token.

\n","urlObject":{"path":["subscriptions"],"host":["https://api-sandbox.y.uno/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"548a8aa5-5025-49f7-b7be-86eaba542cea"},{"name":"Get Subscription","id":"c16ca815-d8b7-4d1f-831a-0cf6cbff354b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"public-api-key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private-secret-key","value":"YOUR_PRIVATE_SECRET_KEY"}],"url":"https://api-sandbox.y.uno/v1/subscriptions/","urlObject":{"path":["subscriptions",""],"host":["https://api-sandbox.y.uno/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"c16ca815-d8b7-4d1f-831a-0cf6cbff354b"},{"name":"Update Subscription","id":"32517a34-6d3a-45fe-9af4-38d9e5fd509c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"public-api-key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private-secret-key","value":"YOUR_PRIVATE_SECRET_KEY"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"retries\": {\n \"retry_on_decline\": true,\n \"amount\": 3\n },\n \"frequency\": {\n \"type\": \"MONTH\",\n \"value\": 1,\n \"monthly_billing_day\": 1\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://api-sandbox.y.uno/v1/subscriptions/","description":"

Update frequency, retry policy, or billing day.

\n

retries.amount max: 7 attempts.

\n","urlObject":{"path":["subscriptions",""],"host":["https://api-sandbox.y.uno/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"32517a34-6d3a-45fe-9af4-38d9e5fd509c"},{"name":"Pause Subscription","id":"68a01e8b-a051-42ea-aea3-9574a19a0de5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"public-api-key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private-secret-key","value":"YOUR_PRIVATE_SECRET_KEY"}],"url":"https://api-sandbox.y.uno/v1/subscriptions//pause","urlObject":{"path":["subscriptions","","pause"],"host":["https://api-sandbox.y.uno/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"68a01e8b-a051-42ea-aea3-9574a19a0de5"},{"name":"Resume Subscription","id":"0d2e3cd2-d64e-4fda-a09b-c9b70adfcd97","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"public-api-key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private-secret-key","value":"YOUR_PRIVATE_SECRET_KEY"}],"url":"https://api-sandbox.y.uno/v1/subscriptions//resume","urlObject":{"path":["subscriptions","","resume"],"host":["https://api-sandbox.y.uno/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"0d2e3cd2-d64e-4fda-a09b-c9b70adfcd97"},{"name":"Cancel Subscription","id":"127b96a0-a046-4f56-aad5-328dab621b34","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"public-api-key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private-secret-key","value":"YOUR_PRIVATE_SECRET_KEY"}],"url":"https://api-sandbox.y.uno/v1/subscriptions//cancel","urlObject":{"path":["subscriptions","","cancel"],"host":["https://api-sandbox.y.uno/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"127b96a0-a046-4f56-aad5-328dab621b34"},{"name":"Retry Subscription","id":"225f4d30-3450-4446-94c2-feef65eb0305","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"public-api-key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private-secret-key","value":"YOUR_PRIVATE_SECRET_KEY"}],"url":"https://api-sandbox.y.uno/v1/subscriptions//retry","description":"

Manually retry a failed billing cycle.

\n","urlObject":{"path":["subscriptions","","retry"],"host":["https://api-sandbox.y.uno/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"225f4d30-3450-4446-94c2-feef65eb0305"}],"id":"79957252-ffd3-4227-bdfd-bb7fa22a50f1","description":"

Manage recurring billing. Requires a vaulted card — enroll a card first to obtain vaulted_token.

\n

frequency.type: DAY | WEEK | MONTH

\n

name is a required field (distinct from description).

\n","_postman_id":"79957252-ffd3-4227-bdfd-bb7fa22a50f1"},{"name":"Payouts","item":[{"name":"Create Payout","event":[{"listen":"test","script":{"exec":["if ([200, 201].includes(pm.response.code)) {"," pm.collectionVariables.set('payout_id', pm.response.json().id);","}"],"type":"text/javascript","id":"90181b0a-ceec-4516-bc28-abc4aea8ee62"}}],"id":"8fc3dfca-aa07-4402-b7c3-cf1ce630307f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"public-api-key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private-secret-key","value":"YOUR_PRIVATE_SECRET_KEY"},{"key":"Content-Type","value":"application/json"},{"key":"X-Idempotency-Key","value":"0d4fd85d-6783-45ed-b7ed-ad95a92c6a27"}],"body":{"mode":"raw","raw":"{\n \"account_id\": \"YOUR_ACCOUNT_ID\",\n \"merchant_reference\": \"payout-1779269669\",\n \"description\": \"Payout description\",\n \"country\": \"US\",\n \"purpose\": \"PROVIDER_SERVICES\",\n \"amount\": {\n \"currency\": \"USD\",\n \"value\": 10000\n },\n \"beneficiary\": {\n \"merchant_beneficiary_id\": \"beneficiary-1779269669\",\n \"national_entity\": \"INDIVIDUAL\",\n \"first_name\": \"Jane\",\n \"last_name\": \"Smith\",\n \"email\": \"jane.smith@example.com\",\n \"country\": \"US\",\n \"document\": {\n \"document_type\": \"DNI\",\n \"document_number\": \"987654321\"\n },\n \"phone\": {\n \"country_code\": \"+1\",\n \"number\": \"5550000002\"\n },\n \"address\": {\n \"address_line_1\": \"456 Oak Ave\",\n \"city\": \"Los Angeles\",\n \"state\": \"CA\",\n \"zip_code\": \"90001\"\n }\n },\n \"withdrawal_method\": {\n \"type\": \"CARD\",\n \"provider_id\": \"UNLIMINT\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://api-sandbox.y.uno/v1/payouts","description":"

Required: account_id, merchant_reference, country, purpose, amount, beneficiary, withdrawal_method

\n

withdrawal_method types: CARD | PIX_PAYOUT | PAYPAL_PAYOUT | NEQUI_PAYOUT | ASTROPAY_PAYOUT | STP_PAYOUT | ...

\n","urlObject":{"path":["payouts"],"host":["https://api-sandbox.y.uno/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"8fc3dfca-aa07-4402-b7c3-cf1ce630307f"},{"name":"Create Payout — PIX (Brazil)","id":"018d36cd-2b11-4617-bc89-df4231e9d7f9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"public-api-key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private-secret-key","value":"YOUR_PRIVATE_SECRET_KEY"},{"key":"Content-Type","value":"application/json"},{"key":"X-Idempotency-Key","value":"5b6f5fb3-7a45-45fc-9eae-a83e6608543a"}],"body":{"mode":"raw","raw":"{\n \"account_id\": \"YOUR_ACCOUNT_ID\",\n \"merchant_reference\": \"pix-payout-1779269669\",\n \"country\": \"BR\",\n \"purpose\": \"REMITTANCES\",\n \"amount\": {\n \"currency\": \"BRL\",\n \"value\": 10000\n },\n \"beneficiary\": {\n \"merchant_beneficiary_id\": \"br-beneficiary-1779269669\",\n \"national_entity\": \"INDIVIDUAL\",\n \"first_name\": \"Carlos\",\n \"last_name\": \"Silva\",\n \"email\": \"carlos.silva@example.com\",\n \"country\": \"BR\",\n \"document\": {\n \"document_type\": \"CPF\",\n \"document_number\": \"12345678901\"\n }\n },\n \"withdrawal_method\": {\n \"type\": \"PIX_PAYOUT\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://api-sandbox.y.uno/v1/payouts","description":"

PIX payout to a Brazilian beneficiary. Requires CPF (11 digits) or CNPJ (14 digits).

\n","urlObject":{"path":["payouts"],"host":["https://api-sandbox.y.uno/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"018d36cd-2b11-4617-bc89-df4231e9d7f9"},{"name":"Get Payout","id":"52a79538-ea1e-46ab-9707-f764ca6576ef","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"public-api-key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private-secret-key","value":"YOUR_PRIVATE_SECRET_KEY"}],"url":"https://api-sandbox.y.uno/v1/payouts/","urlObject":{"path":["payouts",""],"host":["https://api-sandbox.y.uno/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"52a79538-ea1e-46ab-9707-f764ca6576ef"},{"name":"Get Payout by Merchant Reference","id":"0d4ff9d9-deb3-41e2-a233-6489b601e06a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"public-api-key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private-secret-key","value":"YOUR_PRIVATE_SECRET_KEY"}],"url":"https://api-sandbox.y.uno/v1/payouts/merchant-reference/:merchant_reference","urlObject":{"path":["payouts","merchant-reference",":merchant_reference"],"host":["https://api-sandbox.y.uno/v1"],"query":[],"variable":[{"id":"c73fef18-f5da-4be2-a871-d393d6f13932","type":"any","value":"payout-001","key":"merchant_reference"}]}},"response":[],"_postman_id":"0d4ff9d9-deb3-41e2-a233-6489b601e06a"}],"id":"cc100665-232d-461f-9d1f-534164152211","description":"

Disburse funds to individuals or entities.

\n

purpose enum (common): FAMILY_AND_FRIENDS | PERSONAL_TRANSFER | REMITTANCES | PROVIDER_SERVICES

\n

document_type enum: DNI | CI | CPF | CNPJ | RFC | CURP | CC | CE | NIT | RUT | PAS | ...

\n","_postman_id":"cc100665-232d-461f-9d1f-534164152211"},{"name":"Reports","item":[{"name":"Create Report","event":[{"listen":"test","script":{"exec":["if ([200, 201].includes(pm.response.code)) {"," pm.collectionVariables.set('report_id', pm.response.json().id);","}"],"type":"text/javascript","id":"37a853ff-d339-4029-9261-1deacb132c2b"}}],"id":"6396c184-25ec-4293-bab1-43e6f9b13002","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"public-api-key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private-secret-key","value":"YOUR_PRIVATE_SECRET_KEY"},{"key":"X-Organization-Code","value":"YOUR_ORG_CODE"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"type\": \"TRANSACTIONS\",\n \"start_date\": \"2026-03-01T00:00:00.000Z\",\n \"end_date\": \"2026-03-31T23:59:59.000Z\",\n \"account_id\": \"YOUR_ACCOUNT_ID\",\n \"transaction_type\": \"PURCHASE,REFUND,CAPTURE\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api-sandbox.y.uno/v1/reports","description":"

Required: type, start_date, end_date

\n

Dates must be exactly 24 chars: 2026-03-01T00:00:00.000Z

\n

Poll Get Report until status: COMPLETED, then call Download Report.

\n","urlObject":{"path":["reports"],"host":["https://api-sandbox.y.uno/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"6396c184-25ec-4293-bab1-43e6f9b13002"},{"name":"List Reports","id":"7538367b-40bf-4c30-b53a-c5352c4806ba","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"public-api-key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private-secret-key","value":"YOUR_PRIVATE_SECRET_KEY"},{"key":"X-Organization-Code","value":"YOUR_ORG_CODE"}],"url":"https://api-sandbox.y.uno/v1/reports","urlObject":{"path":["reports"],"host":["https://api-sandbox.y.uno/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"7538367b-40bf-4c30-b53a-c5352c4806ba"},{"name":"Get Report","id":"96021717-059e-44cf-8523-ec42aa7e3a14","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"public-api-key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private-secret-key","value":"YOUR_PRIVATE_SECRET_KEY"},{"key":"X-Organization-Code","value":"YOUR_ORG_CODE"}],"url":"https://api-sandbox.y.uno/v1/reports/","description":"

Poll this endpoint until status: COMPLETED before downloading.

\n","urlObject":{"path":["reports",""],"host":["https://api-sandbox.y.uno/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"96021717-059e-44cf-8523-ec42aa7e3a14"},{"name":"Download Report","id":"7d83feea-d2fa-489b-848b-3fd9019d201d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"public-api-key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private-secret-key","value":"YOUR_PRIVATE_SECRET_KEY"},{"key":"X-Organization-Code","value":"YOUR_ORG_CODE"}],"url":"https://api-sandbox.y.uno/v1/reports//download","urlObject":{"path":["reports","","download"],"host":["https://api-sandbox.y.uno/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"7d83feea-d2fa-489b-848b-3fd9019d201d"}],"id":"3c3d8d3b-f4d8-4cf2-861a-b952b97ac1cd","description":"

Generate and download transaction reports.

\n
\n

Requires X-Organization-Code header in addition to API keys.

\n
\n

type enum: PAYMENTS | TRANSACTIONS | PAYOUTS | SETTLEMENTS | TRANSACTION_RECONCILIATION

\n

Dates must be exactly 24 characters: 2026-03-01T00:00:00.000Z

\n","_postman_id":"3c3d8d3b-f4d8-4cf2-861a-b952b97ac1cd"},{"name":"Currency Conversion","item":[{"name":"Get Conversion Rate","id":"10428692-2742-47f6-a309-c7f72adc4b6f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"public-api-key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private-secret-key","value":"YOUR_PRIVATE_SECRET_KEY"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"account_id\": \"YOUR_ACCOUNT_ID\",\n \"amount\": {\n \"value\": 10000,\n \"currency\": \"USD\",\n \"currency_conversion\": {\n \"cardholder_currency\": \"BRL\"\n }\n },\n \"provider_data\": {\n \"id\": \"CIBC\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://api-sandbox.y.uno/v1/currency-conversion","description":"

Required: account_id, amount.currency_conversion.cardholder_currency, provider_data.id

\n

Returns the conversion rate, cardholder amount, and an expiry timestamp.

\n

Pass the returned id in the payment's amount.currency_conversion.id field.

\n","urlObject":{"path":["currency-conversion"],"host":["https://api-sandbox.y.uno/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"10428692-2742-47f6-a309-c7f72adc4b6f"},{"name":"Get Conversion Rate — With Vaulted Card","id":"eda6b5b5-643b-4baf-a8dc-320545765b73","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"public-api-key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private-secret-key","value":"YOUR_PRIVATE_SECRET_KEY"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"account_id\": \"YOUR_ACCOUNT_ID\",\n \"amount\": {\n \"value\": 10000,\n \"currency\": \"USD\",\n \"currency_conversion\": {\n \"cardholder_currency\": \"MXN\"\n }\n },\n \"provider_data\": {\n \"id\": \"CIBC\"\n },\n \"payment_method\": {\n \"vaulted_token\": \"\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://api-sandbox.y.uno/v1/currency-conversion","description":"

Pass vaulted_token to get a rate tied to a specific card's issuing currency.

\n","urlObject":{"path":["currency-conversion"],"host":["https://api-sandbox.y.uno/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"eda6b5b5-643b-4baf-a8dc-320545765b73"}],"id":"1c6354cb-8dd7-4cc6-85b5-e0dd36bbfa0f","description":"

Get real-time FX rates for dynamic currency conversion (DCC) at checkout.

\n
\n

This is a POST request — not GET.

\n
\n

provider_data.id enum: CIBC | MERCADO_PAGO

\n","_postman_id":"1c6354cb-8dd7-4cc6-85b5-e0dd36bbfa0f"}],"variable":[{"key":"base_url","value":"https://api-sandbox.y.uno/v1"},{"key":"public_api_key","value":"YOUR_PUBLIC_API_KEY"},{"key":"private_secret_key","value":"YOUR_PRIVATE_SECRET_KEY"},{"key":"account_id","value":"YOUR_ACCOUNT_ID"},{"key":"customer_id","value":""},{"key":"customer_session","value":""},{"key":"checkout_session_id","value":""},{"key":"vaulted_token","value":""},{"key":"payment_id","value":""},{"key":"transaction_id","value":""},{"key":"payment_link_id","value":""},{"key":"subscription_id","value":""},{"key":"payout_id","value":""},{"key":"report_id","value":""},{"key":"org_code","value":"YOUR_ORG_CODE"}]}