Wires

Simulate an inbound payment

5min
in this tutorial, you'll learn how to ✅ simulate an inbound wire transfer if you are new to wire transfers we recommend you read the wires docid\ zaxecgz253epmvur5l4eh before starting this tutorial if you are new to apis and how they work we recommend you read the api overview docid\ p4oymfdtb4xc52tud3 iu page before starting this tutorial the tutorial uses this api endpoint api description post /wires/v1/payments/simulations simulate a post of an inbound wire transfer to an account before you begin make sure you have bank rails docid\ kbym9o05dwmdjsf8k7lzi partner id webhook registration docid 6skz9uoz84ply4vjodinp the following webhook webhook description wire payment received inbound wire has been received from another bank request a refund by wire transfer when you call post /wires/v1/payments/simulations , the cr sandbox creates a simulation of an inbound wire transfer to a deposit or subledger account so you can see what the inbound transfer looks like and test any automations you are designing in this example, stream247 is refunding $19 99 to their customer, jana parker, by sending a wire transfer from their jp morgan chase account post /wires/v1/payments/simulations request { "accountnumber" "2846838676", "originator" { "idcode" "d", "identifier" "4236598541", "name" "stream247", "address1" "257 dalton groves", "address2" "barton city, mi 48075" }, "businessfunctioncode" "ctr", "senderroutingnumber" "021000021", "senderdiname" "jp morgan chase", "originatorfi" { "idcode" "f", "identifier" "021000021", "name" "jp morgan chase" }, "beneficiaryreference" "refund sep2022", "amount" 1999 } these details show in the api response the stream247 account at jp morgan chase as the originator sent an inbound wire transfer direction inbound , to jana parker, the beneficiary , via cross river bank2 in the amount of $19 99 reflected in amount as 1999 the payment id is e68e32c3 a475 4d0b a6d8 ae3c01186ff4 , as seen in the id attribute post /v1/payments/simulations response { "id" "e68e32c3 a475 4d0b a6d8 ae3c01186ff4", "accountnumber" "2846838676", "referenceid" "w2204571at5", "direction" "inbound", "paymenttype" "transfer", "source" "api", "status" "hold", "posting" "pending", "amount" 1999, "currency" "usd", "purpose" "simulation", "imad" "1563371856856662630811", "omad" "942955532798176168895701363106962410", "businessfunctioncode" "ctr", "typecode" "1000", "senderroutingnumber" "021000021", "sendername" "jp morgan chase", "senderreference" "test", "receiverroutingnumber" "021214891", "receivername" "cross river bank2", "originatingfi" { "idcode" "f", "identifier" "021000021", "name" "jp morgan chase" }, "originator" { "idcode" "d", "identifier" "4236598541", "name" "stream247", "address1" "257 dalton groves", "address2" "barton city, mi 48705" }, "beneficiaryfi" { "idcode" "f", "identifier" "021000021", "name" "cross river bank", "address1" "400 kelby street", "address2" "fort lee, nj", "address3" "us" }, "beneficiary" { "idcode" "d", "identifier" "2846838676", "name" "jana parker", "address1" "250 kuhn highway", "address2" "", "address3" "grover, nc 28073" }, "beneficiaryreference" "refund sep2022", "receiptdate" "0214", "receipttime" "1201", "wasreversed" false, "isinternational" false, "createdat" "2022 02 14t12 01 02 460748 05 00", "effectivedate" "2022 02 14t00 00 00 05 00", "originalpaymentid" "e68e32c3 a475 4d0b a6d8 ae3c01186ff4", "partnerid" "f03ff044 8883 4939 9d22 ade301661897", "productid" "9b8490c9 ccac 4f7d 8b49 ae3800e6b418", "lastmodifiedat" "2022 02 14t12 01 02 4967164 05 00", "postingcode" "ok" } the wire payment received webhook event fires the payment id ( e68e32c3 a475 4d0b a6d8 ae3c01186ff4 ) appears in the resources object that is the same id that you received in the response to your simulation request wire payment received webhook { "id" "3809b97e 58dc 4082 bc64 ae3c01188e1c", "eventname" "wire payment received", "status" "pending", "partnerid" "f03ff044 8883 4939 9d22 ade301661897", "createdat" "2022 02 14t12 01 28 197 05 00", "resources" \[ "wires/v1/payments/e68e32c3 a475 4d0b a6d8 ae3c01186ff4" ], "details" \[] }