TOKEN

Request Details

Parameter NameData TypeMandatoryDescription
merchantOrderIdStringYesUnique order ID generated by merchant
amountlongYesAmount of order in Paisa
contraintsList<InstrumentConstraint>NoDifferent type of constraints that must be applied to the payment
authModeStringYesDefault to 3DS
encryptionKeyIdlongYesKeyId of key which merchant uses to encrypt card number & cvv.
encryptedTokenStringYesEncrypted TOKEN number which merchant passes to process card transaction
encryptedCvvStringYesEncrypted CVV of the card with which payment is being initiated.
cryptogramStringYesThe cryptogram fetched from the gateway where the card was tokenized.
panSuffixStringYesLast four digits of card number
cardHolderNameStringYesCard Holder Name
expiryMonthStringYesToken expiry month
expiryYearStringYesToken expiry year
merchantUserIdStringNoThe unique identifier of the merchant user. It is used to associate the payment with a specific user.
Sample Request
public async Task<IActionResult> CustomPay()
    {
        var merchantOrderID = $"Order_{DateTime.UtcNow:yyyyMMddHHmmssfff}";

        var metaInfo = MetaInfo.Builder()
                .SetUdf1("xyz")
                .Build();

       var payRequest = PgPaymentRequest.TokenPayRequestBuilder()
       .SetMerchantOrderId(merchantOrderID)
       .SetAmount(100)
       .SetAuthMode("3DS")
       .SetCardHolderName("")
       .SetEncryptionKeyId(0)
       .SetEncryptedToken("")
       .SetEncryptedCvv("")
       .SetCryptogram("")
       .SetPanSuffix("")
       .SetExpiryMonth("")
       .SetExpiryYear("")
       .SetRedirectUrl("")
       .SetMetaInfo(metaInfo)
       .SetExpireAfter(300)
       .Build();

        _logger.LogInformation("Custom Pay Request:\n{Request}", JsonSerializer.Serialize(payRequest, JsonOptions.IndentedWithRelaxedEscaping));
        try
        {
            var response = await _customCheckoutClient.Pay(payRequest);
            _logger.LogInformation("Custom Pay Response:\n{Response}", JsonSerializer.Serialize(response, JsonOptions.IndentedWithRelaxedEscaping));
            return Ok(response);
        }
        catch (Exception ex)
        {
            _logger.LogError(ex, "Custom Pay API Failed");
            return StatusCode(500, new { message = ex.Message });
        }
    }

Extract the redirectUrl from the response received.

Response Details

PropertyTypeDescription
orderIdStringOrder Id created by PhonePe
stateStringState of the order. Initially it will be PENDING.
expireAtLongOrder expire date in epoch
redirectUrlStringRedirect url to perform the transaction

Is this article helpful?