PayPay

Features
Method	Async - POST Redirect
Merchant countries	Hong Kong
Consumer Countries	Japan
Processing currencies	JPY
Increments	-
Captures	✅
Partial captures	✅
Multiple partial captures	-
Cancels	✅
Partial cancels	✅
Multiple partial cancels	-
Refunds	✅
Partial refunds	✅
Multiple partial refunds	✅
Recurring	-
Installments	-
Credits	-
Disputes	-
Min Amount	1
Account verification	-

PayPay is a very popular cashless payment provider in Japan. With the PayPay app, payments can be made using only a smartphone, eliminating the need to carry a wallet. And since using it doesn’t require a credit card, offering PayPay as a payment method allows businesses to reach new customer demographics — that is, people who don’t have credit cards or, on the other hand, prefer not to use them.

Payment flow

Payment

Request

{
    "processingAccountId": "2HdN2jq6XWmlkhqRC2gDTNYCvNH",
    "merchantReference": "c5211d6b-0178-49f8-a06b-69df097a712f",
    "amount": {
        "value": 200,
        "currency": "jpy"
    },
    "paymentMethod": {
        "type": "paypay",
        "paypay": {
            "returnUrl": "https://merchant.site/complete-payment"
         }
    }
}

Response

{
    "id": "27yiW9MgzBtwiodreuNOXk0rtIw",
    "merchantReference": "c5211d6b-0178-49f8-a06b-69df097a712f",
    "status": "pending",
    "trackingUrl": "/v1/tracks/payments/{trackId}",
    "reason": {
        "code": "required_next_step",
        "description": "An additional step is needed to complete the payment."
    },
    "nextStep": {
        "type": "redirect",
        "redirect": {
            "method": "post",
            "url": "https://payment.method/complete",
            "params": [
                {
                    "name": "pay_method",
                    "value": "paypay"
                },
                {
                    "name": "merchant_id",
                    "value": "99999"
                },
                {
                    "name": "service_id",
                    "value": "000"
                },
                {
                    "name": "cust_code",
                    "value": "27yiW9MgzBtwiodreuNOXk0rtIw"
                },
                {
                    "name": "order_id",
                    "value": "27yiW9MgzBtwiodreuNOXk0rtIw"
                },
                {
                    "name": "item_id",
                    "value": "27yiW9MgzBtwiodreuNOXk0rtIw"
                },
                {
                    "name": "amount",
                    "value": "200"
                },
                {
                    "name": "pay_type",
                    "value": "0"
                },
                {
                    "name": "service_type",
                    "value": "0"
                },
                {
                    "name": "success_url",
                    "value": "https://merchant.site/complete-payment"
                },
                {
                    "name": "cancel_url",
                    "value": "https://merchant.site/complete-payment"
                },
                {
                    "name": "error_url",
                    "value": "https://merchant.site/complete-payment"
                },
                {
                    "name": "pagecon_url",
                    "value": "https://merchant.site/complete-payment"
                },
                {
                    "name": "request_date",
                    "value": "20251113004457"
                },
                {
                    "name": "limit_second",
                    "value": "600"
                },
                {
                    "name": "sps_hashcode",
                    "value": "925A6E17DC937C3C1D277BADE05322DBXXXXXXXX"
                }
            ]
        }
    }
}