Fundtransfer

This API is used for making realtime transfer via Napas, Sacombank and eWallet in Vietnam (Momo,Zalo,VNPT,..)

Request

Good to know: Please press ">" to see detail.

This API is used for making realtime transfer via Napas, Sacombank and eWallet in Vietnam (Zalo,VNPT,..)

POST https://{SERVER}/Api/SBR/Fundtransfer

The result of proceeding transaction shall be responded immediately (without recalling API for checking status). In case transaction is failed, SBR will actively re-proceed. Afterward, Partner can call API CheckOrderStatus/GetOrderDetails for rechecking (for the case of Status =2)

Request Body

Name	Type	Description
AuthID*	Text	User ID assigned by SBR
ProtocolData*		Data request
Reference*	Text	ID of payment order
AgentID*	Text(20)	Assigned by SBR, AgentID=UserID=AuthID
CurrencyID*	Text(10)	Currency (USD; EUR; JPY; CAD; VND…)
OrderedAmt*	Number	Amount
Beneficiary*	Text(300)	Beneficiary name
Address*	Text(500)	Address of beneficiary name
Sender*	Text(300)	Sender name
SenderAddress*	Text(300)	Address of sender
SenderCountryID*	Text(20)	Sender country code
BankAcctNo*	Text(30)	Aaccount number of Beneficiary
BankName*	Text	Bank name of Beneficiary
BankGroup*	Text(1)	Bank mode Sacombank = 1 Napas= 3 Citad =4 eWallet = 7
AccType	Text	Type of account transferring Account Deposit = ACC Pan Depost = PAN Sacombank Pay = PAY ZaloPay = Zalo VNPTPay= VNPTPay
BankCode*	Text	BankCode of Method Sacombank / SacombankPay -> BankCode=303 Zalo -> BankCode=Zalo If VNPTPay -> BankCode=VNPTPay If NAPAS -> BankCode=BankCode of NAPAS, ex: 970406 - DongABank

200: OK Success

{
    // Response
}

401: Unauthorized Invalid username or password. Please try again!

406: Not Acceptable Require signature - Signature incorrect

Response Data

Parameters	Data Type	Description
Status	Number	Return status of request: Fail = 0 Success = 1 Processing = 2
Error Message	Text	Error description
ProtocolData	Object	List of payments has error

In case you receive a response "400 - Internal server error/Timeout", call the CheckOrderStatus or GetOrderDetail API to check the final status of the transaction. If the result is Payment not found, please re-send the new transaction or cancel on your side. If the result returns the status of the transaction => The transaction has been sent to SBR successfully and the status is compared according to the description of the API CheckOrderStatus or GetOrderDetail

Example: { "Status": 0, "Error": "400 - Internal server error/Timeout", }

Request Example

Sacombank Deposit with Account Number

// Request Sacmbank Deposit with Account Number
{
  "AuthID": "123",
  "ProtocolData": {
    "BankName": "Sacombank",
    "SenderAddress": "JAPAN",
    "Address": "Vietnam",
    "AccType": "ACC",
    "Reference": "REF123456",
    "SenderCountryID": "JP",
    "BankCode": "303",
    "CurrencyID": "VND",
    "OrderedAmt": "10000",
    "Sender": "NGUYEN VAN B",
    "BankAcctNo": "0909227275",
    "AgentID": "123",
    "BankGroup": "1",
    "Beneficiary": "NGUYEN VAN A"
  }
}

Sacombank Deposit with PAN Number

// Request Sacmbank Deposit with PAN Number
{
  "AuthID": "123",
  "ProtocolData": {
    "BankName": "Sacombank",
    "SenderAddress": "JAPAN",
    "Address": "Vietnam",
    "AccType": "PAN",
    "Reference": "REF123456",
    "SenderCountryID": "JP",
    "BankCode": "303",
    "CurrencyID": "VND",
    "OrderedAmt": "10000",
    "Sender": "NGUYEN VAN B",
    "BankAcctNo": "970403XXXXXXX",
    "AgentID": "123",
    "BankGroup": "1",
    "Beneficiary": "NGUYEN VAN A"
  }
}

Napas Deposit with PAN Number

// Request Napas Deposit with PAN Number
{
  "AuthID": "123",
  "ProtocolData": {
    "BankName": "DONG A BANK",
    "SenderAddress": "JAPAN",
    "Address": "Vietnam",
    "AccType": "PAN",
    "Reference": "REF123456",
    "SenderCountryID": "JP",
    "BankCode": "970406",
    "CurrencyID": "VND",
    "OrderedAmt": "10000",
    "Sender": "NGUYEN VAN B",
    "BankAcctNo": "970406xxxxxxxxx",
    "AgentID": "123",
    "BankGroup": "1",
    "Beneficiary": "NGUYEN VAN A"
  }
}

Sacombank Pay eWallet

// Request Sacmbank Pay
{
  "AuthID": "123",
  "ProtocolData": {
    "BankName": "SacombankPay",
    "SenderAddress": "JAPAN",
    "Address": "Vietnam",
    "AccType": "PAY",
    "Reference": "REF123456",
    "SenderCountryID": "JP",
    "BankCode": "303",
    "CurrencyID": "VND",
    "OrderedAmt": "10000",
    "Sender": "NGUYEN VAN B",
    "BankAcctNo": "0912456789",
    "AgentID": "123",
    "BankGroup": "1",
    "Beneficiary": "NGUYEN VAN A"
  }
}

ZaloPay

// Request Zalo Pay
{
  "AuthID": "123",
  "ProtocolData": {
    "BankName": "ZaloPay",
    "SenderAddress": "JAPAN",
    "Address": "Vietnam",
    "AccType": "Zalo",
    "Reference": "REF123456",
    "SenderCountryID": "JP",
    "BankCode": "Zalo",
    "CurrencyID": "VND",
    "OrderedAmt": "10000",
    "Sender": "NGUYEN VAN B",
    "BankAcctNo": "0909227275",
    "AgentID": "123",
    "BankGroup": "7",
    "Beneficiary": "NGUYEN VAN A"
  }
}

VNPTPay

// Request VNPTPay eWallet
{
  "AuthID": "123",
  "ProtocolData": {
    "BankName": "VNPTPay",
    "SenderAddress": "JAPAN",
    "Address": "Vietnam",
    "AccType": "VNPTPay",
    "Reference": "REF123456",
    "SenderCountryID": "JP",
    "BankCode": "VNPTPay",
    "CurrencyID": "VND",
    "OrderedAmt": "10000",
    "Sender": "NGUYEN VAN B",
    "BankAcctNo": "0909227275",
    "AgentID": "123",
    "BankGroup": "7",
    "Beneficiary": "NGUYEN VAN A"
  }
}

ZaloPay

// Request MoMo eWallet
{
  "AuthID": "123",
  "ProtocolData": [
    {
      "Reference": "REF123456",
      "DelMode": "3",
      "CurrencyID": "VND",
      "OrderedAmt": 10000,
      "AgentID": "123",
      "Beneficiary": "Beneficiary Name",
      "Phone": "0912345678",
      "Address": "Vietnam",
      "Sender": "Sender Name",
      "SenderPhone": "",
      "SenderAddress": "Sender Address",
      "SenderCountryID": "JP",
      "BankAcctNo": "1234567890",
      "BankName": "Zalo or ZaloPay",
      "BankGroup": "7",
      "AccType": "Zalo"
    }
  ]
}

Response Example

Order is error

//Payment received for processing 
{
  "Status": 2,
  "Error": "206-Balance is not enough to payment",
  "Trace": "Payment received for processing, please check the status in a few minutes"
}

Success

{
  "Status": 1,
  "Error": ""
}