Yuno

https://docs.y.uno/
Admin
Yuno is a global payment orchestration platform that integrates various payment methods, processors,...
Tokens:1,581,229
Snippets:8,579
Trust Score:9.4
Update:3 months ago
Show doc for...
Tokens:
Raw
### 3DS Setup Response Examples

Source: https://docs.y.uno/docs/payment-features/3ds-standalone

These JSON responses show the expected output after initiating a 3DS setup, with variations for different providers like Netcetera, Cybersource, and Checkout.com. Note that some providers may return empty collect_url and token values.

```json
{
    "three_d_secure_setup_id": "59192489-3713-4d1b-894b-ac15ac5b6f6f",
    "collect_url": "https://ndm-prev.3dss-non-prod.cloud.netcetera.com/acs/3ds-method",
    "token": "eyJ0aHJlZURTTWV0aG9kTm90aWZpY2F0aW9uVVJMIjoiaHR0cHM6Ly9zYW5kYm94LnkudW5vL25ldGNldGVyYS0zZHMtd2ViaG9vay92MS9zdGFydCIsInRocmVlRFNTZXJ2ZXJUcmFuc0lEIjoiNTkxOTI0ODktMzcxMy00ZDFiLTg5NGItYWMxNWFjNWI2ZjZmIn0",
    "provider_id": "NETCETERA_3DS",
    "timeout_value": 3000,
    "account_id": "account_id"
}
```

```json
{
    "three_d_secure_setup_id": "06bc1782-b00d-4ef7-9b56-78f066821d2e",
    "collect_url": "https://cas.client.cardinaltrusted.com/centinelapi/V1/Cruise/Collect",
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "provider_id": "CYBERSOURCE_3DS",
    "timeout_value": 3000,
    "account_id": "05327270-54f8-4189-b2fc-492864ecfc47"
}
```

```json
{
    "three_d_secure_setup_id": "eae7eca3-902b-475d-a2ea-a434aa57391b",
    "collect_url": "",
    "token": "",
    "provider_id": "CHECKOUT_COM_3DS",
    "timeout_value": 3000,
    "account_id": "05327270-54f8-4189-b2fc-492864ecfc47"
}
```

--------------------------------

### Get Installments Plan by ID OpenAPI Specification

Source: https://docs.y.uno/reference/installments/get-installments-plan

This OpenAPI specification defines the GET /installments-plans/{installment_code} endpoint for retrieving installment plan details. It includes request parameters, response structure, and example data.

```yaml
openapi: 3.1.0
info:
  title: installments
  version: 1.0.2
servers:
  - url: https://api-sandbox.y.uno/v1
security:
  - sec0: []
    sec1: []
paths:
  /installments-plans/{installment_code}:
    get:
      summary: Get Installments Plan by ID
      operationId: get-installments-plan
      parameters:
        - name: installment_code
          in: path
          description: Identifier of the installment plan.
          schema:
            type: string
          required: true
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value:
                    - id: 4d573425-33f9-4c46-b009-2c7e749b0ec7
                      name: plan_007
                      account_id:
                        - f7c5fe77-721b-49c2-84d3-957748df3c2c
                      merchant_reference: Test
                      installments_plan:
                        - installment: 1
                          rate: 1
                          provider_id: ''
                          amount:
                            currency: USD
                            value: '0'
                            total_value: '0'
                        - installment: 3
                          rate: 1
                          provider_id: ''
                          financial_costs:
                            - type: CFT
                              rate: 45.25
                              formatted_value: 45,25%
                            - type: TEA
                              rate: 38.5
                              formatted_value: 38,50%
                          amount:
                            currency: USD
                            value: '0'
                            total_value: '0'
                        - installment: 6
                          rate: 1
                          provider_id: ''
                          amount:
                            currency: USD
                            value: '0'
                            total_value: '0'
                        - installment: 9
                          rate: 1
                          provider_id: ''
                          amount:
                            currency: USD
                            value: '0'
                            total_value: '0'
                        - installment: 12
                          rate: 1
                          provider_id: ''
                          amount:
                            currency: USD
                            value: '0'
                            total_value: '0'
                      iin: null
                      country_code: US
                      first_installment_deferral: 0
                      amount:
                        Currency: USD
                        min_value: 0
                        max_value: 100000000
                      availability:
                        start_at: '2023-09-12T00:00:00Z'
                        finish_at: '2030-09-20T00:00:00Z'
                      created_at: '2023-10-11T17:52:31.886178Z'
                      updated_at: '2023-10-11T17:52:31.886178Z'
                      payment_method_type: NU_PAY_ENROLLMENT
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                      example: 4d573425-33f9-4c46-b009-2c7e749b0ec7
                    name:
                      type: string
                      example: plan_007
                    account_id:
                      type: array
                      items:
                        type: string
                        example: f7c5fe77-721b-49c2-84d3-957748df3c2c
                    merchant_reference:
                      type: string
                      example: Test
                    installments_plan:
                      type: array
                      items:
                        type: object
                        properties:
                          installment:
                            type: integer
                            example: 1
                            default: 0

```

--------------------------------

### Create Onboarding with Go

Source: https://docs.y.uno/reference/create-onboarding

This Go example shows how to make a POST request to create an onboarding. It utilizes the standard `net/http` package and includes necessary headers for authentication and content type.

```go
package main  
  
import (
	"fmt"
	"strings"
	"net/http"
	"io"
)
  
func main() {

	url := "https://api-sandbox.y.uno/v1/recipients/{recipient_id}/onboardings"  

	payload := strings.NewReader("{
  \"account_id\": \"{{account-code}}\",
  \"type\": \"PREVIOUSLY_ONBOARDED\",
  \"workflow\": \"DIRECT\",
  \"callback_url\": \"https://merchant.example.com/webhook/onboarding\",
  \"provider\": {
    \"id\": \"VR\",
    \"connection_id\": \"d2c1f0e9-8a90-432a-ab7c-fdee4c7d58e4\",
    \"recipient_id\": \"test01\",
    \"recipient_type\": \"MULTI_BENEFITS\"
  },
  \"documentation\": [
    {
      \"file_name\": \"onboarding.pdf\",
      \"content_type\": \"application/pdf\",
      \"content_category\": \"IDENTIFICATION_DOCUMENT\",
      \"content\": \"VGV4dG8gZGUgZWplbXBsbyBwYXJhIEJhc2U2NA==\"
    }
  ],
  \"withdrawal_methods\": {
    \"bank\": {
      \"code\": \"002\",
      \"branch\": \"002\",
      \"account\": \"9876543210\",
      \"account_type\": \"CHECKINGS\",
      \"country\": \"US\",
      \"currency\": \"USD\",
      \"routing\": \"021000022\"
    }
  },
  \"terms_of_service\": {
    \"acceptance\": true,
    \"date\": \"2025-07-21T20:43:54.786342Z\",
    \"ip\": \"129.21.111.11\"
  }
}")  

	req, _ := http.NewRequest("POST", url, payload)  

	req.Header.Add("public-api-key", "<Your public-api-key>")  
	req.Header.Add("private-secret-key", "<Your private-secret-key>")  
	rereq.Header.Add("Content-Type", "application/json")  

	res, _ := http.DefaultClient.Do(req)  

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)  

	fmt.Println(string(body))

}

```

--------------------------------

### Clone Yuno SDK Web Project

Source: https://docs.y.uno/docs/how-yuno-works/step-2-your-first-payment

Download the example project or clone the GitHub repository to get started with the Yuno Web SDK and a sample frontend.

```bash
git clone https://github.com/yuno-payments/yuno-sdk-web.git
cd yuno-sdk-web
```

--------------------------------

### Continue Onboarding with Go

Source: https://docs.y.uno/reference/continue-onboarding

This Go example demonstrates how to make a POST request to continue an onboarding process. It includes setting up the HTTP client, request payload, and headers. Remember to replace placeholder API keys.

```go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api-sandbox.y.uno/v1/recipients/{recipient_id}/onboardings/{onboarding_id}/continue"

	payload := strings.NewReader("{\n  \"account_id\": \"9104911d-5df9-429e-8488-ad41abea1a4b\",\n  \"type\": \"TWO_STEP_ONBOARDING\",\n  \"workflow\": \"HOSTED_BY_PROVIDER\",\n  \"callback_url\": \"https://www.google.com\",\n  \"provider\": {\n    \"id\": \"PAGARME\",\n    \"connection_id\": \"104911d-5df9-429e-8488-ad41abea1a4b\",\n    \"recipient_id\": \"AAAAA01\"\n  },\n  \"documentation\": [\n    {\n      \"file_name\": \"PDF\",\n      \"content_type\": \"application/pdf\",\n      \"content\": \"JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCg==\"\n    }\n  ],\n  \"withdrawal_methods\": {\n    \"bank\": {\n      \"code\": \"246\",\n      \"branch\": \"XXXX\",\n      \"branch_digit\": \"<string>\",\n      \"account\": \"1093333333\",\n      \"account_digit\": \"<string>\",\n      \"account_type\": \"SAVINGS\",\n      \"routing\": \"XXXXYYYYC\",\n      \"country\": \"CO\",\n      \"currency\": \"COP\"\n    }\n  },\n  \"legal_representatives\": [\n    {\n      \"merchant_reference\": \"<string>\",\n      \"first_name\": \"John\",\n      \"last_name\": \"Doe\",\n      \"email\": \"john.doe@email.com\",\n      \"date_of_birth\": \"1990-02-28\",\n      \"country\": \"CO\",\n      \"nationality\": \"CO\",\n      \"title\": \"CTO\",\n      \"publicly_exposed_person\": false,\n      \"ultimate_beneficial_owner\": false\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("public-api-key", "<Your public-api-key>")
	req.Header.Add("private-secret-key", "<Your private-secret-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

```

--------------------------------

### Set Up Local White-Label Proxy Server

Source: https://docs.y.uno/docs/sdks/customization/web/white-label

Use this command sequence to set up and start the local proxy server for testing white-label SDK configurations. Ensure you copy the example environment file and adjust upstream URLs if necessary.

```bash
cd yuno-sdk-web/white-label-proxy-server
cp .env.example .env   # tweak SDK_UPSTREAM / BACKEND_URL if needed
npm install
npm start              # http://localhost:9090
```

--------------------------------

### Get Installments Plans

Source: https://docs.y.uno/llms.txt

Retrieves the list of installment plans configured for a specific account.

```APIDOC
## GET /installments/plans

### Description
Retrieves the list of installment plans configured for a specific account.

### Method
GET

### Endpoint
/installments/plans

### Query Parameters
- **account_id** (string) - Optional - The ID of the account to retrieve installment plans for.
```

--------------------------------

### Go HTTP Client for Reverse Onboarding

Source: https://docs.y.uno/reference/recipients-for-marketplace/reverse-onboarding

Implement reverse onboarding in Go using the net/http package. This example shows how to create a POST request and set the required headers.

```go
package main  
  
import (  
	"fmt"  
	"net/http"  
	"io"  
)  
  
func main() {  
  
	url := "https://api-sandbox.y.uno/v1/recipients/onboardings/reverse-transfer/{transfer_id}"  
  
	req, _ := http.NewRequest("POST", url, nil)  
  
	req.Header.Add("X-organization-code", "<x-organization-code>")  
	req.Header.Add("X-Idempotency-Key", "<x-idempotency-key>")  
	req.Header.Add("public-api-key", "<Your public-api-key>")  
	req.Header.Add("private-secret-key", "<Your private-secret-key>")  
  
	res, _ := http.DefaultClient.Do(req)  
  
defer res.Body.Close()  
	body, _ := io.ReadAll(res.Body)  
  
	fmt.Println(string(body))  
  
}
```

--------------------------------

### Get Conversion Rate Example

Source: https://docs.y.uno/reference/conversion-rate/get-conversion-rate

This example demonstrates how to request currency conversion details.

```APIDOC
## POST /conversion-rate

### Description
Retrieves the currency conversion rate for a given transaction.

### Method
POST

### Endpoint
/conversion-rate

### Request Body
- **account_id** (string) - Required - The ID of the account.
- **amount** (object) - Required - The transaction amount details.
  - **value** (integer) - Required - The monetary value.
  - **currency** (string) - Required - The currency code (e.g., COP).
  - **currency_conversion** (object) - Optional - Details for currency conversion.
    - **cardholder_currency** (string) - Required - The currency code for the cardholder (e.g., USD).
- **provider_data** (object) - Optional - Provider-specific data.
  - **id** (string) - Required - The provider's ID.
- **payment_method** (object) - Required - Details about the payment method.
  - **card** (object) - Required - Card payment details.
    - **card_data** (object) - Required - Card data.
      - **number** (string) - Required - The card number.
      - **holder_name** (string) - Required - The cardholder's full name.
      - **expiration_month** (integer) - Required - The expiration month (1-12).
      - **expiration_year** (integer) - Required - The expiration year (2 digits).

### Request Example
```json
{
  "account_id": "fe14c7c6-c75e-43b7-bdbe-4c87ad52c482",
  "amount": {
    "value": 10000,
    "currency": "COP",
    "currency_conversion": {
      "cardholder_currency": "USD"
    }
  },
  "provider_data": {
    "id": "CIBC"
  },
  "payment_method": {
    "card": {
      "card_data": {
        "number": "4111111111111111",
        "holder_name": "JOHN DOE",
        "expiration_month": 12,
        "expiration_year": 25
      }
    }
  }
}
```

### Response
#### Success Response (200)
- **id** (string) - The unique identifier for the conversion.
- **amount** (object) - The transaction amount details.
  - **value** (integer) - The monetary value.
  - **currency** (string) - The currency code.
  - **currency_conversion** (object) - Details of the currency conversion.
    - **cardholder_currency** (string) - The cardholder's currency code.
    - **cardholder_amount** (number) - The amount in the cardholder's currency.
    - **rate** (number) - The conversion rate.
    - **provider_data** (object) - Provider-specific data for the conversion.
      - **id** (string) - The provider's ID.
      - **transaction_id** (string) - The transaction ID from the provider.
      - **response_code** (string) - The response code from the provider.
      - **response_message** (string) - The response message from the provider.
      - **raw_response** (object) - The raw response from the provider.
- **expired_at** (string) - The expiration date of the conversion.

#### Response Example
```json
{
  "id": "599cc714-9bb6-4a3c-8465-c360cd47e04e",
  "amount": {
    "value": 10000,
    "currency": "COP",
    "currency_conversion": {
      "cardholder_currency": "USD",
      "cardholder_amount": 2.58,
      "rate": 3879.812207,
      "provider_data": {
        "id": "CIBC",
        "transaction_id": "274c4fc9a1e3c27625fc4d925e0331783c3c5c94358280158d3980e97ac66795a80970d48c176078f394106345c05215431bbc6260a6980db3a2e0b753db1a3f32d0c8adfc02c18794dc07ac1c13a14e581a3d78ba4b9c5afdae537f38cc495628239b7470a997cc8d5b51ae787603b64de3b19cea09f825f6fd13896656b75092bd7fe19a0560df29b94",
        "response_code": "2000",
        "response_message": "Successful",
        "raw_response": {
          "fxRateInquiryResponse": {
            "localDate": 210,
            "localTime": 180927,
            "merchantID": "18695684",
            "rateEndTime": 1739212767659,
            "ratePreferenceCode": "R1",
            "rateStartTime": 1739210967659,
            "rateValidityPeriod": 30,
            "rates": [
              {
                "cardholderAmount": 2.58,
                "cardholderCurrency": "840",
                "merchantAmount": 10000,
                "merchantCurrency": "170",
                "rate": 3879.812207,
                "rateInquiryRef": "274c4fc9a1e3c27625fc4d925e0331783c3c5c94358280158d3980e97ac66795a80970d48c176078f394106345c05215431bbc6260a6980db3a2e0b753db1a3f32d0c8adfc02c18794dc07ac1c13a14e581a3d78ba4b9c5afdae537f38cc495628239b7470a997cc8d5b51ae787603b64de3b19cea09f825f6fd13896656b75092bd7fe19a0560df29b94"
              }
            ],
            "responseCode": "2000",
            "responseMessage": "Successful",
            "sessionId": "2a587fa2-e7da-11ef-8b88-7e36493c761f",
            "terminalID": "CT000001",
            "traceNumber": 3594
          }
        }
      }
    }
  },
  "expired_at": "2025-02-10T18:39:27Z"
}
```
```

--------------------------------

### Get Installments Plan by ID

Source: https://docs.y.uno/reference/installments/get-installments-plan

Retrieves the configuration details of a specific installment plan by its code.

```APIDOC
## GET /installments-plans/{installment_code}

### Description
Retrieves the configuration details of a specific installment plan by its code.

### Method
GET

### Endpoint
/installments-plans/{installment_code}

### Parameters
#### Path Parameters
- **installment_code** (string) - Required - Identifier of the installment plan.

### Response
#### Success Response (200)
- **id** (string) - Example: 4d573425-33f9-4c46-b009-2c7e749b0ec7
- **name** (string) - Example: plan_007
- **account_id** (array of strings) - Example: ["f7c5fe77-721b-49c2-84d3-957748df3c2c"]
- **merchant_reference** (string) - Example: Test
- **installments_plan** (array of objects) - Contains details for each installment option.
  - **installment** (integer) - Example: 1
  - **rate** (integer)
  - **provider_id** (string)
  - **financial_costs** (array of objects) - Present for some installment options, includes cost details.
    - **type** (string) - Example: CFT
    - **rate** (number) - Example: 45.25
    - **formatted_value** (string) - Example: 45,25%
  - **amount** (object) - Details about the amount for the installment.
    - **currency** (string) - Example: USD
    - **value** (string) - Example: '0'
    - **total_value** (string) - Example: '0'
- **iin** (null)
- **country_code** (string) - Example: US
- **first_installment_deferral** (integer) - Example: 0
- **amount** (object) - General amount limits for the plan.
  - **Currency** (string) - Example: USD
  - **min_value** (integer) - Example: 0
  - **max_value** (integer) - Example: 100000000
- **availability** (object) - Defines the availability period of the plan.
  - **start_at** (string) - Example: '2023-09-12T00:00:00Z'
  - **finish_at** (string) - Example: '2030-09-20T00:00:00Z'
- **created_at** (string) - Example: '2023-10-11T17:52:31.886178Z'
- **updated_at** (string) - Example: '2023-10-11T17:52:31.886178Z'
- **payment_method_type** (string) - Example: NU_PAY_ENROLLMENT

#### Response Example
```json
[
  {
    "id": "4d573425-33f9-4c46-b009-2c7e749b0ec7",
    "name": "plan_007",
    "account_id": [
      "f7c5fe77-721b-49c2-84d3-957748df3c2c"
    ],
    "merchant_reference": "Test",
    "installments_plan": [
      {
        "installment": 1,
        "rate": 1,
        "provider_id": "",
        "amount": {
          "currency": "USD",
          "value": "0",
          "total_value": "0"
        }
      },
      {
        "installment": 3,
        "rate": 1,
        "provider_id": "",
        "financial_costs": [
          {
            "type": "CFT",
            "rate": 45.25,
            "formatted_value": "45,25%"
          },
          {
            "type": "TEA",
            "rate": 38.5,
            "formatted_value": "38,50%"
          }
        ],
        "amount": {
          "currency": "USD",
          "value": "0",
          "total_value": "0"
        }
      },
      {
        "installment": 6,
        "rate": 1,
        "provider_id": "",
        "amount": {
          "currency": "USD",
          "value": "0",
          "total_value": "0"
        }
      },
      {
        "installment": 9,
        "rate": 1,
        "provider_id": "",
        "amount": {
          "currency": "USD",
          "value": "0",
          "total_value": "0"
        }
      },
      {
        "installment": 12,
        "rate": 1,
        "provider_id": "",
        "amount": {
          "currency": "USD",
          "value": "0",
          "total_value": "0"
        }
      }
    ],
    "iin": null,
    "country_code": "US",
    "first_installment_deferral": 0,
    "amount": {
      "Currency": "USD",
      "min_value": 0,
      "max_value": 100000000
    },
    "availability": {
      "start_at": "2023-09-12T00:00:00Z",
      "finish_at": "2030-09-20T00:00:00Z"
    },
    "created_at": "2023-10-11T17:52:31.886178Z",
    "updated_at": "2023-10-11T17:52:31.886178Z",
    "payment_method_type": "NU_PAY_ENROLLMENT"
  }
]
```
```

--------------------------------

### Create User with Go (net/http)

Source: https://docs.y.uno/reference/organizations/create-user

This Go example shows how to create a user using the standard `net/http` package. It constructs the request with the necessary headers and JSON body.

```go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api-sandbox.y.uno/v1/organizations/users"

	payload := strings.NewReader("{\n  \"email\": \"jsmith@example.com\",\n  \"first_name\": \"<string>\",\n  \"last_name\": \"<string>\",\n  \"account_permissions\": [
    {\n      \"account_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n      \"role_id\": \"<string>\"\n    }
  ],
  \"account_group_permissions\": [
    {\n      \"account_group_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n      \"role_id\": \"<string>\"\n    }
  ]
}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("PUBLIC-API-KEY", "<Your PUBLIC-API-KEY>")
	req.Header.Add("PRIVATE-SECRET-KEY", "<Your PRIVATE-SECRET-KEY>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Create Customer Session with Go

Source: https://docs.y.uno/reference/create-customer-session

This Go example demonstrates creating a customer session using the standard net/http package. It reads and prints the response body.

```go
package main  
  
import (  
	"fmt"  
	"strings"  
	"net/http"  
	"io"  
)  
  
func main() {  
  
	url := "https://api-sandbox.y.uno/v1/customers/sessions"  
  
	payload := strings.NewReader("{\n  \"account_id\": \"8beac4de-5f6f-11ed-9b6a-0242ac120002\",\n  \"customer_id\": \"ae106483-65ee-463b-8782-9794022b3112\",\n  \"country\": \"US\",\n  \"callback_url\": \"https://www.google.com/?customerSession=7dd71f21-9e4c-439a-9c6d-58f240bd28df\",\n  \"created_at\": \"2025-05-07T20:00:18.721786Z\",\n  \"checkout_id\": \"6822f80c-684e-41a3-8628-78963d3d60f7\"\n}")  
  
	req, _ := http.NewRequest("POST", url, payload)  
  
	req.Header.Add("public-api-key", "<Your public-api-key>")  
	req.Header.Add("private-secret-key", "<Your private-secret-key>")  
	req.Header.Add("Content-Type", "application/json")  
  
	res, _ := http.DefaultClient.Do(req)  
  
defer res.Body.Close()  
	body, _ := io.ReadAll(res.Body)  
  
	fmt.Println(string(body))  
  
}
```

--------------------------------

### OpenAPI Availability Object Example

Source: https://docs.y.uno/reference/subscriptions/cancel-subscription

Example of an availability object in OpenAPI, specifying start and finish times.

```yaml
availability:
  type: object
  properties:
    start_at:
      type: string
      example: '2024-01-16T00:00:00.786342Z'
    finish_at:
      type: string
      example: '2024-05-26T20:00:00.786342Z'
```

--------------------------------

### Initiate Reverse Onboarding with Go

Source: https://docs.y.uno/reference/reverse-onboarding

This Go program demonstrates how to make a POST request to the reverse onboarding endpoint using the standard `net/http` package. It configures the request headers and prints the response body.

```go
package main  
  
import (  
	"fmt"  
	"net/http"  
	"io"  
)  
  
func main() {  
  
	url := "https://api-sandbox.y.uno/v1/recipients/onboardings/reverse-transfer/{transfer_id}"  
  
	req, _ := http.NewRequest("POST", url, nil)  
  
	req.Header.Add("X-organization-code", "<x-organization-code>")  
	req.Header.Add("X-Idempotency-Key", "<x-idempotency-key>")  
	req.Header.Add("public-api-key", "<Your public-api-key>")  
	req.Header.Add("private-secret-key", "<Your private-secret-key>")  
  
	res, _ := http.DefaultClient.Do(req)  
  
	defer res.Body.Close()  
	body, _ := io.ReadAll(res.Body)  
  
	fmt.Println(string(body))  
  
}
```

--------------------------------

### Get Installments Plan by Account

Source: https://docs.y.uno/reference/installments/get-installments-plan-by-account

Fetches a list of installment plans available for a given account. This includes details about each installment, associated financial costs, and currency information.

```APIDOC
## GET /installments/plans

### Description
Retrieves a list of installment plans associated with a specific account. This endpoint provides detailed information about each plan, including its structure, rates, and financial costs.

### Method
GET

### Endpoint
/installments/plans

### Parameters
#### Query Parameters
- **accountId** (string) - Required - The ID of the account for which to retrieve installment plans.

### Response
#### Success Response (200)
- **id** (string) - The unique identifier of the installment plan.
- **name** (string) - The name of the installment plan.
- **account_id** (array[string]) - A list of account IDs associated with this plan.
- **merchant_reference** (string) - A reference identifier from the merchant.
- **installments_plan** (array[object]) - Details of each installment within the plan.
  - **installment** (integer) - The installment number.
  - **rate** (integer) - The interest rate for the installment.
  - **provider_id** (string) - The ID of the payment provider.
  - **financial_costs** (array[object]) - A list of financial costs associated with the installment.
    - **type** (string) - The type of financial cost (e.g., CFT, TEA, CET, CAT).
    - **rate** (number) - The rate of the financial cost.
    - **formatted_value** (string) - The formatted value of the financial cost.
  - **amount** (object) - The amount details for the installment.
    - **currency** (string) - The currency of the amount.
    - **value** (string) - The value of the installment.
    - **total_value** (string) - The total value of the installment.
- **iin** (object) - Information related to Issuer Identification Number (details not provided).
- **country_code** (string) - The country code associated with the plan.
- **first_installment_deferral** (integer) - The number of days the first installment can be deferred.
- **amount** (object) - General amount information for the plan.
  - **Currency** (string) - The currency of the plan amount.
  - **min_value** (integer) - The minimum value for the plan.
  - **max_value** (integer) - The maximum value for the plan.
- **availability** (object) - The availability period for the installment plan.
  - **start_at** (string) - The start date of availability.
  - **finish_at** (string) - The end date of availability.
- **created_at** (string) - The timestamp when the plan was created.
- **updated_at** (string) - The timestamp when the plan was last updated.
- **payment_method_type** (string) - The type of payment method.

#### Response Example (200)
{
  "example": [
    {
      "id": "4d573425-33f9-4c46-b009-2c7e749b0ec7",
      "name": "plan_007",
      "account_id": [
        "f7c5fe77-721b-49c2-84d3-957748df3c2c"
      ],
      "merchant_reference": "Test",
      "installments_plan": [
        {
          "installment": 1,
          "rate": 1,
          "provider_id": "",
          "financial_costs": [
            {
              "type": "CFT",
              "rate": 0.5,
              "formatted_value": "0.5%"
            }
          ],
          "amount": {
            "currency": "USD",
            "value": "100.00",
            "total_value": "100.00"
          }
        }
      ],
      "iin": {},
      "country_code": "US",
      "first_installment_deferral": 0,
      "amount": {
        "Currency": "USD",
        "min_value": 0,
        "max_value": 100000000
      },
      "availability": {
        "start_at": "2023-09-12T00:00:00Z",
        "finish_at": "2030-09-20T00:00:00Z"
      },
      "created_at": "2023-10-11T17:52:31.886178Z",
      "updated_at": "2023-10-11T17:52:31.886178Z",
      "payment_method_type": "NU_PAY_ENROLLMENT"
    }
  ]
}

#### Error Response (400)
- **code** (string) - Error code (e.g., INVALID_REQUEST).
- **messages** (array[string]) - A list of error messages.

#### Response Example (400)
{
  "example": {
    "code": "INVALID_REQUEST",
    "messages": [
      "Invalid request"
    ]
  }
}
```

--------------------------------

### Get Installments Plan

Source: https://docs.y.uno/reference/installments/get-installments-plan

Retrieves installment plans based on provided criteria. This endpoint is useful for displaying payment options to users.

```APIDOC
## GET /installments/plan

### Description
Retrieves available installment plans.

### Endpoint
/installments/plan

### Query Parameters
- **rate** (integer) - Optional - The installment rate.
- **provider_id** (string) - Optional - The ID of the provider.
- **amount** (object) - Optional - The amount details, including currency, value, and total value.
  - **currency** (string) - Optional - The currency of the amount.
  - **value** (string) - Optional - The value of the amount.
  - **total_value** (string) - Optional - The total value of the amount.
- **iin** (object) - Optional - Information related to the issuer identification number.
- **country_code** (string) - Optional - The country code for filtering plans.
- **first_installment_deferral** (integer) - Optional - The deferral period for the first installment.
- **amount** (object) - Optional - Specifies the minimum and maximum values for the installment amount.
  - **currency** (string) - Optional - The currency for the amount range.
  - **min_value** (integer) - Optional - The minimum allowed installment value.
  - **max_value** (integer) - Optional - The maximum allowed installment value.
- **availability** (object) - Optional - Filters plans based on availability dates.
  - **start_at** (string) - Optional - The start date for availability (ISO 8601 format).
  - **finish_at** (string) - Optional - The end date for availability (ISO 8601 format).
- **payment_method_type** (string) - Optional - The type of payment method.

### Response
#### Success Response (200)
- **rate** (integer) - The installment rate.
- **provider_id** (string) - The ID of the provider.
- **amount** (object) - The amount details.
  - **currency** (string) - The currency of the amount.
  - **value** (string) - The value of the amount.
  - **total_value** (string) - The total value of the amount.
- **iin** (object) - Issuer identification number details.
- **country_code** (string) - The country code.
- **first_installment_deferral** (integer) - The deferral period for the first installment.
- **amount** (object) - Amount range details.
  - **currency** (string) - The currency for the amount range.
  - **min_value** (integer) - The minimum allowed installment value.
  - **max_value** (integer) - The maximum allowed installment value.
- **availability** (object) - Availability details.
  - **start_at** (string) - The start date for availability.
  - **finish_at** (string) - The end date for availability.
- **created_at** (string) - Timestamp when the plan was created.
- **updated_at** (string) - Timestamp when the plan was last updated.
- **payment_method_type** (string) - The type of payment method.

#### Response Example
{
  "rate": 1,
  "provider_id": "",
  "amount": {
    "currency": "USD",
    "value": "0",
    "total_value": "0"
  },
  "iin": {},
  "country_code": "US",
  "first_installment_deferral": 0,
  "amount": {
    "currency": "USD",
    "min_value": 0,
    "max_value": 100000000
  },
  "availability": {
    "start_at": "2023-09-12T00:00:00Z",
    "finish_at": "2030-09-20T00:00:00Z"
  },
  "created_at": "2023-10-11T17:52:31.886178Z",
  "updated_at": "2023-10-11T17:52:31.886178Z",
  "payment_method_type": "NU_PAY_ENROLLMENT"
}

### Error Handling
#### Error Response (400)
- **description**: '400'
- **content**: application/json
  - **schema**: {}
  - **examples**: Result: {}

```

--------------------------------

### 3DS Standalone Setup - MERCHANT_PROVIDED Request

Source: https://docs.y.uno/docs/payment-features/3ds-standalone

Use this snippet to initiate a 3DS setup when the merchant provides all browser and device fingerprint information. Ensure the `provider_id` in `device_fingerprints` matches the configured 3DS provider.

```bash
curl --location 'https://api-staging.y.uno/v1/three-d-secure/setups' \
--header 'X-idempotency-key: idempotency-key' \
--header 'public-api-key: api-key' \
--header 'private-secret-key: secret-key' \
--header 'Content-Type: application/json' \
--data '{ \
    "account_id": "account_id", \
    "type": "MERCHANT_PROVIDED", \
    "card": { \
        "holder_name": "TEST CUSTOMER", \
        "number": "4556557955726624", \
        "expiration_month": 12, \
        "expiration_year": 26, \
        "security_code": "123" \
    }, \
    "browser_info": { \
        "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36", \
        "accept_header": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8", \
        "color_depth": "24", \
        "screen_height": "1080", \
        "screen_width": "1920", \
        "language": "es-CO", \
        "java_enabled": false, \
        "javascript_enabled": true, \
        "browser_time_difference": "300", \
        "platform": "WEB" \
    }, \
    "device_fingerprints": [ \
        { \
            "id": "3dae048e-b95e-47c6-8064-ea7f1aa16e90", \
            "provider_id": "NETCETERA_3DS" \
        } \
    ], \
    "metadata": [ \
        { \
            "key": "3ds_connection", \
            "value": "standard" \
        } \
    ] \
}'
```
Tokens:
Raw