Create FX Pay Transfer (GQL)

post

https://api.cloud.mbanq.com/graphql ( For FX Pay Transfer)

Note: All the payment API's have the endpoint: /graphql

Use this API for initiating an FX Pay Transfer using the SWIFT network. You need to specify the account details of both the originator and recipient. An outgoing credit transaction can be initiated using this Payment Rail.

Please checkout the page at FX PAY to understand more about FX PAY Payment Rail.

During the lifecycle of a transfer, its status may undergo changes. Refer to the Transfer Status page at Transfer Status for detailed descriptions associated with each status.

The address information is available at Address Info

Note: All the payment API's have the endpoint: /payments

Body Params

Following are the details on the GraphQL fields :

Parameter	Description	Mandatory	Data Type	Example
paymentRail	The type of transfer.	Yes	String	`FXPAY`
paymentType	The payment type.	Yes	String	`CREDIT`
fxPayCreditorIdentifier	The identifier of the creditor.	Yes	String	`FXPAY://028/1321/1234567`
amount	The amount to be transferred.	Yes	Number	`1000.00`
correlationId	A unique identifier or correlation to avoid duplicate transfers.	Yes	String	`6B56xh4DxD5gmYzEjpuZn11dfsdfsd1f6B56xh4DxD5gmYzEjpuZn11dfsdfsd1f`
originator	The originator of the transfer.	Yes	String	`John Doe`
recipient	The recipient of the transfer.	Yes	String	`Jane Smith`
reference	The reference of the transfer.	Yes	String	`Invoice 123`
paymentRailMetaData	Additional metadata for the payment rail.	No	Object
fxHoldId	Unique identifier for the booked FX rate.	No	String	`dfc90253-8f36-4c57-9285-a29084e7b544`
destinationCurrency	The currency in which the payment is received.	No	String	`EUR`
destinationAmount	The amount to be received in the destination currency.	Yes	Float	74000.00
sourceCurrency	The currency in which the payment is made.	No	String	`USD`
fxRate	The exchange rate applied to the FX transaction.	No	Number	`82.668`
holdExpiryAt	The expiry timestamp for the FX hold.	No	String (ISO 8601)	`2025-03-13T05:30:21.509Z`
purposeCode	The code representing the purpose of the transaction.	No	String	`IR002`

Headers

tenantId

string

required

Defaults to z01j3e71zd6zkq908vyf5861a8

The ID of your banking instance visible in the MBANQ Console.