Changelog

​

KYC/KYB API and idempotency support 🤯

1. KYC/KYB verification endpoints

• PATCH /customers/{id}/additional-information — Submit KYC/KYB data
• POST /customers/{id}/documents — Upload verification documents
• POST /customers/{id}/associated-parties — Add UBOs, shareholders, and representatives
• GET /customers/{id}/associated-parties — List associated parties
• GET /customers/{id}/associated-parties/{associatedPartyId} — Read an associated party
• POST /customers/{id}/verifications — Start a verification
• GET /customers/{id}/verifications/{verificationId} — Read verification status

2. additionalInformation in customer response

3. Multi-level corporate structures

{
  "type": "INDIVIDUAL",
  "role": "SHAREHOLDER",
  "parentId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "name": "John Smith",
  "ownershipPercentage": 50
}

4. Idempotency support

​

Individual customers and bank account holders 🥳

1. Individual customer type

{
  "type": "INDIVIDUAL",
  "name": "William Default",
  "taxId": "100.100.100-01",
  "birthDate": "1990-01-01"
}

2. Individual bank account holders

3. Individual bank account identifier key type as CPF

4. New relationship types for bank account holders

​

Multi-blockchain support 🔥

1. Multiple wallets per customer

{
  "wallets": [
    {
      "blockchain": "POLYGON",
      "address": "0x...",
      "blockExplorerUrl": "https://polygonscan.com/address/0x...",
      "isDefault": true,
      "balances": [
        { "stablecoin": "USDC", "balance": "1000.00" }
      ]
    }
  ]
}

2. Blockchain field in transactions

{
  "blockchain": "BASE",
  "sourceCurrency": "BRL",
  "sourceAmount": "1000.00",
  "targetCurrency": "USDC"
}

3. Blockchain field in exchange rates

4. Improved balance tracking

5. wallet and balances fields deprecated on customers: Migrate to the new wallets array. Affected endpoints: POST /customers, GET /customers.
6. Default partner fee removed: If no partnerFeeId is provided, partner fees will be zero. Remove any logic that depends on a default fee. Affected endpoints: GET /partner-fees, POST /partner-fees.

​

Transaction limits response improved ⚡

1. Transaction limits now include usage tracking

{
  "transactionLimits": {
    "single": { "max": "10000.00" },
    "daily": {
      "max": "100000.00",
      "used": "0.00",
      "remaining": "100000.00"
    },
    "monthly": {
      "max": "1000000.00",
      "used": "0.00",
      "remaining": "1000000.00"
    }
  }
}

2. transactionLimits no longer returned by default: The transactionLimits field is no longer included in GET /customers/{id} responses by default. Use the new query parameter includeTransactionLimits=true to retrieve transaction limits.
3. transactionLimits removed from customer listing: The GET /customers endpoint no longer returns the transactionLimits field in the response array.
4. 10-second timelock removed from exchange rates: The 10-second timelock option is no longer available. The 30-second timelock now has no additional fees, and fees for other timelock options have been optimized.

​

SEPA and SWIFT are live 🚀

1. SEPA support now available

{
  "rail": "SEPA",
  "sourceCurrency": "EUR",
  "sourceAmount": "10000.00",
  "targetCurrency": "USDC",
  "purpose": "PERSONAL_ACCOUNT"
}

2. SWIFT support now available

{
  "rail": "SWIFT",
  "sourceCurrency": "USD",
  "sourceAmount": "10000.00",
  "targetCurrency": "USDC",
  "purpose": "PERSONAL_ACCOUNT"
}

3. Purpose field now returned in transaction responses

4. Target amount visibility improved

5. Bank account ordering updated

​

Bank Accounts are live 🎉

1. Supplier payments now available

2. PROCESSING status renamed to TRANSFERRING_STABLECOIN
3. state.blockchain moved to state.receipt

4. purpose now required for on-ramp and off-ramp transactions

5. On-ramp: payment.rail moved to request level rail
6. Off-ramp: customerId and payment object removed, use bankAccountId only
7. Exchange Rate: rail and customerId parameters now required