---
updatedAt: 2026-09-17T02:53:12.000Z
agentTools:
  projectIndex: https://docs.walapay.io/llms.txt
---

# Stablecoin-to-Fiat (Crypto Off-Ramp)

<Callout icon="📘" theme="info">
  ### Funding methods

  For an explainer on the difference between a payment with vs. without source account ID, visit the [Payments](https://docs.walapay.io/docs/payments#/) page.
</Callout>

## Stablecoin to Fiat with Source Account Id

When sending a payment **with** a source.accountId, we will automatically pull funds from this account to fund the payment (as long as the Account is a Virtual Account).

<Callout icon="📘" theme="info">
  ### Sandbox

  In sandbox, there are two ways to get testnet USDC in your Virtual Digital Asset Wallet:

  1. Use the official testnet faucet: [https://faucet.circle.com/](https://faucet.circle.com/)
  2. Cancel a payment (this will automatically refund the USDC wallet)
</Callout>

### Request

```curl USDC to PHP
curl --request POST \
  --url 'https://sandbox-api.walapay.io/v1/payments/<customerId>' \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --header 'X-Api-Key: fa15de08-f1af-4c41-a74b-2302b6785c13' \
  --header 'X-Idempotency-Key: ced13348-d16d-4310-aa07-b3264cb00bc4' \
  --data '{
  "source": {
    "currencyCode": "USDC",
    "amount": 100,
    "rail": "POLYGON",
    "accountId": "cm3zbgjxe000hr8cqmm3v384e"
  },
  "destination": {
    "currencyCode": "PHP",
    "rail": "LOCAL",
    "accountId": "cm3zbgjxe000hr8cqmm3v384e"
  },
  "comment": "Test USDC to PHP payment",
  "reference": "FFC80602740",
  "paymentReason": "PERSONAL_TRANSFERS"
}'
```
```curl USDT to BRL
curl --request POST \
  --url 'https://sandbox-api.walapay.io/v1/payments/<customerId>' \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --header 'X-Api-Key: fa15de08-f1af-4c41-a74b-2302b6785c13' \
  --header 'X-Idempotency-Key: ced13348-d16d-4310-aa07-b3264cb00bc4' \
  --data '{
  "source": {
    "currencyCode": "USDC",
    "rail": "POLYGON",
    "amount": 100,
    "accountId": "cm3zbgjxe000hr8cqmm3v384e"
  },
  "destination": {
    "currencyCode": "BRL",
    "rail": "LOCAL",
    "accountId": "cm3zbgjxe000hr8cqmm3v384e"
  },
  "comment": "Test USDT to BRL payment",
  "reference": "FFC80602740",
  "paymentReason": "Testing fiat to crypto payment",
  "sourceOfFunds": "PERSONAL_ACCOUNT"
}'
```

## Stablecoin to Fiat without Source Entity Account Id

When sending a payment **without** a source.accountId, the response will include the funding instructions for the customer to fund the payment. All payments of this type have a 15 minute window for the customer to send the funds.

### Request

```curl USDC to PHP
curl --request POST \
  --url 'https://sandbox-api.walapay.io/v1/payments/<customerId>' \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --header 'X-Api-Key: fa15de08-f1af-4c41-a74b-2302b6785c13' \
  --header 'X-Idempotency-Key: ced13348-d16d-4310-aa07-b3264cb00bc4' \
  --data '{
  "source": {
    "currencyCode": "USDC",
    "amount": 100,
    "rail": "POLYGON",
    "fromAddress": "0x388C818CA8B9251b393131C08a736A67ccB19297"
  },
  "destination": {
    "currencyCode": "PHP",
    "rail": "LOCAL",
    "accountId": "cm3zbgjxe000hr8cqmm3v384e"
  },
  "reference": "FFC80602740",
  "paymentReason": "PERSONAL_TRANSFERS"
}'
```
```curl USDT to BRL
curl --request POST \
  --url 'https://sandbox-api.walapay.io/v1/payments/<customerId>' \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --header 'X-Api-Key: fa15de08-f1af-4c41-a74b-2302b6785c13' \
  --header 'X-Idempotency-Key: ced13348-d16d-4310-aa07-b3264cb00bc4' \
  --data '{
  "source": {
    "currencyCode": "USDC",
    "amount": 100,
    "rail": "POLYGON",
    "fromAddress": "0x388C818CA8B9251b393131C08a736A67ccB19297"
  },
  "destination": {
    "currencyCode": "BRL",
    "rail": "LOCAL",
    "accountId": "cm3zbgjxe000hr8cqmm3v384e"
  },
  "comment": "Test USDC to BRL payment",
  "reference": "FFC80602740",
  "paymentReason": "Testing fiat to crypto payment"
}'
```

### Response

Notice that the response here includes a fundingInstructions object with the details required to fund the payment.

```curl USDC to PHP
{
    "id": "cm40pxvdo0005xnyhgkr54uvk",
    "createdAt": "2024-11-28T02:51:50.173Z",
    "updatedAt": "2024-11-28T02:51:50.173Z",
    "status": "AWAITING_FUNDS",
    "paymentReason": "PERSONAL_TRANSFERS",
    "source": {
        "rail": "POLYGON",
        "fromAddress": "0x388C818CA8B9251b393131C08a736A67ccB19297",
        "currencyCode": "USDC"
    },
    "destination": {
        "rail": "LOCAL",
        "currencyCode": "PHP",
        "accountId": "cm3zbgjxe000hr8cqmm3v384e"
    },
    "fundingInstructions": {
        "amount": 100,
        "currencyCode": "USDC",
        "rail": "CRYPTO",
        "fromAddress": "0x388C818CA8B9251b393131C08a736A67ccB19297",
        "toAddress": "0x12345678900987654321234567890"
    }
}
```
```curl USDT to BRL
{
    "id": "cm40pxvdo0005xnyhgkr54uvk",
    "createdAt": "2024-11-28T02:51:50.173Z",
    "updatedAt": "2024-11-28T02:51:50.173Z",
    "status": "AWAITING_FUNDS",
    "comment": "Test USDC to BRL payment",
    "paymentReason": "Testing fiat to crypto payment",
    "source": {
        "rail": "POLYGON",
        "fromAddress": "0x388C818CA8B9251b393131C08a736A67ccB19297",
        "currencyCode": "USDC"
    },
    "destination": {
        "rail": "LOCAL",
        "currencyCode": "BRL",
        "accountId": "cm3zbgjxe000hr8cqmm3v384e"
    },
    "fundingInstructions": {
        "amount": 100,
        "currencyCode": "USDT",
        "rail": "CRYPTO",
        "fromAddress": "0x388C818CA8B9251b393131C08a736A67ccB19297",
        "toAddress": "0x12345678900987654321234567890",
        "chain": "Example Chain"
    }
}
```

## Files

Payments to CN, BR (B2B over 50,000 BRL only), GH, and IN (depending on the provider) require a file to be attached that explains the purpose of the payment (e.g., an invoice, a salary stipend)