Schema

Webhook Payload for Transfer

Parameter

Type

Example

subscription_type

String

transfer

id

UUID

18ea46e5-2c36-4862-9eac-adc44364df7b

user_id

UUID

18ea46e5-2c36-4862-9eac-adc44364df7b

entity_id

UUID

18ea46e5-2c36-4862-9eac-adc44364df7b

beneficiary_id

UUID

18ea46e5-2c36-4862-9eac-adc44364df7b

wallet_id

UUID

18ea46e5-2c36-4862-9eac-adc44364df7b

state

String

processing

fee

String

0.00

fee_usd

String

0.00

source_amount

String

15

source_currency

String

MXN

destination_amount

String

0.87

destination_currency

String

USD

purpose_of_payment

String

Test

rate

String

0.057817

reference

String

Test

created_date

String

2023-08-08T16:59:42.463Z

expected_delivery_date

String

2023-08-09T17:00:06.375Z

funding_instructions

FundingInstructions

payment_method

String

local

scheduled_delivery_date

String

2023-08-09T17:00:06.375Z

wire

String

false


Webhook Payload for Entity

ParameterTypeExample
subscription_typeStringentity
idUUID18ea46e5-2c36-4862-9eac-adc44364df7
typeStringbusiness or person
business_nameStringRoutefusion, Inc
created_dateString2023-08-08T16:59:42.463Z
stateStateapproved
first_nameStringJohn
last_nameStringSmith
emailString[email protected]
phoneString555-555-5555
phone_countryStringUS
address1String123 S. Congress
address2StringSuite 3
cityStringAustin
state_province_regionStringTX
postal_codeString78702
countryStringUS
user_idUUID18ea46e5-2c36-4862-9eac-adc44364df7b
representatives[UUID]['18ea46e5-2c36-4862-9eac-adc44364df7b']

Webhook Payload for IncomingTransfer

ParameterTypeExample
idUUID27f96699-55a9-4c03-8b36-7627bc344751
entity_idUUID102eafea-957a-41fe-b0bd-6dc078021f16
wallet_idUUID202a9c54-e7fa-4ccb-8303-a9195f7593b2
currencyStringUSD
creditBooleantrue
amountString'2500.00'
transaction_dateDateTime2024-02-06T23:16:54Z
referenceString
counterparty_nameStringBob's Burgers
account_numberString'13254355'
name_on_bank_accountStringFrankie's Fries
nicename_on_bank_accountStringFries Account #1
stateIncomingTransferStatecomplete
purpose_of_paymentStringPurchase of goods
updated_dateDateTime2024-02-07T00:05:00Z
created_dateDateTime2024-02-07T00:05:00Z
senders_bankStringBank of America
traceString22ADF2345DB3455

Webhook Payload for Wallet

ParameterTypeExample
available_balanceString'10,000'
balanceString'10,000'
countryISO3166_1US
created_dateDateTime2024-08-12T00:05:00Z
currencyISO4217USD
entityUUID102eafea-957a-41fe-b0bd-6dc078021f16
idUUID202a9c54-e7fa-4ccb-8303-a9195f7593b2
organizationUUID27f96699-55a9-4c03-8b36-7627bc344751
representative_currencyISO4217USD
stateStringone of: 'accepted', 'pending', 'verified', 'rejected', 'suspended'
suspendedBooleanfalse
updated_dateDateTime2024-08-12T00:06:00Z

Webhook Payload for Beneficiary

Attribute

Type

Definition

Example

id

UUID

the id of the beneficiary

a9d0164d-22df-46c6-a836-1a3da5a470d8

entity

Entity

the entity object - NOT editable after creation

see entity schema

creator

UserAccount

the user object that created the beneficiary - NOT editable after creation

see UserAccount schema

type

String

the classification of the beneficiary, can either be 'personal' or 'business' - NOT editable after creation

personal

email

Email

email used for notification

[email protected]

phone

String

phone number of beneficiary

9177234464

phone_country

String

2 letter ISO code of the country the phone number exists in

US

tax_number

TaxNumber

tax number of the beneficiary for the country provided

121904576

first_name

String

first name of the beneficiary

Thomas

last_name

String

last name of the beneficiary

Jones

address1

String

address line 1 of beneficiary

1305 E 6th St.

address2

String

address line 2 of beneficiary

Unit 10

city

String

city the beneficiary resides in

Austin

state

BeneficiaryState

state of the beneficiary

  • accepted
  • pending
  • verified
  • failed
  • change_required

state_province_region

String

the state (US), province, or region the beneficiary resides in

Texas

postal_code

String

the postal code of the beneficiary

78702

country

String!

2 letter ISO code of the country the beneficiary resides in

US

tax_number

String

the tax number of the beneficiary, this is only required for some countries

111564839

contact_first_name

String

first name of the contact of the beneficiary (business only)

George

contact_last_name

String

last name of the contact of the beneficiary (business only)

Castanza

business_name

String

name of business receiving payment

Routefusion

name_on_bank_account

String

legal owner of the bank account

Thomas Jones

swift_bic

String

SWIFT/BIC code of the bank; this can be an account number, CLABE or IBAN

CITIUS33XXX

account_type

AccountType

type of the beneficiaries account, can only be checking or saving

checking

account_number

String

the IBAN, CLABE, or account number of the bank account

2345366452

routing_code

String

routing code of the local financial system

A bank routing code

currency

String

the 3 character code of the currency - NOT editable after creation

USD

bank_name

String

the name of the banking institution

Citibank

branch_name

String

the name of the bank branch

LOS ANGELES-BRENTWOOD

bank_address1

String

line 1 of the bank address

11726 SAN VICENTE BLVD

bank_address2

String

line 2 of the bank address

Unit 10

bank_city

String

the city the bank is located

Los Angeles

bank_state_province_region

String

the state, region, or province the bank resides in

California

bank_postal_code

PostalCode

the postal code of the bank

90049

bank_country

ISO3166_1!

the 2 character country code the bank resides in - NOT editable after creation

US

changes_required

[String]

an array of beneficiary keys that need changes

["account_number"]

GraphQL Schema

enum SubscriptionType {
  entity
  transfer
  incoming_transfer
  wallet
}

type Mutation {
  createWebhookSubscription(
    subscription_type: SubscriptionType!
    url: String!
    header_key: String
    header_value: String
  ): String

  disableWebhookSubscription(
    subscription_id: UUID!
  ): String
}