Step 3 - Settle a payment

This step confirms the transaction, after which we will send the payment order to the paying bank.

The only parameter not mandatory to consider is 'WebHookUrl'; this URL is used to post notifications about the payment status.

Payment status can be retrieved in two ways: by using a webhook or by executing the 'get payment' method. It is advisable to implement both methods.

API Call

Submit the transaction

post

Required scopes

This endpoint requires the following scopes:

• : MoneyTransfer API
• : Support API

Authorizations

oauth2-client-credentials & oauth2-implicit

OAuth2clientCredentialsRequired

Token URL:

OAuth2implicitRequired

Authorization URL:

Path parameters

idstring · uuidRequired

Identifier.

Body

application/json-patch+jsonapplication/jsonapplication/*+json

webHookUrlstringOptional

Responses

200

If the Payment was settled

application/json

idstring · uuidOptional

typestring · enumOptionalPossible values:

createdAtstring · date-timeOptional

quoteIdstring · uuidOptional

payerIdinteger · int32Optional

debitAmountnumber · doubleOptional

debitCurrencystringOptional

fxRatenumber · doubleOptional

amountnumber · doubleOptional

currencystringOptional

collectMethodstring · enumOptionalPossible values:

referenceIdstringOptional

statusstring · enumOptionalPossible values:

subStatestring · enumOptionalPossible values:

lockDeclineReasonstringOptional

lockDeclineDescriptionstringOptional

reverseReasonstringOptional

payerPaymentCodestringOptional

transactionIdinteger · int32Optional

lockedAtstring · date-timeOptional

lockDeclinedAtstring · date-timeOptional

expiredAtstring · date-timeOptional

settledAtstring · date-timeOptional

forwardedAtstring · date-timeOptional

awaitingCollectionSincestring · date-timeOptional

completedAtstring · date-timeOptional

reversedAtstring · date-timeOptional

liquidityErrorbooleanOptional

invoiceUrlstringOptional

400

If the request body is not correct

401

Unauthorized

402

If the balance is insufficient

403

Forbidden

404

If the id don't exists

409

If the Payment was already settled

412

If the Payment wan't locked

post

/api/Payments/{id}/Settle

HTTPcURLJavaScriptPython

POST /api/Payments/{id}/Settle HTTP/1.1
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json-patch+json
Accept: */*
Content-Length: 119

{
  "webHookUrl": "text",
  "ledgerInfo": {
    "crytoNetworkCode": "text",
    "cryptoCurrencyName": "text",
    "cryptoTransactionId": "text"
  }
}

application/json-patch+jsonapplication/jsonapplication/*+json

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "type": "C2C",
  "createdAt": "2026-04-02T18:56:32.030Z",
  "quoteId": "123e4567-e89b-12d3-a456-426614174000",
  "payerId": 1,
  "debitAmount": 1,
  "debitCurrency": "text",
  "fxRate": 1,
  "amount": 1,
  "currency": "text",
  "collectMethod": "CASH_PICKUP",
  "referenceId": "text",
  "userInfo": {
    "Dbtr": {
      "StrdNm": {
        "FirstNm": "text",
        "LastNm": "text"
      },
      "PstlAdr": {
        "Ctry": "text",
        "CtrySubDvsn": "text",
        "TwnNm": "text",
        "AdrLine": "text",
        "PstCd": "text"
      },
      "Id": {
        "PrvtId": {
          "Othr": {
            "Id": "text",
            "Issr": "text",
            "SchmeNm": {
              "Cd": "ARNU",
              "Prtry": "text"
            }
          },
          "DtAndPlcOfBirth": {
            "BirthDt": "text",
            "CtryOfBirth": "text"
          }
        },
        "OrgId": {
          "Othr": {
            "Id": "text",
            "Issr": "text",
            "SchmeNm": {
              "Cd": "ARNU",
              "Prtry": "text"
            }
          }
        }
      },
      "CtctDtls": {
        "EmailAdr": "text",
        "PhneNb": "text",
        "Othr": "text"
      },
      "Nm": "text"
    },
    "Cdtr": {
      "StrdNm": {
        "FirstNm": "text",
        "LastNm": "text"
      },
      "PstlAdr": {
        "Ctry": "text",
        "CtrySubDvsn": "text",
        "TwnNm": "text",
        "AdrLine": "text",
        "PstCd": "text"
      },
      "Id": {
        "PrvtId": {
          "Othr": {
            "Id": "text",
            "Issr": "text",
            "SchmeNm": {
              "Cd": "ARNU",
              "Prtry": "text"
            }
          },
          "DtAndPlcOfBirth": {
            "BirthDt": "text",
            "CtryOfBirth": "text"
          }
        }
      },
      "CtctDtls": {
        "EmailAdr": "text",
        "PhneNb": "text",
        "Othr": "text"
      }
    },
    "CdtrAgt": {
      "FinInstnId": {
        "BICFI": "text"
      },
      "BrnchId": {
        "Id": "text"
      }
    },
    "CdtrAcct": {
      "Id": {
        "Othr": {
          "Id": "text"
        }
      },
      "Tp": {
        "Cd": "SVGS"
      }
    },
    "Purp": {
      "Prtry": "FAMILY_SUPPORT"
    },
    "InstForCdtrAgt": {
      "InstrInf": "text"
    },
    "PmtId": {
      "TxId": "text"
    }
  },
  "status": "CREATED",
  "subState": "FORWARDED",
  "lockDeclineReason": "text",
  "lockDeclineDescription": "text",
  "reverseReason": "text",
  "withholdingPercentages": {
    "vatWithholdingPercentage": 1,
    "incomeWithholdingPercentage": 1,
    "vatWithholdingReceiptUrl": "text",
    "incomeWithholdingReceiptUrl": "text"
  },
  "payerPaymentCode": "text",
  "transactionId": 1,
  "lockedAt": "2026-04-02T18:56:32.030Z",
  "lockDeclinedAt": "2026-04-02T18:56:32.030Z",
  "expiredAt": "2026-04-02T18:56:32.030Z",
  "settledAt": "2026-04-02T18:56:32.030Z",
  "forwardedAt": "2026-04-02T18:56:32.030Z",
  "awaitingCollectionSince": "2026-04-02T18:56:32.030Z",
  "completedAt": "2026-04-02T18:56:32.030Z",
  "reversedAt": "2026-04-02T18:56:32.030Z",
  "liquidityError": true,
  "invoiceUrl": "text"
}