Vaulting with Purchase

[KunJeongPark]

Summary of changes

• add optional Vault object with optional customerID of String type in CardRequest
• move Attributes from Card to new EncodedCard struct that formats contents of CardRequest for confirm-payment-source Orders API request.

Checklist

• [x] Added a changelog entry

Authors

List GitHub usernames for everyone who contributed to this pull request.

• @KunJeongPark

  

No Vault Request:

Method: POST URL: https://api.sandbox.paypal.com/v2/checkout/orders/0EL07199CK987522C/confirm-payment-source Body:

{
  "application_context": {
    "return_url": "sdk.ios.paypal://card/success",
    "cancel_url": "sdk.ios.paypal://card/cancel"
  },
  "payment_source": {
    "card": {
      "number": "4344511979394247",
      "security_code": "123",
      "billing_address": null,
      "name": null,
      "attributes": {
        "verification": {
          "method": "SCA_ALWAYS"
        }
      },
      "expiry": "2025-01"
    }
  }
}

Response After Authorize

{
  "id": "0EL07199CK987522C",
  "status": "COMPLETED",
  "payment_source": {
    "card": {
      "last_digits": "4247",
      "expiry": "2025-01",
      "brand": "VISA",
      "type": "UNKNOWN"
    }
  }

Vault with Purchase Request:

Method: POST URL: https://api.sandbox.paypal.com/v2/checkout/orders/3FB45835KB971130X/confirm-payment-source

Body:

{
  "application_context": {
    "return_url": "sdk.ios.paypal://card/success",
    "cancel_url": "sdk.ios.paypal://card/cancel"
  },
  "payment_source": {
    "card": {
      "number": "4344511979394247",
      "security_code": "123",
      "billing_address": null,
      "name": null,
      "attributes": {
        "vault": {
          "store_in_vault": "ON_SUCCESS"
        },
        "verification": {
          "method": "SCA_ALWAYS"
        },
        "customer": {
          "id": "test567"
        }
      },
      "expiry": "2025-01"
    }
  }
}

Response After Authorize:

{
  "id": "3FB45835KB971130X",
  "status": "COMPLETED",
  "payment_source": {
    "card": {
      "last_digits": "4247",
      "expiry": "2025-01",
      "brand": "VISA",
      "type": "UNKNOWN",
      "attributes": {
        "vault": {
          "id": "3fb3mfxf",
          "status": "VAULTED",
          "customer": {
            "id": "test567"
          }..