Remittance API
The Remittance API enables merchants to securely transfer funds to beneficiaries across supported financial institutions. It supports cross-currency transfers, reconciliation references, and metadata while keeping each transaction traceable.
Capabilities
- Initiate remittance transactions to supported recipients
- Handle source and destination currency transfers
- Attach references and metadata for reconciliation
- Integrate with account and institution verification flows
Authentication
Base URL:https://360pay-merchant-api.libertepay.com
Authorization:API_KEY
Content-Type:application/json
POST
/v1/payments/remittance1. Initiate Remittance
Initiates a remittance transfer to a supported recipient account with source and destination currency details.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| account_name | string | Yes | Name of the recipient account (should come from Name Verify). |
| account_number | string | Yes | Recipient account or wallet number. |
| amount | number | Yes | Amount to be sent to the recipient in transaction currency. |
| institution_code | string | Yes | Destination institution code. |
| transaction_id | string | Yes | Unique transaction identifier from the merchant. |
| transaction_currency | string | Yes | Destination currency for the beneficiary transfer. |
| currency | string | Yes | Source currency of funds. |
| reference | string | Yes | Narration or description for tracking and reconciliation. |
| currency_amount | number | Yes | Converted amount in source currency. |
| origin_country_code | string | Yes | Origin country code of the sender. |
| sender_name | string | Yes | Full name of sender. |
| meta_data | object | No | Optional custom key-value metadata for business context. |
Request Body
{
"account_name": "JOHN DOE",
"account_number": "0246089019",
"amount": 2220,
"institution_code": "300591",
"transaction_id": "DEST54454221417",
"transaction_currency": "GHS",
"currency": "USD",
"reference": "Transfer to John",
"currency_amount": 200,
"origin_country_code": "US",
"sender_name": "SANDRA DOE",
"meta_data": {
"sometimes": "another"
}
}Response Example
{
"code": "00",
"data": {
"transaction_id": "DEST54454221417",
"transaction_message": "Request Processed"
},
"msg": "Transaction initiated",
"status": "SUCCESS"
}