increase 0.59.0 → 0.60.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (299) hide show
  1. package/CHANGELOG.md +31 -0
  2. package/README.md +41 -17
  3. package/error.d.ts.map +1 -1
  4. package/error.js +0 -3
  5. package/error.js.map +1 -1
  6. package/error.mjs +0 -3
  7. package/error.mjs.map +1 -1
  8. package/index.d.mts +190 -172
  9. package/index.d.ts +190 -172
  10. package/index.d.ts.map +1 -1
  11. package/index.js +96 -87
  12. package/index.js.map +1 -1
  13. package/index.mjs +96 -87
  14. package/index.mjs.map +1 -1
  15. package/package.json +1 -1
  16. package/resources/cards.d.ts +1 -1
  17. package/resources/cards.d.ts.map +1 -1
  18. package/resources/cards.js +1 -1
  19. package/resources/cards.js.map +1 -1
  20. package/resources/cards.mjs +1 -1
  21. package/resources/cards.mjs.map +1 -1
  22. package/resources/declined-transactions.d.ts +2 -231
  23. package/resources/declined-transactions.d.ts.map +1 -1
  24. package/resources/declined-transactions.js.map +1 -1
  25. package/resources/declined-transactions.mjs.map +1 -1
  26. package/resources/{entities/entities.d.ts → entities.d.ts} +276 -46
  27. package/resources/entities.d.ts.map +1 -0
  28. package/resources/{entities/entities.js → entities.js} +28 -17
  29. package/resources/entities.js.map +1 -0
  30. package/resources/{entities/entities.mjs → entities.mjs} +28 -17
  31. package/resources/entities.mjs.map +1 -0
  32. package/resources/groups.d.ts +1 -1
  33. package/resources/groups.d.ts.map +1 -1
  34. package/resources/groups.js +1 -1
  35. package/resources/groups.js.map +1 -1
  36. package/resources/groups.mjs +1 -1
  37. package/resources/groups.mjs.map +1 -1
  38. package/resources/inbound-ach-transfers.d.ts +218 -7
  39. package/resources/inbound-ach-transfers.d.ts.map +1 -1
  40. package/resources/inbound-ach-transfers.js +8 -8
  41. package/resources/inbound-ach-transfers.js.map +1 -1
  42. package/resources/inbound-ach-transfers.mjs +8 -8
  43. package/resources/inbound-ach-transfers.mjs.map +1 -1
  44. package/resources/inbound-check-deposits.d.ts +25 -1
  45. package/resources/inbound-check-deposits.d.ts.map +1 -1
  46. package/resources/inbound-check-deposits.js +6 -0
  47. package/resources/inbound-check-deposits.js.map +1 -1
  48. package/resources/inbound-check-deposits.mjs +6 -0
  49. package/resources/inbound-check-deposits.mjs.map +1 -1
  50. package/resources/inbound-mail-items.d.ts +0 -14
  51. package/resources/inbound-mail-items.d.ts.map +1 -1
  52. package/resources/inbound-mail-items.js.map +1 -1
  53. package/resources/inbound-mail-items.mjs.map +1 -1
  54. package/resources/inbound-wire-transfers.d.ts +4 -0
  55. package/resources/inbound-wire-transfers.d.ts.map +1 -1
  56. package/resources/inbound-wire-transfers.js.map +1 -1
  57. package/resources/inbound-wire-transfers.mjs.map +1 -1
  58. package/resources/index.d.ts +11 -8
  59. package/resources/index.d.ts.map +1 -1
  60. package/resources/index.js +15 -6
  61. package/resources/index.js.map +1 -1
  62. package/resources/index.mjs +7 -4
  63. package/resources/index.mjs.map +1 -1
  64. package/resources/{intrafi/account-enrollments.d.ts → intrafi-account-enrollments.d.ts} +17 -17
  65. package/resources/intrafi-account-enrollments.d.ts.map +1 -0
  66. package/resources/{intrafi/account-enrollments.js → intrafi-account-enrollments.js} +11 -11
  67. package/resources/intrafi-account-enrollments.js.map +1 -0
  68. package/resources/{intrafi/account-enrollments.mjs → intrafi-account-enrollments.mjs} +9 -9
  69. package/resources/intrafi-account-enrollments.mjs.map +1 -0
  70. package/resources/{intrafi/balances.d.ts → intrafi-balances.d.ts} +7 -7
  71. package/resources/intrafi-balances.d.ts.map +1 -0
  72. package/resources/{intrafi/balances.js → intrafi-balances.js} +7 -7
  73. package/resources/intrafi-balances.js.map +1 -0
  74. package/resources/{intrafi/balances.mjs → intrafi-balances.mjs} +5 -5
  75. package/resources/intrafi-balances.mjs.map +1 -0
  76. package/resources/{intrafi/exclusions.d.ts → intrafi-exclusions.d.ts} +15 -15
  77. package/resources/intrafi-exclusions.d.ts.map +1 -0
  78. package/resources/{intrafi/exclusions.js → intrafi-exclusions.js} +11 -11
  79. package/resources/intrafi-exclusions.js.map +1 -0
  80. package/resources/{intrafi/exclusions.mjs → intrafi-exclusions.mjs} +9 -9
  81. package/resources/intrafi-exclusions.mjs.map +1 -0
  82. package/resources/lockboxes.d.ts +0 -14
  83. package/resources/lockboxes.d.ts.map +1 -1
  84. package/resources/lockboxes.js.map +1 -1
  85. package/resources/lockboxes.mjs.map +1 -1
  86. package/resources/routing-numbers.d.ts +5 -5
  87. package/resources/routing-numbers.d.ts.map +1 -1
  88. package/resources/routing-numbers.js +5 -5
  89. package/resources/routing-numbers.js.map +1 -1
  90. package/resources/routing-numbers.mjs +3 -3
  91. package/resources/routing-numbers.mjs.map +1 -1
  92. package/resources/simulations/ach-transfers.d.ts +10 -61
  93. package/resources/simulations/ach-transfers.d.ts.map +1 -1
  94. package/resources/simulations/ach-transfers.js +10 -14
  95. package/resources/simulations/ach-transfers.js.map +1 -1
  96. package/resources/simulations/ach-transfers.mjs +10 -14
  97. package/resources/simulations/ach-transfers.mjs.map +1 -1
  98. package/resources/simulations/card-authorization-expirations.d.ts +20 -0
  99. package/resources/simulations/card-authorization-expirations.d.ts.map +1 -0
  100. package/resources/simulations/card-authorization-expirations.js +17 -0
  101. package/resources/simulations/card-authorization-expirations.js.map +1 -0
  102. package/resources/simulations/card-authorization-expirations.mjs +13 -0
  103. package/resources/simulations/card-authorization-expirations.mjs.map +1 -0
  104. package/resources/simulations/card-authorizations.d.ts +91 -0
  105. package/resources/simulations/card-authorizations.d.ts.map +1 -0
  106. package/resources/simulations/{cards.js → card-authorizations.js} +7 -17
  107. package/resources/simulations/card-authorizations.js.map +1 -0
  108. package/resources/simulations/{cards.mjs → card-authorizations.mjs} +5 -15
  109. package/resources/simulations/card-authorizations.mjs.map +1 -0
  110. package/resources/simulations/card-fuel-confirmations.d.ts +27 -0
  111. package/resources/simulations/card-fuel-confirmations.d.ts.map +1 -0
  112. package/resources/simulations/card-fuel-confirmations.js +19 -0
  113. package/resources/simulations/card-fuel-confirmations.js.map +1 -0
  114. package/resources/simulations/card-fuel-confirmations.mjs +15 -0
  115. package/resources/simulations/card-fuel-confirmations.mjs.map +1 -0
  116. package/resources/simulations/card-increments.d.ts +32 -0
  117. package/resources/simulations/card-increments.d.ts.map +1 -0
  118. package/resources/simulations/card-increments.js +18 -0
  119. package/resources/simulations/card-increments.js.map +1 -0
  120. package/resources/simulations/card-increments.mjs +14 -0
  121. package/resources/simulations/card-increments.mjs.map +1 -0
  122. package/resources/simulations/card-reversals.d.ts +28 -0
  123. package/resources/simulations/card-reversals.d.ts.map +1 -0
  124. package/resources/simulations/card-reversals.js +20 -0
  125. package/resources/simulations/card-reversals.js.map +1 -0
  126. package/resources/simulations/card-reversals.mjs +16 -0
  127. package/resources/simulations/card-reversals.mjs.map +1 -0
  128. package/resources/simulations/card-settlements.d.ts +34 -0
  129. package/resources/simulations/card-settlements.d.ts.map +1 -0
  130. package/resources/simulations/card-settlements.js +21 -0
  131. package/resources/simulations/card-settlements.js.map +1 -0
  132. package/resources/simulations/card-settlements.mjs +17 -0
  133. package/resources/simulations/card-settlements.mjs.map +1 -0
  134. package/resources/simulations/inbound-ach-transfers.d.ts +89 -0
  135. package/resources/simulations/inbound-ach-transfers.d.ts.map +1 -0
  136. package/resources/simulations/inbound-ach-transfers.js +26 -0
  137. package/resources/simulations/inbound-ach-transfers.js.map +1 -0
  138. package/resources/simulations/inbound-ach-transfers.mjs +22 -0
  139. package/resources/simulations/inbound-ach-transfers.mjs.map +1 -0
  140. package/resources/simulations/inbound-real-time-payments-transfers.d.ts +71 -0
  141. package/resources/simulations/inbound-real-time-payments-transfers.d.ts.map +1 -0
  142. package/resources/simulations/inbound-real-time-payments-transfers.js +18 -0
  143. package/resources/simulations/inbound-real-time-payments-transfers.js.map +1 -0
  144. package/resources/simulations/inbound-real-time-payments-transfers.mjs +14 -0
  145. package/resources/simulations/inbound-real-time-payments-transfers.mjs.map +1 -0
  146. package/resources/simulations/inbound-wire-transfers.d.ts +99 -0
  147. package/resources/simulations/inbound-wire-transfers.d.ts.map +1 -0
  148. package/resources/simulations/inbound-wire-transfers.js +17 -0
  149. package/resources/simulations/inbound-wire-transfers.js.map +1 -0
  150. package/resources/simulations/inbound-wire-transfers.mjs +13 -0
  151. package/resources/simulations/inbound-wire-transfers.mjs.map +1 -0
  152. package/resources/simulations/index.d.ts +14 -7
  153. package/resources/simulations/index.d.ts.map +1 -1
  154. package/resources/simulations/index.js +21 -7
  155. package/resources/simulations/index.js.map +1 -1
  156. package/resources/simulations/index.mjs +11 -4
  157. package/resources/simulations/index.mjs.map +1 -1
  158. package/resources/simulations/interest-payments.js +1 -1
  159. package/resources/simulations/interest-payments.js.map +1 -1
  160. package/resources/simulations/interest-payments.mjs +1 -1
  161. package/resources/simulations/interest-payments.mjs.map +1 -1
  162. package/resources/simulations/physical-cards.d.ts +3 -3
  163. package/resources/simulations/physical-cards.js +2 -2
  164. package/resources/simulations/physical-cards.mjs +2 -2
  165. package/resources/simulations/real-time-payments-transfers.d.ts +0 -3686
  166. package/resources/simulations/real-time-payments-transfers.d.ts.map +1 -1
  167. package/resources/simulations/real-time-payments-transfers.js +0 -7
  168. package/resources/simulations/real-time-payments-transfers.js.map +1 -1
  169. package/resources/simulations/real-time-payments-transfers.mjs +0 -7
  170. package/resources/simulations/real-time-payments-transfers.mjs.map +1 -1
  171. package/resources/simulations/simulations.d.ts +67 -118
  172. package/resources/simulations/simulations.d.ts.map +1 -1
  173. package/resources/simulations/simulations.js +45 -54
  174. package/resources/simulations/simulations.js.map +1 -1
  175. package/resources/simulations/simulations.mjs +45 -54
  176. package/resources/simulations/simulations.mjs.map +1 -1
  177. package/resources/simulations/wire-transfers.d.ts +10 -85
  178. package/resources/simulations/wire-transfers.d.ts.map +1 -1
  179. package/resources/simulations/wire-transfers.js +14 -5
  180. package/resources/simulations/wire-transfers.js.map +1 -1
  181. package/resources/simulations/wire-transfers.mjs +14 -5
  182. package/resources/simulations/wire-transfers.mjs.map +1 -1
  183. package/resources/{entities/supplemental-documents.d.ts → supplemental-documents.d.ts} +17 -10
  184. package/resources/supplemental-documents.d.ts.map +1 -0
  185. package/resources/{entities/supplemental-documents.js → supplemental-documents.js} +9 -9
  186. package/resources/supplemental-documents.js.map +1 -0
  187. package/resources/{entities/supplemental-documents.mjs → supplemental-documents.mjs} +7 -7
  188. package/resources/supplemental-documents.mjs.map +1 -0
  189. package/resources/transactions.d.ts +6 -276
  190. package/resources/transactions.d.ts.map +1 -1
  191. package/resources/transactions.js.map +1 -1
  192. package/resources/transactions.mjs.map +1 -1
  193. package/resources/wire-transfers.d.ts +4 -13
  194. package/resources/wire-transfers.d.ts.map +1 -1
  195. package/resources/wire-transfers.js +0 -17
  196. package/resources/wire-transfers.js.map +1 -1
  197. package/resources/wire-transfers.mjs +0 -17
  198. package/resources/wire-transfers.mjs.map +1 -1
  199. package/src/error.ts +0 -8
  200. package/src/index.ts +210 -189
  201. package/src/resources/cards.ts +1 -1
  202. package/src/resources/declined-transactions.ts +0 -297
  203. package/src/resources/{entities/entities.ts → entities.ts} +351 -56
  204. package/src/resources/groups.ts +1 -1
  205. package/src/resources/inbound-ach-transfers.ts +288 -13
  206. package/src/resources/inbound-check-deposits.ts +34 -1
  207. package/src/resources/inbound-mail-items.ts +0 -16
  208. package/src/resources/inbound-wire-transfers.ts +5 -0
  209. package/src/resources/index.ts +32 -14
  210. package/src/resources/{intrafi/account-enrollments.ts → intrafi-account-enrollments.ts} +18 -18
  211. package/src/resources/{intrafi/balances.ts → intrafi-balances.ts} +6 -6
  212. package/src/resources/{intrafi/exclusions.ts → intrafi-exclusions.ts} +19 -16
  213. package/src/resources/lockboxes.ts +0 -16
  214. package/src/resources/routing-numbers.ts +6 -6
  215. package/src/resources/simulations/ach-transfers.ts +15 -76
  216. package/src/resources/simulations/card-authorization-expirations.ts +29 -0
  217. package/src/resources/simulations/card-authorizations.ts +112 -0
  218. package/src/resources/simulations/card-fuel-confirmations.ts +37 -0
  219. package/src/resources/simulations/card-increments.ts +43 -0
  220. package/src/resources/simulations/card-reversals.ts +38 -0
  221. package/src/resources/simulations/card-settlements.ts +45 -0
  222. package/src/resources/simulations/inbound-ach-transfers.ts +124 -0
  223. package/src/resources/simulations/inbound-real-time-payments-transfers.ts +89 -0
  224. package/src/resources/simulations/inbound-wire-transfers.ts +124 -0
  225. package/src/resources/simulations/index.ts +26 -21
  226. package/src/resources/simulations/interest-payments.ts +1 -1
  227. package/src/resources/simulations/physical-cards.ts +5 -5
  228. package/src/resources/simulations/real-time-payments-transfers.ts +0 -4659
  229. package/src/resources/simulations/simulations.ts +80 -157
  230. package/src/resources/simulations/wire-transfers.ts +18 -104
  231. package/src/resources/{entities/supplemental-documents.ts → supplemental-documents.ts} +21 -13
  232. package/src/resources/transactions.ts +5 -350
  233. package/src/resources/wire-transfers.ts +5 -19
  234. package/src/version.ts +1 -1
  235. package/version.d.ts +1 -1
  236. package/version.js +1 -1
  237. package/version.mjs +1 -1
  238. package/resources/entities/beneficial-owners.d.ts +0 -279
  239. package/resources/entities/beneficial-owners.d.ts.map +0 -1
  240. package/resources/entities/beneficial-owners.js +0 -29
  241. package/resources/entities/beneficial-owners.js.map +0 -1
  242. package/resources/entities/beneficial-owners.mjs +0 -25
  243. package/resources/entities/beneficial-owners.mjs.map +0 -1
  244. package/resources/entities/entities.d.ts.map +0 -1
  245. package/resources/entities/entities.js.map +0 -1
  246. package/resources/entities/entities.mjs.map +0 -1
  247. package/resources/entities/index.d.ts +0 -5
  248. package/resources/entities/index.d.ts.map +0 -1
  249. package/resources/entities/index.js +0 -15
  250. package/resources/entities/index.js.map +0 -1
  251. package/resources/entities/index.mjs +0 -6
  252. package/resources/entities/index.mjs.map +0 -1
  253. package/resources/entities/industry-code.d.ts +0 -23
  254. package/resources/entities/industry-code.d.ts.map +0 -1
  255. package/resources/entities/industry-code.js +0 -17
  256. package/resources/entities/industry-code.js.map +0 -1
  257. package/resources/entities/industry-code.mjs +0 -13
  258. package/resources/entities/industry-code.mjs.map +0 -1
  259. package/resources/entities/supplemental-documents.d.ts.map +0 -1
  260. package/resources/entities/supplemental-documents.js.map +0 -1
  261. package/resources/entities/supplemental-documents.mjs.map +0 -1
  262. package/resources/intrafi/account-enrollments.d.ts.map +0 -1
  263. package/resources/intrafi/account-enrollments.js.map +0 -1
  264. package/resources/intrafi/account-enrollments.mjs.map +0 -1
  265. package/resources/intrafi/balances.d.ts.map +0 -1
  266. package/resources/intrafi/balances.js.map +0 -1
  267. package/resources/intrafi/balances.mjs.map +0 -1
  268. package/resources/intrafi/exclusions.d.ts.map +0 -1
  269. package/resources/intrafi/exclusions.js.map +0 -1
  270. package/resources/intrafi/exclusions.mjs.map +0 -1
  271. package/resources/intrafi/index.d.ts +0 -5
  272. package/resources/intrafi/index.d.ts.map +0 -1
  273. package/resources/intrafi/index.js +0 -15
  274. package/resources/intrafi/index.js.map +0 -1
  275. package/resources/intrafi/index.mjs +0 -6
  276. package/resources/intrafi/index.mjs.map +0 -1
  277. package/resources/intrafi/intrafi.d.ts +0 -24
  278. package/resources/intrafi/intrafi.d.ts.map +0 -1
  279. package/resources/intrafi/intrafi.js +0 -48
  280. package/resources/intrafi/intrafi.js.map +0 -1
  281. package/resources/intrafi/intrafi.mjs +0 -21
  282. package/resources/intrafi/intrafi.mjs.map +0 -1
  283. package/resources/simulations/cards.d.ts +0 -1763
  284. package/resources/simulations/cards.d.ts.map +0 -1
  285. package/resources/simulations/cards.js.map +0 -1
  286. package/resources/simulations/cards.mjs.map +0 -1
  287. package/resources/simulations/inbound-international-ach-transfers.d.ts +0 -285
  288. package/resources/simulations/inbound-international-ach-transfers.d.ts.map +0 -1
  289. package/resources/simulations/inbound-international-ach-transfers.js +0 -21
  290. package/resources/simulations/inbound-international-ach-transfers.js.map +0 -1
  291. package/resources/simulations/inbound-international-ach-transfers.mjs +0 -17
  292. package/resources/simulations/inbound-international-ach-transfers.mjs.map +0 -1
  293. package/src/resources/entities/beneficial-owners.ts +0 -346
  294. package/src/resources/entities/index.ts +0 -25
  295. package/src/resources/entities/industry-code.ts +0 -33
  296. package/src/resources/intrafi/index.ts +0 -18
  297. package/src/resources/intrafi/intrafi.ts +0 -29
  298. package/src/resources/simulations/cards.ts +0 -2188
  299. package/src/resources/simulations/inbound-international-ach-transfers.ts +0 -367
@@ -1,1763 +0,0 @@
1
- import { APIResource } from "../../resource.js";
2
- import * as Core from "../../core.js";
3
- import * as CardsAPI from "./cards.js";
4
- import * as TransactionsAPI from "../transactions.js";
5
- export declare class Cards extends APIResource {
6
- /**
7
- * Simulates a purchase authorization on a [Card](#cards). Depending on the balance
8
- * available to the card and the `amount` submitted, the authorization activity
9
- * will result in a [Pending Transaction](#pending-transactions) of type
10
- * `card_authorization` or a [Declined Transaction](#declined-transactions) of type
11
- * `card_decline`. You can pass either a Card id or a
12
- * [Digital Wallet Token](#digital-wallet-tokens) id to simulate the two different
13
- * ways purchases can be made.
14
- */
15
- authorize(body: CardAuthorizeParams, options?: Core.RequestOptions): Core.APIPromise<CardAuthorizationSimulation>;
16
- /**
17
- * Simulates the settlement of an authorization by a card acquirer. After a card
18
- * authorization is created, the merchant will eventually send a settlement. This
19
- * simulates that event, which may occur many days after the purchase in
20
- * production. The amount settled can be different from the amount originally
21
- * authorized, for example, when adding a tip to a restaurant bill.
22
- */
23
- settlement(body: CardSettlementParams, options?: Core.RequestOptions): Core.APIPromise<TransactionsAPI.Transaction>;
24
- }
25
- /**
26
- * The results of a Card Authorization simulation.
27
- */
28
- export interface CardAuthorizationSimulation {
29
- /**
30
- * If the authorization attempt fails, this will contain the resulting
31
- * [Declined Transaction](#declined-transactions) object. The Declined
32
- * Transaction's `source` will be of `category: card_decline`.
33
- */
34
- declined_transaction: CardAuthorizationSimulation.DeclinedTransaction | null;
35
- /**
36
- * If the authorization attempt succeeds, this will contain the resulting Pending
37
- * Transaction object. The Pending Transaction's `source` will be of
38
- * `category: card_authorization`.
39
- */
40
- pending_transaction: CardAuthorizationSimulation.PendingTransaction | null;
41
- /**
42
- * A constant representing the object's type. For this resource it will always be
43
- * `inbound_card_authorization_simulation_result`.
44
- */
45
- type: 'inbound_card_authorization_simulation_result';
46
- }
47
- export declare namespace CardAuthorizationSimulation {
48
- /**
49
- * If the authorization attempt fails, this will contain the resulting
50
- * [Declined Transaction](#declined-transactions) object. The Declined
51
- * Transaction's `source` will be of `category: card_decline`.
52
- */
53
- interface DeclinedTransaction {
54
- /**
55
- * The Declined Transaction identifier.
56
- */
57
- id: string;
58
- /**
59
- * The identifier for the Account the Declined Transaction belongs to.
60
- */
61
- account_id: string;
62
- /**
63
- * The Declined Transaction amount in the minor unit of its currency. For dollars,
64
- * for example, this is cents.
65
- */
66
- amount: number;
67
- /**
68
- * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date on which the
69
- * Transaction occurred.
70
- */
71
- created_at: string;
72
- /**
73
- * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the Declined
74
- * Transaction's currency. This will match the currency on the Declined
75
- * Transaction's Account.
76
- *
77
- * - `CAD` - Canadian Dollar (CAD)
78
- * - `CHF` - Swiss Franc (CHF)
79
- * - `EUR` - Euro (EUR)
80
- * - `GBP` - British Pound (GBP)
81
- * - `JPY` - Japanese Yen (JPY)
82
- * - `USD` - US Dollar (USD)
83
- */
84
- currency: 'CAD' | 'CHF' | 'EUR' | 'GBP' | 'JPY' | 'USD';
85
- /**
86
- * This is the description the vendor provides.
87
- */
88
- description: string;
89
- /**
90
- * The identifier for the route this Declined Transaction came through. Routes are
91
- * things like cards and ACH details.
92
- */
93
- route_id: string | null;
94
- /**
95
- * The type of the route this Declined Transaction came through.
96
- *
97
- * - `account_number` - An Account Number.
98
- * - `card` - A Card.
99
- * - `lockbox` - A Lockbox.
100
- */
101
- route_type: 'account_number' | 'card' | 'lockbox' | null;
102
- /**
103
- * This is an object giving more details on the network-level event that caused the
104
- * Declined Transaction. For example, for a card transaction this lists the
105
- * merchant's industry and location. Note that for backwards compatibility reasons,
106
- * additional undocumented keys may appear in this object. These should be treated
107
- * as deprecated and will be removed in the future.
108
- */
109
- source: DeclinedTransaction.Source;
110
- /**
111
- * A constant representing the object's type. For this resource it will always be
112
- * `declined_transaction`.
113
- */
114
- type: 'declined_transaction';
115
- }
116
- namespace DeclinedTransaction {
117
- /**
118
- * This is an object giving more details on the network-level event that caused the
119
- * Declined Transaction. For example, for a card transaction this lists the
120
- * merchant's industry and location. Note that for backwards compatibility reasons,
121
- * additional undocumented keys may appear in this object. These should be treated
122
- * as deprecated and will be removed in the future.
123
- */
124
- interface Source {
125
- /**
126
- * An ACH Decline object. This field will be present in the JSON response if and
127
- * only if `category` is equal to `ach_decline`.
128
- */
129
- ach_decline: Source.ACHDecline | null;
130
- /**
131
- * A Card Decline object. This field will be present in the JSON response if and
132
- * only if `category` is equal to `card_decline`.
133
- */
134
- card_decline: Source.CardDecline | null;
135
- /**
136
- * The type of the resource. We may add additional possible values for this enum
137
- * over time; your application should be able to handle such additions gracefully.
138
- *
139
- * - `ach_decline` - ACH Decline: details will be under the `ach_decline` object.
140
- * - `card_decline` - Card Decline: details will be under the `card_decline`
141
- * object.
142
- * - `check_decline` - Check Decline: details will be under the `check_decline`
143
- * object.
144
- * - `inbound_real_time_payments_transfer_decline` - Inbound Real-Time Payments
145
- * Transfer Decline: details will be under the
146
- * `inbound_real_time_payments_transfer_decline` object.
147
- * - `international_ach_decline` - International ACH Decline: details will be under
148
- * the `international_ach_decline` object.
149
- * - `wire_decline` - Wire Decline: details will be under the `wire_decline`
150
- * object.
151
- * - `check_deposit_rejection` - Check Deposit Rejection: details will be under the
152
- * `check_deposit_rejection` object.
153
- * - `other` - The Declined Transaction was made for an undocumented or deprecated
154
- * reason.
155
- */
156
- category: 'ach_decline' | 'card_decline' | 'check_decline' | 'inbound_real_time_payments_transfer_decline' | 'international_ach_decline' | 'wire_decline' | 'check_deposit_rejection' | 'other';
157
- /**
158
- * A Check Decline object. This field will be present in the JSON response if and
159
- * only if `category` is equal to `check_decline`.
160
- */
161
- check_decline: Source.CheckDecline | null;
162
- /**
163
- * A Check Deposit Rejection object. This field will be present in the JSON
164
- * response if and only if `category` is equal to `check_deposit_rejection`.
165
- */
166
- check_deposit_rejection: Source.CheckDepositRejection | null;
167
- /**
168
- * An Inbound Real-Time Payments Transfer Decline object. This field will be
169
- * present in the JSON response if and only if `category` is equal to
170
- * `inbound_real_time_payments_transfer_decline`.
171
- */
172
- inbound_real_time_payments_transfer_decline: Source.InboundRealTimePaymentsTransferDecline | null;
173
- /**
174
- * An International ACH Decline object. This field will be present in the JSON
175
- * response if and only if `category` is equal to `international_ach_decline`.
176
- */
177
- international_ach_decline: Source.InternationalACHDecline | null;
178
- /**
179
- * A Wire Decline object. This field will be present in the JSON response if and
180
- * only if `category` is equal to `wire_decline`.
181
- */
182
- wire_decline: Source.WireDecline | null;
183
- }
184
- namespace Source {
185
- /**
186
- * An ACH Decline object. This field will be present in the JSON response if and
187
- * only if `category` is equal to `ach_decline`.
188
- */
189
- interface ACHDecline {
190
- /**
191
- * The ACH Decline's identifier.
192
- */
193
- id: string;
194
- /**
195
- * The declined amount in the minor unit of the destination account currency. For
196
- * dollars, for example, this is cents.
197
- */
198
- amount: number;
199
- /**
200
- * The identifier of the Inbound ACH Transfer object associated with this decline.
201
- */
202
- inbound_ach_transfer_id: string;
203
- /**
204
- * The descriptive date of the transfer.
205
- */
206
- originator_company_descriptive_date: string | null;
207
- /**
208
- * The additional information included with the transfer.
209
- */
210
- originator_company_discretionary_data: string | null;
211
- /**
212
- * The identifier of the company that initiated the transfer.
213
- */
214
- originator_company_id: string;
215
- /**
216
- * The name of the company that initiated the transfer.
217
- */
218
- originator_company_name: string;
219
- /**
220
- * Why the ACH transfer was declined.
221
- *
222
- * - `ach_route_canceled` - The account number is canceled.
223
- * - `ach_route_disabled` - The account number is disabled.
224
- * - `breaches_limit` - The transaction would cause an Increase limit to be
225
- * exceeded.
226
- * - `credit_entry_refused_by_receiver` - A credit was refused. This is a
227
- * reasonable default reason for decline of credits.
228
- * - `duplicate_return` - A rare return reason. The return this message refers to
229
- * was a duplicate.
230
- * - `entity_not_active` - The account's entity is not active.
231
- * - `field_error` - There was an error with one of the required fields.
232
- * - `group_locked` - Your account is inactive.
233
- * - `insufficient_funds` - Your account contains insufficient funds.
234
- * - `misrouted_return` - A rare return reason. The return this message refers to
235
- * was misrouted.
236
- * - `return_of_erroneous_or_reversing_debit` - The originating financial
237
- * institution made a mistake and this return corrects it.
238
- * - `no_ach_route` - The account number that was debited does not exist.
239
- * - `originator_request` - The originating financial institution asked for this
240
- * transfer to be returned.
241
- * - `transaction_not_allowed` - The transaction is not allowed per Increase's
242
- * terms.
243
- * - `user_initiated` - Your integration declined this transfer via the API.
244
- */
245
- reason: 'ach_route_canceled' | 'ach_route_disabled' | 'breaches_limit' | 'credit_entry_refused_by_receiver' | 'duplicate_return' | 'entity_not_active' | 'field_error' | 'group_locked' | 'insufficient_funds' | 'misrouted_return' | 'return_of_erroneous_or_reversing_debit' | 'no_ach_route' | 'originator_request' | 'transaction_not_allowed' | 'user_initiated';
246
- /**
247
- * The id of the receiver of the transfer.
248
- */
249
- receiver_id_number: string | null;
250
- /**
251
- * The name of the receiver of the transfer.
252
- */
253
- receiver_name: string | null;
254
- /**
255
- * The trace number of the transfer.
256
- */
257
- trace_number: string;
258
- /**
259
- * A constant representing the object's type. For this resource it will always be
260
- * `ach_decline`.
261
- */
262
- type: 'ach_decline';
263
- }
264
- /**
265
- * A Card Decline object. This field will be present in the JSON response if and
266
- * only if `category` is equal to `card_decline`.
267
- */
268
- interface CardDecline {
269
- /**
270
- * The Card Decline identifier.
271
- */
272
- id: string;
273
- /**
274
- * Whether this authorization was approved by Increase, the card network through
275
- * stand-in processing, or the user through a real-time decision.
276
- *
277
- * - `user` - This object was actioned by the user through a real-time decision.
278
- * - `increase` - This object was actioned by Increase without user intervention.
279
- * - `network` - This object was actioned by the network, through stand-in
280
- * processing.
281
- */
282
- actioner: 'user' | 'increase' | 'network';
283
- /**
284
- * The declined amount in the minor unit of the destination account currency. For
285
- * dollars, for example, this is cents.
286
- */
287
- amount: number;
288
- /**
289
- * The ID of the Card Payment this transaction belongs to.
290
- */
291
- card_payment_id: string;
292
- /**
293
- * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the destination
294
- * account currency.
295
- *
296
- * - `CAD` - Canadian Dollar (CAD)
297
- * - `CHF` - Swiss Franc (CHF)
298
- * - `EUR` - Euro (EUR)
299
- * - `GBP` - British Pound (GBP)
300
- * - `JPY` - Japanese Yen (JPY)
301
- * - `USD` - US Dollar (USD)
302
- */
303
- currency: 'CAD' | 'CHF' | 'EUR' | 'GBP' | 'JPY' | 'USD';
304
- /**
305
- * The identifier of the declined transaction created for this Card Decline.
306
- */
307
- declined_transaction_id: string;
308
- /**
309
- * If the authorization was made via a Digital Wallet Token (such as an Apple Pay
310
- * purchase), the identifier of the token that was used.
311
- */
312
- digital_wallet_token_id: string | null;
313
- /**
314
- * The merchant identifier (commonly abbreviated as MID) of the merchant the card
315
- * is transacting with.
316
- */
317
- merchant_acceptor_id: string;
318
- /**
319
- * The Merchant Category Code (commonly abbreviated as MCC) of the merchant the
320
- * card is transacting with.
321
- */
322
- merchant_category_code: string | null;
323
- /**
324
- * The city the merchant resides in.
325
- */
326
- merchant_city: string | null;
327
- /**
328
- * The country the merchant resides in.
329
- */
330
- merchant_country: string | null;
331
- /**
332
- * The merchant descriptor of the merchant the card is transacting with.
333
- */
334
- merchant_descriptor: string;
335
- /**
336
- * The state the merchant resides in.
337
- */
338
- merchant_state: string | null;
339
- /**
340
- * Fields specific to the `network`.
341
- */
342
- network_details: CardDecline.NetworkDetails;
343
- /**
344
- * Network-specific identifiers for a specific request or transaction.
345
- */
346
- network_identifiers: CardDecline.NetworkIdentifiers;
347
- /**
348
- * The risk score generated by the card network. For Visa this is the Visa Advanced
349
- * Authorization risk score, from 0 to 99, where 99 is the riskiest.
350
- */
351
- network_risk_score: number | null;
352
- /**
353
- * If the authorization was made in-person with a physical card, the Physical Card
354
- * that was used.
355
- */
356
- physical_card_id: string | null;
357
- /**
358
- * The declined amount in the minor unit of the transaction's presentment currency.
359
- */
360
- presentment_amount: number;
361
- /**
362
- * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the
363
- * transaction's presentment currency.
364
- */
365
- presentment_currency: string;
366
- /**
367
- * The processing category describes the intent behind the authorization, such as
368
- * whether it was used for bill payments or an automatic fuel dispenser.
369
- *
370
- * - `account_funding` - Account funding transactions are transactions used to
371
- * e.g., fund an account or transfer funds between accounts.
372
- * - `automatic_fuel_dispenser` - Automatic fuel dispenser authorizations occur
373
- * when a card is used at a gas pump, prior to the actual transaction amount
374
- * being known. They are followed by an advice message that updates the amount of
375
- * the pending transaction.
376
- * - `bill_payment` - A transaction used to pay a bill.
377
- * - `purchase` - A regular purchase.
378
- * - `quasi_cash` - Quasi-cash transactions represent purchases of items which may
379
- * be convertible to cash.
380
- * - `refund` - A refund card authorization, sometimes referred to as a credit
381
- * voucher authorization, where funds are credited to the cardholder.
382
- */
383
- processing_category: 'account_funding' | 'automatic_fuel_dispenser' | 'bill_payment' | 'purchase' | 'quasi_cash' | 'refund';
384
- /**
385
- * The identifier of the Real-Time Decision sent to approve or decline this
386
- * transaction.
387
- */
388
- real_time_decision_id: string | null;
389
- /**
390
- * Why the transaction was declined.
391
- *
392
- * - `card_not_active` - The Card was not active.
393
- * - `physical_card_not_active` - The Physical Card was not active.
394
- * - `entity_not_active` - The account's entity was not active.
395
- * - `group_locked` - The account was inactive.
396
- * - `insufficient_funds` - The Card's Account did not have a sufficient available
397
- * balance.
398
- * - `cvv2_mismatch` - The given CVV2 did not match the card's value.
399
- * - `card_expiration_mismatch` - The given expiration date did not match the
400
- * card's value. Only applies when a CVV2 is present.
401
- * - `transaction_not_allowed` - The attempted card transaction is not allowed per
402
- * Increase's terms.
403
- * - `breaches_limit` - The transaction was blocked by a Limit.
404
- * - `webhook_declined` - Your application declined the transaction via webhook.
405
- * - `webhook_timed_out` - Your application webhook did not respond without the
406
- * required timeout.
407
- * - `declined_by_stand_in_processing` - Declined by stand-in processing.
408
- * - `invalid_physical_card` - The card read had an invalid CVV, dCVV, or
409
- * authorization request cryptogram.
410
- * - `missing_original_authorization` - The original card authorization for this
411
- * incremental authorization does not exist.
412
- * - `suspected_fraud` - The transaction was suspected to be fraudulent. Please
413
- * reach out to support@increase.com for more information.
414
- */
415
- reason: 'card_not_active' | 'physical_card_not_active' | 'entity_not_active' | 'group_locked' | 'insufficient_funds' | 'cvv2_mismatch' | 'card_expiration_mismatch' | 'transaction_not_allowed' | 'breaches_limit' | 'webhook_declined' | 'webhook_timed_out' | 'declined_by_stand_in_processing' | 'invalid_physical_card' | 'missing_original_authorization' | 'suspected_fraud';
416
- /**
417
- * Fields related to verification of cardholder-provided values.
418
- */
419
- verification: CardDecline.Verification;
420
- }
421
- namespace CardDecline {
422
- /**
423
- * Fields specific to the `network`.
424
- */
425
- interface NetworkDetails {
426
- /**
427
- * The payment network used to process this card authorization.
428
- *
429
- * - `visa` - Visa
430
- */
431
- category: 'visa';
432
- /**
433
- * Fields specific to the `visa` network.
434
- */
435
- visa: NetworkDetails.Visa | null;
436
- }
437
- namespace NetworkDetails {
438
- /**
439
- * Fields specific to the `visa` network.
440
- */
441
- interface Visa {
442
- /**
443
- * For electronic commerce transactions, this identifies the level of security used
444
- * in obtaining the customer's payment credential. For mail or telephone order
445
- * transactions, identifies the type of mail or telephone order.
446
- *
447
- * - `mail_phone_order` - Single transaction of a mail/phone order: Use to indicate
448
- * that the transaction is a mail/phone order purchase, not a recurring
449
- * transaction or installment payment. For domestic transactions in the US
450
- * region, this value may also indicate one bill payment transaction in the
451
- * card-present or card-absent environments.
452
- * - `recurring` - Recurring transaction: Payment indicator used to indicate a
453
- * recurring transaction that originates from an acquirer in the US region.
454
- * - `installment` - Installment payment: Payment indicator used to indicate one
455
- * purchase of goods or services that is billed to the account in multiple
456
- * charges over a period of time agreed upon by the cardholder and merchant from
457
- * transactions that originate from an acquirer in the US region.
458
- * - `unknown_mail_phone_order` - Unknown classification: other mail order: Use to
459
- * indicate that the type of mail/telephone order is unknown.
460
- * - `secure_electronic_commerce` - Secure electronic commerce transaction: Use to
461
- * indicate that the electronic commerce transaction has been authenticated using
462
- * e.g., 3-D Secure
463
- * - `non_authenticated_security_transaction_at_3ds_capable_merchant` -
464
- * Non-authenticated security transaction at a 3-D Secure-capable merchant, and
465
- * merchant attempted to authenticate the cardholder using 3-D Secure: Use to
466
- * identify an electronic commerce transaction where the merchant attempted to
467
- * authenticate the cardholder using 3-D Secure, but was unable to complete the
468
- * authentication because the issuer or cardholder does not participate in the
469
- * 3-D Secure program.
470
- * - `non_authenticated_security_transaction` - Non-authenticated security
471
- * transaction: Use to identify an electronic commerce transaction that uses data
472
- * encryption for security however , cardholder authentication is not performed
473
- * using 3-D Secure.
474
- * - `non_secure_transaction` - Non-secure transaction: Use to identify an
475
- * electronic commerce transaction that has no data protection.
476
- */
477
- electronic_commerce_indicator: 'mail_phone_order' | 'recurring' | 'installment' | 'unknown_mail_phone_order' | 'secure_electronic_commerce' | 'non_authenticated_security_transaction_at_3ds_capable_merchant' | 'non_authenticated_security_transaction' | 'non_secure_transaction' | null;
478
- /**
479
- * The method used to enter the cardholder's primary account number and card
480
- * expiration date.
481
- *
482
- * - `unknown` - Unknown
483
- * - `manual` - Manual key entry
484
- * - `magnetic_stripe_no_cvv` - Magnetic stripe read, without card verification
485
- * value
486
- * - `optical_code` - Optical code
487
- * - `integrated_circuit_card` - Contact chip card
488
- * - `contactless` - Contactless read of chip card
489
- * - `credential_on_file` - Transaction initiated using a credential that has
490
- * previously been stored on file
491
- * - `magnetic_stripe` - Magnetic stripe read
492
- * - `contactless_magnetic_stripe` - Contactless read of magnetic stripe data
493
- * - `integrated_circuit_card_no_cvv` - Contact chip card, without card
494
- * verification value
495
- */
496
- point_of_service_entry_mode: 'unknown' | 'manual' | 'magnetic_stripe_no_cvv' | 'optical_code' | 'integrated_circuit_card' | 'contactless' | 'credential_on_file' | 'magnetic_stripe' | 'contactless_magnetic_stripe' | 'integrated_circuit_card_no_cvv' | null;
497
- }
498
- }
499
- /**
500
- * Network-specific identifiers for a specific request or transaction.
501
- */
502
- interface NetworkIdentifiers {
503
- /**
504
- * A life-cycle identifier used across e.g., an authorization and a reversal.
505
- * Expected to be unique per acquirer within a window of time. For some card
506
- * networks the retrieval reference number includes the trace counter.
507
- */
508
- retrieval_reference_number: string | null;
509
- /**
510
- * A counter used to verify an individual authorization. Expected to be unique per
511
- * acquirer within a window of time.
512
- */
513
- trace_number: string | null;
514
- /**
515
- * A globally unique transaction identifier provided by the card network, used
516
- * across multiple life-cycle requests.
517
- */
518
- transaction_id: string | null;
519
- }
520
- /**
521
- * Fields related to verification of cardholder-provided values.
522
- */
523
- interface Verification {
524
- /**
525
- * Fields related to verification of the Card Verification Code, a 3-digit code on
526
- * the back of the card.
527
- */
528
- card_verification_code: Verification.CardVerificationCode;
529
- /**
530
- * Cardholder address provided in the authorization request and the address on file
531
- * we verified it against.
532
- */
533
- cardholder_address: Verification.CardholderAddress;
534
- }
535
- namespace Verification {
536
- /**
537
- * Fields related to verification of the Card Verification Code, a 3-digit code on
538
- * the back of the card.
539
- */
540
- interface CardVerificationCode {
541
- /**
542
- * The result of verifying the Card Verification Code.
543
- *
544
- * - `not_checked` - No card verification code was provided in the authorization
545
- * request.
546
- * - `match` - The card verification code matched the one on file.
547
- * - `no_match` - The card verification code did not match the one on file.
548
- */
549
- result: 'not_checked' | 'match' | 'no_match';
550
- }
551
- /**
552
- * Cardholder address provided in the authorization request and the address on file
553
- * we verified it against.
554
- */
555
- interface CardholderAddress {
556
- /**
557
- * Line 1 of the address on file for the cardholder.
558
- */
559
- actual_line1: string | null;
560
- /**
561
- * The postal code of the address on file for the cardholder.
562
- */
563
- actual_postal_code: string | null;
564
- /**
565
- * The cardholder address line 1 provided for verification in the authorization
566
- * request.
567
- */
568
- provided_line1: string | null;
569
- /**
570
- * The postal code provided for verification in the authorization request.
571
- */
572
- provided_postal_code: string | null;
573
- /**
574
- * The address verification result returned to the card network.
575
- *
576
- * - `not_checked` - No adress was provided in the authorization request.
577
- * - `postal_code_match_address_not_checked` - Postal code matches, but the street
578
- * address was not verified.
579
- * - `postal_code_match_address_no_match` - Postal code matches, but the street
580
- * address does not match.
581
- * - `postal_code_no_match_address_match` - Postal code does not match, but the
582
- * street address matches.
583
- * - `match` - Postal code and street address match.
584
- * - `no_match` - Postal code and street address do not match.
585
- */
586
- result: 'not_checked' | 'postal_code_match_address_not_checked' | 'postal_code_match_address_no_match' | 'postal_code_no_match_address_match' | 'match' | 'no_match';
587
- }
588
- }
589
- }
590
- /**
591
- * A Check Decline object. This field will be present in the JSON response if and
592
- * only if `category` is equal to `check_decline`.
593
- */
594
- interface CheckDecline {
595
- /**
596
- * The declined amount in the minor unit of the destination account currency. For
597
- * dollars, for example, this is cents.
598
- */
599
- amount: number;
600
- /**
601
- * A computer-readable number printed on the MICR line of business checks, usually
602
- * the check number. This is useful for positive pay checks, but can be unreliably
603
- * transmitted by the bank of first deposit.
604
- */
605
- auxiliary_on_us: string | null;
606
- /**
607
- * The identifier of the API File object containing an image of the back of the
608
- * declined check.
609
- */
610
- back_image_file_id: string | null;
611
- /**
612
- * The identifier of the Check Transfer object associated with this decline.
613
- */
614
- check_transfer_id: string | null;
615
- /**
616
- * The identifier of the API File object containing an image of the front of the
617
- * declined check.
618
- */
619
- front_image_file_id: string | null;
620
- /**
621
- * The identifier of the Inbound Check Deposit object associated with this decline.
622
- */
623
- inbound_check_deposit_id: string | null;
624
- /**
625
- * Why the check was declined.
626
- *
627
- * - `ach_route_disabled` - The account number is disabled.
628
- * - `ach_route_canceled` - The account number is canceled.
629
- * - `altered_or_fictitious` - The deposited check was altered or fictitious.
630
- * - `breaches_limit` - The transaction would cause a limit to be exceeded.
631
- * - `entity_not_active` - The account's entity is not active.
632
- * - `group_locked` - Your account is inactive.
633
- * - `insufficient_funds` - Your account contains insufficient funds.
634
- * - `stop_payment_requested` - Stop payment requested for this check.
635
- * - `duplicate_presentment` - The check was a duplicate deposit.
636
- * - `not_authorized` - The check was not authorized.
637
- * - `amount_mismatch` - The amount the receiving bank is attempting to deposit
638
- * does not match the amount on the check.
639
- * - `not_our_item` - The check attempting to be deposited does not belong to
640
- * Increase.
641
- * - `no_account_number_found` - The account number on the check does not exist at
642
- * Increase.
643
- * - `refer_to_image` - The check is not readable. Please refer to the image.
644
- * - `unable_to_process` - The check cannot be processed. This is rare: please
645
- * contact support.
646
- * - `user_initiated` - Your integration declined this check via the API.
647
- */
648
- reason: 'ach_route_disabled' | 'ach_route_canceled' | 'altered_or_fictitious' | 'breaches_limit' | 'entity_not_active' | 'group_locked' | 'insufficient_funds' | 'stop_payment_requested' | 'duplicate_presentment' | 'not_authorized' | 'amount_mismatch' | 'not_our_item' | 'no_account_number_found' | 'refer_to_image' | 'unable_to_process' | 'user_initiated';
649
- }
650
- /**
651
- * A Check Deposit Rejection object. This field will be present in the JSON
652
- * response if and only if `category` is equal to `check_deposit_rejection`.
653
- */
654
- interface CheckDepositRejection {
655
- /**
656
- * The rejected amount in the minor unit of check's currency. For dollars, for
657
- * example, this is cents.
658
- */
659
- amount: number;
660
- /**
661
- * The identifier of the Check Deposit that was rejected.
662
- */
663
- check_deposit_id: string;
664
- /**
665
- * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the check's
666
- * currency.
667
- *
668
- * - `CAD` - Canadian Dollar (CAD)
669
- * - `CHF` - Swiss Franc (CHF)
670
- * - `EUR` - Euro (EUR)
671
- * - `GBP` - British Pound (GBP)
672
- * - `JPY` - Japanese Yen (JPY)
673
- * - `USD` - US Dollar (USD)
674
- */
675
- currency: 'CAD' | 'CHF' | 'EUR' | 'GBP' | 'JPY' | 'USD';
676
- /**
677
- * Why the check deposit was rejected.
678
- *
679
- * - `incomplete_image` - The check's image is incomplete.
680
- * - `duplicate` - This is a duplicate check submission.
681
- * - `poor_image_quality` - This check has poor image quality.
682
- * - `incorrect_amount` - The check was deposited with the incorrect amount.
683
- * - `incorrect_recipient` - The check is made out to someone other than the
684
- * account holder.
685
- * - `not_eligible_for_mobile_deposit` - This check was not eligible for mobile
686
- * deposit.
687
- * - `missing_required_data_elements` - This check is missing at least one required
688
- * field.
689
- * - `suspected_fraud` - This check is suspected to be fraudulent.
690
- * - `deposit_window_expired` - This check's deposit window has expired.
691
- * - `unknown` - The check was rejected for an unknown reason.
692
- */
693
- reason: 'incomplete_image' | 'duplicate' | 'poor_image_quality' | 'incorrect_amount' | 'incorrect_recipient' | 'not_eligible_for_mobile_deposit' | 'missing_required_data_elements' | 'suspected_fraud' | 'deposit_window_expired' | 'unknown';
694
- /**
695
- * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which
696
- * the check deposit was rejected.
697
- */
698
- rejected_at: string;
699
- }
700
- /**
701
- * An Inbound Real-Time Payments Transfer Decline object. This field will be
702
- * present in the JSON response if and only if `category` is equal to
703
- * `inbound_real_time_payments_transfer_decline`.
704
- */
705
- interface InboundRealTimePaymentsTransferDecline {
706
- /**
707
- * The declined amount in the minor unit of the destination account currency. For
708
- * dollars, for example, this is cents.
709
- */
710
- amount: number;
711
- /**
712
- * The name the sender of the transfer specified as the recipient of the transfer.
713
- */
714
- creditor_name: string;
715
- /**
716
- * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code of the declined
717
- * transfer's currency. This will always be "USD" for a Real-Time Payments
718
- * transfer.
719
- *
720
- * - `CAD` - Canadian Dollar (CAD)
721
- * - `CHF` - Swiss Franc (CHF)
722
- * - `EUR` - Euro (EUR)
723
- * - `GBP` - British Pound (GBP)
724
- * - `JPY` - Japanese Yen (JPY)
725
- * - `USD` - US Dollar (USD)
726
- */
727
- currency: 'CAD' | 'CHF' | 'EUR' | 'GBP' | 'JPY' | 'USD';
728
- /**
729
- * The account number of the account that sent the transfer.
730
- */
731
- debtor_account_number: string;
732
- /**
733
- * The name provided by the sender of the transfer.
734
- */
735
- debtor_name: string;
736
- /**
737
- * The routing number of the account that sent the transfer.
738
- */
739
- debtor_routing_number: string;
740
- /**
741
- * Why the transfer was declined.
742
- *
743
- * - `account_number_canceled` - The account number is canceled.
744
- * - `account_number_disabled` - The account number is disabled.
745
- * - `account_restricted` - Your account is restricted.
746
- * - `group_locked` - Your account is inactive.
747
- * - `entity_not_active` - The account's entity is not active.
748
- * - `real_time_payments_not_enabled` - Your account is not enabled to receive
749
- * Real-Time Payments transfers.
750
- */
751
- reason: 'account_number_canceled' | 'account_number_disabled' | 'account_restricted' | 'group_locked' | 'entity_not_active' | 'real_time_payments_not_enabled';
752
- /**
753
- * Additional information included with the transfer.
754
- */
755
- remittance_information: string | null;
756
- /**
757
- * The Real-Time Payments network identification of the declined transfer.
758
- */
759
- transaction_identification: string;
760
- }
761
- /**
762
- * An International ACH Decline object. This field will be present in the JSON
763
- * response if and only if `category` is equal to `international_ach_decline`.
764
- */
765
- interface InternationalACHDecline {
766
- /**
767
- * The declined amount in the minor unit of the destination account currency. For
768
- * dollars, for example, this is cents.
769
- */
770
- amount: number;
771
- /**
772
- * The [ISO 3166](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2), Alpha-2
773
- * country code of the destination country.
774
- */
775
- destination_country_code: string;
776
- /**
777
- * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code for the
778
- * destination bank account.
779
- */
780
- destination_currency_code: string;
781
- /**
782
- * A description of how the foreign exchange rate was calculated.
783
- *
784
- * - `fixed_to_variable` - The originator chose an amount in their own currency.
785
- * The settled amount in USD was converted using the exchange rate.
786
- * - `variable_to_fixed` - The originator chose an amount to settle in USD. The
787
- * originator's amount was variable; known only after the foreign exchange
788
- * conversion.
789
- * - `fixed_to_fixed` - The amount was originated and settled as a fixed amount in
790
- * USD. There is no foreign exchange conversion.
791
- */
792
- foreign_exchange_indicator: 'fixed_to_variable' | 'variable_to_fixed' | 'fixed_to_fixed';
793
- /**
794
- * Depending on the `foreign_exchange_reference_indicator`, an exchange rate or a
795
- * reference to a well-known rate.
796
- */
797
- foreign_exchange_reference: string | null;
798
- /**
799
- * An instruction of how to interpret the `foreign_exchange_reference` field for
800
- * this Transaction.
801
- *
802
- * - `foreign_exchange_rate` - The ACH file contains a foreign exchange rate.
803
- * - `foreign_exchange_reference_number` - The ACH file contains a reference to a
804
- * well-known foreign exchange rate.
805
- * - `blank` - There is no foreign exchange for this transfer, so the
806
- * `foreign_exchange_reference` field is blank.
807
- */
808
- foreign_exchange_reference_indicator: 'foreign_exchange_rate' | 'foreign_exchange_reference_number' | 'blank';
809
- /**
810
- * The amount in the minor unit of the foreign payment currency. For dollars, for
811
- * example, this is cents.
812
- */
813
- foreign_payment_amount: number;
814
- /**
815
- * A reference number in the foreign banking infrastructure.
816
- */
817
- foreign_trace_number: string | null;
818
- /**
819
- * The type of transfer. Set by the originator.
820
- *
821
- * - `annuity` - Sent as `ANN` in the Nacha file.
822
- * - `business_or_commercial` - Sent as `BUS` in the Nacha file.
823
- * - `deposit` - Sent as `DEP` in the Nacha file.
824
- * - `loan` - Sent as `LOA` in the Nacha file.
825
- * - `miscellaneous` - Sent as `MIS` in the Nacha file.
826
- * - `mortgage` - Sent as `MOR` in the Nacha file.
827
- * - `pension` - Sent as `PEN` in the Nacha file.
828
- * - `remittance` - Sent as `REM` in the Nacha file.
829
- * - `rent_or_lease` - Sent as `RLS` in the Nacha file.
830
- * - `salary_or_payroll` - Sent as `SAL` in the Nacha file.
831
- * - `tax` - Sent as `TAX` in the Nacha file.
832
- * - `accounts_receivable` - Sent as `ARC` in the Nacha file.
833
- * - `back_office_conversion` - Sent as `BOC` in the Nacha file.
834
- * - `machine_transfer` - Sent as `MTE` in the Nacha file.
835
- * - `point_of_purchase` - Sent as `POP` in the Nacha file.
836
- * - `point_of_sale` - Sent as `POS` in the Nacha file.
837
- * - `represented_check` - Sent as `RCK` in the Nacha file.
838
- * - `shared_network_transaction` - Sent as `SHR` in the Nacha file.
839
- * - `telphone_initiated` - Sent as `TEL` in the Nacha file.
840
- * - `internet_initiated` - Sent as `WEB` in the Nacha file.
841
- */
842
- international_transaction_type_code: 'annuity' | 'business_or_commercial' | 'deposit' | 'loan' | 'miscellaneous' | 'mortgage' | 'pension' | 'remittance' | 'rent_or_lease' | 'salary_or_payroll' | 'tax' | 'accounts_receivable' | 'back_office_conversion' | 'machine_transfer' | 'point_of_purchase' | 'point_of_sale' | 'represented_check' | 'shared_network_transaction' | 'telphone_initiated' | 'internet_initiated';
843
- /**
844
- * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code for the
845
- * originating bank account.
846
- */
847
- originating_currency_code: string;
848
- /**
849
- * The [ISO 3166](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2), Alpha-2
850
- * country code of the originating branch country.
851
- */
852
- originating_depository_financial_institution_branch_country: string;
853
- /**
854
- * An identifier for the originating bank. One of an International Bank Account
855
- * Number (IBAN) bank identifier, SWIFT Bank Identification Code (BIC), or a
856
- * domestic identifier like a US Routing Number.
857
- */
858
- originating_depository_financial_institution_id: string;
859
- /**
860
- * An instruction of how to interpret the
861
- * `originating_depository_financial_institution_id` field for this Transaction.
862
- *
863
- * - `national_clearing_system_number` - A domestic clearing system number. In the
864
- * US, for example, this is the American Banking Association (ABA) routing
865
- * number.
866
- * - `bic_code` - The SWIFT Bank Identifier Code (BIC) of the bank.
867
- * - `iban` - An International Bank Account Number.
868
- */
869
- originating_depository_financial_institution_id_qualifier: 'national_clearing_system_number' | 'bic_code' | 'iban';
870
- /**
871
- * The name of the originating bank. Sometimes this will refer to an American bank
872
- * and obscure the correspondent foreign bank.
873
- */
874
- originating_depository_financial_institution_name: string;
875
- /**
876
- * A portion of the originator address. This may be incomplete.
877
- */
878
- originator_city: string;
879
- /**
880
- * A description field set by the originator.
881
- */
882
- originator_company_entry_description: string;
883
- /**
884
- * A portion of the originator address. The
885
- * [ISO 3166](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2), Alpha-2 country
886
- * code of the originator country.
887
- */
888
- originator_country: string;
889
- /**
890
- * An identifier for the originating company. This is generally stable across
891
- * multiple ACH transfers.
892
- */
893
- originator_identification: string;
894
- /**
895
- * Either the name of the originator or an intermediary money transmitter.
896
- */
897
- originator_name: string;
898
- /**
899
- * A portion of the originator address. This may be incomplete.
900
- */
901
- originator_postal_code: string | null;
902
- /**
903
- * A portion of the originator address. This may be incomplete.
904
- */
905
- originator_state_or_province: string | null;
906
- /**
907
- * A portion of the originator address. This may be incomplete.
908
- */
909
- originator_street_address: string;
910
- /**
911
- * A description field set by the originator.
912
- */
913
- payment_related_information: string | null;
914
- /**
915
- * A description field set by the originator.
916
- */
917
- payment_related_information2: string | null;
918
- /**
919
- * A portion of the receiver address. This may be incomplete.
920
- */
921
- receiver_city: string;
922
- /**
923
- * A portion of the receiver address. The
924
- * [ISO 3166](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2), Alpha-2 country
925
- * code of the receiver country.
926
- */
927
- receiver_country: string;
928
- /**
929
- * An identification number the originator uses for the receiver.
930
- */
931
- receiver_identification_number: string | null;
932
- /**
933
- * A portion of the receiver address. This may be incomplete.
934
- */
935
- receiver_postal_code: string | null;
936
- /**
937
- * A portion of the receiver address. This may be incomplete.
938
- */
939
- receiver_state_or_province: string | null;
940
- /**
941
- * A portion of the receiver address. This may be incomplete.
942
- */
943
- receiver_street_address: string;
944
- /**
945
- * The name of the receiver of the transfer. This is not verified by Increase.
946
- */
947
- receiving_company_or_individual_name: string;
948
- /**
949
- * The [ISO 3166](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2), Alpha-2
950
- * country code of the receiving bank country.
951
- */
952
- receiving_depository_financial_institution_country: string;
953
- /**
954
- * An identifier for the receiving bank. One of an International Bank Account
955
- * Number (IBAN) bank identifier, SWIFT Bank Identification Code (BIC), or a
956
- * domestic identifier like a US Routing Number.
957
- */
958
- receiving_depository_financial_institution_id: string;
959
- /**
960
- * An instruction of how to interpret the
961
- * `receiving_depository_financial_institution_id` field for this Transaction.
962
- *
963
- * - `national_clearing_system_number` - A domestic clearing system number. In the
964
- * US, for example, this is the American Banking Association (ABA) routing
965
- * number.
966
- * - `bic_code` - The SWIFT Bank Identifier Code (BIC) of the bank.
967
- * - `iban` - An International Bank Account Number.
968
- */
969
- receiving_depository_financial_institution_id_qualifier: 'national_clearing_system_number' | 'bic_code' | 'iban';
970
- /**
971
- * The name of the receiving bank, as set by the sending financial institution.
972
- */
973
- receiving_depository_financial_institution_name: string;
974
- /**
975
- * A 15 digit number recorded in the Nacha file and available to both the
976
- * originating and receiving bank. Along with the amount, date, and originating
977
- * routing number, this can be used to identify the ACH transfer at either bank.
978
- * ACH trace numbers are not unique, but are
979
- * [used to correlate returns](https://increase.com/documentation/ach-returns#ach-returns).
980
- */
981
- trace_number: string;
982
- }
983
- /**
984
- * A Wire Decline object. This field will be present in the JSON response if and
985
- * only if `category` is equal to `wire_decline`.
986
- */
987
- interface WireDecline {
988
- /**
989
- * The identifier of the Inbound Wire Transfer that was declined.
990
- */
991
- inbound_wire_transfer_id: string;
992
- /**
993
- * Why the wire transfer was declined.
994
- *
995
- * - `account_number_canceled` - The account number is canceled.
996
- * - `account_number_disabled` - The account number is disabled.
997
- * - `entity_not_active` - The account's entity is not active.
998
- * - `group_locked` - Your account is inactive.
999
- * - `no_account_number` - The beneficiary account number does not exist.
1000
- * - `transaction_not_allowed` - The transaction is not allowed per Increase's
1001
- * terms.
1002
- */
1003
- reason: 'account_number_canceled' | 'account_number_disabled' | 'entity_not_active' | 'group_locked' | 'no_account_number' | 'transaction_not_allowed';
1004
- }
1005
- }
1006
- }
1007
- /**
1008
- * If the authorization attempt succeeds, this will contain the resulting Pending
1009
- * Transaction object. The Pending Transaction's `source` will be of
1010
- * `category: card_authorization`.
1011
- */
1012
- interface PendingTransaction {
1013
- /**
1014
- * The Pending Transaction identifier.
1015
- */
1016
- id: string;
1017
- /**
1018
- * The identifier for the account this Pending Transaction belongs to.
1019
- */
1020
- account_id: string;
1021
- /**
1022
- * The Pending Transaction amount in the minor unit of its currency. For dollars,
1023
- * for example, this is cents.
1024
- */
1025
- amount: number;
1026
- /**
1027
- * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date on which the Pending
1028
- * Transaction was completed.
1029
- */
1030
- completed_at: string | null;
1031
- /**
1032
- * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date on which the Pending
1033
- * Transaction occurred.
1034
- */
1035
- created_at: string;
1036
- /**
1037
- * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the Pending
1038
- * Transaction's currency. This will match the currency on the Pending
1039
- * Transaction's Account.
1040
- *
1041
- * - `CAD` - Canadian Dollar (CAD)
1042
- * - `CHF` - Swiss Franc (CHF)
1043
- * - `EUR` - Euro (EUR)
1044
- * - `GBP` - British Pound (GBP)
1045
- * - `JPY` - Japanese Yen (JPY)
1046
- * - `USD` - US Dollar (USD)
1047
- */
1048
- currency: 'CAD' | 'CHF' | 'EUR' | 'GBP' | 'JPY' | 'USD';
1049
- /**
1050
- * For a Pending Transaction related to a transfer, this is the description you
1051
- * provide. For a Pending Transaction related to a payment, this is the description
1052
- * the vendor provides.
1053
- */
1054
- description: string;
1055
- /**
1056
- * The identifier for the route this Pending Transaction came through. Routes are
1057
- * things like cards and ACH details.
1058
- */
1059
- route_id: string | null;
1060
- /**
1061
- * The type of the route this Pending Transaction came through.
1062
- *
1063
- * - `account_number` - An Account Number.
1064
- * - `card` - A Card.
1065
- * - `lockbox` - A Lockbox.
1066
- */
1067
- route_type: 'account_number' | 'card' | 'lockbox' | null;
1068
- /**
1069
- * This is an object giving more details on the network-level event that caused the
1070
- * Pending Transaction. For example, for a card transaction this lists the
1071
- * merchant's industry and location.
1072
- */
1073
- source: PendingTransaction.Source;
1074
- /**
1075
- * Whether the Pending Transaction has been confirmed and has an associated
1076
- * Transaction.
1077
- *
1078
- * - `pending` - The Pending Transaction is still awaiting confirmation.
1079
- * - `complete` - The Pending Transaction is confirmed. An associated Transaction
1080
- * exists for this object. The Pending Transaction will no longer count against
1081
- * your balance and can generally be hidden from UIs, etc.
1082
- */
1083
- status: 'pending' | 'complete';
1084
- /**
1085
- * A constant representing the object's type. For this resource it will always be
1086
- * `pending_transaction`.
1087
- */
1088
- type: 'pending_transaction';
1089
- }
1090
- namespace PendingTransaction {
1091
- /**
1092
- * This is an object giving more details on the network-level event that caused the
1093
- * Pending Transaction. For example, for a card transaction this lists the
1094
- * merchant's industry and location.
1095
- */
1096
- interface Source {
1097
- /**
1098
- * An Account Transfer Instruction object. This field will be present in the JSON
1099
- * response if and only if `category` is equal to `account_transfer_instruction`.
1100
- */
1101
- account_transfer_instruction: Source.AccountTransferInstruction | null;
1102
- /**
1103
- * An ACH Transfer Instruction object. This field will be present in the JSON
1104
- * response if and only if `category` is equal to `ach_transfer_instruction`.
1105
- */
1106
- ach_transfer_instruction: Source.ACHTransferInstruction | null;
1107
- /**
1108
- * A Card Authorization object. This field will be present in the JSON response if
1109
- * and only if `category` is equal to `card_authorization`.
1110
- */
1111
- card_authorization: Source.CardAuthorization | null;
1112
- /**
1113
- * The type of the resource. We may add additional possible values for this enum
1114
- * over time; your application should be able to handle such additions gracefully.
1115
- *
1116
- * - `account_transfer_instruction` - Account Transfer Instruction: details will be
1117
- * under the `account_transfer_instruction` object.
1118
- * - `ach_transfer_instruction` - ACH Transfer Instruction: details will be under
1119
- * the `ach_transfer_instruction` object.
1120
- * - `card_authorization` - Card Authorization: details will be under the
1121
- * `card_authorization` object.
1122
- * - `check_deposit_instruction` - Check Deposit Instruction: details will be under
1123
- * the `check_deposit_instruction` object.
1124
- * - `check_transfer_instruction` - Check Transfer Instruction: details will be
1125
- * under the `check_transfer_instruction` object.
1126
- * - `inbound_funds_hold` - Inbound Funds Hold: details will be under the
1127
- * `inbound_funds_hold` object.
1128
- * - `real_time_payments_transfer_instruction` - Real-Time Payments Transfer
1129
- * Instruction: details will be under the
1130
- * `real_time_payments_transfer_instruction` object.
1131
- * - `wire_transfer_instruction` - Wire Transfer Instruction: details will be under
1132
- * the `wire_transfer_instruction` object.
1133
- * - `other` - The Pending Transaction was made for an undocumented or deprecated
1134
- * reason.
1135
- */
1136
- category: 'account_transfer_instruction' | 'ach_transfer_instruction' | 'card_authorization' | 'check_deposit_instruction' | 'check_transfer_instruction' | 'inbound_funds_hold' | 'real_time_payments_transfer_instruction' | 'wire_transfer_instruction' | 'other';
1137
- /**
1138
- * A Check Deposit Instruction object. This field will be present in the JSON
1139
- * response if and only if `category` is equal to `check_deposit_instruction`.
1140
- */
1141
- check_deposit_instruction: Source.CheckDepositInstruction | null;
1142
- /**
1143
- * A Check Transfer Instruction object. This field will be present in the JSON
1144
- * response if and only if `category` is equal to `check_transfer_instruction`.
1145
- */
1146
- check_transfer_instruction: Source.CheckTransferInstruction | null;
1147
- /**
1148
- * An Inbound Funds Hold object. This field will be present in the JSON response if
1149
- * and only if `category` is equal to `inbound_funds_hold`.
1150
- */
1151
- inbound_funds_hold: Source.InboundFundsHold | null;
1152
- /**
1153
- * A Real-Time Payments Transfer Instruction object. This field will be present in
1154
- * the JSON response if and only if `category` is equal to
1155
- * `real_time_payments_transfer_instruction`.
1156
- */
1157
- real_time_payments_transfer_instruction: Source.RealTimePaymentsTransferInstruction | null;
1158
- /**
1159
- * A Wire Transfer Instruction object. This field will be present in the JSON
1160
- * response if and only if `category` is equal to `wire_transfer_instruction`.
1161
- */
1162
- wire_transfer_instruction: Source.WireTransferInstruction | null;
1163
- }
1164
- namespace Source {
1165
- /**
1166
- * An Account Transfer Instruction object. This field will be present in the JSON
1167
- * response if and only if `category` is equal to `account_transfer_instruction`.
1168
- */
1169
- interface AccountTransferInstruction {
1170
- /**
1171
- * The pending amount in the minor unit of the transaction's currency. For dollars,
1172
- * for example, this is cents.
1173
- */
1174
- amount: number;
1175
- /**
1176
- * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the destination
1177
- * account currency.
1178
- *
1179
- * - `CAD` - Canadian Dollar (CAD)
1180
- * - `CHF` - Swiss Franc (CHF)
1181
- * - `EUR` - Euro (EUR)
1182
- * - `GBP` - British Pound (GBP)
1183
- * - `JPY` - Japanese Yen (JPY)
1184
- * - `USD` - US Dollar (USD)
1185
- */
1186
- currency: 'CAD' | 'CHF' | 'EUR' | 'GBP' | 'JPY' | 'USD';
1187
- /**
1188
- * The identifier of the Account Transfer that led to this Pending Transaction.
1189
- */
1190
- transfer_id: string;
1191
- }
1192
- /**
1193
- * An ACH Transfer Instruction object. This field will be present in the JSON
1194
- * response if and only if `category` is equal to `ach_transfer_instruction`.
1195
- */
1196
- interface ACHTransferInstruction {
1197
- /**
1198
- * The pending amount in the minor unit of the transaction's currency. For dollars,
1199
- * for example, this is cents.
1200
- */
1201
- amount: number;
1202
- /**
1203
- * The identifier of the ACH Transfer that led to this Pending Transaction.
1204
- */
1205
- transfer_id: string;
1206
- }
1207
- /**
1208
- * A Card Authorization object. This field will be present in the JSON response if
1209
- * and only if `category` is equal to `card_authorization`.
1210
- */
1211
- interface CardAuthorization {
1212
- /**
1213
- * The Card Authorization identifier.
1214
- */
1215
- id: string;
1216
- /**
1217
- * Whether this authorization was approved by Increase, the card network through
1218
- * stand-in processing, or the user through a real-time decision.
1219
- *
1220
- * - `user` - This object was actioned by the user through a real-time decision.
1221
- * - `increase` - This object was actioned by Increase without user intervention.
1222
- * - `network` - This object was actioned by the network, through stand-in
1223
- * processing.
1224
- */
1225
- actioner: 'user' | 'increase' | 'network';
1226
- /**
1227
- * The pending amount in the minor unit of the transaction's currency. For dollars,
1228
- * for example, this is cents.
1229
- */
1230
- amount: number;
1231
- /**
1232
- * The ID of the Card Payment this transaction belongs to.
1233
- */
1234
- card_payment_id: string;
1235
- /**
1236
- * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the
1237
- * transaction's currency.
1238
- *
1239
- * - `CAD` - Canadian Dollar (CAD)
1240
- * - `CHF` - Swiss Franc (CHF)
1241
- * - `EUR` - Euro (EUR)
1242
- * - `GBP` - British Pound (GBP)
1243
- * - `JPY` - Japanese Yen (JPY)
1244
- * - `USD` - US Dollar (USD)
1245
- */
1246
- currency: 'CAD' | 'CHF' | 'EUR' | 'GBP' | 'JPY' | 'USD';
1247
- /**
1248
- * If the authorization was made via a Digital Wallet Token (such as an Apple Pay
1249
- * purchase), the identifier of the token that was used.
1250
- */
1251
- digital_wallet_token_id: string | null;
1252
- /**
1253
- * The direction descibes the direction the funds will move, either from the
1254
- * cardholder to the merchant or from the merchant to the cardholder.
1255
- *
1256
- * - `settlement` - A regular card authorization where funds are debited from the
1257
- * cardholder.
1258
- * - `refund` - A refund card authorization, sometimes referred to as a credit
1259
- * voucher authorization, where funds are credited to the cardholder.
1260
- */
1261
- direction: 'settlement' | 'refund';
1262
- /**
1263
- * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) when this authorization
1264
- * will expire and the pending transaction will be released.
1265
- */
1266
- expires_at: string;
1267
- /**
1268
- * The merchant identifier (commonly abbreviated as MID) of the merchant the card
1269
- * is transacting with.
1270
- */
1271
- merchant_acceptor_id: string;
1272
- /**
1273
- * The Merchant Category Code (commonly abbreviated as MCC) of the merchant the
1274
- * card is transacting with.
1275
- */
1276
- merchant_category_code: string | null;
1277
- /**
1278
- * The city the merchant resides in.
1279
- */
1280
- merchant_city: string | null;
1281
- /**
1282
- * The country the merchant resides in.
1283
- */
1284
- merchant_country: string | null;
1285
- /**
1286
- * The merchant descriptor of the merchant the card is transacting with.
1287
- */
1288
- merchant_descriptor: string;
1289
- /**
1290
- * Fields specific to the `network`.
1291
- */
1292
- network_details: CardAuthorization.NetworkDetails;
1293
- /**
1294
- * Network-specific identifiers for a specific request or transaction.
1295
- */
1296
- network_identifiers: CardAuthorization.NetworkIdentifiers;
1297
- /**
1298
- * The risk score generated by the card network. For Visa this is the Visa Advanced
1299
- * Authorization risk score, from 0 to 99, where 99 is the riskiest.
1300
- */
1301
- network_risk_score: number | null;
1302
- /**
1303
- * The identifier of the Pending Transaction associated with this Transaction.
1304
- */
1305
- pending_transaction_id: string | null;
1306
- /**
1307
- * If the authorization was made in-person with a physical card, the Physical Card
1308
- * that was used.
1309
- */
1310
- physical_card_id: string | null;
1311
- /**
1312
- * The pending amount in the minor unit of the transaction's presentment currency.
1313
- */
1314
- presentment_amount: number;
1315
- /**
1316
- * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the
1317
- * transaction's presentment currency.
1318
- */
1319
- presentment_currency: string;
1320
- /**
1321
- * The processing category describes the intent behind the authorization, such as
1322
- * whether it was used for bill payments or an automatic fuel dispenser.
1323
- *
1324
- * - `account_funding` - Account funding transactions are transactions used to
1325
- * e.g., fund an account or transfer funds between accounts.
1326
- * - `automatic_fuel_dispenser` - Automatic fuel dispenser authorizations occur
1327
- * when a card is used at a gas pump, prior to the actual transaction amount
1328
- * being known. They are followed by an advice message that updates the amount of
1329
- * the pending transaction.
1330
- * - `bill_payment` - A transaction used to pay a bill.
1331
- * - `purchase` - A regular purchase.
1332
- * - `quasi_cash` - Quasi-cash transactions represent purchases of items which may
1333
- * be convertible to cash.
1334
- * - `refund` - A refund card authorization, sometimes referred to as a credit
1335
- * voucher authorization, where funds are credited to the cardholder.
1336
- */
1337
- processing_category: 'account_funding' | 'automatic_fuel_dispenser' | 'bill_payment' | 'purchase' | 'quasi_cash' | 'refund';
1338
- /**
1339
- * The identifier of the Real-Time Decision sent to approve or decline this
1340
- * transaction.
1341
- */
1342
- real_time_decision_id: string | null;
1343
- /**
1344
- * A constant representing the object's type. For this resource it will always be
1345
- * `card_authorization`.
1346
- */
1347
- type: 'card_authorization';
1348
- /**
1349
- * Fields related to verification of cardholder-provided values.
1350
- */
1351
- verification: CardAuthorization.Verification;
1352
- }
1353
- namespace CardAuthorization {
1354
- /**
1355
- * Fields specific to the `network`.
1356
- */
1357
- interface NetworkDetails {
1358
- /**
1359
- * The payment network used to process this card authorization.
1360
- *
1361
- * - `visa` - Visa
1362
- */
1363
- category: 'visa';
1364
- /**
1365
- * Fields specific to the `visa` network.
1366
- */
1367
- visa: NetworkDetails.Visa | null;
1368
- }
1369
- namespace NetworkDetails {
1370
- /**
1371
- * Fields specific to the `visa` network.
1372
- */
1373
- interface Visa {
1374
- /**
1375
- * For electronic commerce transactions, this identifies the level of security used
1376
- * in obtaining the customer's payment credential. For mail or telephone order
1377
- * transactions, identifies the type of mail or telephone order.
1378
- *
1379
- * - `mail_phone_order` - Single transaction of a mail/phone order: Use to indicate
1380
- * that the transaction is a mail/phone order purchase, not a recurring
1381
- * transaction or installment payment. For domestic transactions in the US
1382
- * region, this value may also indicate one bill payment transaction in the
1383
- * card-present or card-absent environments.
1384
- * - `recurring` - Recurring transaction: Payment indicator used to indicate a
1385
- * recurring transaction that originates from an acquirer in the US region.
1386
- * - `installment` - Installment payment: Payment indicator used to indicate one
1387
- * purchase of goods or services that is billed to the account in multiple
1388
- * charges over a period of time agreed upon by the cardholder and merchant from
1389
- * transactions that originate from an acquirer in the US region.
1390
- * - `unknown_mail_phone_order` - Unknown classification: other mail order: Use to
1391
- * indicate that the type of mail/telephone order is unknown.
1392
- * - `secure_electronic_commerce` - Secure electronic commerce transaction: Use to
1393
- * indicate that the electronic commerce transaction has been authenticated using
1394
- * e.g., 3-D Secure
1395
- * - `non_authenticated_security_transaction_at_3ds_capable_merchant` -
1396
- * Non-authenticated security transaction at a 3-D Secure-capable merchant, and
1397
- * merchant attempted to authenticate the cardholder using 3-D Secure: Use to
1398
- * identify an electronic commerce transaction where the merchant attempted to
1399
- * authenticate the cardholder using 3-D Secure, but was unable to complete the
1400
- * authentication because the issuer or cardholder does not participate in the
1401
- * 3-D Secure program.
1402
- * - `non_authenticated_security_transaction` - Non-authenticated security
1403
- * transaction: Use to identify an electronic commerce transaction that uses data
1404
- * encryption for security however , cardholder authentication is not performed
1405
- * using 3-D Secure.
1406
- * - `non_secure_transaction` - Non-secure transaction: Use to identify an
1407
- * electronic commerce transaction that has no data protection.
1408
- */
1409
- electronic_commerce_indicator: 'mail_phone_order' | 'recurring' | 'installment' | 'unknown_mail_phone_order' | 'secure_electronic_commerce' | 'non_authenticated_security_transaction_at_3ds_capable_merchant' | 'non_authenticated_security_transaction' | 'non_secure_transaction' | null;
1410
- /**
1411
- * The method used to enter the cardholder's primary account number and card
1412
- * expiration date.
1413
- *
1414
- * - `unknown` - Unknown
1415
- * - `manual` - Manual key entry
1416
- * - `magnetic_stripe_no_cvv` - Magnetic stripe read, without card verification
1417
- * value
1418
- * - `optical_code` - Optical code
1419
- * - `integrated_circuit_card` - Contact chip card
1420
- * - `contactless` - Contactless read of chip card
1421
- * - `credential_on_file` - Transaction initiated using a credential that has
1422
- * previously been stored on file
1423
- * - `magnetic_stripe` - Magnetic stripe read
1424
- * - `contactless_magnetic_stripe` - Contactless read of magnetic stripe data
1425
- * - `integrated_circuit_card_no_cvv` - Contact chip card, without card
1426
- * verification value
1427
- */
1428
- point_of_service_entry_mode: 'unknown' | 'manual' | 'magnetic_stripe_no_cvv' | 'optical_code' | 'integrated_circuit_card' | 'contactless' | 'credential_on_file' | 'magnetic_stripe' | 'contactless_magnetic_stripe' | 'integrated_circuit_card_no_cvv' | null;
1429
- }
1430
- }
1431
- /**
1432
- * Network-specific identifiers for a specific request or transaction.
1433
- */
1434
- interface NetworkIdentifiers {
1435
- /**
1436
- * A life-cycle identifier used across e.g., an authorization and a reversal.
1437
- * Expected to be unique per acquirer within a window of time. For some card
1438
- * networks the retrieval reference number includes the trace counter.
1439
- */
1440
- retrieval_reference_number: string | null;
1441
- /**
1442
- * A counter used to verify an individual authorization. Expected to be unique per
1443
- * acquirer within a window of time.
1444
- */
1445
- trace_number: string | null;
1446
- /**
1447
- * A globally unique transaction identifier provided by the card network, used
1448
- * across multiple life-cycle requests.
1449
- */
1450
- transaction_id: string | null;
1451
- }
1452
- /**
1453
- * Fields related to verification of cardholder-provided values.
1454
- */
1455
- interface Verification {
1456
- /**
1457
- * Fields related to verification of the Card Verification Code, a 3-digit code on
1458
- * the back of the card.
1459
- */
1460
- card_verification_code: Verification.CardVerificationCode;
1461
- /**
1462
- * Cardholder address provided in the authorization request and the address on file
1463
- * we verified it against.
1464
- */
1465
- cardholder_address: Verification.CardholderAddress;
1466
- }
1467
- namespace Verification {
1468
- /**
1469
- * Fields related to verification of the Card Verification Code, a 3-digit code on
1470
- * the back of the card.
1471
- */
1472
- interface CardVerificationCode {
1473
- /**
1474
- * The result of verifying the Card Verification Code.
1475
- *
1476
- * - `not_checked` - No card verification code was provided in the authorization
1477
- * request.
1478
- * - `match` - The card verification code matched the one on file.
1479
- * - `no_match` - The card verification code did not match the one on file.
1480
- */
1481
- result: 'not_checked' | 'match' | 'no_match';
1482
- }
1483
- /**
1484
- * Cardholder address provided in the authorization request and the address on file
1485
- * we verified it against.
1486
- */
1487
- interface CardholderAddress {
1488
- /**
1489
- * Line 1 of the address on file for the cardholder.
1490
- */
1491
- actual_line1: string | null;
1492
- /**
1493
- * The postal code of the address on file for the cardholder.
1494
- */
1495
- actual_postal_code: string | null;
1496
- /**
1497
- * The cardholder address line 1 provided for verification in the authorization
1498
- * request.
1499
- */
1500
- provided_line1: string | null;
1501
- /**
1502
- * The postal code provided for verification in the authorization request.
1503
- */
1504
- provided_postal_code: string | null;
1505
- /**
1506
- * The address verification result returned to the card network.
1507
- *
1508
- * - `not_checked` - No adress was provided in the authorization request.
1509
- * - `postal_code_match_address_not_checked` - Postal code matches, but the street
1510
- * address was not verified.
1511
- * - `postal_code_match_address_no_match` - Postal code matches, but the street
1512
- * address does not match.
1513
- * - `postal_code_no_match_address_match` - Postal code does not match, but the
1514
- * street address matches.
1515
- * - `match` - Postal code and street address match.
1516
- * - `no_match` - Postal code and street address do not match.
1517
- */
1518
- result: 'not_checked' | 'postal_code_match_address_not_checked' | 'postal_code_match_address_no_match' | 'postal_code_no_match_address_match' | 'match' | 'no_match';
1519
- }
1520
- }
1521
- }
1522
- /**
1523
- * A Check Deposit Instruction object. This field will be present in the JSON
1524
- * response if and only if `category` is equal to `check_deposit_instruction`.
1525
- */
1526
- interface CheckDepositInstruction {
1527
- /**
1528
- * The pending amount in the minor unit of the transaction's currency. For dollars,
1529
- * for example, this is cents.
1530
- */
1531
- amount: number;
1532
- /**
1533
- * The identifier of the File containing the image of the back of the check that
1534
- * was deposited.
1535
- */
1536
- back_image_file_id: string | null;
1537
- /**
1538
- * The identifier of the Check Deposit.
1539
- */
1540
- check_deposit_id: string | null;
1541
- /**
1542
- * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the
1543
- * transaction's currency.
1544
- *
1545
- * - `CAD` - Canadian Dollar (CAD)
1546
- * - `CHF` - Swiss Franc (CHF)
1547
- * - `EUR` - Euro (EUR)
1548
- * - `GBP` - British Pound (GBP)
1549
- * - `JPY` - Japanese Yen (JPY)
1550
- * - `USD` - US Dollar (USD)
1551
- */
1552
- currency: 'CAD' | 'CHF' | 'EUR' | 'GBP' | 'JPY' | 'USD';
1553
- /**
1554
- * The identifier of the File containing the image of the front of the check that
1555
- * was deposited.
1556
- */
1557
- front_image_file_id: string;
1558
- }
1559
- /**
1560
- * A Check Transfer Instruction object. This field will be present in the JSON
1561
- * response if and only if `category` is equal to `check_transfer_instruction`.
1562
- */
1563
- interface CheckTransferInstruction {
1564
- /**
1565
- * The pending amount in the minor unit of the transaction's currency. For dollars,
1566
- * for example, this is cents.
1567
- */
1568
- amount: number;
1569
- /**
1570
- * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the check's
1571
- * currency.
1572
- *
1573
- * - `CAD` - Canadian Dollar (CAD)
1574
- * - `CHF` - Swiss Franc (CHF)
1575
- * - `EUR` - Euro (EUR)
1576
- * - `GBP` - British Pound (GBP)
1577
- * - `JPY` - Japanese Yen (JPY)
1578
- * - `USD` - US Dollar (USD)
1579
- */
1580
- currency: 'CAD' | 'CHF' | 'EUR' | 'GBP' | 'JPY' | 'USD';
1581
- /**
1582
- * The identifier of the Check Transfer that led to this Pending Transaction.
1583
- */
1584
- transfer_id: string;
1585
- }
1586
- /**
1587
- * An Inbound Funds Hold object. This field will be present in the JSON response if
1588
- * and only if `category` is equal to `inbound_funds_hold`.
1589
- */
1590
- interface InboundFundsHold {
1591
- /**
1592
- * The Inbound Funds Hold identifier.
1593
- */
1594
- id: string;
1595
- /**
1596
- * The held amount in the minor unit of the account's currency. For dollars, for
1597
- * example, this is cents.
1598
- */
1599
- amount: number;
1600
- /**
1601
- * When the hold will be released automatically. Certain conditions may cause it to
1602
- * be released before this time.
1603
- */
1604
- automatically_releases_at: string;
1605
- /**
1606
- * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time at which the hold
1607
- * was created.
1608
- */
1609
- created_at: string;
1610
- /**
1611
- * The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the hold's
1612
- * currency.
1613
- *
1614
- * - `CAD` - Canadian Dollar (CAD)
1615
- * - `CHF` - Swiss Franc (CHF)
1616
- * - `EUR` - Euro (EUR)
1617
- * - `GBP` - British Pound (GBP)
1618
- * - `JPY` - Japanese Yen (JPY)
1619
- * - `USD` - US Dollar (USD)
1620
- */
1621
- currency: 'CAD' | 'CHF' | 'EUR' | 'GBP' | 'JPY' | 'USD';
1622
- /**
1623
- * The ID of the Transaction for which funds were held.
1624
- */
1625
- held_transaction_id: string | null;
1626
- /**
1627
- * The ID of the Pending Transaction representing the held funds.
1628
- */
1629
- pending_transaction_id: string | null;
1630
- /**
1631
- * When the hold was released (if it has been released).
1632
- */
1633
- released_at: string | null;
1634
- /**
1635
- * The status of the hold.
1636
- *
1637
- * - `held` - Funds are still being held.
1638
- * - `complete` - Funds have been released.
1639
- */
1640
- status: 'held' | 'complete';
1641
- /**
1642
- * A constant representing the object's type. For this resource it will always be
1643
- * `inbound_funds_hold`.
1644
- */
1645
- type: 'inbound_funds_hold';
1646
- }
1647
- /**
1648
- * A Real-Time Payments Transfer Instruction object. This field will be present in
1649
- * the JSON response if and only if `category` is equal to
1650
- * `real_time_payments_transfer_instruction`.
1651
- */
1652
- interface RealTimePaymentsTransferInstruction {
1653
- /**
1654
- * The pending amount in the minor unit of the transaction's currency. For dollars,
1655
- * for example, this is cents.
1656
- */
1657
- amount: number;
1658
- /**
1659
- * The identifier of the Real-Time Payments Transfer that led to this Pending
1660
- * Transaction.
1661
- */
1662
- transfer_id: string;
1663
- }
1664
- /**
1665
- * A Wire Transfer Instruction object. This field will be present in the JSON
1666
- * response if and only if `category` is equal to `wire_transfer_instruction`.
1667
- */
1668
- interface WireTransferInstruction {
1669
- /**
1670
- * The account number for the destination account.
1671
- */
1672
- account_number: string;
1673
- /**
1674
- * The pending amount in the minor unit of the transaction's currency. For dollars,
1675
- * for example, this is cents.
1676
- */
1677
- amount: number;
1678
- /**
1679
- * The message that will show on the recipient's bank statement.
1680
- */
1681
- message_to_recipient: string;
1682
- /**
1683
- * The American Bankers' Association (ABA) Routing Transit Number (RTN) for the
1684
- * destination account.
1685
- */
1686
- routing_number: string;
1687
- /**
1688
- * The identifier of the Wire Transfer that led to this Pending Transaction.
1689
- */
1690
- transfer_id: string;
1691
- }
1692
- }
1693
- }
1694
- }
1695
- export interface CardAuthorizeParams {
1696
- /**
1697
- * The authorization amount in cents.
1698
- */
1699
- amount: number;
1700
- /**
1701
- * The identifier of the Card to be authorized.
1702
- */
1703
- card_id?: string;
1704
- /**
1705
- * The identifier of the Digital Wallet Token to be authorized.
1706
- */
1707
- digital_wallet_token_id?: string;
1708
- /**
1709
- * The identifier of the Event Subscription to use. If provided, will override the
1710
- * default real time event subscription. Because you can only create one real time
1711
- * decision event subscription, you can use this field to route events to any
1712
- * specified event subscription for testing purposes.
1713
- */
1714
- event_subscription_id?: string;
1715
- /**
1716
- * The merchant identifier (commonly abbreviated as MID) of the merchant the card
1717
- * is transacting with.
1718
- */
1719
- merchant_acceptor_id?: string;
1720
- /**
1721
- * The Merchant Category Code (commonly abbreviated as MCC) of the merchant the
1722
- * card is transacting with.
1723
- */
1724
- merchant_category_code?: string;
1725
- /**
1726
- * The city the merchant resides in.
1727
- */
1728
- merchant_city?: string;
1729
- /**
1730
- * The country the merchant resides in.
1731
- */
1732
- merchant_country?: string;
1733
- /**
1734
- * The merchant descriptor of the merchant the card is transacting with.
1735
- */
1736
- merchant_descriptor?: string;
1737
- /**
1738
- * The identifier of the Physical Card to be authorized.
1739
- */
1740
- physical_card_id?: string;
1741
- }
1742
- export interface CardSettlementParams {
1743
- /**
1744
- * The identifier of the Card to create a settlement on.
1745
- */
1746
- card_id: string;
1747
- /**
1748
- * The identifier of the Pending Transaction for the Card Authorization you wish to
1749
- * settle.
1750
- */
1751
- pending_transaction_id: string;
1752
- /**
1753
- * The amount to be settled. This defaults to the amount of the Pending Transaction
1754
- * being settled.
1755
- */
1756
- amount?: number;
1757
- }
1758
- export declare namespace Cards {
1759
- export import CardAuthorizationSimulation = CardsAPI.CardAuthorizationSimulation;
1760
- export import CardAuthorizeParams = CardsAPI.CardAuthorizeParams;
1761
- export import CardSettlementParams = CardsAPI.CardSettlementParams;
1762
- }
1763
- //# sourceMappingURL=cards.d.ts.map