POST
/v2/transfer/add
This endpoint allows the developer to create a transfer for a specific customer. With this call you can initiate two types of transfers - INCOMING (request funds) and OUTGOING (send funds). It is also possible to initiate transfers to the customer already defined in the system, or just pass the customer information and the customer will be created automatically.
Parámetros
Nombre
Descripción
transfer
(necesario)
attachments
(opcional)
Response Messages
Código
Descripción
200
OK
201
Created
401
Unauthorized
403
Forbidden
404
Not Found
{
"amount": 1.01,
"bank_account_from": 0,
"bank_account_to": {
"id": 0,
"account_number": "string",
"branch": "string",
"institution": "string",
"routing_numbers": "string"
},
"customer_info": {
"billing_addresses": [
{
"id": 0,
"zip": "string",
"city": "string",
"country": 0,
"province": 0,
"address": "string",
"selected": true
}
],
"contract_email": "string",
"contracts": [
{
"id": 0,
"name": "string"
}
],
"customer_id": "string",
"customer_name": "string",
"customer_since": "yyyy-MM-dd'T'HH:mm:ss.SSSXXX",
"delete_billing_address_ids": [],
"main_address": {
"id": 0,
"zip": "string",
"city": "string",
"country": 0,
"province": 0,
"address": "string",
"selected": true
},
"mobile_number": "string",
"phone_number": "string"
},
"notes": "string",
"send_on": "string",
"state": "DRAFT",
"transfer_id": "string",
"transfer_type": "INCOMING"
}
{ } TransferRequestV2Model
amount
required
number
bank_account_from
optional
integer
notes
optional
string
send_on
optional
string
state
required
string
transfer_id
required
string
transfer_type
required
string
{ } BankV2Model
id
optional
integer
account_number
optional
string
branch
optional
string
institution
optional
string
routing_numbers
optional
string
{ } CCProfileApiV2Model
contract_email
optional
string
customer_id
optional
string
customer_name
optional
string
customer_since
optional
string
delete_billing_address_ids
optional
array
mobile_number
optional
string
phone_number
optional
string
{
"amount": 1.01,
"attachments": [
{
"name": "string",
"url": "string"
}
],
"currency": "AED",
"description": "string",
"fee_settings": [
{
"fee_id": 0,
"fee_settings_template": {
"company_fee_percent": 1.01,
"company_fees_state": "ACTIVE",
"cross_border_fee": 1.01,
"customer_fee_percent": 1.01,
"fee_collection_strategy": "IMMEDIATELY",
"fee_settings_payment_method": "CREDIT_CARD",
"fee_type": "AR_INVOICES",
"id": 0,
"profit_margin": 1.01,
"transaction_fee": 1.01,
"version": 0
},
"fee_version": 0,
"id": 0,
"selected_company_fee_percent": 1.01,
"selected_customer_fee_percent": 1.01
}
],
"id": 0,
"participants": [
{
"address": {
"address": "string",
"city": "string",
"country": 0,
"has_invoice": true,
"id": 0,
"province": 0,
"province_abbreviation": "string",
"selected": true,
"zip": "string"
},
"email": "string",
"full_name": "string",
"id": 0,
"payment_method": {
"allow_preauthorize": true,
"brand": "string",
"ends": "string",
"expire": "string",
"pre_authorized": "yyyy-MM-dd'T'HH:mm:ss.SSSXXX",
"registered": "yyyy-MM-dd'T'HH:mm:ss.SSSXXX",
"state": "string"
},
"payment_method_id": 0,
"side": "RECIPIENT",
"type": "COMPANY",
"version": 0
}
],
"progress": [
{
"date": "yyyy-MM-dd'T'HH:mm:ss.SSSXXX",
"progress_step": "INITIATE_APPROVAL"
}
],
"send_on": "yyyy-MM-dd'T'HH:mm:ss.SSSXXX",
"transfer_number": "string",
"transfer_state": "DRAFT",
"transfer_type": "INCOMING",
"user_id": 0,
"uuid": "string",
"version": 0
}
{ } TransferResponseV2Model
amount
required
number
currency
required
string
description
optional
string
id
required
integer
send_on
optional
string
transfer_number
required
string
transfer_state
required
string
transfer_type
required
string
user_id
required
integer
uuid
required
string
version
required
integer
{ } FileV2Model
name
optional
string
url
optional
string
{ } FeeResponseV2Model
fee_id
optional
integer
fee_version
optional
integer
id
optional
integer
selected_company_fee_percent
optional
number
selected_customer_fee_percent
optional
number
{ } TransferParticipantV2Model
email
required
string
full_name
optional
string
id
required
integer
payment_method_id
optional
integer
side
required
string
type
required
string
version
optional
integer
{ } TransferProgressV2Model
date
optional
string
progress_step
required
string
<transfer_request_model>
<amount>1.01</amount>
<bank_account_from>0</bank_account_from>
<bank_account_to/>
<customer_info/>
<notes>string</notes>
<send_on>string</send_on>
<state>DRAFT</state>
<transfer_id>string</transfer_id>
<transfer_type>INCOMING</transfer_type>
</transfer_request_model>
{ } TransferRequestV2Model
amount
required
number
bank_account_from
optional
integer
notes
optional
string
send_on
optional
string
state
required
string
transfer_id
required
string
transfer_type
required
string
{ } BankV2Model
id
optional
integer
account_number
optional
string
branch
optional
string
institution
optional
string
routing_numbers
optional
string
{ } CCProfileApiV2Model
contract_email
optional
string
customer_id
optional
string
customer_name
optional
string
customer_since
optional
string
delete_billing_address_ids
optional
array
mobile_number
optional
string
phone_number
optional
string
<transfer_response_model>
<amount>1.01</amount>
<attachments>
<attachment>
<name>string</name>
<url>string</url>
</attachment>
<attachment>
<name>string</name>
<url>string</url>
</attachment>
</attachments>
<currency>AED</currency>
<description>string</description>
<fee_settings>
<fee_setting>
<fee_id>0</fee_id>
<fee_settings_template/>
<fee_version>0</fee_version>
<id>0</id>
<selected_company_fee_percent>1.01</selected_company_fee_percent>
<selected_customer_fee_percent>1.01</selected_customer_fee_percent>
</fee_setting>
<fee_setting>
<fee_id>0</fee_id>
<fee_settings_template/>
<fee_version>0</fee_version>
<id>0</id>
<selected_company_fee_percent>1.01</selected_company_fee_percent>
<selected_customer_fee_percent>1.01</selected_customer_fee_percent>
</fee_setting>
</fee_settings>
<id>0</id>
<participants>
<participant>
<address/>
<email>string</email>
<full_name>string</full_name>
<id>0</id>
<payment_method/>
<payment_method_id>0</payment_method_id>
<side>RECIPIENT</side>
<type>COMPANY</type>
<version>0</version>
</participant>
<participant>
<address/>
<email>string</email>
<full_name>string</full_name>
<id>0</id>
<payment_method/>
<payment_method_id>0</payment_method_id>
<side>RECIPIENT</side>
<type>COMPANY</type>
<version>0</version>
</participant>
</participants>
<progress>
<progress>
<date>yyyy-MM-dd'T'HH:mm:ss.SSSXXX</date>
<progress_step>INITIATE_APPROVAL</progress_step>
</progress>
<progress>
<date>yyyy-MM-dd'T'HH:mm:ss.SSSXXX</date>
<progress_step>INITIATE_APPROVAL</progress_step>
</progress>
</progress>
<send_on>yyyy-MM-dd'T'HH:mm:ss.SSSXXX</send_on>
<transfer_number>string</transfer_number>
<transfer_state>DRAFT</transfer_state>
<transfer_type>INCOMING</transfer_type>
<user_id>0</user_id>
<uuid>string</uuid>
<version>0</version>
</transfer_response_model>
{ } TransferResponseV2Model
amount
required
number
currency
required
string
description
optional
string
id
required
integer
send_on
optional
string
transfer_number
required
string
transfer_state
required
string
transfer_type
required
string
user_id
required
integer
uuid
required
string
version
required
integer
{ } FileV2Model
name
optional
string
url
optional
string
{ } FeeResponseV2Model
fee_id
optional
integer
fee_version
optional
integer
id
optional
integer
selected_company_fee_percent
optional
number
selected_customer_fee_percent
optional
number
{ } TransferParticipantV2Model
email
required
string
full_name
optional
string
id
required
integer
payment_method_id
optional
integer
side
required
string
type
required
string
version
optional
integer
{ } TransferProgressV2Model
date
optional
string
progress_step
required
string