Skip to main content
POST
/
payments
/
v1
/
cards
/
pin
Submit Card PIN
curl --request POST \
  --url https://sandbox-api.payfonte.com/payments/v1/cards/pin \
  --header 'Content-Type: application/json' \
  --header 'client-id: <api-key>' \
  --header 'client-secret: <api-key>' \
  --data '
{
  "reference": "DCD20260701144120NCDZW",
  "provider": "card-nigeria",
  "card": {
    "pan": "5061 4604 1012 1111 106",
    "expiry": {
      "month": "12",
      "year": "2050"
    },
    "cvv": "562",
    "pin": "1106",
    "cardHolderName": "Donna Flatley"
  }
}
'
{
  "statusCode": 200,
  "data": {
    "reference": "DCD20260701133425EIQWF",
    "action": "pin",
    "data": {}
  }
}

Authorizations

​
client-id
string
header
required
​
client-secret
string
header
required

Body

application/json

Card PIN request

​
reference
string
required

Card payment reference returned by the previous card payment step.

Example:

"DCD20260701144120NCDZW"

​
provider
string
required

Card provider slug.

Example:

"card-nigeria"

​
card
object
required

Response

Card payment requires the next customer action or verification.

​
statusCode
integer
required

Application status code returned in the response body.

Example:

200

​
data
object
required