Verify Payoneer Payments via API — Real-Time, Non-Custodial
Quick Answer: ShegerPay verifies Payoneer payments in under 5 seconds through one REST API call. The customer or marketplace sends funds to the merchant's Payoneer account, funds settle, and ShegerPay's webhook fires with payment.verified. ShegerPay never holds the funds — no merchant license required.
What is Payoneer?
Payoneer is a global payouts and cross-border payment platform that lets freelancers, marketplaces, and small businesses receive money from international clients in 190+ countries. Payoneer is one of the most-used international payment rails for Ethiopian freelancers, agencies, Upwork/Fiverr earners, and Amazon/eBay sellers.
How Payoneer verification works with ShegerPay
- Customer or marketplace sends funds to the merchant's Payoneer account (USD/EUR receiving accounts, billing service, or P2P)
- Payoneer settles the transfer and emits a payment ID
- Merchant backend POSTs to
/api/v1/verifywithprovider=payoneerand the Payoneer payment ID - ShegerPay calls Payoneer's payment-status API, returns
verified=truewith payer, amount, currency, then fires the webhook
Code example
curl -X POST https://api.shegerpay.com/api/v1/verify \
-H "X-API-Key: sk_test_demo" \
-H "Content-Type: application/json" \
-d '{"provider":"payoneer","transaction_id":"PO-2026-AB12CD","amount":250,"currency":"USD"}'
import ShegerPay from '@shegerpay/sdk';
const sp = new ShegerPay('sk_test_demo');
const result = await sp.verify({
provider: 'payoneer',
transactionId: 'PO-2026-AB12CD',
amount: 250,
currency: 'USD'
});
from shegerpay import ShegerPay
sp = ShegerPay('sk_test_demo')
result = sp.verify(provider='payoneer', transaction_id='PO-2026-AB12CD', amount=250, currency='USD')
$sp = new ShegerPay\Client('sk_test_demo');
$result = $sp->verify([
'provider' => 'payoneer',
'transaction_id' => 'PO-2026-AB12CD',
'amount' => 250,
'currency' => 'USD'
]);
Payoneer-specific features
- Receiving Accounts — verify payments to your Payoneer USD/EUR/GBP receiving account details
- Billing Service — verify Payoneer billing-service invoice payments from clients
- Marketplace payouts — verify payouts from Upwork, Fiverr, Amazon, Airbnb, etc., that land in Payoneer
- Multi-currency — ShegerPay returns native + ETB-converted amount
- Sandbox-friendly — works with Payoneer sandbox payment IDs out of the box
Why ShegerPay for Payoneer
- Non-custodial — funds settle directly to your Payoneer account
- No merchant license required
- 3–5 second verification on the Payoneer API
- Free tier includes Payoneer
- Works with WooCommerce plugin out of the box
- HMAC-SHA256 webhook signatures
- 12 official SDKs
Pricing for Payoneer verification
- Free: 100 verifications/month
- Startup ($9/mo): 2,000 verifications
- Business ($29/mo): 10,000 verifications + crypto
- Enterprise: custom
Comparison
| Feature | ShegerPay | Chapa | Arifpay | Manual |
|---|---|---|---|---|
| Payoneer supported | Yes | No | No | Yes |
| Marketplace payouts | Yes | No | No | Yes |
| Multi-currency | Yes | No | No | — |
| Non-custodial | Yes | No | No | — |
| Verification time | 3–5s | — | — | Minutes |
FAQ
How fast is Payoneer verification with ShegerPay? 3–5 seconds typical.
Do I need a Payoneer business account? A Payoneer freelancer or business account both work for receiving. Business unlocks higher limits and API access.
Can I verify a marketplace payout (Upwork, Fiverr) that hits Payoneer? Yes — pass the Payoneer payment ID; ShegerPay surfaces the originating marketplace in the response.
Does ShegerPay hold Payoneer funds? No — funds settle directly to your Payoneer account.
Is there a sandbox/demo for Payoneer?
Yes — use sk_test_demo with a Payoneer sandbox payment ID. No signup required.
What happens if Payoneer verification fails?
API returns verified=false with reason: not_found, pending, rejected, or amount_mismatch.
Related: Pricing · Docs · Verify PayPal · Verify Wise
Contact: [email protected] · +251 998 169 242