YfpayYfpay
  • Introduction
  • Signing API requests
  • Receive money
  • Get a transaction for receive money
  • Webhook for receive money
  • Send money
  • Get a transaction for send money
  • Webhook for send money
  • Account Balance
  • All Channels
  • Responses
  • Brazil
  • China
  • India
  • Indonesia
  • Mexico
  • Nigeria
  • Philippines
  • South Africa
  • Thailand
  • Ukraine
  • Vietnam
  • Usdt
  • English
  • 简体中文
  • Introduction
  • Signing API requests
  • Receive money
  • Get a transaction for receive money
  • Webhook for receive money
  • Send money
  • Get a transaction for send money
  • Webhook for send money
  • Account Balance
  • All Channels
  • Responses
  • Brazil
  • China
  • India
  • Indonesia
  • Mexico
  • Nigeria
  • Philippines
  • South Africa
  • Thailand
  • Ukraine
  • Vietnam
  • Usdt
  • English
  • 简体中文
  • Reference

    • Countries
    • Brazil
    • China
    • India
    • Indonesia
    • Mexico
    • Nigeria
    • Philippines
    • South Africa
    • Thailand
    • Ukraine
    • Vietnam
    • Usdt

South Africa

Receive money

Channels for receive money

IDDescription
1046Banks in South Africa

Request example for receive money

curl -X POST \
  https://example.com/api/v1/trades \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "client_key": "01h6tn69wfcpy5q5x3vpb3x9me",
    "amount": "100.00",
    "channel_id": "1046",
    "out_trade_no": "20230101000000",
    "notify_url": "https://your-domain.com/webhook",
    "signature": "ba5df26991273c746960ce5238c6479e8ca6116381ac46cea96ffd30fafed082"
  }'
{
  "client_key": "01h6tn69wfcpy5q5x3vpb3x9me",
  "amount": "100.00",
  "trade_no": "100000012023072123389872",
  "out_trade_no": "20230101000000",
  "payment_url": "https://example.com/cashier",
  "created_at": "2023-01-01T01:01:01.000000Z"
}

Get a transaction for receive money

curl -X GET \
  https://example.com/api/v1/trades/20230101000000?client_key=01h6tn69wfcpy5q5x3vpb3x9me&signature=ba5df26991273c746960ce5238c6479e8ca6116381ac46cea96ffd30fafed082 \
  -H "Accept: application/json"
{
  "client_key": "01h6tn69wfcpy5q5x3vpb3x9me",
  "amount": "100.00",
  "trade_no": "100000012023072123389872",
  "out_trade_no": "1698896652712",
  "created_at": "2023-01-01T01:01:01.000000Z",
  "paid_at": "2023-01-01T01:02:03.000000Z",
  "status": 1
}

Send money

Channels for send money

IDDescription
5052Banks in South Africa

Extra parameter extra

extra

FieldRequiredDescription
bank_codeYesBank codes

Request example for send money

curl -X POST \
  https://example.com/api/v1/transfers \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "client_key": "01hcd0d0c2qh9wy5efm5sxrk38",
    "amount": "100.00",
    "channel_id": "5052",
    "out_transfer_no": "20230101000000",
    "notify_url": "https://your-domain.com/webhook",
    "payee_account": "1234567890",
    "payee_name": "Sammy Shark",
    "extra": "{\"bank_code\":\"10010\"}",
    "signature": "ba5df26991273c746960ce5238c6479e8ca6116381ac46cea96ffd30fafed082"
  }'
{
  "client_key": "01hcd0d0c2qh9wy5efm5sxrk38",
  "amount": "100.00",
  "transfer_no": "100000012023072123389872",
  "out_transfer_no": "20230101000000",
  "channel_id": "5052",
  "payee_account": "1234567890",
  "payee_name": "Sammy Shark",
  "created_at": "2023-01-01T01:01:01.000000Z"
}

Get a transaction for send money

curl -X GET \
  https://example.com/api/v1/transfers/20230101000000?client_key=01h6tn69wfcpy5q5x3vpb3x9me&signature=ba5df26991273c746960ce5238c6479e8ca6116381ac46cea96ffd30fafed082 \
  -H "Accept: application/json"
{
  "client_key": "01hcd0d0c2qh9wy5efm5sxrk38",
  "amount": "100.00",
  "transfer_no": "100000012023072123389872",
  "out_transfer_no": "20230101000000",
  "channel_id": "5052",
  "payee_account": "1234567890",
  "payee_name": "Sammy Shark",
  "created_at": "2023-01-01T01:01:01.000000Z",
  "paid_at": "2023-01-01T01:02:03.000000Z",
  "status": 1
}

Bank codes

extra.bank_code

Bank codeBank name
10010Absa
10011NedBank
10012Capitec
10013Standard
10014Fnb
10015African Bank
10016Bidvest Bank
10017Discovery
10018FirstRand Bank
10019Grindrod Bank
10020Imperial Bank
10021Investec Bank
10022Sasfin Bank
10023Ubank
10024TymeBank
10025Mercantile Bank
10026Albaraka Bank
10027HBZ Bank
10028Habib Overseas Bank
10029Wesbank
10030Rand Merchant Bank
10031Bank of Athens
10032Access Bank
Prev
Philippines
Next
Thailand