Transfero BaaSiC

https://docs.transfero.com/
Admin
Transfero BaaSiC provides blockchain infrastructure for businesses to offer banking, crypto, and...
Tokens:88,304
Snippets:320
Trust Score:8.1
Update:5 months ago
Show doc for...
Tokens:
Raw
### Off-ramp and On-ramp Example (USDC to BRL)

Source: https://docs.transfero.com/reference/preview-a-swap

This example demonstrates the structure for a transaction involving USDC and BRL, showing conditional fields for off-ramp and on-ramp operations.

```json
{
  "taxId": "33821597035",
  "name": "José", //optional
  "email": "jose@bzr.group", //optional
  "externalId": "123", //optional
  "taxIdCountry": "BRA",
  
  // Conditional: Required for Off-ramp
  "DepositBlockchain": "Ethereum",
  "fiatWithdrawalInformation": {       
      "Key": "valid@sandbox.com"
  },

  // Conditional: Required for On-ramp
  // "cryptoWithdrawalInformation": {
  //    "key": "0x636...",
  //    "blockChain": "Ethereum"
  // },

  // Optional: For Auto-Refunds on Off-ramp
  // "refundCryptoAddress": "0x...",
  
	// required
  "quoteRequest": {
      "Side": "Sell",
      "BaseAmount": 10,
      "QuoteAmount": 0,
      "BaseCurrency": "USDC",
      "QuoteCurrency": "BRL"
  }
}
```

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

### Deposit Order Callback Request Example

Source: https://docs.transfero.com/reference/deposit-order-callback

This example shows a successful response from the deposit order callback endpoint.

```json
{
    "subscriptionId": "646a7469-26ef-48cc-a7c5-8306ab903bc8",
    "accountId": "15",
    "notificationType": "Webhook"
}
```

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

### Retrieve Account Balance Example

Source: https://docs.transfero.com/reference/retrieve-the-account-balance

This example shows the expected JSON response when successfully retrieving an account balance. It includes the amount, currency, account type, and the timestamp of the inquiry.

```json
{
    "balance": {
        "amount": 5501,
        "currency": "BRL"
    },
    "type": "Credit",
    "timeStamp": "2019-10-05T02:45:00Z"
}
```

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

### Swap Order Response Example

Source: https://docs.transfero.com/reference/create-a-swap-order

This example demonstrates the structure of a successful response when creating a swap order. It includes details like the order ID, currency, blockchain, deposit amount, reference ID, expiration time, deposit address, and wallet address for off-ramp cases.

```json
{
	"id": "b6a11cca-ef64-4292-8bbd-a78689bda16d",
  "currency": "BRL",
  "blockchain": "Bitcoin",
  "depositAmount": 101.1,
  "referenceId": "teste-reference01",
  "expireAt": "2020-07-30T18:00:00.000Z",
  "depositAddress": "pix-0123129442",
  "blockchainFee": 3,
  "walletAddress": "0xdasd15215w2344",//only for offramp cases
  "base64QRCode": "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
```

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

### USDC to USD Swap Example

Source: https://docs.transfero.com/reference/preview-a-swap

This example defines a quote request for selling USDC to receive USD, including detailed fiat withdrawal information for international transfers.

```json
{
    "quoteRequest": {
        "side": "Sell",
        "quoteAmount": 300,
        "baseAmount": 0, 
        "baseCurrency": "USDC",
        "quoteCurrency": "USD"
    },
    "taxId": "46356246172",
    "taxIdCountry": 76,
    "fiatWithdrawalInformation": {
        "ComplementaryInfos": {
            "senderType": "INDIVIDUAL" | "BUSINESS",
            "senderCountry": "BR",
            "recipientType": "INDIVIDUAL" | "BUSINESS",
            "destinationCountry": "US",
            "methodType": "WIRE" | "FEDWIRE",
            "beneficiaryAccountData": {
                "bankName": "Bank of America",
                "swiftCode": "BOFAUS3N",
                "bankCountry": "US",
                "accountNumber": "123456789012",
                "recipientLegalName": "Gabriela Souza"
            },
            "travelRuleData": {
                "originatorName": "Josuel",
                "originatorAccountNumber": "test-account-12345",
                "originatorPhoneNumber": "5521987654321",
                "originatorAddress": {
                    "street": "123 Main St",
                    "city": "New York",
                    "stateProvince": "NY",
                    "postalCode": "10001",
                    "country": "US"
                },
                "beneficiaryName": "Gabriela Souza",
                "beneficiaryAddress": {
                    "street": "742 Evergreen Terrace",
                    "city": "Springfield",
                    "stateProvince": "IL",
                    "postalCode": "62704",
                    "country": "US"
                }
            },
            "useCase": "C2B" | "B2C" | "C2C" | "B2B",
            "reasonForPaymentType": "PMT001",
            "customerRefId": "CUST-BR123456" //optional
        }
    }
}
```

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

### Swap Order Callback Message Example

Source: https://docs.transfero.com/reference/swap-order-callback

This is an example of the JSON message structure that will be sent to your provided callback URL for critical status changes in the swap order flow.

```json
{
    "id": "123456789-0e9c-492e-8815-10ef81964f87",
    "externalId": "TESTETESTE99D6f3521dF211DcC3EE1Ca62dC9d559",
    "clientId": "testetes-24f9-4f7e-afe9-16ac09e8787a",
    "referenceId": "TESTESTES1517571431075858",
    "name": "Phineas",
    "taxId": "12345678910",
    "taxIdCountry": "BRA",
    "status": "SwapOrderCreated",
    "from": {
        "accountId": "0000",
        "amount": 10.00,
        "currency": "BRL"
    },
    "to": {
        "accountId": "0000",
        "amount": 10.0000,
        "currency": "BRZ"
    },
    "depositInformation": {
        "blockchain": "None"
    },
    "withdrawalInformation": {
        "blockchain": "Polygon",
        "accountKey": "TESTETESTE99D6f3521dF211DcC3EE1Ca62dC9d559"
    }
}
```

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

### Successful Response Example

Source: https://docs.transfero.com/reference/retrieve-payment-groups-by-taxid

This example shows the structure of a successful response when retrieving payment groups. It includes details like payment group ID, total amounts, and payment counts.

```json
[
    {
    "paymentGroupId": "86571dbd-e97f-4552-ae9c-22f0e81abfba",
    "totalAmount": 4000,
    "totalAmountPaymentsCompletedWithSuccess": 0,
    "numberOfPayments": 2,
    "numberOfPaymentsPending": 1,
    "numberOfPaymentsProcessing": 1,
    "numberOfPaymentsCompletedWithSuccess": 0,
    "numberOfPaymentsCompletedWithError": 0,
    "createdAt": "2020-05-14",
    "createdAtDetailed": "0001-01-01T12:00:00Z"
}, {
    "paymentGroupId": "3801bdda-22f1-44e6-99dc-5673fc540a40",
    "totalAmount": 2513.5,
    "totalAmountPaymentsCompletedWithSuccess": 13.5,
    "numberOfPayments": 2,
    "numberOfPaymentsPending": 0,
    "numberOfPaymentsProcessing": 0,
    "numberOfPaymentsCompletedWithSuccess": 1,
    "numberOfPaymentsCompletedWithError": 1,
    "createdAt": "2020-05-14",
    "createdAtDetailed": "0001-01-01T12:00:00Z"
}]

```

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

### Preview Swap Request

Source: https://docs.transfero.com/reference/preview-a-swap

This example demonstrates how to preview a swap with an off-ramp using a QR code without an embedded value. You must provide either BaseAmount or QuoteAmount in the quoteRequest.

```APIDOC
## POST /v1/swap/preview

### Description
Simulates a ramp process to generate a quote, validates the payload, calculates the exchange rate, and estimates blockchain fees.

### Method
POST

### Endpoint
/v1/swap/preview

### Parameters
#### Request Body
- **taxId** (string) - Required - Tax ID of the user.
- **name** (string) - Required - Name of the user.
- **email** (string) - Required - Email of the user.
- **externalId** (string) - Required - External ID for the transaction.
- **taxIdCountry** (string) - Required - Country code for the tax ID.
- **DepositBlockchain** (string) - Required - The blockchain network for deposit.
- **fiatWithdrawalInformation** (object) - Optional - Information for fiat withdrawal.
  - **Key** (string) - Required if QrCode is not present - PIX Key for withdrawal.
  - **QrCode** (string) - Required if Key is not present - QR Code for withdrawal.
- **cryptoWithdrawalInformation** (object) - Optional - Information for cryptocurrency withdrawal.
  - **address** (string) - Required - The cryptocurrency withdrawal address.
  - **network** (string) - Required - The blockchain network for withdrawal.
- **quoteRequest** (object) - Required - Details for the quote request.
  - **Side** (string) - Required - 'Buy' or 'Sell'.
  - **BaseAmount** (number) - Required - The amount in the base currency.
  - **QuoteAmount** (number) - Required - The amount in the quote currency.
  - **BaseCurrency** (string) - Required - The base currency symbol.
  - **QuoteCurrency** (string) - Required - The quote currency symbol.
- **refundCryptoAddress** (string) - Optional - Address for automatic refunds.

### Request Example
```json
{
  "taxId": "33821597035",
  "name": "José",
  "email": "jose@bz.group",
  "externalId": "123",
  "taxIdCountry": "BRA",
  "DepositBlockchain": "Polygon",
  "fiatWithdrawalInformation": {
    "QrCode": "000201..." 
  },
  "quoteRequest": {
    "Side": "Sell",
    "BaseAmount": 10, 
    "QuoteAmount": 0,
    "BaseCurrency": "USDC",
    "QuoteCurrency": "BRL"
  }
}
```

### Response
#### Success Response (200)
- **previewId** (string) - ID required to create a swap order.
- **blockchainFee** (number) - Estimated blockchain network fee.

#### Response Example
```json
{
  "previewId": "pre_12345abcde",
  "blockchainFee": 0.0005
}
```
```

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

### Accept Swap Order Request

Source: https://docs.transfero.com/reference/create-swap-order-accept

Use this example to accept a swap order. Ensure you have a valid previewId from the Preview endpoint. An externalId can be provided for your own tracking.

```json
{
  "previewId": "97fe5691-3473-43cd-a047-e965fe7005fa",
  "externalId": "kl122ml2-0667-45ml-6a48-332a52b1559"
}
```

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

### New Payment Request (Alias)

Source: https://docs.transfero.com/reference/new-payment

This example shows how to initiate a payment using an alias. The alias field replaces the CBU/CVU for recipient identification.

```json
{
    "paymentGroupId": "6a08ae9f-2e88-408d-b95d-85e6dad6389e",
    "totalAmount": 10000,
    "totalAmountPaymentsCompletedWithSuccess": 0,
    "numberOfPayments": 1,
    "numberOfPaymentsPending": 1,
    "numberOfPaymentsProcessing": 0,
    "numberOfPaymentsCompletedWithSuccess": 0,
    "numberOfPaymentsCompletedWithError": 0,
    "createdAt": "2020-05-14",
    "payments": [{
        "paymentId": "754bd72a-3b72-4c3a-a511-315ca44ed151",
        "amount": 10000,
        "currency": "ARS",
        "name": "Maria Oliveira",
        "taxIdCountry": 32,
        "taxId": "27870613097",
        "alias": "12a345a6789"
    }]
}
```

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

### USDC to MXN Swap Example

Source: https://docs.transfero.com/reference/preview-a-swap

This example defines a quote request for selling USDC to receive MXN, including specific fiat withdrawal information for Mexican bank transfers via SPEI.

```json
{
    "quoteRequest": {
        "side": "Sell",
        "quoteAmount": 300,
        "baseAmount": 0, 
        "baseCurrency": "USDC",
        "quoteCurrency": "MXN"
    },
    "taxId": "46356246172",
    "taxIdCountry": 76,
    "fiatWithdrawalInformation": {
        "ComplementaryInfos": {
            "senderType": "INDIVIDUAL" | "BUSINESS",
            "senderCountry": "US",
            "recipientType": "INDIVIDUAL" | "BUSINESS",
            "destinationCountry": "MX",
            "methodType": "SPEI",
            "beneficiaryAccountData": {
                "clabe": "46356246172"
            },
            "travelRuleData": {
                "originatorName": "Josuel",
                "originatorAccountNumber": "test-account-12345",
                "originatorAddress": {
                    "street": "123 Main St",
                    "city": "New York",
                    "stateProvince": "NY",
                    "postalCode": "10001",
                    "country": "US"
                },
                "beneficiaryName": "Gabriela Souza",
                "beneficiaryNationalIdentificationNumber": "1234567890",
                "beneficiaryAddress": {
                    "street": "Av. Paseo de la Reforma 350",
                    "city": "Ciudad de México",
                    "stateProvince": "CDMX",
                    "postalCode": "06600",
                    "country": "MX"
                }
            },
            "useCase": "C2B" | "B2C" | "C2C" | "B2B",
            "reasonForPaymentType": "PMT001",
            "refCode": "TRANSFERENCIA CLIENTE 1 PARA CLIENTE 2"
        }
    }
}
```

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

### Nigerian Payment Request Example

Source: https://docs.transfero.com/reference/new-payment

Example of a payment request for Nigerian currency. Requires details like amount, currency, name, tax ID, and bank account information.

```json
[
  {
    "amount": 1.50,
    "currency": "USDT",
    "name": "Nigerian Example",
    "taxIdCountry": "NGN",
    "taxId": "7654444432",
    "outputCurrency": "NGN",
    "emailAddress": "teste@transfero.com",
    "phoneNumber": "+9877776645",
    "bankAccount": "0987654332",
    "bankCode": "011",
    "bankBranch": "Lagos"
  }
]
```

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

### Euro Withdrawal Request Example

Source: https://docs.transfero.com/reference/new-payment

Example of a payment request for Euro withdrawal. Requires amount, currency, name, tax ID country, tax ID, and IBAN.

```json
[
  {
    "amount": 150,
    "currency": "EUR",
    "name": "Napoleão Bonaparte",
    "taxIdCountry": 250,
    "taxId": "27870613097",
    "iban": "FR1420041010050500013M02606"
	}
]
```

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

### Preview Swap Request with QR Code with Value

Source: https://docs.transfero.com/reference/preview-a-swap

This example shows how to preview a swap when the QR code has an embedded value. Both BaseAmount and QuoteAmount must be set to 0 in the quoteRequest.

```APIDOC
## POST /v1/swap/preview

### Description
Simulates a ramp process to generate a quote, validates the payload, calculates the exchange rate, and estimates blockchain fees.

### Method
POST

### Endpoint
/v1/swap/preview

### Parameters
#### Request Body
- **taxId** (string) - Required - Tax ID of the user.
- **name** (string) - Required - Name of the user.
- **email** (string) - Required - Email of the user.
- **externalId** (string) - Required - External ID for the transaction.
- **taxIdCountry** (string) - Required - Country code for the tax ID.
- **DepositBlockchain** (string) - Required - The blockchain network for deposit.
- **fiatWithdrawalInformation** (object) - Optional - Information for fiat withdrawal.
  - **Key** (string) - Required if QrCode is not present - PIX Key for withdrawal.
  - **QrCode** (string) - Required if Key is not present - QR Code for withdrawal.
- **cryptoWithdrawalInformation** (object) - Optional - Information for cryptocurrency withdrawal.
  - **address** (string) - Required - The cryptocurrency withdrawal address.
  - **network** (string) - Required - The blockchain network for withdrawal.
- **quoteRequest** (object) - Required - Details for the quote request.
  - **Side** (string) - Required - 'Buy' or 'Sell'.
  - **BaseAmount** (number) - Required - The amount in the base currency.
  - **QuoteAmount** (number) - Required - The amount in the quote currency.
  - **BaseCurrency** (string) - Required - The base currency symbol.
  - **QuoteCurrency** (string) - Required - The quote currency symbol.
- **refundCryptoAddress** (string) - Optional - Address for automatic refunds.

### Request Example
```json
{
  "taxId": "33821597035",
  "name": "José",
  "email": "jose@bz.group",
  "externalId": "123",
  "taxIdCountry": "BRA",
  "DepositBlockchain": "Polygon",
  "fiatWithdrawalInformation": {
    "QrCode": "000201..." 
  },
  "quoteRequest": {
    "Side": "Sell",
    "BaseAmount": 0, 
    "QuoteAmount": 0,
    "BaseCurrency": "USDC",
    "QuoteCurrency": "BRL"
  }
}
```

### Response
#### Success Response (200)
- **previewId** (string) - ID required to create a swap order.
- **blockchainFee** (number) - Estimated blockchain network fee.

#### Response Example
```json
{
  "previewId": "pre_12345abcde",
  "blockchainFee": 0.0005
}
```
```

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

### Preview USDC to EUR Swap

Source: https://docs.transfero.com/reference/preview-a-swap

This example demonstrates the JSON payload for previewing a USDC to EUR swap. It specifies SEPA as the withdrawal method and includes travel rule data.

```json
{
    "quoteRequest": {
        "side": "Sell",
        "quoteAmount": 300,
        "baseAmount": 0,
        "baseCurrency": "USDC",
        "quoteCurrency": "EUR"
    },
    "taxId": "46356246172",
    "taxIdCountry": 76,
    "fiatWithdrawalInformation": {
        "ComplementaryInfos": {
            "senderType": "INDIVIDUAL",
            "senderCountry": "BR",
            "recipientType": "INDIVIDUAL",
            "destinationCountry": "PT",
            "methodType": "SEPA",
            "beneficiaryAccountData": {
                "iban": "PT50003300004512345678901",
                "recipientLegalName": "João Miguel Pereira"
            },
            "travelRuleData": {
                "originatorName": "Josuel",
                "originatorAccountNumber": "test-account-12345",
                "originatorAddress": {
                    "street": "123 Main St",
                    "city": "New York",
                    "stateProvince": "NY",
                    "postalCode": "10001",
                    "country": "US"
                },
                "beneficiaryName": "João Miguel Pereira",
                "beneficiaryNationalIdentificationNumber": "1234567890",
                "beneficiaryAddress": {
                    "street": "Av. da Liberdade 245",
                    "city": "Lisboa",
                    "stateProvince": "Lisboa",
                    "postalCode": "1250-096",
                    "country": "PT"
                }
            },
            "useCase": "C2C",
            "reasonForPaymentType": "PMT001",
            "refCode": "TRANSFERENCIA CLIENTE 1 PARA CLIENTE 2"
        }
    }
}
```

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

### New Payment Request (Pix Key)

Source: https://docs.transfero.com/reference/new-payment

This example demonstrates creating a payment request using a Pix key for recipient identification. The currency is set to BRL.

```json
{
    "paymentGroupId": "6a08ae9f-2e88-408d-b95d-85e6dad6389e",
    "totalAmount": 370,
    "totalAmountPaymentsCompletedWithSuccess": 0,
    "numberOfPayments": 1,
    "numberOfPaymentsPending": 1,
    "numberOfPaymentsProcessing": 0,
    "numberOfPaymentsCompletedWithSuccess": 0,
    "numberOfPaymentsCompletedWithError": 0,
    "createdAt": "2020-05-14",
    "payments": [{
        "paymentId": "754bd72a-3b72-4c3a-a511-315ca44ed151",
        "amount": 370,
        "currency": "BRL",
        "name": "Maria Oliveira",
        "taxIdCountry": 76,
        "taxId": "85517053009",
        "pixKey": "maria_oliveira@gmail.com"
    }]
}
```

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

### Error: Account ID Null

Source: https://docs.transfero.com/reference/retrieve-the-account-balance

This example illustrates the plain text error response when the provided AccountId is null or empty.

```text
AccountId cannot be null or empty
```

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

### Preview USDC to HKD Swap

Source: https://docs.transfero.com/reference/preview-a-swap

This example shows the JSON payload for previewing a USDC to HKD swap. It includes details for fiat withdrawal, sender/recipient information, and travel rule data.

```json
{
    "quoteRequest": {
        "side": "Sell",
        "quoteAmount": 300,
        "baseAmount": 0, 
        "baseCurrency": "USDC",
        "quoteCurrency": "HKD"
    },
    "taxId": "46356246172",
    "taxIdCountry": 76,
    "fiatWithdrawalInformation": {
        "ComplementaryInfos": {
            "senderType": "INDIVIDUAL" | "BUSINESS",
            "senderCountry": "BR",
            "recipientType": "INDIVIDUAL" | "BUSINESS",
            "destinationCountry": "HK",
            "methodType": "WIRE" | "CHATS" | "FPS",
            "beneficiaryAccountData": {
              "bankName": "HSBC Hong Kong",
              "swiftCode": "HSBCHKHHHKH",
              "bankCountry": "HK",
              "accountNumber": "123456789012",
              "recipientLegalName": "Gabriela Souza"
            },
            "travelRuleData": {
                "originatorName": "Josuel",
                "originatorNationalIdentificationNumber": "1234567890",
                "originatorAccountNumber": "test-account-12345",
                "originatorAddress": {
                    "street": "123 Main St",
                    "city": "New York",
                    "stateProvince": "NY",
                    "postalCode": "10001",
                    "country": "US"
                },
                "beneficiaryName": "Gabriela Souza",
                "beneficiaryAddress": {
                    "street": "123 Queen's Road Central",
                    "city": "Hong Kong",
                    "stateProvince": "Hong Kong",
                    "postalCode": "00000",
                    "country": "HK"
                }
            },
            "useCase": "C2B" | "B2C" | "C2C" | "B2B",
            "reasonForPaymentType": "PMT001",
            "refCode": "TRANSFERENCIA CLIENTE 1 PARA CLIENTE 2"
        }
    }
}
```

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

### Example Credit Transaction Callback Message

Source: https://docs.transfero.com/reference/subscribe-to-credit-transaction-callback

This JSON object represents a sample callback message received for a credit transaction. It includes details about the account, transaction amount, description, dates, transaction ID, counterpart information, and reference ID.

```json
{
    "accountId": "000",
    "amount": {
        "amount": 50.0,
        "currency": "BRL"
    },
    "amountNet": {
        "amount": 50.0,
        "currency": "BRL"
    },
    "transactionDescription": {
        "description": "Deposit Order Credit Transaction",
        "name": "Sponge Bob",
        "taxId": "12345678910",
        "taxIdCountry": 76
    },
    "date": "2024-10-15",
    "dateDetailed": "2024-10-15T18:17:03.9446528+00:00",
    "type": "Credit",
    "transactionId": "testeste-bc6f-4d6c-942a-9f4b4cd0591e",
    "transactionHash": "testeste0202410151816s17f7f54bcd",
    "counterpart": {
        "name": "Sponge Bob",
        "taxId": "12345678910",
        "bankAccount": "123456789",
        "bankBranch": "0000",
        "taxIdCountry": 76
    },
    "referenceId": "TESTE241015163678868543968",
    "blockchain": "None",
    "externalId": "AAAA1234"
}
```

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

### OpenAPI Definition for Swap Order Acceptance

Source: https://docs.transfero.com/reference/create-swap-order-accept

This JSON snippet provides the complete OpenAPI 3.1.0 definition for the 'accept swap order' endpoint, including its path, HTTP method, response schema, and an example of a successful 200 OK response.

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "authentication",
    "version": "2.0"
  },
  "servers": [
    {
      "url": "https://sandbox-api-baasic.transfero.com"
    }
  ],
  "security": [
    {}
  ],
  "paths": {
    "/api/ramp/v2/swaporder/accept": {
      "post": {
        "description": "",
        "operationId": "post_apiv2swaporderaccept",
        "responses": {
          "200": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "currency": {
                      "type": "string"
                    },
                    "depositAmount": {
                      "type": "number"
                    },
                    "blockchain": {
                      "type": "string"
                    },
                    "referenceId": {
                      "type": "string"
                    },
                    "expireAt": {
                      "type": "string"
                    },
                    "depositAddress": {
                      "type": "string"
                    },
                    "walletAddress": {
                      "type": "string"
                    },
                    "base64QRCode": {
                      "type": "string"
                    },
                    "blockchainFee": {
                      "type": "number"
                    }
                  }
                },
                "examples": {
                  "OK": {
                    "summary": "OK",
                    "value": {
                      "id": "8a6018ea-6022-4ffe-abba-cbd821c0ec85",
                      "currency": "USDC",
                      "depositAmount": 1,
                      "blockchain": "Ethereum",
                      "referenceId": "2387TG25121661665E8D",
                      "expireAt": "2025-12-16T18:52:28.75985Z",
                      "depositAddress": "ethereum:0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238@11155111/transfer?uint256=1000000&label=Renan&message=&address=0x83FdDa64eAE51631508AE156c4BE8F6CbE246e7C&gas=70000&referenceId=2387TG25121661665E8D",
                      "walletAddress": "0x83FdDa64eAE51631508AE156c4BE8F6CbE246e7C",
                      "base64QRCode": "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"
```

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

### Crypto Withdrawal Request Example

Source: https://docs.transfero.com/reference/new-payment

Example of a payment request for cryptocurrency withdrawal. Requires amount, currency, tax ID country, tax ID, wallet address, and blockchain network.

```json
[
    {
        "amount": 100,
        "currency": "USDT",
        "taxIdCountry": "BRA",
        "taxId": "89953635099",
        "wallet": "0x7756aD1a21b3648f747FFeB937017034B02A9620",
        "blockchain": "Ethereum"
    }
]
```

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

### Error Case: Missing TaxId

Source: https://docs.transfero.com/reference/new-payment

Example of a payment request missing the mandatory TaxId field. This will result in an error.

```json
[
  {
    "amount": 370,
    "currency": "BRL",
    "name": "Irmao do Jorel",
    "taxIdCountry": "BRA",
    "pixKey": "12345678910"
	}
]
```

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

### Staging Environment URL

Source: https://docs.transfero.com/reference/getting-started-with-baasic-api

Use this URL to access the staging environment for testing and integration.

```json
https://sandbox-api-baasic.transfero.com
```
Tokens:
Raw