# 1. Create Payment

# Request URL

  • {domain}/open-api/philippines/payment/generate

# Request Method

  • POST

# Request Header

Parameter Name Required Type Description
Content-Type Y string application/json

# Request Body Param

Parameter Name Required Type Description
appId Y string Application Id
param Y string param
sign Y string signature

# param

Parameter Name Required Type Length Example Description
timestamp Y long - 1677495496979 current timestamp
mchOrderId Y string 1-32 CCP20220428011068111 Merchant order id (unique for transactionId) 1-32 characters
amount Y long - - payment amount (unit: cents) PHP:500.10, should set 50010 cents
customerName Y string 1-128 - payer name
channelCode Y string - Reference List Platform ChannelCode
notifyUrl Y string 1-256 - notify url
redirectUrl Y string 1-512 - redirect url
email Y string 1-128 - payer email
mobile Y string 11-14 - payer mobile (format: start with 09)
remark N string 1-256 - payment remark

# Request Example

# Request Body

{
    "appId": "b858d8bca8124be9ac799659d9567293",
    "sign": "iMvHjMT2AZMZD2BV4+bczpMTxm0ks1si+4IXIrvSDBcoQ4QpLtiUGZpjGUuWPq/gZSnewUe2giop2U2g4Ove1ga2xTWK6PhDOhFqngPW8/BguGtI8RH0qAI24Xuns7z8Ti7U3BLyNdgzOBrKrsxP4THWup9RSZVfsbO9Pu+MHJ0SkZONInHgFX66k+WOZasgEffR8x/1wJp+EZUhEVwcoMDdF2DggOcvBRHVHUmV6svJEOQx09qWuo4eU4CilkDRhbDpmqfLTKS+aN/nI9cYR7CWg+hosh/xr0Y0RypyrlTv68hMSx1+XCqKCpjmKrKOV7wx6ZQ15Il3tYUPEzlujw==",
    "param": "{\"mchOrderId\":\"Platform0000058\",\"amount\":56,\"customerName\":\"user01\",\"channelCode\":\"PH_GCASH_URL\",\"email\":\"Platform@gmail.com\",\"redirectUrl\":\"https://www.google.com/\",\"notifyUrl\":\"https://test.com\",\"mobile\":\"123456789\",\"timestamp\":\"1679451632737\"}"
}

How to construct request body


# Response Param

Parameter Name Type Description
code integer response code
message string response message
data Object data

# data

Parameter Name Type Description
transactionId string Platform transaction id
payData string payment data(VA,URL or QR Content)
mchOrderId string Merchant order id
channelType string Channel Type("URL","VA","QR")
cashierUrl string Cashier Url

# Response Example

// URL
{
  "code": 10000,
  "message": "Success",
  "data": {
    "transactionId": "C1113681121341931458",
    "payData": "https://open-sea.alipayplus.com/api/open/v1/ac/cashier/self/codevalue/checkout.htm?codeValue=281666040096IxZD7PhzX3033x6IgJmv4IQF",
    "channelType": "URL",
    "cashierUrl": "https://cashier.ezpaytechs.com/xxxxxxxxxxxxxxxxxxxx"
  }
}

// QR Content
{
  "code": 10000,
  "message": "Success",
  "data": {
    "transactionId": "C1030677502883797639",
    "payData": "281666040099hr4l48MSF31LJU2tl4Xv48AR",
    "channelType": "QR",
    "cashierUrl": "https://cashier.ezpaytechs.com/xxxxxxxxxxxxxxxxxxxx"
  }
}

Code Collection

# Failed Response Example

{
  "code":21016,
  "message":"Merchant ip forbidden"
}