Confirm a Batch

POST/batches/{batchId}/confirm

This endpoint will confirm the batch and send all Transfers to providers.

Path Parameters

batchIdstringrequired

Body application/json

The method to use to pay the transfer. If payment_method was specified when creating the transfer (quote time), the same value must be provided here — otherwise the request will be rejected with invalid.payment_method.

success_urlstring

Webpage to redirect the customer to on successful payment. We inject some information into the URL as URL parameters.

cancel_urlstring

Webpage to redirect the customer to on cancelled payment. We inject some information into the URL as URL parameters.

amount_to_paynumber

the amount to pay in the sending currency of the transfer

the cryptocurrency used to pay

card_idstring<uuid>

Response

The Batch has been confirmed by the Merchant.

idstring<uuid>

Batch Identifier

external_idstring

Batch Reference provided by API caller

Batch Status

reasonobject[]

Show reason properties

csvLinenumber

CSV line number for the Batch error

messageobject[]

The error message

Show message properties

messagestring

errorsobject[]

Show errors properties

errorCodestring

messagestring

paymentobject

Payment

Show payment properties

idstring<uuid>

Payment Identifier

statusstring

Payment status

reasonstring<uuid>

Failed/Declined Reason

urlstring

CDN of payment page

crypto_addressstring

Cryptocurrency token address

crypto_currencystring

Cryptocurrency value

crypto_networkstring

The blockchain to use to pay

expires_atstring<date-time>

The expiration of the address

card_issuer_countrystring

The issuer country of card if payment is made via card

reference_numberstring

Payment reference number

ibanstring

IBAN

total_transfersnumber

Total number of transfers in the batch

total_sending_amountobject[]

Show total_sending_amount properties

currencystring<iso-4217>

The currency

amountnumber<double>

The total amount for the currency

total_receiving_amountobject[]

Show total_receiving_amount properties

currencystring<iso-4217>

The currency

amountnumber<double>

The total amount for the currency

total_feesobject[]

Show total_fees properties

currencystring<iso-4217>

The currency

amountnumber<double>

The total amount for the currency

expires_atstring<date-time>

Creation Timestamp

created_atstring<date-time>

Creation Timestamp

updated_atstring<date-time>

Update Timestamp

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/batches/<batchId>/confirm" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer <token>" \ -d '{ "payment_method": "crypto_page", "success_url": "string", "cancel_url": "string", "amount_to_pay": 100, "cryptocurrency": "BTC", "card_id": "00000000-0000-0000-0000-000000000000" }'

const response = await fetch(`https://api.uat.triple-a.io/api/fiat-payout/v1/batches/${batchId}/confirm`, { method: 'POST', headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer <token>' }, body: JSON.stringify({ "payment_method": "crypto_page", "success_url": "string", "cancel_url": "string", "amount_to_pay": 100, "cryptocurrency": "BTC", "card_id": "00000000-0000-0000-0000-000000000000" }) }); const data = await response.json();

import requests response = requests.request( "POST", "https://api.uat.triple-a.io/api/fiat-payout/v1/batches/{batchId}/confirm", headers={ "Authorization": "Bearer <token>" }, json={ "payment_method": "crypto_page", "success_url": "string", "cancel_url": "string", "amount_to_pay": 100, "cryptocurrency": "BTC", "card_id": "00000000-0000-0000-0000-000000000000" }, ) data = response.json()

<?php $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, "https://api.uat.triple-a.io/api/fiat-payout/v1/batches/<batchId>/confirm"); 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, '{ "payment_method": "crypto_page", "success_url": "string", "cancel_url": "string", "amount_to_pay": 100, "cryptocurrency": "BTC", "card_id": "00000000-0000-0000-0000-000000000000" }'); $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/batches/<batchId>/confirm", strings.NewReader(`{ "payment_method": "crypto_page", "success_url": "string", "cancel_url": "string", "amount_to_pay": 100, "cryptocurrency": "BTC", "card_id": "00000000-0000-0000-0000-000000000000" }`)) 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/batches/<batchId>/confirm")) .header("Content-Type", "application/json") .header("Authorization", "Bearer <token>") .method("POST", HttpRequest.BodyPublishers.ofString("{\n \"payment_method\": \"crypto_page\",\n \"success_url\": \"string\",\n \"cancel_url\": \"string\",\n \"amount_to_pay\": 100,\n \"cryptocurrency\": \"BTC\",\n \"card_id\": \"00000000-0000-0000-0000-000000000000\"\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/batches/<batchId>/confirm") 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 \"payment_method\": \"crypto_page\",\n \"success_url\": \"string\",\n \"cancel_url\": \"string\",\n \"amount_to_pay\": 100,\n \"cryptocurrency\": \"BTC\",\n \"card_id\": \"00000000-0000-0000-0000-000000000000\"\n}" response = http.request(request) puts response.body

{ "id": "00000000-0000-0000-0000-000000000000", "external_id": "string", "status": "created", "reason": [ { "csvLine": 0, "message": [ { "message": "string", "errors": [ { "errorCode": null, "message": null } ] } ] } ], "payment": { "id": "00000000-0000-0000-0000-000000000000", "status": "string", "reason": "00000000-0000-0000-0000-000000000000", "url": "string", "crypto_address": "string", "crypto_currency": "string", "crypto_network": "string", "expires_at": "1970-01-01T00:00:00.000Z", "card_issuer_country": "USA", "reference_number": "MFB-870989-FPP", "iban": "FR7630006000011234567890189" }, "total_transfers": 0, "total_sending_amount": [ { "currency": "string", "amount": 0.001 } ], "total_receiving_amount": [ { "currency": "string", "amount": 0.001 } ], "total_fees": [ { "currency": "string", "amount": 0.001 } ], "expires_at": "1970-01-01T00:00:00.000Z", "created_at": "1970-01-01T00:00:00.000Z", "updated_at": "1970-01-01T00:00:00.000Z" }