CardCheck

A 0 authorization will be initiated against the cardholder to verify the card number provided. The cardholder needs to supply valid information to complete the validation.

Verification can be performed using the hosted page offered by YabandPay. This enables merchants to securely process requests, as sensitive PCI DSS data is hosted within the YabandPay system.

[!TIP|style:flat]

You can retrieve the verification result via query API.

API URL：https://mapi.yabandpay.com/Payments

Method：POST

POST data type：Json

参数 类型 描述 是否必填
user String the UID of cashier account Required
sign String signature Required
method String v3.CardCheck Required
time Long timestamp Required
  • 参数
Parameter Type Description Required
pay_method String online Required
sub_pay_method String CardCheck Required
operation String 3 Required
order_id String order id from Merchant Required
description String order description Required
form_type String The returned URL type, default is 01. 01.completed, 02.iframe Optional
demo String custom field Optional
timeout String Timeout (minutes) value 0-1440 Required
redirect_url String the redirect URL after payment is completed Optional
notify_url String asynchronous notification url Required
request_id String The request ID must be unique. It is recommended to use a combination of at least 24 digits and letters. Required

Signature：

Lexicographical sequence and URL key-value format new string

"description=cardcheck test&form_type=01&method=v3.CardCheck&notify_url=https://www.yabandpay.com/notify&operation=3&order_id=203040950640690239603690&pay_method=online&redirect_url=https://www.yabandpay.com/redirect_url&request_id=tscqf7ki76o7aem4z1yl1xs72f89fptl&sub_pay_method=CardCheck&time=1720680417&timeout=0&user=016683"

Use stringA and secret_key to get stringSign

Get Signature：

"fe910a99bb9baee3e31ea996c2df76f391f89ca5769d7b7b45a32075af25149e"

Example Request:：

{
    "user": "016683",
    "sign": "fe910a99bb9baee3e31ea996c2df76f391f89ca5769d7b7b45a32075af25149e",
    "method": "v3.CardCheck",
    "time": 1720680417,
    "data": {
        "description": "cardcheck test",
        "form_type": "01",
        "timeout": "0",
        "pay_method": "online",
        "sub_pay_method": "CardCheck",
        "operation": "3",
        "order_id": "203040950640690239603690",
        "redirect_url": "https://www.yabandpay.com/redirect_url",
        "notify_url": "https://www.yabandpay.com/notify",
        "request_id": "tscqf7ki76o7aem4z1yl1xs72f89fptl"
    }
}

Example Response:：

{
    "status": true,
    "code": "200",
    "data": {
        "order_id": "203040950640690239603690",
        "trade_id": "160899f3-f6d9-a8d8-ab5b-82eacdab9c5b",
        "amount": "0.00",
        "currency": "EUR",
        "url": "https://pay.yabandpay.com/payments/callback/order/MTYwODk5ZjMtZjZkOS1hOGQ4LWFiNWItODJlYWNkYWI5YzVi",
        "state": "processing"
    },
    "message": "",
    "response_id": "202407111544200649155078"
}

More Information:

Return results:

  1. On a successful API call, the response will be "status": true.

  2. On a failed API call, the response will be "status": false.

We strongly recommend using both Order Query and Asynchronous Notification simultaneously to synchronize and update payment status, ensuring real-time accuracy of payment information.

If the order status state is paid, the payment is successful（Card verified successfully）.

Result/Error codes:
Status Code Message
true 200
false -1000 Internal error
false -403 The signature Error
false -2001 The user not exist
false -3001 Required field is missing
false -4118 Incorrect request ID

results matching ""

    No results matching ""