Skip to content

7.1 payoutQueryStatus

The payment status query service API is provided by Skypay and can query transaction status, with a maximum quantity of 50 transactions

Input parameters

parametertypelengthmustdescribe
userNamestring50YESUser name
provided by SkyPay - Ex:"userName":"AppName@skypay"
actionstring50YESCall behavior
payoutQueryStatus(Fixed parameter values) - Ex:"action":"payoutQueryStatus"
authenticationstring255YESVerification Code
Verification Key - Ex:"authentication":"E1234567-123C-1234-123F-A12345670"
controlNumbersString[]YESPayment code array name
Array(parameter tag name is controlNumber)
controlNumberString13~15YESPayment code
Prefix code 5+8-10 digits (Prefix code can be obtained from the bound email) - Ex:SKY**12345678

Post data

{
    "userName" : "AppName@skypay",
    "action" : "payoutQueryStatus",
    "authentication" : "30AC21B2-9EAA-4503-B0F0-7BE5C277ED75",
    "controlNumbers" :[
    {
      "controlNumber" : "SK0XXXXXXXXXX"
     },
     {
      "controlNumber" :  "SK0XXXXXXXXXX"
     }
    ]
}

Output parameters

parametertypelengthmustdescribe
responseTimeDateTime50YESReturn time
yyyy-MM-dd HH:mm:ss.SSSS
responseCodeint4YESReturn Code
System default return code, a number of 4 in length, standard reference return code definition. When the system default return code is insufficient, users can customize the code. Please start with the number 2, a number of 4 in length, and specify the content of the return
responseDescriptionstring255YESFeedback Content Description
Response Information (Required)
controlNumbersString[]YESName of withdrawal code array
Array
controlNumberstring13~15YESWithdrawal code
name of the payee - separated by commas。Last name+","+First name+","+Middle name+","+Suffix(Required) Regulatory requirements require retention of repayment information in archives
transactionDateDateTimeTransaction Date
yyyy-MM-dd HH:mm:ss.fff
statusintYESStatus code :
0 Pending:Waiting
1 Completed:Completed
2 Uploaded:Complete upload
3 Cancelled:Canceled
4 Failed:fail
10 Inquiry Success:query was successful
11 Inquiry Failure:Query failed
statusDescString50YESState Description:
Pending:Waiting
Completed:Complet
Uploaded:Complete upload
Cancelled:Canceled
Failed:fail
Inquiry Success:query was successful
Inquiry Failure:Query failed
payTimeDateTimeWithdrawal time
(yyyy-MM-dd HH:mm:ss)
cancelTimeDateTimeCancel time
(yyyy-MM-dd HH:mm:ss)
withdrawChannelintPayment Pipeline
For detailed information, please refer to section12Channel code value
referenceNoString50Receipt No
GCash:reference number - Real time return receipt number
traceNoString50MLExclusive payment code
MLhuillier(RT) - referenceNumber MLExclusive payment code

Output data:

{
 : ,
     : ,
     : ,
     : [
       { 
          : ,
           : ,
           : ,
           : ,
           : ,
           : ,
           : ,
           : 
       },
       { 
          : ,
           : ,
           : ,
           : ,
           : ,
           : ,
           : ,
           : ,
       }
    ]
}