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 (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 eWallet = 7
AccType	Text	Type of account transferring Account Deposit = ACC Pan Depost = PAN ZaloPay = Zalo VNPTPay= VNPTPay
BankCode*	Text	BankCode of Method Sacombank -> 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	Note
Status	Number	Return status of request: Fail = 0 Success = 1 Processing = 2	If Status = 0 and Error Message refers to a timeout/failed => please verify transaction status before proceeding with a retry or cancellation
Error Message	Text	Error description
ProtocolData	Object	List of payments has error

Note: In case you receive a response "400 - Internal server error/Timeout" or errors starting with 'Internal server error!....'", 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

Napas Deposit with PAN Number

ZaloPay

VNPTPay

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