Skip to main content

Overview​

OPCard uses an Access Token mechanism for API request authentication. Before calling OPCard APIs, you must first generate an Access Token using the merchant’s app_key and app_secret.

Create Access Token​

curl -X POST 'https://checkout-s.oceanpayment.com/open-api/v1/oauth/token/create'
-H 'Content-Type: application/json'
-D '{"app_key":"7FWGJDQYQZFCPXT7QL", "app_secret":"LQ7qF1UM7x3BfyfYTVa24qci53uPsNGJmrlC2NEJQq8BLszrrsRdIJb04teTgAx9yV5ncXPOjpYOYC0rZ6BkWP7yesQD0Dla3hRJ8WCd6880qaJeZM6idAv0WZYnY5s1"}'
{
  "msg": "SUCCESS",
  "code": "200",
  "data": {
    "token": "eyJhbGciOiJIUzUxMiJ9.eyJ1c2VyX3NvdXJjZSI6Mywib3BfaWQiOiIyNTAwMDAxIiwic2lnbl9kYXRlIjoxNzc5MzYwNjM1LCJwX2lkcyI6IjNlOTg3ZWUxOTZhYjQ0ODczYzcwM2QxZmM2OTljZTZiYmFiNzM2MGY5NTVjNTNiY2Q3MDYwNDhjOTViYzY5MGI0MDMzNjlkY2IzNjViZmU2MTNiYzk5MTk1MTc1NjdiOSJ9.7DIyH-PPbxXXfJk_bDcF4sMfdu1PqiCOiW81WDcZUsa0exvjgI_ttXgnWPe7rG2Zc7Hw7T0qWP_3i2nLk70ruA",
    "expire": 3600,
    "refresh_token": "eyJhbGciOiJIUzUxMiJ9.eyJ1c2VyX3NvdXJjZSI6Mywib3BfaWQiOiIyNTAwMDAxIiwic2lnbl9kYXRlIjoxNzc5MzU4ODM1LCJwX2lkcyI6IjNlOTg3ZWUxOTZhYjQ0ODczYzcwM2QxZmM2OTljZTZiYmFiNzM2MGY5NTVjNTNiY2Q3MDYwNDhjOTViYzY5MGI0MDMzNjlkY2IzNjViZmU2MTNiYzk5MTk1MTc1NjdiOSJ9.dScSCdefXmCu6-jjiiQOy6qpvKrkLaNxpZQWmtUifeFpUIAFpBzGfhsyeYkyxvfS732ZAKkVqGL5biSnC4-Ghg",
    "refresh_expire": 1800
  }
}

Refresh Access Token​

Use the refresh_token to refresh the access token. The refreshed token is used as a credential for API requests and is valid for 60 minutes.

curl -X POST 'https://checkout-s.oceanpayment.com/open-api/v1/oauth/token/refresh'
-H 'Content-Type: application/json'
-D '{"refresh_token": "eyJhbGciOiJIUzUxMiJ9.eyJ1c2VyX3NvdXJjZSI6Mywib3BfaWQiOiIyNTAwMDAxIiwic2lnbl9kYXRlIjoxNzc5MzU4ODM1LCJwX2lkcyI6IjNlOTg3ZWUxOTZhYjQ0ODczYzcwM2QxZmM2OTljZTZiYmFiNzM2MGY5NTVjNTNiY2Q3MDYwNDhjOTViYzY5MGI0MDMzNjlkY2IzNjViZmU2MTNiYzk5MTk1MTc1NjdiOSJ9.dScSCdefXmCu6-jjiiQOy6qpvKrkLaNxpZQWmtUifeFpUIAFpBzGfhsyeYkyxvfS732ZAKkVqGL5biSnC4-Ghg"}'
{
  "msg": "SUCCESS",
  "code": "200",
  "data": {
    "token": "eyJhbGciOiJIUzUxMiJ9.eyJ1c2VyX3NvdXJjZSI6Mywib3BfaWQiOiIyNTAwMDAxIiwic2lnbl9kYXRlIjoxNzc5MzYwNzcwLCJwX2lkcyI6IjNlOTg3ZWUxOTZhYjQ0ODczYzcwM2QxZmM2OTljZTZiYmFiNzM2MGY5NTVjNTNiY2Q3MDYwNDhjOTViYzY5MGI0MDMzNjlkY2IzNjViZmU2MTNiYzk5MTk1MTc1NjdiOSJ9.ftyVK41fIlh40hVhlV6RCQrgrMzyrc_V5d2NpNgPDeqVwtVumdoAyH3CRfH4KC5RfNDJ11msc0x5Tx03KyztpQ",
    "expire": 3600,
    "refresh_token": "eyJhbGciOiJIUzUxMiJ9.eyJ1c2VyX3NvdXJjZSI6Mywib3BfaWQiOiIyNTAwMDAxIiwic2lnbl9kYXRlIjoxNzc5MzU4OTcwLCJwX2lkcyI6IjNlOTg3ZWUxOTZhYjQ0ODczYzcwM2QxZmM2OTljZTZiYmFiNzM2MGY5NTVjNTNiY2Q3MDYwNDhjOTViYzY5MGI0MDMzNjlkY2IzNjViZmU2MTNiYzk5MTk1MTc1NjdiOSJ9.XynHyAmjVsbzXJnnOMW8K5NFA0IXLrZZAPWh5wSRQ7rfRg7OWYHLfGF71iu69ymiTlag4vuQyAK5kL1X9hv_vQ",
    "refresh_expire": 1800
  }
}