momo-api-sdk/io.rekast.sdk.network.service.products/RemittanceService/cashTransfer

cashTransfer

@POST(value = "/remittance/{apiVersion}/cashtransfer")

abstract suspend fun cashTransfer(@Body cashTransfer: CashTransfer, @Path(value = "apiVersion") apiVersion: String, @Header(value = "Ocp-Apim-Subscription-Key") productSubscriptionKey: String, @Header(value = "X-Target-Environment") environment: String, @Header(value = "X-Reference-Id") uuid: String): Response<Unit>

Initiates a remittance cash transfer using the V2 endpoint, which supports extended KYC fields for cross-border compliance where the sender is not an MTN mobile money subscriber.

The request is accepted asynchronously; poll getCashTransferStatus with the same uuid as the reference ID to retrieve the final transaction outcome.

Return

A Response with an empty body; HTTP 202 indicates the transfer was accepted.

Parameters

cashTransfer

The cash transfer payload including recipient, amounts, and optional KYC fields.

apiVersion

The API version to target (e.g., v2_0).

productSubscriptionKey

The Ocp-Apim-Subscription-Key for the Remittance product.

environment

The target environment (e.g., sandbox or production).

uuid

A UUID V4 used as the X-Reference-Id to uniquely identify this request.