HomeGuidesChangelogDiscussions
Log In
Guides

Wire Payouts

Take these steps to ensure your wallet pay outs are successful.

Wallet Payout to Wire

To successfully make a wire payout API call, you must provide the following information:
• The recipient's billing_details
• The recipient's banking information - their account_no and routing_no
• The receiving bank's information, which includes the institutions bank_address

👍

Noteworthy 👋

We currently support transfers to US based bank account, as well as international accounts without IBAN.
When making the API request for a wire payout to an international account, replace the routing_no with a BIC or SWIFT code.

Use the /crypto-integrators/payout/wire endpoint to initiate a payout to wire. A sample request is shown:

curl --location --request POST ‘https::/api-sandbox.spendjuice.org/crypto-integrators/payout/wire’ \
--data-raw ‘{
    “source_address_id”: “0f220c15-7f22-4a39-9fbb-ab40497b5998",
    “billing_details”: {
          “name”: “Wire Recipient”,
          “city”: “New York”,
          “country”: “US”,
          “line1": “19 W 24th Street”,
          “line2": “Suite 1”,
          “district”: “NY”,
          “postalCode”: “10010”
    },
    “bank_address”: {
          “bankName”: “Community Federal Savings Bank”,
          “city”: “Woodhaven”,
          “country”: “US”,
          “line1”: “89-16 Jamaica Ave”,
          “line2”: “11421",
          “district”: “NY”
    },
    “amount”: “1.0",
    “currency”: “USD”,
    “account_no”: “8310697692",
    “routing_no”: “026073008"
}’

A successful wire payout response would look like this:

{
    “data”: {
        “amount”: {
            “amount”: “1.00",
            “currency”: “USD”
        },
        “create_date”: “2022-01-24T11:27:10.439Z”,
        “destination”: {
            “account_no”: “8310697692”,
            “bank_address”: {
                “bankName”: “Community Federal Savings Bank”,
                “city”: “Woodhaven”,
                “country”: “US”,
                “district”: “NY”,
                “line1”: “89-16 Jamaica Ave”,
                “line2”: “11421"
            },
            “billing_details”: {
                “city”: “New York”,
                “country”: “US”,
                “district”: “NY”,
                “line1": “19 W 24th Street”,
                “line2": “Suite 1”,
                “name”: “Wire Recipient”,
                “postalCode”: “10010”
            },
            “name”: “COMMUNITY FEDERAL SAVINGS BANK ****7692”,
            “routing_no”: “026073008”,
            “type”: “wire”
        },
        “id”: “86cd9a1f-dd30-4dfb-a400-66c488d71de3”,
        “source”: {
            “id”: “0f220c15-7f22-4a39-9fbb-ab40497b5998",
            “type”: “address”
        },
        “status”: “pending”,
        “transaction_hash”: null,
        “type”: “debit”
    }
}

Webhooks let you get notified whenever the USDC has been successfully sent out of your wallet address with a status: complete tag on the incoming webhook payload.

In the event that a wire transaction which was hitherto in a complete status is returned by the receiving bank, the wire transfer transforms to status:failed with the event propagated via webhook as well.

👍

Confirm Pay out

You can monitor the status of your wallet pay out (even after receiving a notification from our webhook) by checking the transaction using our /crypto-integrators/transaction/{id} endpoint which will return these details for you.