Pay-in collection

Pakistan region pay-in API (PKR). See Payment methods.

Request

POST/v2.0/transaction/pay-in

Request Path:

sandbox: https://sandbox-gateway.smilepayz.com/v2.0/transaction/pay-in
production: https://gateway.smilepayz.com/v2.0/transaction/pay-in

Header Parameters

Field	Required	Type	Description
Content-Type	M	String	application/json request body.
X-TIMESTAMP	M	String	Format: yyyy-MM-ddTHH:mm:ss±HH:mm (Pakistan +05:00).
X-SIGNATURE	M	String	Signature of JSON body (see product Signature doc).
X-PARTNER-ID	M	String	Your merchantID.

Body Parameters

Field	Required	Type	Description
orderNo	M	String(32)	Merchant-unique id.
purpose	M	String(64)	Transaction memo.
merchant	M	Object	Merchant information.
merchantId	M	String	Smilepayz merchantId.
money	M	Object	Currency and amount.
currency	M	String	Fixed to PKR.
amount	M	Number	Amount in PKR.
paymentMethod	M	String	See Payment methods.
payer	O	Object	Payer information.
name	O	String	Payer name.
phone	O	String	Payer mobile number.
redirectUrl	O	String(256)	Post-pay return URL.
callbackUrl	O	String(256)	Async status URL.

Example Body

{
    "orderNo": "PKR_PAYIN_10001",
    "purpose": "Pakistan wallet pay-in",
    "merchant": {
        "merchantId": "20001"
    },
    "money": {
        "currency": "PKR",
        "amount": 1000
    },
    "paymentMethod": "JAZZCASH",
    "payer": {
        "name": "Ali Khan",
        "phone": "03001234567"
    },
    "redirectUrl": "https://www.example.com/success",
    "callbackUrl": "https://www.example.com/callback"
}

Responses

Field	Required	Type	Description
code	M	String	00 success, other values error.
message	M	String	Result message.
orderNo	M	String	Merchant order number.
tradeNo	O	String	Smilepayz trade number.
money.currency	M	String	PKR.
money.amount	M	Number	Order amount.
channel.paymentMethod	O	String	Payment method used.
channel.paymentUrl	O	String	Hosted payment URL when returned.
status	O	String	INIT, PROCESSING, SUCCESS, FAILED, or EXPIRED.

Notification/Callback

Callback signature differs from request signature

Do not verify callback X-SIGNATURE with the request-signing formula. See Callback Signature.

Respond with the string SUCCESS only after the callback is accepted.