# Payment Nonce

The payment nonce is a string returned by the client SDK to represent a payment method. This string is a reference to the payer payment information that was provided in your payment form and should be sent to your server where it can be used with the server SDKs to create a new payment request.

# Get Credit card nonce

Retrieves a credit card nonce from the credit card information.

TIP

Used by the client SDK to retrieve a credit card nonce. This should not be called on server

POST: https://api.openacquiring.com/v1/merchants/YOUR_MERCHANT_ID/credit-card-nonce

Request example

Shell
JavaScript

curl -X POST \
  https://api.openacquiring.com/v1/merchants/<merchant_id>/credit-card-nonce \
  -H 'authorization: Bearer <client_token>' \
  -H 'content-type: application/json' \
  -d '{
        "number": "4005520201264821",
        "expire_month": 12,
        "expire_year": 2020,
        "cvv2": "123"
    }'

Response example

{
    "data": {
        "brand_code": "VISA",
        "credit_card_nonce": "dd959bad-0943-4d2e-9baf-fa64656420b7",
        "last4": "4821",
        "type": "Visa",
        "expire_month": 12,
        "expire_year": 2020,
        "expires_on": "2018-11-03T14:20:53Z",
        "issued_on": "2018-11-02T14:20:53Z"
    }
}

# Request body

Parameter	Type	Description
number required	string	Credit card number. Numeric characters only with no spaces or punctuation. The string must conform with modulo and length required by each credit card type.
expire_month required	integer	Expiration month with no leading zero. Acceptable values are 1 through 12.
expire_year required	integrer	Expiration year Acceptable values should be 4 digits
cvv2	string	3-4 digit card validation code.

# Response body

Parameter	Type	Description
data	object	Root object of the card details reponse
brand_code	string	The credit card brand. Value is visa, mastercard, discover, or amex.
credit_card_nonce	string	Credit card payment nonce used to perform server side transaction request
last4	string	The last four digits of the stored credit card number.
type	string	The credit card type. Value is visa, mastercard, discover, or amex.
expire_month	integrer	The expiration month with no leading zero. Value is from 1 to 12.
expire_year	integer	The four-digit expiration year
expires_on	string Internet date and time format	The date and time when the payment nonce expires
issued_on	string Internet date and time format	The date and time when the payment nonce was issued

← API Request Create Payment →