Skip to main content
POST
/
v1
/
payouts
curl --location --request POST 'https://stablecoin-api.sandbox.getmeru.com/v1/payouts' \
--header 'Content-Type: application/json' \
--header 'api-key: <api-key>' \
--data-raw '{
    "onBehalfOf": "123",
    "amount": 1000,
    "source": {
        "paymentRail": "stellar",
        "currency": "usdc",
        "address": "123123"
    },
    "deductFromBalance": true,
    "quoteId": "efaaf971-6d8b-4f36-be36-187c9f68fc06",
    "destination": {
        "type": "bank",
        "currency": "cop",
        "details": {
            "country": "CO",
            "accountType": "savings",
            "bankAccountNumber": "1234567890",
            "bankCode": "876",
            "beneficiary": {
                "email": "beneficiary@example.com",
                "documentType": "CC",
                "documentNumber": "12345678",
                "firstName": "John",
                "lastName": "Doe",
                "phone": "+573001234567",
                "city": "Bogotá",
                "state": "Cundinamarca",
                "address": "Calle 123 #45-67",
                "country": "CO",
                "type": "individual"
            }
        }
    }
}'

{
  "success": true,
  "id": "3ddd0e5b-6276-4b48-b756-c1fcc9a2efd1"
}

​
Body

​
onBehalfOf
string
required
The identifier of the user or entity on whose behalf the payout is being made
​
amount
number
Amount to send in the source currency
​
source
object
Source payment details. Required if deductFromBalance is false
​
deductFromBalance
boolean
required
Whether to deduct the amount from the account balance
​
quoteId
string
Optional quote ID to use for exchange rate calculation. If provided, the exchange rate from the quote will be used. If not provided, the exchange rate will be calculated on the fly.
​
destination
object
required
Destination payment details. The structure depends on the destination type.

​
Response

​
success
boolean
Indicates whether the call was successful.
​
id
string
The id of the payout process. Use this id to check the status of the process
curl --location --request POST 'https://stablecoin-api.sandbox.getmeru.com/v1/payouts' \
--header 'Content-Type: application/json' \
--header 'api-key: <api-key>' \
--data-raw '{
    "onBehalfOf": "123",
    "amount": 1000,
    "source": {
        "paymentRail": "stellar",
        "currency": "usdc",
        "address": "123123"
    },
    "deductFromBalance": true,
    "quoteId": "efaaf971-6d8b-4f36-be36-187c9f68fc06",
    "destination": {
        "type": "bank",
        "currency": "cop",
        "details": {
            "country": "CO",
            "accountType": "savings",
            "bankAccountNumber": "1234567890",
            "bankCode": "876",
            "beneficiary": {
                "email": "beneficiary@example.com",
                "documentType": "CC",
                "documentNumber": "12345678",
                "firstName": "John",
                "lastName": "Doe",
                "phone": "+573001234567",
                "city": "Bogotá",
                "state": "Cundinamarca",
                "address": "Calle 123 #45-67",
                "country": "CO",
                "type": "individual"
            }
        }
    }
}'

{
  "success": true,
  "id": "3ddd0e5b-6276-4b48-b756-c1fcc9a2efd1"
}