Payout Request (Internal Transfer)

Request

URL

[POST] /api/v1/transfer/internal

Headers

Content-Type: application/json
x-client-id: <client_id>
x-signature: <signature>
x-timestamp: <timestamp>

Body

variable	condition	type	description
account_id	required	string	Account bank number
amount	required	float	min=0,max=1000000000
to_account_id	required	string	To VA account bank number
currency_code	required	string	VND/USD
note	optional	string

📘

Please refer session Common > Bank List to get Bank code

Response

Headers

Content-Type: application/json

Body

Name	Type	Description
id	string	payment id
status	string	waiting_confirm,processing,success
reference_id	string	Reference ID
bank_payment_number	string	Bank payment number
remaining_try	int	Beneficiary account number

Errors

Status	Messsage
201	Success
401	Unauthorized

Example

URL

[POST] /api/v1/transfer/internal

Request

Body

{
    "account_id": "81981386-f480-4ff8-ba27-ff921779fb16",
    "amount": 938000,
    "to_account_id": "72780f7f-bad9-46c0-8ef0-c3320affb430",
    "currency_code": "VND",
    "is_internal_transfer": true,
    "note": "[Open API] note for external transfer",
    "user_id": "bf86cfd4-39c6-4c88-9b4c-0fb0b93610bf"
}

Response

Body

{
  "message": {
    "content": "Bạn vừa thực hiện tạo thành công %s"
  },
  "code": 102001,
  "request_id": "f3fe9810-c9a9-4f56-93b1-b54ef6dbcac8",
  "data": {
    "id": "a5ab9910-cdc8-4b6b-a5aa-0d3ffd72f34e",
    "status": "Success",
    "reference_id": "REF123456789",
    "bank_payment_number": "BPN987654321",
    "remaining_try": 2
  }
}