curl --request POST \
--url https://hpay-api.host-sl.com/api/v1/transactions/sync/mnm_ref_123 \
--header 'api-key: YOUR_API_KEY' \
--header 'secret-key: YOUR_SECRET_KEY'
from hostpay import HostPay
client = HostPay(api_key="YOUR_API_KEY", secret_key="YOUR_SECRET_KEY")
result = client.transactions.sync("mnm_ref_123")
print(result["status"])
import { HostPay } from "@hostpay/sdk";
const client = new HostPay({ apiKey: "YOUR_API_KEY", secretKey: "YOUR_SECRET_KEY" });
const result = await client.transactions.sync("mnm_ref_123");
console.log(result.status);
{
"status": "completed",
"transaction_id": "b1f2c3d4-...",
"message": "Transaction synced."
}
{
"detail": "Transaction not found"
}
Transactions
Sync Transaction
Trigger an immediate reconciliation sync for one of your transactions by its provider reference.
POST
/
api
/
v1
/
transactions
/
sync
/
{reference_id}
curl --request POST \
--url https://hpay-api.host-sl.com/api/v1/transactions/sync/mnm_ref_123 \
--header 'api-key: YOUR_API_KEY' \
--header 'secret-key: YOUR_SECRET_KEY'
from hostpay import HostPay
client = HostPay(api_key="YOUR_API_KEY", secret_key="YOUR_SECRET_KEY")
result = client.transactions.sync("mnm_ref_123")
print(result["status"])
import { HostPay } from "@hostpay/sdk";
const client = new HostPay({ apiKey: "YOUR_API_KEY", secretKey: "YOUR_SECRET_KEY" });
const result = await client.transactions.sync("mnm_ref_123");
console.log(result.status);
{
"status": "completed",
"transaction_id": "b1f2c3d4-...",
"message": "Transaction synced."
}
{
"detail": "Transaction not found"
}
Fetches the latest provider status for a transaction and reconciles it immediately — instead of waiting for the next scheduled reconciliation run. Call it from your backend right after a payment completes for instant post-payment status.
Scoped to your application and the calling key’s mode (test/live); it cannot touch other merchants’ data.
Path Parameters
string
required
The provider reference ID of the transaction to sync (e.g. the Monime payment reference).
Response
{
"status": "completed",
"transaction_id": "b1f2c3d4-...",
"message": "Transaction synced."
}
{
"detail": "Transaction not found"
}
curl --request POST \
--url https://hpay-api.host-sl.com/api/v1/transactions/sync/mnm_ref_123 \
--header 'api-key: YOUR_API_KEY' \
--header 'secret-key: YOUR_SECRET_KEY'
from hostpay import HostPay
client = HostPay(api_key="YOUR_API_KEY", secret_key="YOUR_SECRET_KEY")
result = client.transactions.sync("mnm_ref_123")
print(result["status"])
import { HostPay } from "@hostpay/sdk";
const client = new HostPay({ apiKey: "YOUR_API_KEY", secretKey: "YOUR_SECRET_KEY" });
const result = await client.transactions.sync("mnm_ref_123");
console.log(result.status);