Get PCI EIP-712 Challenge

Issues a one-time EIP-712 challenge. The response is a complete typed-data object that can be passed directly to signTypedData (convert message.nonce to BigInt first). After signing, forward the hex signature as x-eip712-signature and the nonce as x-eip712-nonce on the subsequent PCI data request. The challenge expires after 5 minutes and can only be used once.

GET /pci/cards/{cardId}/challenge

Get PCI EIP-712 Challenge

JavaScript

const options = {method: 'GET'};

fetch('https://gp-auth-module.prod.gnosispay.com/pci/cards/{cardId}/challenge', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

curl --request GET \
  --url https://gp-auth-module.prod.gnosispay.com/pci/cards/{cardId}/challenge

import requests

url = "https://gp-auth-module.prod.gnosispay.com/pci/cards/{cardId}/challenge"

response = requests.get(url)

print(response.text)

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://gp-auth-module.prod.gnosispay.com/pci/cards/{cardId}/challenge"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://gp-auth-module.prod.gnosispay.com/pci/cards/{cardId}/challenge")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://gp-auth-module.prod.gnosispay.com/pci/cards/{cardId}/challenge")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

200

{
  "domain": {
    "name": "<string>",
    "version": "<string>",
    "chainId": 123
  },
  "primaryType": "Message",
  "types": {
    "Message": [
      {
        "name": "<string>",
        "type": "<string>"
      }
    ]
  },
  "message": {
    "authorization": "<string>",
    "nonce": "<string>"
  }
}

{
  "success": false,
  "error": {
    "name": "ValidationError",
    "message": "<string>"
  }
}

{
  "success": false,
  "error": "<string>"
}

{
  "success": false,
  "error": "<string>"
}

{
  "success": false,
  "error": "<string>"
}

Path Parameters

cardId · string<uuid> · required

Query Parameters

action · enum<string> · required

The operation being authorized: 'view-details' (card PAN/CVV), 'view-pin' (read PIN), 'change-pin' (set new PIN).

Available options: view-details, view-pin, change-pin

Response

200

application/json

Challenge created successfully

Complete EIP-712 typed data. Pass this object directly to signTypedData — convert message.nonce to BigInt before signing.

domain · object · required

EIP-712 domain separator.

Show child attributes

primaryType · enum<string> · required

EIP-712 primary type.

Available options: Message

types · object · required

EIP-712 type definitions.

Show child attributes

message · object · required

EIP-712 message payload.

Show child attributes