Global Account › API Reference › Remittance Orders

Submit a personal remittance (POBO) account application

POST /v1/remit/vp/applications scope: remittances:write

On behalf of a member · x-on-behalf-of required Requires x-idempotency-key

The personal line requires an active upstream subaccount belonging to the member. Without it, ordering returns remit_vp_account_required. This endpoint starts its activation process.

Prerequisites

Member’s L1 approved
Member’s L2 approved
Member has no personal-line subaccount already opened

Field	Type	Required	Description
`x-on-behalf-of`	string	Required	Member for whom the application is submitted.
`x-idempotency-key`	string	Required	UUID v4。

Request Body

No fields. The member is determined entirely by x-on-behalf-of.

Response

200Already under review: returns the same application with reused: true.

{
  "id": "vpa_12",
  "status": "reviewing",
  "reused": true
}

201Submitted

{
  "id": "vpa_12",
  "status": "reviewing"
}

400kyc_required: L1 or L2 missing, without distinguishing which. · state_invalid: account already opened or account agreement not yet configured.

403insufficient_scope: missing remittances:write

404member_not_found

Additional Details

Application ≠ account opening

This only submits an application. Our operations team performs actual account opening, creating an irreversible upstream entity: the upstream has neither delete nor update/resubmit endpoints. That step is outside your control and is not automatically triggered by calling this endpoint.

Prerequisites: both L1 and L2 approved

Missing either returns kyc_required, without identifying which level is missing. Inspect level and l2_status in GET /v1/kyc.

Repeated submission is safe

An application already under review returns the same application with 200 + reused: true, without queueing again. An account already opened returns 400 state_invalid.

Request

curl -X POST 'https://api.zinfra.vip/v1/remit/vp/applications' \
  -H 'x-auth-token: Bearer $TOKEN' \
  -H 'x-on-behalf-of: $MEMBER_ID' \
  -H 'x-idempotency-key: $IDEMPOTENCY_KEY' \
  -H 'content-type: application/json' \
  -d '{}'

const res = await fetch("https://api.zinfra.vip/v1/remit/vp/applications", {
  method: "POST",
  headers: {
    "x-auth-token": "Bearer $TOKEN",
    "x-on-behalf-of": "$MEMBER_ID",
    "x-idempotency-key": "$IDEMPOTENCY_KEY",
    "content-type": "application/json",
  },
  body: JSON.stringify({}),
});
// Keep monetary amounts as strings, never numbers.
const data = await res.json();

import requests

res = requests.post(
    "https://api.zinfra.vip/v1/remit/vp/applications",
    headers={
        "x-auth-token": "Bearer $TOKEN",
        "x-on-behalf-of": "$MEMBER_ID",
        "x-idempotency-key": "$IDEMPOTENCY_KEY",
        "content-type": "application/json",
    },
    json={},
)
# Use Decimal(str(...)) for amounts, not float.
data = res.json()

req, _ := http.NewRequest("POST", "https://api.zinfra.vip/v1/remit/vp/applications",
    strings.NewReader(`{}`))
req.Header.Set("x-auth-token", "Bearer $TOKEN")
req.Header.Set("x-on-behalf-of", "$MEMBER_ID")
req.Header.Set("x-idempotency-key", "$IDEMPOTENCY_KEY")
req.Header.Set("content-type", "application/json")
res, err := http.DefaultClient.Do(req)
// Decode amount fields as string, not float64.

HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://api.zinfra.vip/v1/remit/vp/applications"))
    .header("x-auth-token", "Bearer $TOKEN")
    .header("x-on-behalf-of", "$MEMBER_ID")
    .header("x-idempotency-key", "$IDEMPOTENCY_KEY")
    .header("content-type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("""
{}
"""))
    .build();
// Use String / BigDecimal for amounts, not double.

$ch = curl_init('https://api.zinfra.vip/v1/remit/vp/applications');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'x-auth-token: Bearer $TOKEN',
    'x-on-behalf-of: $MEMBER_ID',
    'x-idempotency-key: $IDEMPOTENCY_KEY',
    'content-type: application/json',
  ],
  CURLOPT_POSTFIELDS => <<<'JSON'
{}
JSON,
]);
$res = curl_exec($ch);
// Use bcmath / strings for amounts, not floatval.

200

{
  "id": "vpa_12",
  "status": "reviewing",
  "reused": true
}