Assign Transfer Balance to Payout Transaction

Transfer balance can be assigned to a payout transaction with the endpoint POST /api/v2/Payment/Transactions/{id}/AssignTransferBalance:

Request
POST /api/v2/Payment/Transactions/PCI_HDQ7OE0OP16SJUOFW40Q5VPHNPNOU0/AssignTransferBalance HTTP/1.1
Host: testing.secupay-ag.de
Authorization: Bearer qb56tjj1bcvo9n2nj4u38k84lo
Accept: application/json

If everything is fine, the API responds with 200 OK, and the updated Payment Transaction:

Response
HTTP/1.1 200 OK
Content-Type: application/json  {
"object": "payment.transactions",
"id": "PCI_H9JPOR1NOI1ZZCYMEA63IMTBQ5V1VK",
"merchant": {
"object": "general.merchants",
"id": "MRC_4NPG1WLFJLI1JKISHA5EWRP37ME9UE",
// ...
},
"related_transactions": [
{
"object": "payment.transactions",
"id": "PCI_WEYR9NZOKWFJ0CEMRHQOGQAYSZUAWC",
"merchant": {
"object": "general.merchants",
"id": "MRC_M5IE5RQMHDJRWZ13Y90WH9ZSPHAT18",
// ...
},
"platform": {
"object": "general.merchants",
"id": "MRC_4NPG1WLFJLI1JKISHA5EWRP37ME9UE"
},
"parents": [
{
"object": "payment.transactions",
"id": "PCI_H9JPOR1NOI1ZZCYMEA63IMTBQ5V1VK",
"ref_type_id": 75,
"trans_id": 74593084
}
],
"related_transactions": [
{
"object": "payment.transactions",
"id": "PCI_H9JPOR1NOI1ZZCYMEA63IMTBQ5V1VK",
"hierarchy": "parent",
"ref_type_id": 75,
"ref_type_raw": "API Auszahlung",
"trans_id": 74593084
}
],
"store_name": null,
"trans_id": 74593085,
"product_id": 401,
"product": "Stakeholder collection",
"product_raw": "Transfer Überweisung",
"zahlungsmittel_id": 4154893,
"contract_id": 1367481,
"amount": 1247501,
"currency": "EUR",
"created": "2023-08-28T08:58:27+02:00",
"completion_date": "2023-08-30T11:33:17+02:00",
"updated": "2023-08-30T11:33:17+02:00",
"description": "Test",
"description_raw": "Test",
"status": 17,
"status_text": "ausgezahlt",
"details": {
"cleared": "cleared",
"status": 17,
"status_text": "ausgezahlt",
"status_simple": 1,
"status_simple_text": "accepted",
"amount": 1247501,
"description": "Test",
"description_raw": "Test"
},
"customer": {
"salutation": "Herr",
"forename": "Max",
"surname": "Mustermann",
"name": "Max Mustermann",
// ...
},
"incoming_payment_date": null,
"tid": null,
"payment_data": "DE12 XXXX XXXX XXXX XX56 78",
"invoice_number": null,
"payout_date": "2023-08-30T11:33:17+02:00",
"account_owner": "MAX MUSTERMANN",
"incoming_payment_purpose": "",
"incoming_payment_iban": "DE49668416460619927521",
"incoming_payment_bic": "WELADED1BOC",
"hierarchy": "child",
"ref_type_id": 75,
"ref_type_raw": "API Auszahlung"
},
// ...
],
"store_name": null,
"trans_id": 74593084,
"product_id": 402,
"product": "API initiierte Auszahlung",
"product_raw": "API initiierte Auszahlung",
"zahlungsmittel_id": 0,
"contract_id": 855573,
"amount": 9442503,
"currency": "EUR",
"created": "2023-08-28T08:58:27+02:00",
"completion_date": "2023-08-24T00:00:00+02:00",
"updated": "2023-08-28T08:59:00+02:00",
"description": "Test",
"description_raw": "Test",
"status": 6,
"status_text": "abgeschlossen",
"details": {
"cleared": "open",
"status": 6,
"status_text": "abgeschlossen",
"status_simple": 1,
"status_simple_text": "accepted",
"amount": 9442503,
"description": "Test",
"description_raw": "Test"
},
"incoming_payment_date": null,
"tid": null,
"payment_data": null,
"invoice_number": null,
"payout_date": "2023-08-30T11:33:17+02:00",
"account_owner": null,
"incoming_payment_purpose": "",
"incoming_payment_iban": null,
"incoming_payment_bic": null
}

The transaction changes to status “abgeschlossen” (“completed”; status ID 6), when the assignment was successful.