To stay in PCI compliance, you need to tokenize the card while collecting the contact's full card information including card number, expiry and CVV. We have partnered with VGS to bring this functionality to you.
There are two steps involved in showing the full card information:
Step 1: Create a Debit Card Token
Step 2: Update the Contact (with debit card info) using the Token
Step 3: Send a Debit Push Payment
Step 1: Create a Debit Card Token
ENDPOINT
- POST /v1/contact/{{contactId}}/debitcard/token
RESPONSE
- {
- "id": "con-cf2e03cc-7fd1-4262-a5de-29e12d207f7d",
- "debitCardToken": "contact-debit-card-test-900241cd-b3a0-4614-9811-0cbc90a9811d"
- }
Step 2: Update the Contact (with debit card info) using the Token
Do not include the sd-api-key and sd-person-id in the header. Include sd-debitcard-token (it is the token that you receive in Step 1) and sd-vgs-authorization. Token is valid for 5 minutes and can be used only once.
Note: Your Customer Success Manager will provide you with the VGS Authorization in Prod-TEST and Prod-LIVE
See example of the cURL request below:
- curl --location --request PATCH 'https://test-api.solidfi.com/v1/contact/:id/debitcard' \
- --header 'sd-debitcard-token: <token>’ \
- --header 'sd-vgs-authorization: <vgs_authorization> ' \
- --header 'Content-Type: application/json' \
- --data-raw '{
- "debitCard": {
- "expiryMonth": "10",
- "expiryYear": "2022",
- "cardNumber": "9010111999999992",
- "cvv": "123",
- "address": {
- "addressType": "card",
- "line1": "123 Main St",
- "line2": "",
- "city": "New York",
- "state": "NY",
- "country": "US",
- "postalCode": "10001"
- }
- }
- }'
-
RESPONSE
- {
- "id": "con-cf2e03cc-7fd1-4262-a5de-29e12d207f7d",
- "accountId": "acc-9eb9d71e-1656-4f68-8ed9-06b78ba34566",
- "name": "Bright Light LLC",
- "email": "dwightlight@gmail.com",
- "phone": "+18467051332",
- "status": "active",
- "intrabank": null,
- "ach": {
- "accountNumber": "1098324502",
- "routingNumber": "121042882",
- "accountType": "businessChecking",
- "bankName": "Wells Fargo"
- },
- "createdAt": "2022-03-01T01:50:17Z",
- "modifiedAt": "2022-03-01T01:51:58Z",
- "wire": {
- "domestic": {
- "accountNumber": "1098324502",
- "routingNumber": "121042882",
- "accountType": "businessChecking",
- "bankName": "Wells Fargo",
- "address": {
- "addressType": "wire",
- "line1": "123 Main St",
- "line2": "",
- "city": "New York",
- "state": "NY",
- "country": "US",
- "postalCode": "10001"
- }
- },
- "international": null
- },
- "check": {
- "address": {
- "addressType": "check",
- "line1": "123 Main St",
- "line2": "",
- "city": "New York",
- "state": "NY",
- "country": "US",
- "postalCode": "10001"
- }
- },
- "card": {
- "address": {
- "addressType": "card",
- "line1": "123 Main St",
- "line2": "",
- "city": "New York",
- "state": "NY",
- "country": "US",
- "postalCode": "10001"
- }
- },
- "type": "others",
- "metadata": null,
- "programId": "prg-b9f17601-4717-460e-bda5-9598f6f6db28",
- "debitCard": {
- "cardNumber": "9010111999999992",
- "cvv": "123",
- "expiryMonth": "10",
- "expiryYear": "2022",
- "address": {
- "addressType": "card",
- "line1": "123 Main St",
- "line2": "",
- "city": "New York",
- "state": "NY",
- "country": "US",
- "postalCode": "10001"
- },
- "pull": {
- "enabled": true
- },
- "push": {
- "enabled": true
- }
- }
- }
Step 3: Send a Debit Push payment
ENDPOINT
- POST /v1/send/debitpush
RESPONSE
- {
- "id": "tra-8fc2ba86-41b4-4dd5-8b03-ad82919016bf",
- "accountId": "acc-9eb9d71e-1656-4f68-8ed9-06b78ba34566",
- "contactId": "con-cf2e03cc-7fd1-4262-a5de-29e12d207f7d",
- "name": "Bright Light LLC",
- "accountNumber": "",
- "routingNumber": "",
- "address": {
- "addressType": "",
- "line1": "",
- "line2": "",
- "city": "",
- "state": "",
- "country": "",
- "postalCode": ""
- },
- "amount": "2.00",
- "status": "completed",
- "description": "Send DebitPush",
- "txnType": "debit",
- "transferType": "debitCard",
- "transferSubType": "originated",
- "createdAt": "2022-03-01T01:57:49Z",
- "modifiedAt": "2022-03-01T01:57:49Z",
- "transferredAt": "2022-03-01T01:57:49Z",
- "accountType": "",
- "iban": "",
- "valid": "",
- "parentTransferId": "",
- "reviewCode": "",
- "reviewMessage": "",
- "type": "",
- "metadata": null,
- "title": ""
- }