POST/transactions/{userId}/cross-border/confirm-quote

Confirm Quote

Confirms and executes a cross-border payment using a previously obtained FX quote.

Path variables

Field	Type	Required	Possible values	Description
`userId`	string	Required	—	Unique user ID.

Headers

Field	Type	Required	Possible values	Description
`session-token`	string	Required	—	SessionToken obtained from the Create GMA Session endpoint. All secured endpoints require this header.

Request body

Field	Type	Required	Possible values	Description
`InstrumentId`	string	Required	—	Cross-border instrument ID.
`CounterpartyId`	string	Required	—	Counterparty ID.
`DestinationAmount`	number	Required	—	Destination amount to send.
`FeeAmount`	number	Required	—	Fee amount agreed upon in the quote.
`PayerInfo`	object	Optional	{ sender_receiver_model: B2C \| B2B, payer_id }	Payer model info: sender_receiver_model and payer_id.
`RateInfo`	object	Optional	{ destination_currency }	Rate info: destination_currency.
`ProviderName`	string	Optional	convera	FX provider name.

Example request

{
  "InstrumentId": "{{instrumentId}}",
  "CounterpartyId": "{{counterpartyId}}",
  "DestinationAmount": 1000,
  "FeeAmount": 10,
  "PayerInfo": {
    "sender_receiver_model": "B2C",
    "payer_id": "1808"
  },
  "RateInfo": {
    "destination_currency": "EUR"
  },
  "ProviderName": "convera"
}

{
  "InstrumentId": "{{instrumentId}}",
  "CounterpartyId": "{{counterpartyId}}",
  "DestinationAmount": 1000,
  "FeeAmount": 10,
  "PayerInfo": {
    "sender_receiver_model": "B2C",
    "payer_id": "1808"
  },
  "RateInfo": {
    "destination_currency": "EUR"
  },
  "ProviderName": "convera"
}

Response

Field	Type	Possible values	Description
`ResponseCode`	integer	200 \| 201 \| 204 \| 301 \| 400 \| 401 \| 403 \| 404 \| 410 \| 422 \| 500 \| 503	API result code in the response envelope. Indicates success or the error category (e.g. 200 success, 400 bad request, 401 unauthorized).
`ResponseMessage`	string	Success \| Created \| NoContent \| BadRequest \| Unauthorized \| Forbidden \| NotFound \| Gone \| UnprocessableContent \| ServerError \| ResourceMoved \| ServiceUnAvailable \| UnProcessableEntity	Human-readable label paired with ResponseCode (e.g. Success, BadRequest, Unauthorized). Use with ResponseCode to interpret the outcome.
`ResponseData`	object	Please refer to below example for response body	Confirmed cross-border payment transaction details.

Example response

{
  "ResponseCode": 200,
  "ResponseMessage": "Success",
  "ResponseData": {
    "DestinationAmount": "1000",
    "DestinationCurrency": "EUR",
    "SourceAmount": "1147.14",
    "SourceCurrency": "USD",
    "FeeAmount": "10",
    "TotalAmount": "1157.14",
    "FxRate": "1.147140",
    "QuoteInfo": {
      "transaction_type": "B2C",
      "destination": {
        "currency": "EUR",
        "amount": 1000
      },
      "source": {
        "currency": "USD",
        "country_iso_code": "USA",
        "amount": 1147.14,
        "actual_amount": 1138.6
      },
      "wholesale_fx_rate": 1.1386,
      "fx_rate": 1.1471395000000002
    },
    "Balance": "47944.75"
  }
}

{
  "ResponseCode": 200,
  "ResponseMessage": "Success",
  "ResponseData": {
    "DestinationAmount": "1000",
    "DestinationCurrency": "EUR",
    "SourceAmount": "1147.14",
    "SourceCurrency": "USD",
    "FeeAmount": "10",
    "TotalAmount": "1157.14",
    "FxRate": "1.147140",
    "QuoteInfo": {
      "transaction_type": "B2C",
      "destination": {
        "currency": "EUR",
        "amount": 1000
      },
      "source": {
        "currency": "USD",
        "country_iso_code": "USA",
        "amount": 1147.14,
        "actual_amount": 1138.6
      },
      "wholesale_fx_rate": 1.1386,
      "fx_rate": 1.1471395000000002
    },
    "Balance": "47944.75"
  }
}

Requires `session-token: {SessionToken}` from Create GMA Session. Use the same client IP as authentication.