Confirm a Beneficiary Import

Materializes beneficiaries for every row that passed preview validation. Invalid rows from the preview phase are skipped. Rows that pass preview but fail at create time (duplicate identity, vault failure, etc.) are reported in errors[].

The import row is marked confirmed once this call completes — even on partial failure. To re-run a subset, edit the source CSV and upload a fresh import.

Requires an Idempotency-Key header.

POST

beneficiaries

import

{importID}

confirm

Confirm a beneficiary import

curl --request POST \
  --url https://api.antonpayments.com/v1/beneficiaries/import/{importID}/confirm \
  --header 'Authorization: Bearer <token>' \
  --header 'DPoP: <api-key>' \
  --header 'Idempotency-Key: <idempotency-key>'

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    DPoP: '<api-key>'
  }
};

fetch('https://api.antonpayments.com/v1/beneficiaries/import/{importID}/confirm', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.antonpayments.com/v1/beneficiaries/import/{importID}/confirm",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "DPoP: <api-key>",
    "Idempotency-Key: <idempotency-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.antonpayments.com/v1/beneficiaries/import/{importID}/confirm"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Idempotency-Key", "<idempotency-key>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("DPoP", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "data": {
    "import_id": "<string>",
    "summary": {
      "created": 123,
      "skipped": 123,
      "failed": 123
    },
    "created_ids": [
      "<string>"
    ],
    "errors": [
      {
        "row_number": 123,
        "error": "<string>"
      }
    ]
  }
}

Authorizations

DPoP

string

header

required

Per-request DPoP proof JWT (RFC 9449). MUST accompany the Authorization: DPoP <access_token> header on every protected operation. The proof is signed by the merchant's private DPoP key and carries htm, htu, iat, jti, and ath claims.

Headers

Idempotency-Key

string

required

Unique key identifying this operation. Sending the same key twice returns the original response instead of creating a duplicate. Keys are retained for 24 hours.

Maximum string length: 255

Path Parameters

importID

string

required

Pattern: ^imp_[a-zA-Z0-9]+$

Response

Confirm completed.

data

object

Result of POST /v1/beneficiaries/import/{import_id}/confirm.

Show child attributes

⌘I

Confirm a beneficiary import

curl --request POST \
  --url https://api.antonpayments.com/v1/beneficiaries/import/{importID}/confirm \
  --header 'Authorization: Bearer <token>' \
  --header 'DPoP: <api-key>' \
  --header 'Idempotency-Key: <idempotency-key>'

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    DPoP: '<api-key>'
  }
};

fetch('https://api.antonpayments.com/v1/beneficiaries/import/{importID}/confirm', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.antonpayments.com/v1/beneficiaries/import/{importID}/confirm",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "DPoP: <api-key>",
    "Idempotency-Key: <idempotency-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.antonpayments.com/v1/beneficiaries/import/{importID}/confirm"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Idempotency-Key", "<idempotency-key>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("DPoP", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "data": {
    "import_id": "<string>",
    "summary": {
      "created": 123,
      "skipped": 123,
      "failed": 123
    },
    "created_ids": [
      "<string>"
    ],
    "errors": [
      {
        "row_number": 123,
        "error": "<string>"
      }
    ]
  }
}

Overview

Cross-Cutting

Reference Data

Beneficiaries

Instruments

Intelligence

Verifications

Payouts

Batches

Balances

Accounts

Webhooks

Pricing

FX

Corridors

Confirm a Beneficiary Import

Authorizations

Headers

Path Parameters

Response