2.b) API’s HTTP Post method

Sending card information via API’s HTTP Post method

To complete the payment transaction, the buyer’s card information must be sent. It can be done by using the Hosted Payment Page or API’s HTTP Post method. It is sufficient to use only one of these two different methods. This section explains sending card information via API’s HTTP Post method.

If your request to create a payment transaction is successful, you can complete the payment transaction by directly sending the recipient user's card information to the payment/authorize endpoint using the paymesOrderId parameter.

payment/authorize

POST https://api.paym.es/v4.6/payment/authorize

If sending the card information is successful, then the user should be directed to the RedirectUrl.

Request Body

Name	Type	Description
paymesOrderId*	string	Unique transaction id sent by Paymes
cardHolderName*	string	Card holder name
cardNumber*	string	Card number
expireYear*	string	Expire year
expireMonth*	string	Expire month
cvc*	string	Card security code
installment*	string	Number of installments between 1 and 12 (inclusive)

200

{
    "status": true,
    "results": {
        "RedirectUrl": "https://example.com/"
    }
}

404

{
    "status": false,
    "error": {
        "cardNumber": [
            "The card number field is required."
        ]
    }
}