Create a Company

POST/companies

This endpoint allows API users to create a company which can be used as sender or recipient when making transfer.

Body application/json

external_idstring

native_registered_namestring

registered_namestring<string-without-emoji>required

trading_namestring<string-without-emoji>

registration_typestring

registration_numberstring

registration_datestring<date>

registration_expiry_datestring<date>

registration_countrystring<iso-3166-1-alpha3>

emailstring

phone_numberstring

native_addressstring

addressstring

country_codestring<iso-3166-1-alpha3>

zip_codestring

citystring

Residence city

province_statestring

Residence State/Province

mobile_numberstring

remarksstring

role"sender" | "recipient"

Role of the company

Business Nature

is_blockedboolean

Whether this sender entity is blocked for transfer operations. Managed by internal ops only.

Response

Created

idstring<uuid>

external_idstring

native_registered_namestring

registered_namestring

Company registered name

trading_namestring

Company trading name

registration_typestring

registration_numberstring

registration_datestring<date>

registration_expiry_datestring<date>

registration_countrystring<iso-3166-1-alpha3>

emailstring

phone_numberstring

native_addressstring

addressstring

country_codestring<iso-3166-1-alpha3>

zip_codestring

citystring

Residence city

province_statestring

Residence State/Province

mobile_numberstring

remarksstring

verification_status"none" | "missing" | "pending" | "failed" | "confirmed"

daily_quotanumber

monthly_quotanumber

yearly_quotanumber

quota_currencystring<iso-4217-ext>

Business Nature

created_atstring<date-time>

updated_atstring<date-time>

is_blockedboolean

Whether this sender entity is blocked for transfer operations. Managed by internal ops only.

Error defines errors may be returned from the system.

messagestring

errorsobject[]

Show errors properties

errorCodestring

messagestring

Error defines errors may be returned from the system.

messagestring

errorsobject[]

Show errors properties

errorCodestring

messagestring

Error defines errors may be returned from the system.

messagestring

errorsobject[]

Show errors properties

errorCodestring

messagestring

curl -X POST "https://api.uat.triple-a.io/api/fiat-payout/v1/companies" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer <token>" \ -d '{ "external_id": "my_user_millerinc01", "native_registered_name": "米勒", "registered_name": "Miller", "trading_name": "Miller Inc", "registration_type": "trade license", "registration_number": "001205682", "registration_date": "2021-02-16", "registration_expiry_date": "2021-02-16", "registration_country": "USA", "email": "[email protected]", "phone_number": "+13152455710", "native_address": "7950 路易斯路", "address": "7950 Lewis Rd", "country_code": "USA", "zip_code": "13305", "city": "New York City", "province_state": "New York", "mobile_number": "+13152455710", "remarks": "string", "role": "sender", "business_nature": "AGRICULTURE_FOOD_CROPS", "is_blocked": true }'

const response = await fetch(`https://api.uat.triple-a.io/api/fiat-payout/v1/companies`, { method: 'POST', headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer <token>' }, body: JSON.stringify({ "external_id": "my_user_millerinc01", "native_registered_name": "米勒", "registered_name": "Miller", "trading_name": "Miller Inc", "registration_type": "trade license", "registration_number": "001205682", "registration_date": "2021-02-16", "registration_expiry_date": "2021-02-16", "registration_country": "USA", "email": "[email protected]", "phone_number": "+13152455710", "native_address": "7950 路易斯路", "address": "7950 Lewis Rd", "country_code": "USA", "zip_code": "13305", "city": "New York City", "province_state": "New York", "mobile_number": "+13152455710", "remarks": "string", "role": "sender", "business_nature": "AGRICULTURE_FOOD_CROPS", "is_blocked": true }) }); const data = await response.json();

import requests response = requests.request( "POST", "https://api.uat.triple-a.io/api/fiat-payout/v1/companies", headers={ "Authorization": "Bearer <token>" }, json={ "external_id": "my_user_millerinc01", "native_registered_name": "米勒", "registered_name": "Miller", "trading_name": "Miller Inc", "registration_type": "trade license", "registration_number": "001205682", "registration_date": "2021-02-16", "registration_expiry_date": "2021-02-16", "registration_country": "USA", "email": "[email protected]", "phone_number": "+13152455710", "native_address": "7950 路易斯路", "address": "7950 Lewis Rd", "country_code": "USA", "zip_code": "13305", "city": "New York City", "province_state": "New York", "mobile_number": "+13152455710", "remarks": "string", "role": "sender", "business_nature": "AGRICULTURE_FOOD_CROPS", "is_blocked": True }, ) data = response.json()

<?php $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, "https://api.uat.triple-a.io/api/fiat-payout/v1/companies"); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST"); curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json", "Authorization: Bearer <token>"]); curl_setopt($ch, CURLOPT_POSTFIELDS, '{ "external_id": "my_user_millerinc01", "native_registered_name": "米勒", "registered_name": "Miller", "trading_name": "Miller Inc", "registration_type": "trade license", "registration_number": "001205682", "registration_date": "2021-02-16", "registration_expiry_date": "2021-02-16", "registration_country": "USA", "email": "[email protected]", "phone_number": "+13152455710", "native_address": "7950 路易斯路", "address": "7950 Lewis Rd", "country_code": "USA", "zip_code": "13305", "city": "New York City", "province_state": "New York", "mobile_number": "+13152455710", "remarks": "string", "role": "sender", "business_nature": "AGRICULTURE_FOOD_CROPS", "is_blocked": true }'); $response = curl_exec($ch); curl_close($ch);

package main import ( "fmt" "io" "net/http" "strings" ) func main() { req, _ := http.NewRequest("POST", "https://api.uat.triple-a.io/api/fiat-payout/v1/companies", strings.NewReader(`{ "external_id": "my_user_millerinc01", "native_registered_name": "米勒", "registered_name": "Miller", "trading_name": "Miller Inc", "registration_type": "trade license", "registration_number": "001205682", "registration_date": "2021-02-16", "registration_expiry_date": "2021-02-16", "registration_country": "USA", "email": "[email protected]", "phone_number": "+13152455710", "native_address": "7950 路易斯路", "address": "7950 Lewis Rd", "country_code": "USA", "zip_code": "13305", "city": "New York City", "province_state": "New York", "mobile_number": "+13152455710", "remarks": "string", "role": "sender", "business_nature": "AGRICULTURE_FOOD_CROPS", "is_blocked": true }`)) req.Header.Set("Content-Type", "application/json") req.Header.Set("Authorization", "Bearer <token>") resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() data, _ := io.ReadAll(resp.Body) fmt.Println(string(data)) }

HttpClient client = HttpClient.newHttpClient(); HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://api.uat.triple-a.io/api/fiat-payout/v1/companies")) .header("Content-Type", "application/json") .header("Authorization", "Bearer <token>") .method("POST", HttpRequest.BodyPublishers.ofString("{\n \"external_id\": \"my_user_millerinc01\",\n \"native_registered_name\": \"米勒\",\n \"registered_name\": \"Miller\",\n \"trading_name\": \"Miller Inc\",\n \"registration_type\": \"trade license\",\n \"registration_number\": \"001205682\",\n \"registration_date\": \"2021-02-16\",\n \"registration_expiry_date\": \"2021-02-16\",\n \"registration_country\": \"USA\",\n \"email\": \"[email protected]\",\n \"phone_number\": \"+13152455710\",\n \"native_address\": \"7950 路易斯路\",\n \"address\": \"7950 Lewis Rd\",\n \"country_code\": \"USA\",\n \"zip_code\": \"13305\",\n \"city\": \"New York City\",\n \"province_state\": \"New York\",\n \"mobile_number\": \"+13152455710\",\n \"remarks\": \"string\",\n \"role\": \"sender\",\n \"business_nature\": \"AGRICULTURE_FOOD_CROPS\",\n \"is_blocked\": true\n}")) .build(); HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body());

require "net/http" require "uri" uri = URI("https://api.uat.triple-a.io/api/fiat-payout/v1/companies") http = Net::HTTP.new(uri.host, uri.port) http.use_ssl = uri.scheme == "https" request = Net::HTTP::Post.new(uri) request["Content-Type"] = "application/json" request["Authorization"] = "Bearer <token>" request.body = "{\n \"external_id\": \"my_user_millerinc01\",\n \"native_registered_name\": \"米勒\",\n \"registered_name\": \"Miller\",\n \"trading_name\": \"Miller Inc\",\n \"registration_type\": \"trade license\",\n \"registration_number\": \"001205682\",\n \"registration_date\": \"2021-02-16\",\n \"registration_expiry_date\": \"2021-02-16\",\n \"registration_country\": \"USA\",\n \"email\": \"[email protected]\",\n \"phone_number\": \"+13152455710\",\n \"native_address\": \"7950 路易斯路\",\n \"address\": \"7950 Lewis Rd\",\n \"country_code\": \"USA\",\n \"zip_code\": \"13305\",\n \"city\": \"New York City\",\n \"province_state\": \"New York\",\n \"mobile_number\": \"+13152455710\",\n \"remarks\": \"string\",\n \"role\": \"sender\",\n \"business_nature\": \"AGRICULTURE_FOOD_CROPS\",\n \"is_blocked\": true\n}" response = http.request(request) puts response.body

{ "id": "00000000-0000-0000-0000-000000000000", "external_id": "my_user_millerinc01", "native_registered_name": "米勒", "registered_name": "Miller", "trading_name": "Miller Inc", "registration_type": "trade license", "registration_number": "001205682", "registration_date": "2021-02-16", "registration_expiry_date": "2021-02-16", "registration_country": "USA", "email": "[email protected]", "phone_number": "+13152455710", "native_address": "7950 路易斯路", "address": "7950 Lewis Rd", "country_code": "USA", "zip_code": "13305", "city": "New York City", "province_state": "New York", "mobile_number": "+13152455710", "remarks": "string", "verification_status": "none", "daily_quota": 100000, "monthly_quota": 200000, "yearly_quota": 500000, "quota_currency": "USD", "business_nature": "AGRICULTURE_FOOD_CROPS", "created_at": "1970-01-01T00:00:00.000Z", "updated_at": "1970-01-01T00:00:00.000Z", "is_blocked": true }