Retrieves a payment instrument with a specified ID.
Retrieves a payment instrument with a specified ID.
$paymentInstrument = $client->paymentInstruments()->load('paymentInstrumentId');
200
Payment instrument retrieved.
id | string <= 50 characters ID of the payment instrument. |
customerId | string (CustomerId) <= 50 characters ID of the customer resource. |
method required | string Method of payment instrument. |
status | string Status of the payment instrument. An For more information, see Deactivate a payment instrument. |
fingerprint | string Unique value that is used to identify the payment instrument. This value is generated from the |
bin | string <bin> Bank Identification Number (BIN) of the payment card. This value is the same as the first 6 digits of the associated Primary Account Number (PAN). |
last4 | string Last 4 digits of the associated Primary Account Number (PAN). |
expYear | integer Expiration year of the payment card. |
expMonth | integer Expiration month of the payment card. |
brand | string Brand of payment card. |
bankCountry | string or null Bank country of the payment instrument. |
bankName | string Bank name of the payment instrument. |
object (ContactObject) Contact's information. | |
useAsBackup | boolean (UseAsBackup) Specifies if this payment instrument can be used as a backup for invoice payment retries. |
billingPortalUrl | string URL of the billing portal where the card can be updated. |
createdTime | string <date-time> (CreatedTime) Date and time which is set automatically when the resource is created. |
updatedTime | string <date-time> (UpdatedTime) Date and time which updates automatically when the resource is updated. |
customFields | object (ResourceCustomFields) Use custom fields to extend a resource scheme to include custom data that is not provided as a common field. For more information, see Custom fields. |
stickyGatewayAccountId | string or null ID of the sticky gateway account. All future payments are processed by this gateway account. For more information, see Gateway routing. |
expirationReminderTime | string or null <date-time> Date and time when an expiration reminder event is triggered. |
expirationReminderNumber | integer or null Number of expiration reminder events that have triggered. |
object Payment instrument reference data. | |
digitalWallet | string or null Digital wallet type. |
Risk metadata (object) or null | |
revision | integer Number of times the payment instrument data has been modified. Use this value when analyzing webhook data to determine if a change must take precedence over the current representation. |
Array of objects Related links. | |
object Embedded objects that are requested by the |
401
Unauthorized access. Invalid credentials used.
403
Access forbidden.
404
Resource not found.
{ "id": "inst_0YVB8KPKNXCBR9EDX7JHSED75N", "customerId": "cus_0YV7DDSDD1C8DA64KHH2W33CPF", "method": "payment-card", "status": "active", "fingerprint": "string", "bin": "string", "last4": "string", "expYear": 0, "expMonth": 0, "brand": "Visa", "bankCountry": "string", "bankName": "string", "billingAddress": { "firstName": "Benjamin", "lastName": "Franklin", "organization": "Rebilly", "address": "36 Craven St", "address2": "string", "city": "Austin", "region": "Texas", "country": "GB", "postalCode": "WC2N 5NF", "phoneNumbers": [ { "label": "main", "value": "512-710-1640", "primary": true } ], "emails": [ { "label": "main", "value": "rebilly@example.com", "primary": true } ], "dob": "1980-04-01", "jobTitle": "CEO", "hash": "056ae6d97c788b9e98b049ebafd7b229bf852221" }, "useAsBackup": false, "billingPortalUrl": "string", "createdTime": "2019-08-24T14:15:22Z", "updatedTime": "2019-08-24T14:15:22Z", "customFields": { "foo": "bar" }, "stickyGatewayAccountId": "string", "expirationReminderTime": "2019-08-24T14:15:22Z", "expirationReminderNumber": 0, "referenceData": { "gatewayTransactionId": "GAT123" }, "digitalWallet": "Apple Pay", "riskMetadata": { "ipAddress": "93.92.91.90", "fingerprint": "pIUt3xbgX3l9g3YDiLbx", "httpHeaders": { "Content-Type": "application/json", "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8" }, "browserData": { "colorDepth": 24, "isJavaEnabled": true, "language": "en-US", "screenWidth": 1920, "screenHeight": 1080, "timeZoneOffset": 300 }, "extraData": { "kountFraudSessionId": "abcdefg12345abababab123456789012", "payPalMerchantSessionId": "dd65ratxc5qv15iph3vyoq7l6davuowa", "threatMetrixSessionId": "dd65ratxc5qv15iph3vyoq7l6davuowadd65ratxc5qv15iph3vyoq7l6davuowa" }, "isProxy": true, "isVpn": true, "isTor": true, "isHosting": true, "hostingName": "string", "isp": "string", "country": "US", "region": "NY", "city": "New York", "latitude": 0.1, "longitude": 0, "postalCode": "string", "timeZone": "America/New_York", "accuracyRadius": 0, "distance": 0, "hasMismatchedBillingAddressCountry": true, "hasMismatchedBankCountry": true, "hasMismatchedTimeZone": true, "hasMismatchedHolderName": true, "hasFakeName": true, "isHighRiskCountry": true, "paymentInstrumentVelocity": 0, "declinedPaymentInstrumentVelocity": 0, "deviceVelocity": 0, "ipVelocity": 0, "emailVelocity": 0, "billingAddressVelocity": 0, "score": 0 }, "revision": 0, "_links": [ { "href": "string", "rel": "self" } ], "_embedded": { "authTransaction": { }, "customer": { } } }