Verify card | Payroc | Documentation

using Payroc;
using System.Threading.Tasks;
using Payroc.PaymentFeatures.Cards;
namespace Usage;
public class Example
{
    public async Task Do() {
        var client = new PayrocClient();
        await client.PaymentFeatures.Cards.VerifyCardAsync(
            new CardVerificationRequest {
                IdempotencyKey = "8e03978e-40d5-43e8-bc93-6894a57f9324",
                ProcessingTerminalId = "1234001",
                Card = new CardVerificationRequestCard(
                    new CardPayload {
                        CardDetails = new CardPayloadCardDetails(
                            new KeyedCardDetails {
                                KeyedData = new KeyedCardDetailsKeyedData(
                                    new PlainTextKeyedDataFormat {
                                        CardNumber = "4539858876047062",
                                        ExpiryDate = "1230"
                                    }
                                ),
                                CardholderName = "Sarah Hazel Hopper",
                                CardholderSignature = "a1b1c012345678a000b000c0012345d0e0f010g10061a031i001j071k0a1b0c1d0e1234567890120f1g0h1i0j1k0a1b0123451c012d0e1f0g1h0i1j123k1a1b1c1d1e1f1g123h1i1j1k1a1b1c1d1e1f1g123h123i1j123k12340a120a12345b012c0123012d0d1e0f1g0h1i123j123k10000"
                            }
                        )
                    }
                ),
                Operator = "Jane"
            }
        );
    }
}

{
  "processingTerminalId": "1234001",
  "verified": true,
  "operator": "Jane",
  "card": {
    "type": "Visa Credit",
    "entryMethod": "keyed",
    "cardNumber": "453985******7062",
    "expiryDate": "1230",
    "cardholderName": "Sarah Hazel Hopper",
    "cardholderSignature": "a1b1c012345678a000b000c0012345d0e0f010g10061a031i001j071k0a1b0c1d0e1234567890120f1g0h1i0j1k0a1b0123451c012d0e1f0g1h0i1j123k1a1b1c1d1e1f1g123h1i1j1k1a1b1c1d1e1f1g123h123i1j123k12340a120a12345b012c0123012d0d1e0f1g0h1i123j123k10000"
  },
  "transactionResult": {
    "status": "ready",
    "responseCode": "A",
    "responseMessage": "APPROVAL",
    "processorResponseCode": "00"
  }
}

Use this method to verify a customer’s card details.

In the request, send the customer’s card details.

In the response, our gateway indicates if the card details are valid and if you should use them in follow-on actions.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

processingTerminalIdstringRequired4-50 characters

Unique identifier that we assigned to the terminal.

cardobjectRequired

Polymorphic object that contains payment details.

operatorstringOptional0-50 characters

Operator who requested to verify the card.

customerobjectOptional

Object that contains the customer's contact details and address information.

Response

Successful request. Returns the verification status of the card details.

processingTerminalIdstring4-50 characters

Unique identifier that we assigned to the terminal.

verifiedboolean

Indicates if the card details are valid:

true - Card details are valid.
false - Card details are not valid.

Indicates if the card details are valid: - `true` - Card details are valid. - `false` - Card details are not valid.

operatorstring0-50 characters

Operator who requested to verify the card.

cardobject

Object that contains the details of the payment card.

transactionResultobject

Object that contains information about the transaction response details.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

406

Not Acceptable Error

409

Conflict Error

415

Unsupported Media Type Error

500

Internal Server Error

Authentication

Headers

Request

Response

Errors